How do I send documents via API?

Before you start, a short checklist:

1. Are your files ready? These can be PDFs or a structured file (e.g., XML or UBL).
2. Size and count: you can send up to 5 files at once, each file up to 5 MB.
3. Optional: you can add information such as cost center and department, and select the desired delivery channel per document (PEPPOL …).
4. Access: an access token is required.

Step 1: choose your delivery method.

1. SendingId: for manually submitted shipments.
2. SendingConfigurationId: for automatic submission or reusing a shipment for the same day (useful for daily batches).
   You cannot combine both methods.

Step 2: gather your files

1. Prepare the documents (up to 5, each maximum 5 MB).
2. Check the format: PDF or structured.
   

Step 3 (optional): choose the delivery channel per document.

1. Provide the delivery channel per document (PEPPOL …).

Step 4 (optional): add extra info

Send your own metadata, such as:

1. Cost center
2. Department
3. ...

Step 5: obtain an access token

1. Authentication is done via OAuth 2.0.
2. Your IT requests a token.
3. Store the token; you’ll need it in the next step.

Step 6: upload your documents

1. Send your files to the upload endpoint.
2. Add your token in the Authorization header.
3. Include the following information:
4. 1. One of the IDs
   2. Optional metadata
   3. Optional channel per document

Step 7: check your confirmation

After the upload, you will receive a response with the status.

API Rate limit: please note that API calls are limited to 500 calls per minute for authenticated users, and 100 calls per minute for unauthenticated users.