UN/CEFACT CII D16B
La sintassi dentro Factur-X e XRechnungCross Industry Invoice (CII) D16B è l'altra sintassi XML EN 16931, insieme a UBL — uno schema a documento singolo che sta alla base sia del formato PDF ibrido Factur-X/ZUGFeRD sia di una delle due sintassi valide di XRechnung.
Cos'è
Dove UBL separa fatture e note di credito in elementi radice distinti, CII rappresenta entrambi come un unico documento CrossIndustryInvoice, distinto da un codice tipo. CrateAPI genera e valida direttamente XML CII puro — non serve passare da Factur-X per ottenerlo.
Dove è obbligatorio
Raramente si sceglie CII da solo — compare come sintassi all'interno di Factur-X (Francia), come una delle due sintassi valide di XRechnung (Germania), oppure quando il sistema di un partner commerciale è nativamente CII e occorre convertire da UBL.
Cosa non facciamo. CII e UBL coprono lo stesso modello semantico EN 16931, solo in forme XML diverse — per questo la conversione tra i due è senza perdite o rifiutata, non un'approssimazione con perdita.
Provalo
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 rilevanti
| Endpoint | Note |
|---|---|
POST /v1/generate/cii?profile=en16931|xrechnung | Profilo en16931 o xrechnung — stesso motore del lato UBL. |
POST /v1/validate/cii?profile=en16931|xrechnunggratuito | Regole ufficiali schematron + XSD, rilievi strutturati. |
POST /v1/convert/{ubl-to-cii,cii-to-ubl} | Senza perdite o rifiutata — 422 con le funzionalità esatte non supportate, mai un degrado silenzioso. |
POST /v1/render/{html,pdf} | CII rilevato automaticamente insieme a UBL, nessun flag separato necessario. |
Esempi e documentazione
Scarica file di esempio CII validati (fattura e nota di credito) dalla nostra libreria di esempi, oppure leggi il riferimento API completo.
Domande frequenti
Devo usare UBL o CII?
Se puoi scegliere liberamente, UBL/Peppol è l'opzione predefinita paneuropea più comune. Usa CII quando lo richiede un partner commerciale, o quando ti serve Factur-X/ZUGFeRD oppure l'opzione CII di XRechnung.
Posso convertire tra UBL e CII?
Sì — POST /v1/convert/{ubl-to-cii,cii-to-ubl}, senza perdite o rifiutata: se una funzionalità non sopravvive alla conversione ricevi un 422 con l'elenco esatto, mai una fattura degradata silenziosamente.
CII supporta le note di credito?
Sì, lo stesso tipo di documento con un codice tipo diverso — vedi il gruppo CII nella nostra libreria di esempi, sia per una fattura sia per una nota di credito.