Automation Features Blog Pricing Contact

Convert CII to XRechnung using REST-API

Promote a plain UN/CEFACT CII D16B EN 16931 invoice to an XRechnung-conformant document. The customization identifier (BT-24) is rebranded to the latest XRechnung CIUS URN, German B2G constraints are applied, and the output is validated against the XRechnung Schematron rules before delivery. Ready for ZRE / OZG-RE submission.

POST /v1/convert/cii/to/xrechnung

Code Example

curl -X POST https://api.invoicexml.com/v1/convert/cii/to/xrechnung \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "[email protected]"

Request

Parameter Type Description
file * binary The XML invoice file to convert.

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 XRechnung CII XML document.

Content-Type: application/xml

Frequently Asked Questions

Which CII versions are accepted?

CII D16B, the version referenced by EN 16931 and used inside ZUGFeRD and Factur-X.

Is the output validated?

Yes. The generated XRechnung is validated against the full XRechnung Schematron rule set on top of EN 16931. Missing German B2G fields (e.g. BT-10 buyer reference / Leitweg-ID) surface as 4001 validation failures.

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

Yes. XRechnung CII is a valid CII payload; pass it to /v1/embed/facturx or /v1/embed/zugferd to produce a hybrid PDF/A-3 with the XRechnung XML inside.