Przegląd SOAP | eConnect

To API jest deprecated. eConnect nie akceptuje już nowych połączeń SOAP. Pakietom oprogramowania, które nadal korzystają z SOAP API, zalecamy migrację do REST API (PSB). Istniejące połączenia SOAP nadal działają, ale nie są już rozwijane.

SOAP API v3.1 to oryginalne API platformy eConnect. To API jest nadal wspierane dla istniejących integracji, ale eConnect nie akceptuje już nowych połączeń SOAP. Wszystkie nowe integracje realizowane są przez REST API (PSB).

Dla kogo jest ta dokumentacja?

Ta dokumentacja jest przeznaczona wyłącznie dla dostawców oprogramowania i organizacji, które mają już działające połączenie SOAP z platformą eConnect, takie jak istniejące integracje partnerów jak ECI, Inventive lub Bloxs. Budujesz nową integrację? Wybierz PSB REST API, które oferuje zabezpieczenie OAuth 2.0, webhooki, SDK i obszerną dokumentację przez Swagger UI.

Wymagania techniczne

SOAP API działa na SOAP 1.1 przez HTTPS/SSL i jest zgodne z WSDL Basic Profile v1.1. Ważna uwaga: Transfer-Encoding=chunked nie jest obsługiwany. Jest to częsty błąd implementacyjny.

Cecha

Wartość

Protokół

SOAP 1.1 przez HTTPS/SSL

Endpoint

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

WSDL

Dostępny przez sales@econnect.eu (wymagana subscriptionKey)

Uwierzytelnianie

Ważność tokena

4 godziny (lub żądanie nowego tokena na sesję)

Dostępne endpointy

SOAP API v3.1 oferuje następujące endpointy:

Uwierzytelnianie i zarządzanie kontem

Endpoint

Funkcja

Login

Pobranie SecurityToken za pomocą Consumer Key + Consumer Secret

GetAccountDetails

Zapytanie o informacje o koncie

GetAccountParties

Pobranie własnych party (z EConnectPartyId i statusem Peppol)

GetParties

Zapytanie o wszystkie znane party

GetParty

Zapytanie o szczegóły party po ReferenceId

Wysyłanie dokumentów

Endpoint

Funkcja

SendDocument

Wysłanie dokumentu (Inbox + Outbox)

GetOutboxDocuments

Lista wysłanych dokumentów (metadane)

GetOutboxDocument

Pobranie pełnego dokumentu outbox po ExternalId

GetOutboxDocumentStatus

Zapytanie o status wysłanego dokumentu

Odbieranie dokumentów

Endpoint

Funkcja

GetInboxDocuments

Lista otrzymanych dokumentów (metadane)

GetInboxDocument

Pobranie pełnego dokumentu inbox po ExternalId

GetInboxDocumentStatus

Zapytanie o aktualny status otrzymanego dokumentu

SetInboxDocumentStatus

Zmiana statusu otrzymanego dokumentu

Wersje robocze i PDF

Endpoint

Funkcja

GetDocuments

Zapytanie o dokumenty robocze

GetDocument

Pobranie pełnego dokumentu roboczego po DocumentId

GetDocumentPdf

Pobranie PDF dokumentu jako base64

Inne

Endpoint

Funkcja

GetAdvisedInvoiceRecipientId

Doradztwo najlepszego ID odbiorcy Peppol

RequestAppIntegration

Rozpoczęcie żądania integracji aplikacji (przepływ księgowego)

SOAP vs. REST: główne różnice

SOAP API v3.1

PSB REST API

Protokół

SOAP 1.1

REST (JSON)

Uwierzytelnianie

Consumer Key/Secret + SecurityToken

OAuth 2.0

Dokumentacja

WSDL (na życzenie)

Swagger UI / OpenAPI

SDK

Brak

PHP i .NET (open source)

Webhooki

Niedostępne

W pełni obsługiwane

Status

Deprecated (brak nowych połączeń)

Aktywnie rozwijane

Żądanie WSDL

WSDL nie jest publicznie dostępny. Masz istniejące połączenie SOAP i potrzebujesz WSDL? Skontaktuj się z support@econnect.eu. Dla nowych integracji WSDL nie jest dostępny; użyj REST API.

Chcą Państwo przejść na nowoczesne REST API? Dokumentacja PSB na psb.econnect.eu z pełnym Swagger UI i przewodnikiem wprowadzającym.

Migruj do REST API

Powiązane