Descripción general de la API Procurement Service Bus (PSB) de eConnect: arquitectura, funcionalidades y tipos de documentos.
El Procurement Service Bus (PSB) es la pasarela API central de eConnect con la que puede enviar, recibir y procesar facturas electrónicas, pedidos y otros documentos electrónicos. El PSB conecta su software con la red Peppol y otras redes de facturación electrónica a través de una API REST moderna con seguridad OAuth2.
Ya sea que usted sea un proveedor de software que desea integrar la facturación electrónica, o una organización que busca automatizar sus flujos documentales, el PSB ofrece la infraestructura para hacerlo de manera fiable y escalable.
El PSB es mucho más que un canal de envío. Es una plataforma completa para el procesamiento de documentos electrónicos, con funcionalidades que cubren todo el proceso purchase-to-pay.
La facturación electrónica es el núcleo. A través de la API, usted envía facturas de venta a los destinatarios en la red Peppol y recibe facturas de compra de sus proveedores. El PSB enruta automáticamente los documentos al Access Point correcto y confirma la entrega con actualizaciones de estado en tiempo real.
Los pedidos electrónicos van más allá de la facturación. El PSB soporta el envío y la recepción de pedidos, confirmaciones de pedido, modificaciones y anulaciones. Se soportan tanto Peppol Order Only como Order Advanced, así como mensajes DICO (incluido el mensaje de mantenimiento), Coupa y cXML. Los pedidos pueden convertirse («flipped») en una factura con un solo clic.
El self-billing permite crear y enviar facturas en nombre de un proveedor. Esto es relevante para organizaciones que elaboran sus propias facturas de compra basándose en bienes o servicios recibidos.
La validación ofrece un endpoint independiente con el que puede verificar la conformidad de documentos XML sin enviarlos. La API Validate reconoce automáticamente el formato del documento, lo evalúa contra los artefactos más recientes y proporciona retroalimentación detallada y multilingüe por regla de validación.
La transformación convierte documentos de un formato de factura electrónica a otro. Usted entrega en el formato que su software produce y el PSB se encarga automáticamente de la conversión correcta hacia el destinatario. El PSB soporta más de 20 estándares, entre ellos UBL 2.1, NLCIUS, Peppol BIS Billing V3, PINT, CII, XRechnung, Factur-X/ZUGFeRD, FatturaPA, ebInterface, Svefaktura, e-FFF, OIOUBL, Finvoice, ISDOC y formatos sectoriales como DICO, SETU y SEEF. El formato se detecta automáticamente al subir el documento; no necesita indicar qué formato entrega.
Validated Party Data (VPD) es una API GraphQL con la que puede consultar y verificar datos de partes. Compruebe si un número KvK, OIN o de IVA corresponde realmente a una organización determinada antes de enviar una factura. En In Control, la misma funcionalidad se conoce con el nombre comercial Purple Pages.
Intelligent Document Recognition (IDR) convierte facturas en PDF a XML estructurado mediante OCR e IA. El IDR se puede controlar directamente a través de la API PSB, con niveles de calidad y prioridades configurables.
El PSB está construido sobre el modelo Actor en un clúster de Microsoft Azure Service Fabric. Puede sonar técnico, pero las ventajas son concretas: los documentos se procesan en paralelo en múltiples servidores, sin esperar unos a otros. En caso de fallo de un servidor, el procesamiento continúa automáticamente en otro nodo, sin pérdida de datos.
En la práctica, esto significa un tiempo de procesamiento inferior a 100 milisegundos por documento en el envío, una capacidad probada de 200.000 mensajes por hora y una disponibilidad del 99,99 % (más de ocho años sin interrupciones no planificadas).
El PSB opera como Peppol Access Point con múltiples Access Points en la configuración estándar. El volumen se distribuye dinámicamente a través de colas fiables. Cada tenant está aislado lógicamente: es técnicamente imposible acceder a los documentos de otro tenant. El PSB se ejecuta en Microsoft Azure (regiones Países Bajos e Irlanda); todo el tratamiento de datos se realiza dentro de la UE/EEE.
Con una sola integración API, usted obtiene acceso a múltiples redes. El PSB enruta automáticamente los documentos al canal correcto en función del destinatario.
El PSB está preparado para la directiva europea ViDA (VAT in the Digital Age), que hace obligatorios los Digital Reporting Requirements (DRR) para transacciones B2B transfronterizas a partir del 1 de julio de 2030. Al enviar una factura, el PSB genera automáticamente el resumen DRR a partir de los datos de la factura y lo envía a la autoridad fiscal correspondiente. Como integrador, no necesita hacer nada adicional: usted envía su factura a través de la API habitual y el PSB se encarga de la declaración.
El PSB implementa para ello el modelo Peppol 5-corner, en el que el Access Point se encarga del reporting CTC (Continuous Transaction Controls) en nombre del remitente. Los mensajes de estado, los archivos de evidencia y los mensajes de reporting CTC están incluidos en el precio del documento, sin costes adicionales por mensaje.
El PSB funciona de manera orientada a eventos. En lugar de verificar periódicamente si hay nuevos documentos, puede configurar webhooks que notifiquen directamente a su aplicación ante eventos relevantes: una factura recibida, una factura entregada con éxito, un error en el envío, una Invoice Response del destinatario.
Los hooks soportan múltiples tipos de acciones: webhooks HTTPS, notificaciones por correo electrónico, push SFTP, e incluso procesamiento por lotes donde los documentos se ofrecen periódicamente como archivo ZIP. Cada tipo de hook está protegido con firmas HMAC SHA256.
El PSB utiliza OAuth 2.0 para la autenticación, con soporte para los flujos Client Credentials y Resource Owner Password Credentials. Todas las comunicaciones se realizan a través de TLS 1.2 o superior. Las cargas binarias se analizan automáticamente en busca de virus y malware, y los documentos XML se validan según conjuntos de reglas estándar.
Cada tenant opera en un entorno aislado lógicamente. El PSB procesa documentos para más de 20.000 organizaciones.
La API REST PSB (v1) está organizada en los siguientes grupos de endpoints:
La documentación completa de los endpoints con los formatos de solicitud y respuesta está disponible como Swagger UI interactivo. El archivo swagger.json correspondiente se puede descargar para generar código cliente.
¿Está listo para comenzar? Los artículos a continuación le guían, desde la solicitud de una cuenta de prueba hasta su primera llamada a la API.
El PSB ofrece endpoints para facturación electrónica (envío y recepción), pedidos electrónicos, self-billing, validación, transformación, datos de partes (VPD) y reconocimiento PDF (IDR). Con una sola integración API obtiene acceso a Peppol y a otras redes de procurement como Coupa y SAP Ariba.
El PSB procesa documentos en menos de 100 milisegundos en el envío, con una capacidad comprobada de 200.000 mensajes por hora. La disponibilidad es del 99,99 %, con más de ocho años sin interrupciones no planificadas.
El PSB utiliza OAuth 2.0 para la autenticación, con soporte para los flujos Client Credentials y Resource Owner Password Credentials. Todas las comunicaciones se realizan a través de TLS 1.2 o superior.
Usted entrega en el formato que su software produce. El PSB detecta automáticamente el formato del documento y lo transforma al formato esperado por el destinatario. Se soportan más de 20 estándares, entre ellos UBL, NLCIUS, BIS Billing V3, PINT, CII, XRechnung, Factur-X, FatturaPA y formatos sectoriales como DICO y SETU. No necesita preocuparse por el formato del destinatario.
El PSB es ViDA-ready. Al enviar una factura, el PSB genera automáticamente el resumen DRR (Digital Reporting Requirement) a partir de los datos de la factura y lo envía a la autoridad fiscal correspondiente. Como integrador, no necesita hacer nada adicional. Los mensajes de estado, los archivos de evidencia y los mensajes de reporting CTC están incluidos en el precio del documento.
Consultar la documentación API interactiva