Create a Public AppCustomize Your Store
Chat on SlackContact Us

Get tax invoices

get https://app.ecwid.com/api/v3//orders//invoices

Receive legally compliant tax invoices for specified order through API. Read more about tax invoices here. Please note that we have a bulk tax invoice download tool in Control Panel: link

Headers

NameTypeDescription
AuthorizationstringoAuth token with mandatory Bearer before it. Example: Bearer e***s0, where e***s0 should be replaced with your oAuth token.

Response

Information about tax invoices for the requested order ID.

FieldTypeDescription
invoicesArray <Invoices>Tax invoices created for the order

Invoices

FieldTypeDescription
internalIdnumberInternal ID of the tax invoice
idstringPublic invoice ID showed in the tax invoice
createdstringDate and time of tax invoice creation in UTC
linkstringDownload link for the tax invoice in PDF format
typestringTax invoice type. Supported values "SALE" (regular), "FULL_CANCEL" (refund)

Errors

Error response example: 

HTTP/1.1 405 Method Not Allowed

In case of error, Ecwid responds with an error HTTP status code and, optionally, JSON-formatted body containing error description

HTTP codes

HTTP StatusDescription
400Request parameters are malformed
403Access token doesn't have read_invoices scope
404The order is not found
405Method not allowed. Can occur when using PUT/POST/DELETE HTTP request methods instead of GET
415Unsupported content-type: expected application/json or text/json
500Cannot retrieve the order info because of an error on the server

Error response body (optional)

FieldTypeDescription
errorMessagestringError message
Language
Authorization
Query