Legacy Platform API: SOAP v3.1 Deprecated::

De SOAP API v3.1 van eConnect is deprecated. Er worden geen nieuwe verbindingen meer geaccepteerd. Overzicht van endpoints en migratie naar de REST API.

Deze API is deprecated. eConnect accepteert geen nieuwe SOAP-verbindingen meer. Softwarepakketten die nu nog de SOAP API gebruiken, adviseren we om over te stappen naar de REST API (PSB). Bestaande SOAP-koppelingen blijven functioneren, maar worden niet meer doorontwikkeld.

De SOAP API v3.1 is de oorspronkelijke API van het eConnect-platform. Deze API wordt nog ondersteund voor bestaande integraties, maar eConnect accepteert geen nieuwe SOAP-koppelingen meer. Alle nieuwe integraties verlopen via de REST API (PSB).

Voor wie is deze documentatie?

Deze documentatie is uitsluitend bedoeld voor softwareleveranciers en organisaties die al een werkende SOAP-koppeling met het eConnect-platform hebben, zoals bestaande integraties van partijen als ECI, Inventive of Bloxs. Bouw je een nieuwe integratie? Kies dan voor de PSB REST API. Die biedt OAuth 2.0-beveiliging, webhooks, SDK's en uitgebreide documentatie via Swagger UI.

Technische vereisten

De SOAP API draait op SOAP 1.1 over HTTPS/SSL en is WSDL-compliant aan Basic Profile v1.1. Een belangrijk aandachtspunt: Transfer-Encoding=chunked wordt niet ondersteund. Dit is een veelvoorkomende implementatiefout.

KenmerkWaardeProtocolSOAP 1.1 over HTTPS/SSLEndpointhttps://api.everbinding.nl/soap/v3.1?subscriptionKey={subscriptionKey}WSDLBeschikbaar via [email protected] (subscriptionKey vereist)AuthenticatieLogin met Consumer Key + Consumer Secret, daarna SecurityTokenToken-geldigheid4 uur (of per sessie een nieuw token aanvragen)
Beschikbare endpoints

De SOAP API v3.1 biedt de volgende endpoints:

Authenticatie en accountbeheer
EndpointFunctieLoginSecurityToken ophalen met Consumer Key + Consumer SecretGetAccountDetailsAccountinformatie opvragenGetAccountPartiesEigen parties ophalen (met EConnectPartyId en Peppol-status)GetPartiesAlle bekende parties opvragenGetPartyParty-details opvragen op ReferenceId
Documenten verzenden
EndpointFunctieSendDocumentDocument versturen (Inbox + Outbox)GetOutboxDocumentsLijst van verstuurde documenten (metadata)GetOutboxDocumentVolledig outboxdocument ophalen op ExternalIdGetOutboxDocumentStatusStatus van een verstuurd document opvragen
Documenten ontvangen
EndpointFunctieGetInboxDocumentsLijst van ontvangen documenten (metadata)GetInboxDocumentVolledig inboxdocument ophalen op ExternalIdGetInboxDocumentStatusHuidige status van een ontvangen document opvragenSetInboxDocumentStatusStatus van een ontvangen document wijzigen
Drafts en PDF's
EndpointFunctieGetDocumentsDraft-documenten opvragenGetDocumentVolledig draft-document ophalen op DocumentIdGetDocumentPdfPDF van een document downloaden als base64
Overig
EndpointFunctieGetAdvisedInvoiceRecipientIdBeste Peppol-ontvanger-ID adviserenRequestAppIntegrationApp-integratieaanvraag starten (accountant-flow)
SOAP vs. REST: de belangrijkste verschillen
SOAP API v3.1PSB REST APIProtocolSOAP 1.1REST (JSON)AuthenticatieConsumer Key/Secret + SecurityTokenOAuth 2.0DocumentatieWSDL (op aanvraag)Swagger UI / OpenAPISDK'sGeenPHP en .NET (open source)WebhooksNiet beschikbaarVolledig ondersteundStatusDeprecated (geen nieuwe verbindingen)Actief doorontwikkeld
WSDL opvragen

De WSDL is niet publiek beschikbaar. Heb je een bestaande SOAP-koppeling en heb je de WSDL nodig? Neem contact op met [email protected]. Voor nieuwe integraties is de WSDL niet beschikbaar; gebruik in dat geval de REST API.

Veelgestelde vragen
Kan ik nog een nieuwe SOAP-koppeling aanvragen?

Nee, eConnect accepteert geen nieuwe SOAP-verbindingen meer. Alle nieuwe integraties verlopen via de REST API (PSB). Bestaande SOAP-koppelingen blijven functioneren maar worden niet meer doorontwikkeld.

Wat zijn de belangrijkste verschillen tussen SOAP en REST?

De REST API biedt OAuth 2.0-beveiliging (in plaats van Consumer Key/Secret), webhooks, SDK's voor PHP en .NET, en interactieve Swagger-documentatie. De SOAP API ondersteunt geen webhooks, heeft geen SDK's en de WSDL is alleen op aanvraag beschikbaar.

Hoe stap ik over van SOAP naar de REST API?

Raadpleeg de PSB API-documentatie op psb.econnect.eu voor de Getting Started-gids. De REST API biedt dezelfde functionaliteit als de SOAP API, maar met moderne authenticatie, webhooks en uitgebreidere documentatie.


Wil je overstappen naar de moderne REST API? Bekijk de PSB-documentatie op psb.econnect.eu voor de volledige Swagger UI en startgids.

Migreer naar de REST API

Gerelateerd