To send a Document, use the POST method and the following URL:

https://e-invoicing-service.vertexcloud.com/customers/v2/documents

When sending a Document, the VRBL file should be represented as raw XML with Content-Type=application/xml.

Attach the VRBL XML file in the body of the request, for example:

curl --request POST \
     --url https://e-invoicing-service.prod.vtxdev.net/customers/v2/documents \
     --header 'Idempotency-Key: <string>' \
     --header 'content-type: application/xml' \
     --header 'accept: application/json' \
     --header 'authorization: ••••••' \ 
     --data-binary '@vrbl.xml'

Restrictions

You must upload a single Document file with a single request. To upload multiple invoices, you must use individual Send Document requests.
The document file size cannot exceed 200 MB in total.
Individual attachments cannot exceed 5 MB.
The above restrictions are imposed by Vertex e-Invoicing.
Some e-invoice recipients may impose more restrictive limits.

Details

Detail	Description
Endpoint	`/customers/v2/documents`
Method	POST
API Reference Example	Send Document

Notes

The VRBL Document attached to the body of this request should not be confused with Additional Documents or Attachments.

Header Parameter

The following parameter should be added as a header:

Field	Description
`Idempotency-Key`	This key prevents a Document from being processed more than once. See Idempotency Key.

The body of the request must be a VRBL document as defined in the VRBL User Guide Overview and should be represented as raw XML with Content-Type=application/xml.

Response Output

Output	Type	Description
`Document ID`	GUID	The unique identifier of the document within Vertex e-Invoicing.
`Idempotency Key`	string	The idempotency key specified in the request.
`Transmission DateTime`	DateTime	The date and time at which the submission was received.