CII to UBL Conversion API
Convert a UN/CEFACT CII XML invoice to UBL XML for Peppol BIS Billing, NLCIUS, EHF, PINT or EN 16931 workflows.
https://api.invoicexml.com/v1/convert/cii/to/ubl
- Peppol BIS, NLCIUS, EHF or PINT output
- Every EN 16931 business term mapped
- Validated against the chosen profile
- Missing Peppol data pointed out
Technical reference
Convert a UN/CEFACT Cross Industry Invoice (CII) XML document to UBL XML. The API maps every EN 16931 Business Term from the CII nested structure to the equivalent UBL flat component model and validates the result. Name a UBL profile in the optional profile field, such as peppol-bis-3, and the invoice declares that profile and is validated against its rules, ready for the Peppol network.
Code Example
curl -X POST https://api.invoicexml.com/v1/convert/cii/to/ubl \ -H "Authorization: Bearer YOUR_API_KEY" \ -F "[email protected]" \ -F "profile=peppol-bis-3" \ -F "validationLanguage=en"
Request
| Parameter | Type | Description |
|---|---|---|
| file * | binary | The XML invoice file to convert. |
| profile | string | Optional. UBL profile of the converted invoice: en16931 (the default), peppol-bis-3, nlcius, ehf or pint, in any letter case. The invoice declares the profile's specification identifier (BT-24) and, where the profile requires one, its business process (BT-23), must meet the profile's requirements (for Peppol, the seller and buyer electronic addresses and a buyer or order reference), and is validated against the profile's rule set. With the default, the invoice declares plain EN 16931, whatever the uploaded file declared, and is validated against the EN 16931 rules. Any other value is rejected with a 400 (errorCode 4002). |
| 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 UBL 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/cii/to/ubl
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.