Skip to content

Get an invoice based on the invoiceId

get
https://api.mercadoe.com/v1/invoices/{invoiceId}

Retrieve information about a specific invoice with the given invoiceId.

Request

Path Parameters

invoiceId
int32
required
the invoice id

Responses

200
404
500
OK

Body

application/json
invoiceId
int32
A unique identifier or alias for the invoice identifier.
tenantId
int32
A unique identifier or alias for the requesting tenant.
supplierId
int32
A unique identifier or alias for the Supplier.
serialNumber
string | null
Invoice Serial Number
issueDate
date-time | null
Invoice issue date
totalDue
double | null
Total amount due informed on the invoice (calculated by the total price of the items)
currency
string | null
Currency in alphabetic code (for more information, please refer to: https://www.iso.org/iso-4217-currency-codes.html).
creationDate
date-time | null
Invoice creation date
updateDate
date-time | null
Invoice update date
isIntegrated
boolean
Indicates if the invoice is integrated
integrationDate
date-time | null
It provides the integration date
netPrice
double | null
Invoice net price
orderId
int32
deprecated
ID of the ME purchase order
clientOrderId
string | null
deprecated
The order ID in the Client’s ERP
invoiceNumber
string | null
Invoice number
invoiceSerial
string | null
Invoice serial number
dateTime
date-time | null
Invoice issue date and time
freightValue
double | null
Freight value informed on the invoice
invoiceCharging
double | null
Amount of invoice charges
invoiceDiscounts
double | null
Amount of invoice discounts
userId
int32 | null
ID of the user who created the invoice
userLogin
string | null
Login of the user who created the invoice
deliveryPlace
string | null
deprecated
Delivery Place
paymentCondition
string | null
deprecated
Payment condition (provided in the order)
itemQuantity
int32 | null
deprecated
Quantity of invoice items
clientSupplierId
string | null
Supplier identifier in the ERP
requester
string | null
deprecated
Requester of the invoice
requesterPhoneNumber
string | null
deprecated
Requester phone number
grossServiceAmount
double | null
deprecated
Gross value of provided services
invoiceCode
string | null
deprecated
Invoice code
exchangeRate
double | null
Value of the foreign currency exchange rate.
hasElectronicInvoice
boolean
Has Eletronic Invoice
withholding
double | null
Withholding tax amount
roundedTotalDue
double | null
Rounded Total Due
accessKey
string
Access Key
buyerDocument
object
supplierDocument
object
deliveryLocationDocument
object
dueDate
date-time | null
Invoice Due Date
category
string | null
Invoice category description
orders
array of object
List of orders related to the invoice, consisting of the fields OrderId, ClientOrderId, ClientSupplierId, among others.
recipient
object
businessOrganizations
array of object
Business Organizations is a list consisting of the Company Code, Delivery Center/Location Code and their descriptions.
Credentials
shell