CII to PDF API
Upload a UN/CEFACT CII XML file and receive a human-readable PDF preview.
https://api.invoicexml.com/v1/render/cii/to/pdf
- All profiles, MINIMUM to EXTENDED
- XML from ZUGFeRD and Factur-X
- Labels in English, German or French
- Optional logo and payment QR code
Technical reference
Upload a UN/CEFACT Cross Industry Invoice (CII) XML file and receive a clean, professionally formatted PDF preview. The API parses the deeply nested CII structure, maps every EN 16931 Business Term to a readable layout, and returns a downloadable PDF. Supports all CII profiles from MINIMUM through EXTENDED.
POST /v1/render/xml/to/pdf,
which accepts any supported invoice XML and detects the syntax itself. Both routes behave identically, so keep this one if the explicit format documents intent, or switch to the generic one to drop the format check from your code.
Code Example
curl -X POST https://api.invoicexml.com/v1/render/cii/to/pdf \ -H "Authorization: Bearer YOUR_API_KEY" \ -F "[email protected]" \ -F "language=en"
Request
| Parameter | Type | Description |
|---|---|---|
| file * | binary | The XML invoice file to render as PDF. |
| language | string | Language for PDF labels and date formatting. Values: en, de, fr. Defaults to en. |
| logo | binary | Your logo, printed top-left as the create endpoints print it: a PNG or JPEG file part of at most 2 MB and 4 megapixels, re-encoded before embedding. Send either this or logoUrl, not both. |
| logoUrl | string | Public URL of your logo instead of the file itself, with the same limits. The API fetches it with the same protections as the create endpoints' pdfUrl. |
| includeQrCode | boolean | Prints an EPC QR code (GiroCode) in the payment section, exactly as the create endpoints' options.includeQrCode does: a banking app turns it into a pre-filled SEPA credit transfer. Printed when the invoice is in EUR, carries a valid IBAN, is paid by credit transfer and has an amount due. Defaults to false. |
Content-Type: multipart/form-data
Headers
| Header | Value |
|---|---|
| Authorization * | Bearer YOUR_API_KEY |
| Content-Type | multipart/form-data |
Response
200 Rendered PDF
Returns the rendered PDF as a binary file.
Useful resources
Companion material for integrating against the API.
Runnable CII integration samples in C#, Java, PHP, Python, Node.js, and browser JavaScript, ready to clone and adapt.
InvoiceXML/cii-api-examples
Run this endpoint on your own file or data straight from your browser, no code and no sign-up required.
www.invoicexml.com/api/render/cii
The full OpenAPI 3.1 document. Drop it into Postman, Insomnia, or any code generator to scaffold a client.
api.invoicexml.com/v1/openapi
Browse and call every endpoint directly from the browser, powered by Scalar.
api.invoicexml.com/v1/scalar
Frequently Asked Questions
Ready to automate your invoices?
Validate, convert and embed compliant e-invoices through one API. Start your 30-day free trial. No credit card required.