SOAP-Übersicht | eConnect

Diese API ist deprecated. eConnect akzeptiert keine neuen SOAP-Verbindungen mehr. Softwarepaketen, die noch die SOAP API nutzen, wird empfohlen, auf die REST API (PSB) umzusteigen. Bestehende SOAP-Anbindungen funktionieren weiterhin, werden aber nicht mehr weiterentwickelt.

Die SOAP API v3.1 ist die ursprüngliche API der eConnect-Plattform. Diese API wird weiterhin für bestehende Integrationen unterstützt, eConnect akzeptiert jedoch keine neuen SOAP-Anbindungen mehr. Alle neuen Integrationen laufen über die REST API (PSB).

Für wen ist diese Dokumentation?

Diese Dokumentation richtet sich ausschließlich an Softwareanbieter und Organisationen, die bereits eine funktionierende SOAP-Anbindung an die eConnect-Plattform haben, wie beispielsweise bestehende Integrationen von Parteien wie ECI, Inventive oder Bloxs. Sie bauen eine neue Integration auf? Wählen Sie die PSB REST API. Sie bietet OAuth 2.0-Sicherheit, Webhooks, SDKs und umfangreiche Dokumentation über Swagger UI.

Technische Anforderungen

Die SOAP API läuft auf SOAP 1.1 über HTTPS/SSL und ist WSDL-konform mit Basic Profile v1.1. Ein wichtiger Hinweis: Transfer-Encoding=chunked wird nicht unterstützt. Dies ist ein häufiger Implementierungsfehler.

Eigenschaft

Wert

Protokoll

SOAP 1.1 über HTTPS/SSL

Endpoint

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

WSDL

Verfügbar über sales@econnect.eu (subscriptionKey erforderlich)

Authentifizierung

Token-Gültigkeit

4 Stunden (oder pro Sitzung ein neues Token anfordern)

Verfügbare Endpoints

Die SOAP API v3.1 bietet folgende Endpoints:

Authentifizierung und Kontoverwaltung

Endpoint

Funktion

Login

SecurityToken mit Consumer Key + Consumer Secret abrufen

GetAccountDetails

Kontoinformationen abfragen

GetAccountParties

Eigene Parties abrufen (mit EConnectPartyId und Peppol-Status)

GetParties

Alle bekannten Parties abfragen

GetParty

Party-Details nach ReferenceId abfragen

Dokumente versenden

Endpoint

Funktion

SendDocument

Dokument versenden (Inbox + Outbox)

GetOutboxDocuments

Liste versendeter Dokumente (Metadaten)

GetOutboxDocument

Vollständiges Outbox-Dokument nach ExternalId abrufen

GetOutboxDocumentStatus

Status eines versendeten Dokuments abfragen

Dokumente empfangen

Endpoint

Funktion

GetInboxDocuments

Liste empfangener Dokumente (Metadaten)

GetInboxDocument

Vollständiges Inbox-Dokument nach ExternalId abrufen

GetInboxDocumentStatus

Aktuellen Status eines empfangenen Dokuments abfragen

SetInboxDocumentStatus

Status eines empfangenen Dokuments ändern

Entwürfe und PDFs

Endpoint

Funktion

GetDocuments

Entwurfsdokumente abfragen

GetDocument

Vollständiges Entwurfsdokument nach DocumentId abrufen

GetDocumentPdf

PDF eines Dokuments als Base64 herunterladen

Sonstiges

Endpoint

Funktion

GetAdvisedInvoiceRecipientId

Beste Peppol-Empfänger-ID empfehlen

RequestAppIntegration

App-Integrationsanfrage starten (Steuerberater-Flow)

SOAP vs. REST: die wichtigsten Unterschiede

SOAP API v3.1

PSB REST API

Protokoll

SOAP 1.1

REST (JSON)

Authentifizierung

Consumer Key/Secret + SecurityToken

OAuth 2.0

Dokumentation

WSDL (auf Anfrage)

Swagger UI / OpenAPI

SDKs

Keine

PHP und .NET (Open Source)

Webhooks

Nicht verfügbar

Vollständig unterstützt

Status

Deprecated (keine neuen Verbindungen)

Aktiv weiterentwickelt

WSDL anfordern

Die WSDL ist nicht öffentlich verfügbar. Haben Sie eine bestehende SOAP-Anbindung und benötigen die WSDL? Kontaktieren Sie support@econnect.eu. Für neue Integrationen ist die WSDL nicht verfügbar; nutzen Sie in dem Fall die REST API.

Möchten Sie auf die moderne REST API umsteigen? Sehen Sie sich die PSB-Dokumentation auf psb.econnect.eu an für die vollständige Swagger UI und den Einstiegsleitfaden.

Zur REST API migrieren

Verwandt