Automation MCP Server Blog Pricing

UBL to CII Conversion API

Convert a UBL XML invoice to UN/CEFACT CII XML for ZUGFeRD, Factur-X, or EN 16931 workflows.

POST 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.

Content-Type: application/xml

Useful resources

Companion material for integrating against the API.

Frequently Asked Questions

What UBL versions are accepted?

The endpoint accepts UBL in the schema release EN 16931 binds to and the Peppol network uses. Both <Invoice> and <CreditNote> document types are supported.

Can I embed the output in a ZUGFeRD or Factur-X PDF?

Yes. The generated CII XML is structurally identical to the XML embedded in ZUGFeRD and Factur-X documents. You can attach it to a PDF/A-3 container. Alternatively, use /v1/create/zugferd or /v1/create/facturx to generate the complete hybrid PDF.

Are all EN 16931 fields preserved?

Yes. The conversion maps every EN 16931 Business Term (BT) from UBL to CII. No semantic data is lost, only the XML syntax changes.

Does this work with Peppol BIS invoices?

Yes. Peppol BIS Billing invoices are UBL documents conforming to EN 16931. They convert cleanly to CII since both syntaxes express the same semantic model.

Is the output validated?

Yes. The generated CII document is validated against EN 16931 Schematron business rules before delivery. If validation fails, the API returns a 400 response with the specific rule violations.

Start free today

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.

GDPR Compliant No credit card required Setup in minutes
Peppol UBL
Factur-X
EN 16931
142 / 142 passed
Compliant
PDF/A-3 embedded