Présentation de SOAP

Cette API est deprecated. eConnect n'accepte plus de nouvelles connexions SOAP. Les éditeurs de logiciels qui utilisent encore l'API SOAP sont invités à migrer vers l'API REST (PSB). Les connexions SOAP existantes continuent de fonctionner, mais ne sont plus développées.

L'API SOAP v3.1 est l'API d'origine de la plateforme eConnect. Cette API est toujours prise en charge pour les intégrations existantes, mais eConnect n'accepte plus de nouvelles connexions SOAP. Toutes les nouvelles intégrations passent par l'API REST (PSB).

À qui s'adresse cette documentation ?

Cette documentation s'adresse exclusivement aux éditeurs de logiciels et organisations qui disposent déjà d'une connexion SOAP fonctionnelle avec la plateforme eConnect, comme les intégrations existantes de partenaires tels que ECI, Inventive ou Bloxs. Vous développez une nouvelle intégration ? Optez pour l'API REST PSB. Celle-ci offre la sécurité OAuth 2.0, des webhooks, des SDK et une documentation complète via Swagger UI.

Exigences techniques

L'API SOAP fonctionne en SOAP 1.1 sur HTTPS/SSL et est conforme au WSDL Basic Profile v1.1. Un point d'attention important : Transfer-Encoding=chunked n'est pas pris en charge. C'est une erreur d'implémentation fréquente.

Caractéristique

Valeur

Protocole

SOAP 1.1 sur HTTPS/SSL

Endpoint

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

WSDL

Disponible via sales@econnect.eu (subscriptionKey requise)

Authentification

Validité du token

4 heures (ou demander un nouveau token par session)

Endpoints disponibles

L'API SOAP v3.1 propose les endpoints suivants :

Authentification et gestion de compte

Endpoint

Fonction

Login

Obtenir un SecurityToken avec Consumer Key + Consumer Secret

GetAccountDetails

Consulter les informations du compte

GetAccountParties

Récupérer vos propres parties (avec EConnectPartyId et statut Peppol)

GetParties

Consulter toutes les parties connues

GetParty

Consulter les détails d'une partie par ReferenceId

Envoi de documents

Endpoint

Fonction

SendDocument

Envoyer un document (Inbox + Outbox)

GetOutboxDocuments

Liste des documents envoyés (métadonnées)

GetOutboxDocument

Récupérer un document outbox complet par ExternalId

GetOutboxDocumentStatus

Consulter le statut d'un document envoyé

Réception de documents

Endpoint

Fonction

GetInboxDocuments

Liste des documents reçus (métadonnées)

GetInboxDocument

Récupérer un document inbox complet par ExternalId

GetInboxDocumentStatus

Consulter le statut actuel d'un document reçu

SetInboxDocumentStatus

Modifier le statut d'un document reçu

Drafts et PDF

Endpoint

Fonction

GetDocuments

Consulter les documents draft

GetDocument

Récupérer un document draft complet par DocumentId

GetDocumentPdf

Télécharger le PDF d'un document en base64

Divers

Endpoint

Fonction

GetAdvisedInvoiceRecipientId

Recommander le meilleur identifiant Peppol du destinataire

RequestAppIntegration

Lancer une demande d'intégration d'application (flux comptable)

SOAP vs. REST : les principales différences

SOAP API v3.1

PSB REST API

Protocole

SOAP 1.1

REST (JSON)

Authentification

Consumer Key/Secret + SecurityToken

OAuth 2.0

Documentation

WSDL (sur demande)

Swagger UI / OpenAPI

SDK

Aucun

PHP et .NET (open source)

Webhooks

Non disponible

Entièrement pris en charge

Statut

Deprecated (plus de nouvelles connexions)

Développement actif

Demander le WSDL

Le WSDL n'est pas disponible publiquement. Vous avez une connexion SOAP existante et avez besoin du WSDL ? Contactez support@econnect.eu. Pour les nouvelles intégrations, le WSDL n'est pas disponible ; utilisez l'API REST.

Vous souhaitez passer à l'API REST moderne ? Consultez la documentation PSB sur psb.econnect.eu pour l'interface Swagger UI complète et le guide de démarrage.

Migrer vers l'API REST

En relation