UN/CEFACT CII D16B
La sintaxis dentro de Factur-X y XRechnungCross Industry Invoice (CII) D16B es la otra sintaxis XML de EN 16931, junto a UBL — un esquema de documento único que sustenta tanto el formato híbrido en PDF Factur-X/ZUGFeRD como una de las dos sintaxis válidas de XRechnung.
Qué es
Donde UBL separa facturas y notas de crédito en elementos raíz distintos, CII representa ambos como un único documento CrossIndustryInvoice, distinguido por un código de tipo. CrateAPI genera y valida XML CII puro directamente — no necesitas pasar por Factur-X para obtenerlo.
Dónde es obligatorio
Raramente eliges CII por sí solo — aparece como la sintaxis dentro de Factur-X (Francia), como una de las dos sintaxis válidas de XRechnung (Alemania), o cuando el sistema de un socio comercial es nativo en CII y necesitas convertir desde UBL.
Qué no hacemos. CII y UBL cubren el mismo modelo semántico de EN 16931, solo que en formas XML distintas — por eso la conversión entre ambos es sin pérdidas o rechazada, en lugar de una aproximación con pérdida.
Pruébalo
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 relevantes
| Endpoint | Notas |
|---|---|
POST /v1/generate/cii?profile=en16931|xrechnung | Perfil en16931 o xrechnung — mismo motor que el lado UBL. |
POST /v1/validate/cii?profile=en16931|xrechnunggratis | Reglas oficiales schematron + XSD, hallazgos estructurados. |
POST /v1/convert/{ubl-to-cii,cii-to-ubl} | Sin pérdidas o rechazada — 422 con las funciones exactas no compatibles, nunca una degradación silenciosa. |
POST /v1/render/{html,pdf} | CII detectado automáticamente junto a UBL, sin necesidad de un indicador aparte. |
Ejemplos y documentación
Descarga archivos de ejemplo CII validados (factura y nota de crédito) desde nuestra biblioteca de ejemplos, o lee la referencia completa de la API.
Preguntas frecuentes
¿Debería usar UBL o CII?
Si puedes elegir libremente, UBL/Peppol es la opción paneuropea por defecto más común. Usa CII cuando lo exija un socio comercial, o cuando necesites Factur-X/ZUGFeRD o la opción CII de XRechnung.
¿Puedo convertir entre UBL y CII?
Sí — POST /v1/convert/{ubl-to-cii,cii-to-ubl}, sin pérdidas o rechazada: si una función no sobrevive a la conversión, recibes un 422 con la lista exacta, nunca una factura degradada silenciosamente.
¿CII admite notas de crédito?
Sí, el mismo tipo de documento con un código de tipo distinto — consulta el grupo CII de nuestra biblioteca de ejemplos, tanto para una factura como para una nota de crédito.