UN/CEFACT CII D16B
La syntaxe à l'intérieur de Factur-X et XRechnungCross Industry Invoice (CII) D16B est l'autre syntaxe XML EN 16931, aux côtés d'UBL — un schéma à document unique qui sous-tend à la fois le format PDF hybride Factur-X/ZUGFeRD et l'une des deux syntaxes valides de XRechnung.
Ce que c'est
Là où UBL sépare factures et avoirs en éléments racines distincts, CII représente les deux comme un seul document CrossIndustryInvoice, distingué par un code de type. CrateAPI génère et valide directement du XML CII pur — inutile de passer par Factur-X pour l'obtenir.
Où c'est obligatoire
Vous choisissez rarement CII seul — il apparaît comme la syntaxe à l'intérieur de Factur-X (France), comme l'une des deux syntaxes valides de XRechnung (Allemagne), ou quand le système d'un partenaire est nativement CII et que vous devez convertir depuis UBL.
Ce que nous ne faisons pas. CII et UBL couvrent le même modèle sémantique EN 16931, juste sous des formes XML différentes — c'est pourquoi la conversion entre les deux est sans perte ou refusée, plutôt qu'une approximation avec perte.
Essayer
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
Endpoints pertinents
| Endpoint | Notes |
|---|---|
POST /v1/generate/cii?profile=en16931|xrechnung | Profil en16931 ou xrechnung — même moteur que côté UBL. |
POST /v1/validate/cii?profile=en16931|xrechnunggratuit | Règles officielles schematron + XSD, constats structurés. |
POST /v1/convert/{ubl-to-cii,cii-to-ubl} | Sans perte ou refusé — 422 avec les fonctionnalités exactes non prises en charge, jamais de dégradation silencieuse. |
POST /v1/render/{html,pdf} | CII détecté automatiquement aux côtés d'UBL, aucun indicateur séparé nécessaire. |
Exemples et documentation
Téléchargez des exemples CII validés (facture et avoir) depuis notre bibliothèque d'exemples, ou consultez la référence API complète.
FAQ
Dois-je utiliser UBL ou CII ?
Si vous avez le choix, UBL/Peppol est l'option pan-européenne la plus courante par défaut. Utilisez CII quand un partenaire commercial l'exige, ou pour Factur-X/ZUGFeRD ou l'option CII de XRechnung.
Puis-je convertir entre UBL et CII ?
Oui — POST /v1/convert/{ubl-to-cii,cii-to-ubl}, sans perte ou refusé : si une fonctionnalité ne survit pas à la conversion, vous recevez un 422 avec la liste exacte, jamais une facture dégradée silencieusement.
CII gère-t-il les avoirs ?
Oui, le même type de document avec un code de type différent — voir le groupe CII de notre bibliothèque d'exemples pour une facture et un avoir.