UBL to CII Conversion API
Convert a UBL XML invoice to UN/CEFACT CII XML for ZUGFeRD, Factur-X, or EN 16931 workflows.
https://api.invoicexml.com/v1/convert/ubl/to/cii
- Ready for ZUGFeRD and Factur-X
- Peppol invoices and credit notes
- Every EN 16931 business term mapped
- Validated before delivery
Technical reference
Convert a UBL XML invoice to a UN/CEFACT Cross Industry Invoice (CII) XML document. The API maps every EN 16931 Business Term from UBL's flat cac:/cbc: component structure to the equivalent CII nested trade model, producing a validated CII document ready for ZUGFeRD or Factur-X embedding, or standalone CII delivery.
Code Example
curl -X POST https://api.invoicexml.com/v1/convert/ubl/to/cii \ -H "Authorization: Bearer YOUR_API_KEY" \ -F "[email protected]" \ -F "validationLanguage=en"
Request
| Parameter | Type | Description |
|---|---|---|
| file * | binary | The XML invoice file to convert. |
| validationLanguage | string | Optional. Language of the finding messages when the converted invoice is rejected: en (default), de or fr, in any letter case. Only each finding's message changes; rule, btCodes, fields and raw stay the same. Any other value is rejected with a 400 (errorCode 4002). See localized error messages. |
Content-Type: multipart/form-data
Headers
| Header | Value |
|---|---|
| Authorization * | Bearer YOUR_API_KEY |
| Content-Type | multipart/form-data |
Response
200 Converted XML
Returns the converted CII XML document.
Useful resources
Companion material for integrating against the API.
Runnable samples in C#, Java, PHP, Python, Node.js, and browser JavaScript, one repository per format.
github.com/InvoiceXML
Run this endpoint on your own file or data straight from your browser, no code and no sign-up required.
www.invoicexml.com/api/convert/ubl/to/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.