Base de conocimientos de Peppol
Entienda la red detrás de cada integración de Peppox
Busque orientación práctica sobre estándares, identificadores, descubrimiento, transporte, validación, operaciones y modelos por país.
BAS
Conceptos básicos
Resumen general de Peppol, la gobernanza y los conceptos fundamentales.
¿Qué es Peppol y quién lo opera?
Peppol es un marco y una red interoperables y gobernados para intercambiar documentos empresariales estructurados (p. ej., facturas electrónicas, notas de crédito, MLR). Está coordinado por OpenPeppol, una asociación sin ánimo de lucro que define especificaciones y certifica Access Points y SMPs.
¿Qué beneficios ofrece Peppol frente a las integraciones punto a punto?
Peppol utiliza un modelo de “conectar una vez, llegar a muchos” a través de Access Points certificados, reduciendo interfaces a medida, imponiendo reglas de validación compartidas (EN 16931, BIS/PINT), mejorando la interoperabilidad transfronteriza y habilitando el descubrimiento estandarizado y el transporte seguro.
¿Peppol es obligatorio en toda la UE?
No existe un mandato único de Peppol para toda la UE. La UE exige EN 16931 para las facturas electrónicas de contratación pública; muchos países introducen obligaciones nacionales B2B. Peppol se adopta ampliamente como la forma de cumplir e interoperar.
¿Qué documentos son los más comunes en Peppol?
Invoice y CreditNote (BIS Billing 3.0 / PINT), Message Level Response (MLR) e Invoice Response. También existen documentos logísticos en el conjunto Peppol Post-Award.
¿Qué es el “modelo de cuatro esquinas”?
Remitente → Access Point de envío → Access Point de recepción → Destinatario. Se utiliza Discovery (SML→SMP) para encontrar las capacidades del destinatario y el endpoint seguro antes de la entrega.
IDE
Identificadores (ISO 6523)
Comprender los identificadores de participantes y los errores más comunes.
¿Cómo se identifican los destinatarios?
Peppol utiliza esquemas ISO 6523 (ICD + valor), con el formato iso6523-actorid-upis::ICD:VALUE (p. ej., GLN = 0088, Belgian CBE = 0208).
¿Qué esquema de identificador debo usar?
Utilice el esquema que coincida con su identificador oficial (p. ej., GLN 0088, Belgium 0208 para BCE/CBE). La guía de su Access Point o de la autoridad nacional debe confirmar el esquema correcto.
Errores comunes con los identificadores
Confundir el VAT con los identificadores del registro mercantil; omitir ceros a la izquierda; usar un formato VAT de un país bajo el ICD incorrecto; usar identificadores de prueba en producción.
Directorio vs registro
Ser visible en un directorio o herramienta de búsqueda no es lo mismo que tener un registro SMP válido para un documento o proceso específico. Verifique siempre las capacidades SMP del destinatario.
DIS
Discovery (SMP/SML)
Cómo funcionan conjuntamente SML y SMP.
¿Cuál es la diferencia entre SML y SMP?
SML (Service Metadata Locator) asigna un ID de participante a su SMP. El SMP (Service Metadata Publisher) almacena los tipos de documento admitidos por el participante, los process IDs y los endpoints.
¿Qué debo revisar en un registro SMP?
documentTypeID correcto, processID, endpoint activo con peppol-transport-as4-v2_0 y un certificado válido. Confirme también el entorno (test vs production).
¿Por qué algunas búsquedas fallan con 404 o 429?
404 = no hay una capacidad publicada para ese participante/documento en ese SMP. 429 = limitación de tasa por parte de endpoints públicos; reduzca la frecuencia o use la API de su proveedor.
DOC
Documentos y perfiles
BIS Billing 3.0, PINT y perfiles relacionados.
¿Qué es Peppol BIS Billing 3.0?
Una CIUS de EN 16931 que define cómo intercambiar UBL Invoice y Credit Note en Peppol con reglas adicionales y listas de códigos para garantizar la interoperabilidad.
¿Qué es PINT y cuándo se utiliza?
El Peppol International Invoice Model (PINT) armoniza la facturación electrónica a nivel global y sustenta especializaciones por país (por ejemplo, PINT A-NZ, PINT MY, SG BIS).
¿Qué son los ProcessIDs y por qué son importantes?
Los ProcessIDs (por ejemplo, cenbii-procid-ubl::urn:fdc:peppol.eu:2017:poacc:billing:3:1.0) expresan procesos de negocio vinculados a un perfil de documento; deben coincidir con la entrada SMP del receptor.
MLR vs Invoice Response
MLR proporciona retroalimentación a nivel técnico/de negocio; Invoice Response proporciona acuses de recibo de negocio (por ejemplo, aceptación/rechazo con motivos). Verifique la compatibilidad en SMP.
VAL
Validación y listas de códigos
Hacer que EN 16931 + BIS/PINT superen la validación.
Causas típicas de errores de validación
Categorías de impuestos incorrectas; códigos de unidad no válidos; desajustes de moneda/redondeo; identificadores BT- faltantes; extensiones específicas del país incorrectas; tipos de adjuntos no permitidos.
¿Qué listas de códigos suelen fallar?
Códigos de unidad UN/ECE, códigos de moneda ISO, categorías de IVA, códigos de medios de pago, listas específicas por país (por ejemplo, especificidades de EHF en Noruega; Singapore, A-NZ PASR/PINT).
¿Cómo solucionar errores de EN 16931 frente a BIS?
Valide primero contra EN 16931 y luego contra las reglas de Peppol BIS/PINT. Utilice validadores oficiales y validadores nacionales cuando estén disponibles (por ejemplo, el validador EHF en Noruega).
TRA
Transporte y seguridad (AS4, PKI)
Fundamentos de transporte AS4 y PKI de OpenPeppol.
¿Qué transporte se utiliza?
Peppol utiliza el perfil AS4 (peppol-transport-as4-v2_0) con firma y cifrado entre Access Points.
Problemas comunes de entrega AS4
Certificados vencidos o próximos a vencer; URL del endpoint incorrecta; desajuste de TLS/cifrado; desfase de reloj; cargas útiles grandes sin compresión; configuración de reintentos demasiado baja.
¿Qué ocurre con los certificados y la PKI?
Los certificados de AP/SMP deben cumplir la política PKI de OpenPeppol. Controle notBefore/notAfter, la validez de la cadena, el estado OCSP/CRL y planifique las renovaciones con antelación.
ONB
Integración y pruebas
Del entorno sandbox a producción.
Lista de verificación para comenzar
Elija un AP certificado, registre el ID ISO 6523, configure las capacidades de SMP, valide UBLs (EN 16931 + BIS/PINT), pilotee MLR/Invoice Response y, después, póngalo en producción.
Entornos de prueba vs. producción
Utilice SML, SMP y endpoints de AP dedicados para pruebas. Nunca reutilice identificadores de prueba en producción.
Buenas prácticas de corte a producción
Ejecute en paralelo con socios de muestra, supervise MLR/errores, confirme las dependencias de reporte fiscal y comunique los plazos a los socios comerciales.
OPS
Operaciones y supervisión
Qué medir y cómo reaccionar.
¿Qué debemos supervisar a diario?
Resultados de validación, cambios en SMP, estado de los endpoints, reintentos AS4, feedback de MLR/Invoice Response, vencimiento de certificados y latencia de los mensajes.
¿Cómo gestionar los límites de tasa y las búsquedas públicas?
Guarde resultados en caché, respete los límites de tasa, priorice las APIs del proveedor y evite extraer datos de endpoints públicos durante las horas pico.
Retención y trazabilidad de auditoría
Conserve los metadatos de los mensajes (hash, marcas de tiempo, IDs de emisor/receptor, IDs de documento), los informes de validación y las respuestas MLR/IR según la política y la ley.
PRI
Protección de datos y aspectos legales
GDPR, leyes locales y responsabilidades.
¿Peppol cumple con GDPR?
Peppol define transporte seguro e identificadores, pero el cumplimiento sigue siendo su responsabilidad: base legal, retención, derechos de los titulares de datos y DPIA cuando sea necesario.
¿Peppol sustituye el reporte fiscal?
No. Algunos países exigen procesos adicionales de e-reporting/CTC. Revise los mandatos nacionales más allá del transporte y la validación de documentos.
TRO
Solución de problemas
Problemas frecuentes y verificaciones rápidas.
La entrega falla pero el participante se “encuentra” en línea
Un resultado en el directorio no prueba la capacidad. Verifique el SMP para el exacto documentTypeID y processID. Asegúrese de que su AP apunte al endpoint AS4 listado.
La validación falla en totales o impuestos
Revise el redondeo (a nivel de línea frente a nivel de factura), la precisión de la moneda, la coherencia de la categoría fiscal y la distribución de descuentos/cargos según las reglas de EN 16931.
Los adjuntos son rechazados
Solo se permiten ciertos tipos MIME y tamaños. Asegúrese de que la codificación base64 y los metadatos sean correctos y, si se requiere, de que los nombres de archivo sean compatibles con ASCII.
429 Demasiadas solicitudes desde puntos de acceso públicos
Limite la velocidad, añada retroceso exponencial y prefiera las API de su proveedor. Procese en lotes las búsquedas en SMP y almacene en caché los resultados.
COU
Perfiles por país y modelos locales
Cómo se utiliza Peppol o EN 16931 localmente.
Bélgica
La facturación electrónica B2B será obligatoria a partir del 1 Jan 2026 (de forma escalonada). Peppol está confirmado como el valor predeterminado para emitir facturas estructuradas. B2G ya está implantado.
Alemania
A partir del 1 Jan 2025, las empresas deben poder recibir facturas electrónicas EN 16931; las obligaciones de emisión se introducirán progresivamente hasta 2028. XRechnung/ZUGFeRD se alinean con EN 16931.
Francia
La facturación electrónica y el reporte electrónico se introducen por fases a partir de Sept 2026; DGFiP es la autoridad Peppol. El modelo incluye PPF/PDP e interoperabilidad con Peppol.
Noruega
EHF Billing 3.0 se basa en Peppol BIS 3.0; uso amplio en el sector público y privado.
Singapur (InvoiceNow)
La facturación electrónica nacional se basa en Peppol; IMDA es la autoridad. Hay guías disponibles para proveedores de servicios y consideraciones de GST.
Australia y Nueva Zelanda
PINT A-NZ es el modelo actual; la extensión A-NZ BIS 3.0 quedó obsoleta en 2025 para migrar hacia PINT.
Malasia
Las especializaciones de PINT Malaysia (Billing/Self-billing) se publican bajo la documentación de Post-Award de OpenPeppol.
Italia
El B2B nacional utiliza SDI (FatturaPA). Peppol puede usarse para operaciones transfronterizas o con partners/APs que lo soporten, pero SDI sigue siendo obligatorio a nivel doméstico.
DEV
Consejos para desarrolladores y operaciones
Orientación práctica para implementadores.
Patrones seguros de consulta a SMP
Agrupe y almacene en caché las consultas; respete el TTL de SML/SMP; use las API del proveedor cuando estén disponibles; verifique tanto documentTypeID como processID.
Gestión de certificados
Controle los períodos de validez, automatice las alertas de renovación, verifique las cadenas y pruebe los endpoints después de la rotación. Mantenga los relojes sincronizados (NTP).
Observabilidad
Registre IDs de correlación, IDs de participante, IDs de documento, URL de SMP, URL de endpoint, resultados de validación y cargas útiles de MLR/IR para facilitar auditorías.
Resiliencia
Use retroceso exponencial para los reintentos AS4, implemente idempotencia en el lado emisor y supervise los SLA de rendimiento/latencia.
GLO
Glosario
Access Point (AP)
Puerta de enlace certificada que valida e intercambia mensajes AS4 en la red Peppol.
SMP / SML
SMP almacena capacidades y endpoints; SML apunta al SMP correcto mediante DNS.
BIS Billing 3.0
Peppol CIUS de EN 16931 para Invoice y CreditNote.
PINT
Peppol International Invoice Model; base para especializaciones globales y por país.
AS4
Perfil seguro y fiable de transporte de mensajes utilizado por los AP de Peppol.