UN/CEFACT CII D16B
Die Syntax innerhalb von Factur-X & XRechnungCross Industry Invoice (CII) D16B ist neben UBL die andere EN-16931-XML-Syntax — ein Einzeldokument-Schema, das sowohl dem hybriden PDF-Format Factur-X/ZUGFeRD als auch einer der beiden gültigen XRechnung-Syntaxen zugrunde liegt.
Worum es geht
Während UBL Rechnungen und Gutschriften in separate Wurzelelemente aufteilt, stellt CII beides als ein einziges CrossIndustryInvoice-Dokument dar, unterschieden durch einen Typcode. CrateAPI erzeugt und validiert reines CII-XML direkt — Sie müssen dafür nicht über Factur-X gehen.
Wo es Pflicht ist
CII wählt man selten für sich allein — es taucht als Syntax innerhalb von Factur-X (Frankreich) auf, als eine von zwei gültigen XRechnung-Syntaxen (Deutschland), oder wenn das System eines Handelspartners CII-nativ ist und Sie aus UBL konvertieren müssen.
Was wir nicht tun. CII und UBL decken dasselbe semantische EN-16931-Modell ab, nur in unterschiedlicher XML-Form — deshalb ist die Konvertierung zwischen ihnen verlustfrei-oder-abgelehnt statt einer verlustbehafteten Bestmöglich-Schätzung.
Ausprobieren
curl -X POST "$BASE/v1/generate/cii?profile=en16931" \ -H "X-API-Key: $KEY" -H "Content-Type: application/json" \ -d @invoice.json -o invoice.xml
Relevante Endpoints
| Endpoint | Hinweise |
|---|---|
POST /v1/generate/cii?profile=en16931|xrechnung | Profil en16931 oder xrechnung — dieselbe Engine wie auf der UBL-Seite. |
POST /v1/validate/cii?profile=en16931|xrechnungkostenlos | Offizielle Schematron- + XSD-Regeln, strukturierte Befunde. |
POST /v1/convert/{ubl-to-cii,cii-to-ubl} | Verlustfrei-oder-abgelehnt — 422 mit den genauen nicht unterstützten Features, nie eine stille Degradierung. |
POST /v1/render/{html,pdf} | CII wird automatisch neben UBL erkannt, kein separates Flag nötig. |
Beispiele & Dokumentation
Laden Sie validierte CII-Beispieldateien (Rechnung und Gutschrift) aus unserer Beispielbibliothek herunter, oder lesen Sie die vollständige API-Referenz.
FAQ
Soll ich UBL oder CII verwenden?
Wenn Sie frei wählen können, ist UBL/Peppol die gängigere paneuropäische Standardoption. Nutzen Sie CII, wenn ein Handelspartner es verlangt, oder wenn Sie Factur-X/ZUGFeRD oder XRechnungs CII-Option benötigen.
Kann ich zwischen UBL und CII konvertieren?
Ja — POST /v1/convert/{ubl-to-cii,cii-to-ubl}, verlustfrei-oder-abgelehnt: Übersteht ein Feature die Konvertierung nicht, erhalten Sie einen 422 mit der genauen Liste, nie eine still degradierte Rechnung.
Unterstützt CII Gutschriften?
Ja, derselbe Dokumenttyp mit anderem Typcode — siehe die CII-Gruppe in unserer Beispielbibliothek für Rechnung und Gutschrift.