Import client invoices in bulk
OAuth scope: client_invoice.write
Imports already-issued client invoices in bulk by uploading their files (1 to 5 per request).
Unlike creating a client invoice, this endpoint does not regenerate the document: the original file you upload is preserved as-is. This makes it the right choice when your ERP or billing system already produces compliant Factur-X invoices that must be transmitted unchanged.
The whole request body is limited to 15 MB, with a maximum of 5 files of 5 MB each per request.
Re-importing a file that has already been imported is idempotent: instead of creating a duplicate, the endpoint returns the invoice_id of the existing invoice.
Bulk import is not available to Italian organizations; their requests return 403 Forbidden.
Authorizations
Bearer authorization header: Bearer <token>, where <token> is the access token received from the authorization server at the end of the OAuth 2.0 flow.
Headers
Required only for Sandbox API requests; to get one, please sign up to the Developer Portal.
Body
You have to specify multipart form data in order to attach the files to the request. Repeat the client_invoices field once per file. When using curl it will look like this:
curl --location --request POST 'https://thirdparty.qonto.com/v2/client_invoices/bulk' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--form 'client_invoices=@"/path/to/invoice1.pdf"' \
--form 'client_invoices=@"/path/to/invoice2.pdf"'The invoice files to import (repeat the client_invoices field once per file). Supported formats:
- PDF (.pdf), including Factur-X
- JPEG (.jpeg, .jpg)
- PNG (.png)
Each file must not exceed 5 MB, and the whole request must not exceed 15 MB.
5Response
Returns the list of successfully imported client invoices.