Skip to navigation
Sales DocumentsEcommerce

Find Sales Documents

Beta

Returns the incoming e-commerce sales documents that match one e-mail address, newest first. Pass exactly one of email (matched against the document’s sell-to e-mail) or invoiceEmail (matched against the document’s sell-to invoice e-mail). The match is case-insensitive on a bare address. Hits are compact by default; withDetails=true returns every property of SalesDocumentDTO except payments.

Authentication

x-np-api-keystring
API Key authentication via header

Path parameters

tenantstringRequired

Your Entra Tenant ID. More details.

environmentstringRequired

Your Business Central Environment. More details.

companystringRequired

Your Business Central Company. More details.

Headers

x-api-versiondateOptional

Used for API versioning. More details.

Query parameters

emailstringOptional

The sell-to e-mail address to search for. Exactly one of email and invoiceEmail may carry a value; passing neither, or both with a value, returns 400. Max. length 80 symbols.

invoiceEmailstringOptional

The sell-to invoice e-mail address to search for. Exactly one of email and invoiceEmail must be given. Max. length 80 symbols.

withDetailsbooleanOptional
Pass true to receive every property of SalesDocumentDTO except payments in each hit, instead of the compact hit.
pageSizeintegerOptional

Documents per page. Defaults to 100, which is also the maximum. A value below 1 falls back to the default, a higher value is capped at 100, and a non-numeric value returns 400.

pageKeystringOptional
Continuation key taken from a previous response's nextPageKey.

Response

This endpoint returns an object.
morePagesboolean
True when further pages follow. Pass nextPageKey to retrieve them.
nextPageKeystring
Continuation key for the next page, blank on the last page.
nextPageURLstring

Ready-made URL for the next page, blank on the last page.

salesDocumentslist of objects

Errors

400
Bad Request