Convert CII XML to ZUGFeRD PDF using REST-API
Upload a UN/CEFACT Cross Industry Invoice (CII) D16B XML document and receive a ZUGFeRD 2.x compliant PDF/A-3 with the XML embedded as the factur-x.xml attachment. The API parses the CII payload, renders a clean visual layer, and writes ZUGFeRD-branded XMP metadata (zf: namespace) into the output container.
https://api.invoicexml.com/v1/convert/cii/to/zugferd
Code Example
curl -X POST https://api.invoicexml.com/v1/convert/cii/to/zugferd \ -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 ZUGFeRD PDF/A-3 as a binary file.
Frequently Asked Questions
How does this differ from /v1/embed/zugferd?
/v1/embed/zugferd attaches your supplied XML to your supplied PDF, the visual layer stays exactly as you uploaded it. /v1/convert/cii/to/zugferd generates a fresh visual layer from the structured XML, so you only need the XML to produce a complete hybrid PDF.
Is the output Schematron-validated?
Yes. The input CII is validated against EN 16931 rules before the PDF is built. Validation failures are returned as 400 with the specific rule violations.