Documents is the collective term for the e-invoice, credit note, and other files that you send to the service. The service then sends these to the Tax Authorities or other recipients.

Sending Files

The Document can be specified in the body of the Send Document request or it can be attached to the request as a file.

📘

Note

We recommend that you include the Document as an upload using the request's payload and the Content-Type=application/xml header as described in the Send Document topic.

You use Documents to load your invoices and credit notes into the service. The information is specified in VRBL.

VRBL

Inbound Documents are sent in the Vertex Universal Standard (VRBL) format.

An overview of VRBL is provided in the VRBL Overview topic.

An introduction to how information is modelled in VRBL is provided in the Modelling Documents topic.

Virus and Malicious Content Precautions

Each file uploaded to the API is scanned for viruses and other malicious content. If any suspicious content is identified, the file will not be ingested and will not display on the e-Invoicing dashboard.

The API only accepts files in the VRBL format, which in addition to the e-invoice data, provides a means of embedding supporting documentation attachments. These attachments are also scanned for viruses and, if any viruses are found, the entire upload process is disrupted.

File Size Restrictions

The following file size restrictions apply:

• You must upload a single Document file with a single request. To upload multiple invoices, you must use individual Send Document requests.
• The file size cannot exceed 200MB in total.

Document Formatting

The following formatting is required for the Document that you send using the Send Document request:

• It is recommended that you include the VRBL in the body of the request and not as an attachment.
• The inbound Documents that you send to the service must use VRBL. See Modelling Documents.
• If you do attach the Document as an attachement, the file itself must be XML.

File Formats for Attachments

Supporting Documents can be attached to the VRBL Document as described in the Attachments topic.