Resumen de los métodos de conexión para desarrolladores: API REST, SFTP y HTTPS. Con enlaces directos a la documentación del PSB.
¿Su software no aparece en la lista de conexiones predefinidas, o está desarrollando una aplicación propia que necesita enviar y recibir facturas a través de Peppol? Entonces puede integrar directamente con el Procurement Service Bus (PSB) de eConnect. El PSB es el sistema técnico detrás de todas las conexiones de eConnect, accesible a través de psb.econnect.eu. La plataforma eConnect (platform.econnect.eu) es la interfaz de cliente donde, entre otras cosas, crea claves de conexión y gestiona su configuración. El PSB ofrece tres métodos de conexión: una API REST moderna, SFTP y HTTPS.
La elección óptima depende de su arquitectura, sus requisitos de seguridad y el volumen previsto. Para cada método, la documentación técnica está disponible en el portal de desarrollo del PSB.
El método más utilizado para nuevas integraciones. La API REST del PSB ofrece endpoints para el envío, recepción y gestión de facturas, pedidos y respuestas. La autenticación se realiza mediante OAuth2, con dos flujos disponibles: Resource Owner Password Credentials y Client Credentials. Los tokens se solicitan a través de POST /connect/token en identity.econnect.eu. Opcionalmente, se puede incluir un header Subscription-Key para acceso específico por organización.
Adecuada para: aplicaciones SaaS, aplicaciones web, microservicios y arquitecturas modernas.
Documentación: PSB API y Swagger UI: documentación API interactiva, especificación OpenAPI y Swagger Editor.
Intercambio de archivos a través de una conexión SFTP segura. El PSB soporta dos flujos: From SFTP (recuperación periódica de archivos desde su servidor SFTP) y To SFTP (envío de documentos a su servidor en el momento de la recepción). Ambos flujos se configuran mediante hooks SFTP en el PSB.
Adecuado para: entornos empresariales con procesamiento por lotes, sistemas ERP como SAP y Unit4 ERP CR.
Documentación: PSB API y hooks: busque los hooks SFTP en los endpoints Hook.
Una conexión HTTPS directa para el intercambio de facturas. El PSB recibe documentos a través de HTTPS POST y los entrega mediante webhooks o HTTPS inbound. Soporta filtrado por IP y OAuth2.
Adecuado para: conexiones empresariales con requisitos de seguridad específicos.
Documentación: PSB API y webhooks: HTTPS inbound/outbound y configuración de webhooks.
Técnico: El PSB se comunica internamente a través del protocolo Peppol AS4 con otros Access Points. No se trata de un método de conexión que usted elija como cliente; se utiliza automáticamente cuando envía facturas a través de Peppol.
Para cualquier integración con el PSB necesita:
La forma más rápida de empezar es a través de la API REST: abra psb.econnect.eu, explore la Swagger UI y realice su primera llamada API. Encontrará más información en la sección API e integración de esta documentación.
Para conexiones SFTP o HTTPS, contacte con el departamento comercial de eConnect para una reunión de acogida. Durante esa reunión se discutirán los detalles técnicos, el volumen previsto y los requisitos de seguridad. Las especificaciones técnicas se encuentran en la documentación de la API del PSB.
Consejo: ¿está desarrollando una integración para un paquete de software utilizado por múltiples clientes? Contacte entonces con el equipo de partners de eConnect. Como partner, puede construir la conexión una sola vez y ponerla a disposición de todos sus clientes.
¿Listo para empezar? Abra la documentación de la API del PSB o lea el resumen del PSB para más contexto.
Consulte la documentación API