Descripción general de SOAP

Esta API está deprecated. eConnect ya no acepta nuevas conexiones SOAP. A los paquetes de software que aún utilizan la API SOAP se les recomienda migrar a la REST API (PSB). Las conexiones SOAP existentes siguen funcionando, pero ya no se desarrollan.

La SOAP API v3.1 es la API original de la plataforma eConnect. Esta API todavía se mantiene para integraciones existentes, pero eConnect ya no acepta nuevas conexiones SOAP. Todas las nuevas integraciones se realizan a través de la REST API (PSB).

¿A quién va dirigida esta documentación?

Esta documentación está dirigida exclusivamente a proveedores de software y organizaciones que ya tienen una conexión SOAP operativa con la plataforma eConnect, como integraciones existentes de empresas como ECI, Inventive o Bloxs. ¿Va a desarrollar una nueva integración? Elija la PSB REST API. Esta ofrece seguridad OAuth 2.0, webhooks, SDKs y documentación completa a través de Swagger UI.

Requisitos técnicos

La SOAP API funciona sobre SOAP 1.1 con HTTPS/SSL y cumple con el estándar WSDL Basic Profile v1.1. Un punto de atención importante: Transfer-Encoding=chunked no es compatible. Este es un error de implementación frecuente.

Característica

Valor

Protocolo

SOAP 1.1 sobre HTTPS/SSL

Endpoint

https://api.everbinding.nl/soap/v3.1?subscriptionKey={subscriptionKey}

WSDL

Disponible a través de [email protected] (se requiere subscriptionKey)

Autenticación

Validez del token

4 horas (o solicitar un nuevo token por sesión)

Endpoints disponibles

La SOAP API v3.1 ofrece los siguientes endpoints:

Autenticación y gestión de cuenta

Endpoint

Función

Login

Obtener SecurityToken con Consumer Key + Consumer Secret

GetAccountDetails

Consultar información de la cuenta

GetAccountParties

Obtener sus propias parties (con EConnectPartyId y estado Peppol)

GetParties

Consultar todas las parties conocidas

GetParty

Consultar detalles de una party por ReferenceId

Envío de documentos

Endpoint

Función

SendDocument

Enviar documento (Inbox + Outbox)

GetOutboxDocuments

Lista de documentos enviados (metadata)

GetOutboxDocument

Obtener documento completo de outbox por ExternalId

GetOutboxDocumentStatus

Consultar el estado de un documento enviado

Recepción de documentos

Endpoint

Función

GetInboxDocuments

Lista de documentos recibidos (metadata)

GetInboxDocument

Obtener documento completo de inbox por ExternalId

GetInboxDocumentStatus

Consultar el estado actual de un documento recibido

SetInboxDocumentStatus

Modificar el estado de un documento recibido

Drafts y PDF's

Endpoint

Función

GetDocuments

Consultar documentos en borrador

GetDocument

Obtener documento borrador completo por DocumentId

GetDocumentPdf

Descargar PDF de un documento como base64

Otros

Endpoint

Función

GetAdvisedInvoiceRecipientId

Recomendar el mejor ID de destinatario Peppol

RequestAppIntegration

Iniciar solicitud de integración de app (flujo de contable)

SOAP vs. REST: las principales diferencias

SOAP API v3.1

PSB REST API

Protocolo

SOAP 1.1

REST (JSON)

Autenticación

Consumer Key/Secret + SecurityToken

OAuth 2.0

Documentación

WSDL (bajo solicitud)

Swagger UI / OpenAPI

SDK's

Ninguno

PHP y .NET (open source)

Webhooks

No disponible

Totalmente compatible

Estado

Deprecated (sin nuevas conexiones)

En desarrollo activo

Solicitar el WSDL

El WSDL no está disponible públicamente. ¿Tiene una conexión SOAP existente y necesita el WSDL? Contacte con [email protected]. Para nuevas integraciones, el WSDL no está disponible; utilice la REST API.

¿Desea migrar a la API REST moderna? Consulte la documentación de PSB en psb.econnect.eu para la Swagger UI completa y la guía de inicio.

Migrar a la REST API

Relacionado