Convert ZUGFeRD PDF to CII using REST-API
Upload a ZUGFeRD 2.x PDF/A-3 hybrid invoice and receive its embedded UN/CEFACT CII D16B XML as a standalone file. The XML is shape-checked and validated against EN 16931 Schematron rules before delivery.
POST
https://api.invoicexml.com/v1/convert/zugferd/to/cii
Code Example
curl -X POST https://api.invoicexml.com/v1/convert/zugferd/to/cii \ -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 embedded CII D16B XML document.
Content-Type: application/xml
Frequently Asked Questions
How does this differ from /v1/extract/xml?
/v1/extract/xml streams the embedded XML out of the PDF as-is, without validation. /v1/convert/zugferd/to/cii returns the same XML but runs EN 16931 Schematron validation first, so a malformed embedded attachment surfaces as a 4001 response.
What happens if the PDF has no embedded XML?
The API returns a 400 response with errorCode 4006 (NoEmbeddedXml).