Prehľad SOAP | eConnect

Toto API je deprecated. eConnect už neakceptuje nové SOAP pripojenia. Softvérovým balíkom, ktoré ešte používajú SOAP API, odporúčame migráciu na REST API (PSB). Existujúce SOAP pripojenia naďalej fungujú, ale nie sú ďalej vyvíjané.

SOAP API v3.1 je pôvodná API platformu eConnect. Táto API je stále podporovaná pre existujúce integrácie, ale eConnect už neakceptuje nové SOAP pripojenia. Všetky nové integrácie prebiehajú cez REST API (PSB).

Pre koho je táto dokumentácia?

Táto dokumentácia je určená výhradne pre dodávateľov softvéru a organizácie, ktorí už majú fungujúce SOAP prepojenie s platformom eConnect, ako sú existujúce integrácie strán ako ECI, Inventive alebo Bloxs. Budujete novú integráciu? Zvoľte PSB REST API. Tá ponúka zabezpečenie OAuth 2.0, webhooky, SDK a rozsiahlu dokumentáciu cez Swagger UI.

Technické požiadavky

SOAP API beží na SOAP 1.1 cez HTTPS/SSL a je WSDL-kompatibilná podľa Basic Profile v1.1. Dôležité upozornenie: Transfer-Encoding=chunked nie je podporované. Ide o častú implementačnú chybu.

Vlastnosť

Hodnota

Protokol

SOAP 1.1 cez HTTPS/SSL

Endpoint

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

WSDL

Dostupné cez sales@econnect.eu (vyžaduje sa subscriptionKey)

Autentifikácia

Prihlásenie cez Consumer Key + Consumer Secret, potom SecurityToken

Platnosť tokenu

4 hodiny (alebo vyžiadanie nového tokenu na každú reláciu)

Dostupné endpointy

SOAP API v3.1 ponúka nasledujúce endpointy:

Autentifikácia a správa účtu

Endpoint

Funkcia

Login

Získanie SecurityToken pomocou Consumer Key + Consumer Secret

GetAccountDetails

Vyžiadanie informácií o účte

GetAccountParties

Získanie vlastných strán (s EConnectPartyId a statusom Peppol)

GetParties

Vyžiadanie všetkých známych strán

GetParty

Vyžiadanie detailov strany podľa ReferenceId

Odosielanie dokumentov

Endpoint

Funkcia

SendDocument

Odoslanie dokumentu (Inbox + Outbox)

GetOutboxDocuments

Zoznam odoslaných dokumentov (metadáta)

GetOutboxDocument

Získanie kompletného outbox dokumentu podľa ExternalId

GetOutboxDocumentStatus

Vyžiadanie stavu odoslaného dokumentu

Prijímanie dokumentov

Endpoint

Funkcia

GetInboxDocuments

Zoznam prijatých dokumentov (metadáta)

GetInboxDocument

Získanie kompletného inbox dokumentu podľa ExternalId

GetInboxDocumentStatus

Vyžiadanie aktuálneho stavu prijatého dokumentu

SetInboxDocumentStatus

Zmena stavu prijatého dokumentu

Koncepty a PDF

Endpoint

Funkcia

GetDocuments

Vyžiadanie konceptových dokumentov

GetDocument

Získanie kompletného konceptového dokumentu podľa DocumentId

GetDocumentPdf

Stiahnutie PDF dokumentu ako base64

Ostatné

Endpoint

Funkcia

GetAdvisedInvoiceRecipientId

Odporúčanie najlepšieho Peppol ID príjemcu

RequestAppIntegration

Spustenie žiadosti o integráciu aplikácie (tok pre účtovníkov)

SOAP vs. REST: hlavné rozdiely

SOAP API v3.1

PSB REST API

Protokol

SOAP 1.1

REST (JSON)

Autentifikácia

Consumer Key/Secret + SecurityToken

OAuth 2.0

Dokumentácia

WSDL (na vyžiadanie)

Swagger UI / OpenAPI

SDK

Žiadne

PHP a .NET (open source)

Webhooky

Nie sú k dispozícii

Plne podporované

Stav

Deprecated (žiadne nové pripojenia)

Aktívne vyvíjané

Vyžiadanie WSDL

WSDL nie je verejne dostupné. Máte existujúce SOAP prepojenie a potrebujete WSDL? Kontaktujte support@econnect.eu. Pre nové integrácie WSDL nie je dostupné; použite REST API.

Chcete prejsť na modernú REST API? Pozrite si PSB dokumentáciu na psb.econnect.eu s kompletným Swagger UI a návodom na začiatok.

Migrácia na REST API

Súvisiace