UBL 2.1 / Peppol BIS 3.0
UE · transfronterizo y sector públicoUBL (Universal Business Language) 2.1 es la sintaxis XML detrás de Peppol BIS Billing 3.0 — lo más parecido a un estándar único de facturación electrónica en la UE: una sola red, un único conjunto de reglas, usado para el comercio transfronterizo y la facturación al sector público en la mayoría de los estados miembros. CrateAPI genera, valida y convierte facturas UBL según las reglas oficiales Peppol/EN 16931 — los mismos artefactos que verifica tu Access Point.
Qué es
Peppol BIS Billing 3.0 es una CIUS (Core Invoice Usage Specification) construida sobre la sintaxis UBL de EN 16931, mantenida por OpenPeppol. Define el esquema de direccionamiento electrónico, los campos obligatorios y las reglas de negocio que permiten que una factura circule por cualquier Access Point Peppol sin un acuerdo bilateral entre emisor y receptor.
Dónde es obligatorio
La facturación electrónica al sector público (B2G) sobre Peppol ya está activa en la mayoría de los estados miembros de la UE — muchos gobiernos solo aceptan Peppol BIS o un perfil equivalente. La adopción en el sector privado es hoy voluntaria pero crece rápido, convirtiéndose en la opción transfronteriza por defecto a medida que cada país despliega sus propios mandatos nacionales hasta 2030 (ViDA).
Qué no hacemos. CrateAPI no es un Access Point Peppol — no operamos en la red ni transmitimos facturas a través de ella. Generamos y validamos el documento; llevarlo a la red sigue siendo trabajo de tu Access Point (el tuyo, o el de un proveedor).
Pruébalo
curl -X POST "$BASE/v1/generate/ubl?profile=peppol" \ -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=peppol | Prevalidada según las reglas Peppol BIS 3.0 antes de devolverse — una factura no válida nunca sale con un 200. |
POST /v1/validate/ubl?profile=peppolgratis | Reglas oficiales Peppol BIS 3.0 + EN 16931, cada hallazgo con su ID de regla. |
POST /v1/convert/cii-to-ubl?profile=peppol | Desde CII, sin pérdidas o rechazada — un 422 lista exactamente qué no sobrevivió. |
POST /v1/render/{html,pdf}?lang=en|de | HTML o PDF legible de la factura, hojas de estilo KoSIT oficiales. |
Ejemplos y documentación
Descarga una factura de ejemplo UBL/Peppol validada desde nuestra biblioteca de ejemplos, o lee la referencia completa de la API.
Preguntas frecuentes
¿UBL es lo mismo que Peppol?
No — UBL es la sintaxis XML; Peppol BIS Billing 3.0 es un conjunto de reglas específico (CIUS) construido sobre ella. El perfil peppol de CrateAPI genera UBL que ya cumple con Peppol BIS.
¿Transmitís mi factura a través de la red Peppol?
No. Producimos un documento conforme a Peppol; llevarlo a la red es trabajo de tu Access Point.
¿Puedo obtener la misma factura como CII?
Sí — POST /v1/convert/ubl-to-cii convierte sin pérdidas o indica exactamente qué no es compatible. Consulta nuestra página de CII.