Document Files
This topic describes information about the files that you can use to send Documents.
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 total file size cannot exceed 200MB.
- Individual attachments cannot exceed 5MB
- The above restrictions are imposed by Vertex e-Invoicing. When an invoice exceeds these limits it will appear as a processing issue on your dashboard.
- Some e-invoice recipients may impose more restrictive limits. When a document exceeds the recipient limits it will appear as an error on your dashboard.
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.
Updated 17 days ago