Skip to content

Create an invoice

post
https://api.mercadoe.com/v1/invoices

Create a new invoice by providing the serial number, invoice number, items, and other details.

Request

Headers

X-ME-CORRELATION-ID
string
Internal client code to be identified in the webhook. It can be, for example, a product code in your ERP, an order number, etc.

Body

application/json
invoiceNumber
string
required
Invoice number
invoiceSerial
string
required
Invoice serial number
currencyCode
string
Currency in alphabetic code (for more information, please refer to: https://www.iso.org/iso-4217-currency-codes.html).
issueDate
date-time | null
Invoice issue date
status
string
required
allowed values: InApprovalReturnedCanceledAcceptedLauchedIntegrated
totalDue
double | null
Total amount due
grossServiceAmount
double
Gross value of the service
withholding
double | null
Withholding tax amount
category
string
required
Invoice category
items
array of object
List with the invoice items
businessOrganizations
array of object
Business Organizations is a list consisting of the Company Code, Delivery Center/Location Code and their descriptions.
attributes
array of object
List with the attributes of the ordered items, consisting of the name, value, and description fields.
supplierId
int32
A unique identifier or alias for the Supplier.
clientSupplierCode
string | null
A unique identifier or alias for the Client Supplier.
clientSupplierBorgCode
string | null
A identifier or alias for the Client Supplier Borg.
integrationTag
string
required
Identification (Login) of the ME user used in the integration.

Responses

202
400
Accepted

Body

application/json
correlationId
string