UN/CEFACT CII D16B
Sintaxa din interiorul Factur-X și XRechnungCross Industry Invoice (CII) D16B e cealaltă sintaxă XML EN 16931, alături de UBL — o schemă cu un singur document, care stă la baza atât a formatului hibrid PDF Factur-X/ZUGFeRD, cât și a uneia dintre cele două sintaxe valide XRechnung.
Ce este
Acolo unde UBL separă facturile și notele de credit în elemente rădăcină distincte, CII reprezintă ambele ca un singur document CrossIndustryInvoice, diferențiat printr-un cod de tip. CrateAPI generează și validează XML CII simplu direct — nu ai nevoie să treci prin Factur-X ca să-l obții.
Unde e obligatoriu
Rareori alegi CII de unul singur — apare ca sintaxă în interiorul Factur-X (Franța), ca una dintre cele două sintaxe valide XRechnung (Germania), sau când sistemul unui partener e nativ CII și trebuie să convertești din UBL.
Ce nu facem. CII și UBL acoperă același model semantic EN 16931, doar în forme XML diferite — de aceea conversia dintre ele e fără pierderi sau respinsă, nu o aproximare cu pierderi.
Încearcă
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
Endpoint-uri relevante
| Endpoint | Note |
|---|---|
POST /v1/generate/cii?profile=en16931|xrechnung | Profil en16931 sau xrechnung — același motor ca pe partea UBL. |
POST /v1/validate/cii?profile=en16931|xrechnunggratuit | Reguli oficiale schematron + XSD, constatări structurate. |
POST /v1/convert/{ubl-to-cii,cii-to-ubl} | Fără pierderi sau respinsă — 422 cu funcționalitățile exacte nesuportate, niciodată o degradare pe tăcute. |
POST /v1/render/{html,pdf} | CII e detectat automat alături de UBL, fără flag separat necesar. |
Exemple și documentație
Descarcă fișiere CII de exemplu validate (factură și notă de credit) din biblioteca noastră de exemple, sau citește referința API completă.
Întrebări frecvente
Ar trebui să folosesc UBL sau CII?
Dacă poți alege liber, UBL/Peppol e opțiunea implicită pan-europeană mai comună. Folosește CII când un partener comercial o cere, sau când ai nevoie de Factur-X/ZUGFeRD sau de opțiunea CII a XRechnung.
Pot converti între UBL și CII?
Da — POST /v1/convert/{ubl-to-cii,cii-to-ubl}, fără pierderi sau respinsă: dacă o funcționalitate nu supraviețuiește conversiei, primești un 422 cu lista exactă, niciodată o factură degradată pe tăcute.
CII suportă note de credit?
Da, același tip de document cu un cod de tip diferit — vezi grupul CII din biblioteca noastră de exemple, atât pentru o factură cât și pentru o notă de credit.