XRechnung 3.0
Alemania · B2G activo, B2B 2027–2028XRechnung es la CIUS alemana sobre EN 16931 — una factura UBL o CII con reglas estrictas del sector público alemán, sobre todo un identificador de enrutamiento obligatorio (Leitweg-ID). Ya es obligatoria para facturar a las administraciones públicas alemanas, y la emisión B2B se vuelve obligatoria por etapas desde 2027.
Qué es
XRechnung 3.0.2 define los campos exactos, las listas de códigos y las reglas de negocio que debe cumplir una factura alemana, en sintaxis UBL o CII. La mantiene KoSIT, y CrateAPI valida contra los propios artefactos de validación de KoSIT — los mismos que usa el sistema de tu destinatario.
Dónde es obligatorio
Alemania: la facturación electrónica al sector público (B2G) ya está activa. La emisión B2B se vuelve obligatoria desde 2027 para empresas con más de 800.000 € de facturación, y desde 2028 para todas — consulta nuestro seguimiento de mandatos para más detalles.
Qué no hacemos. El Leitweg-ID — el código de enrutamiento que necesita un comprador público alemán — se mapea directamente al campo buyer_reference (BT-10) del modelo canónico. Es un campo estándar de EN 16931 que XRechnung simplemente hace obligatorio, no un extra específico de XRechnung.
Pruébalo
curl -X POST "$BASE/v1/generate/ubl?profile=xrechnung" \ -H "X-API-Key: $KEY" -H "Content-Type: application/json" \ -d @invoice.json -o invoice.xml
Endpoints relevantes
| Endpoint | Notas |
|---|---|
POST /v1/generate/ubl?profile=xrechnung | Sintaxis UBL, reglas XRechnung 3.0.2. |
POST /v1/generate/cii?profile=xrechnung | Sintaxis CII — mismas reglas, forma XML distinta. |
POST /v1/validate/{ubl,cii}?profile=xrechnunggratis | Los propios artefactos de validación de KoSIT, los mismos que verifica tu destinatario. |
POST /v1/render/{html,pdf}?lang=de | Para las facturas que recibes y no puedes leer como XML sin procesar. |
Ejemplos y documentación
Descarga un ejemplo de XRechnung validado desde nuestra biblioteca de ejemplos, o lee la referencia completa de la API.
Preguntas frecuentes
¿UBL o CII para XRechnung?
Cualquiera — XRechnung está definido en ambas sintaxis y CrateAPI genera y valida las dos. Usa la que espere tu socio comercial o portal.
¿Es lo mismo que ZUGFeRD?
No, pero está relacionado: ZUGFeRD 2.x es el formato híbrido PDF+XML alemán y comparte su núcleo XML (CII) con Factur-X. Para la versión híbrida en PDF en lugar de XML puro, consulta nuestra página de Factur-X.
¿Necesito un campo especial para el Leitweg-ID?
No — es el campo estándar buyer_reference (BT-10) del modelo canónico, que XRechnung hace obligatorio y otros perfiles dejan opcional.