Přehled SOAP | eConnect

Toto API je deprecated. eConnect již nepřijímá nová SOAP připojení. Softwarovým balíkům, které ještě používají SOAP API, doporučujeme migraci na REST API (PSB). Stávající SOAP připojení nadále fungují, ale již nejsou dále vyvíjena.

SOAP API v3.1 je původní API platformu eConnect. Toto API je stále podporováno pro existující integrace, ale eConnect již nepřijímá nová SOAP připojení. Všechny nové integrace probíhají přes REST API (PSB).

Pro koho je tato dokumentace?

Tato dokumentace je určena výhradně pro dodavatele softwaru a organizace, kteří již mají fungující SOAP propojení s platformem eConnect, jako jsou existující integrace stran jako ECI, Inventive nebo Bloxs. Budujete novou integraci? Zvolte PSB REST API. To nabízí zabezpečení OAuth 2.0, webhooky, SDK a rozsáhlou dokumentaci přes Swagger UI.

Technické požadavky

SOAP API běží na SOAP 1.1 přes HTTPS/SSL a je WSDL-kompatibilní podle Basic Profile v1.1. Důležité upozornění: Transfer-Encoding=chunked není podporováno. Jde o častou implementační chybu.

Vlastnost

Hodnota

Protokol

SOAP 1.1 přes HTTPS/SSL

Endpoint

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

WSDL

Dostupné přes sales@econnect.eu (vyžaduje se subscriptionKey)

Autentizace

Přihlášení přes Consumer Key + Consumer Secret, poté SecurityToken

Platnost tokenu

4 hodiny (nebo vyžádání nového tokenu pro každou relaci)

Dostupné endpointy

SOAP API v3.1 nabízí následující endpointy:

Autentizace a správa účtu

Endpoint

Funkce

Login

Získání SecurityToken pomocí Consumer Key + Consumer Secret

GetAccountDetails

Vyžádání informací o účtu

GetAccountParties

Získání vlastních stran (s EConnectPartyId a statusem Peppol)

GetParties

Vyžádání všech známých stran

GetParty

Vyžádání detailů strany podle ReferenceId

Odesílání dokumentů

Endpoint

Funkce

SendDocument

Odeslání dokumentu (Inbox + Outbox)

GetOutboxDocuments

Seznam odeslaných dokumentů (metadata)

GetOutboxDocument

Získání kompletního outbox dokumentu podle ExternalId

GetOutboxDocumentStatus

Vyžádání stavu odeslaného dokumentu

Přijímání dokumentů

Endpoint

Funkce

GetInboxDocuments

Seznam přijatých dokumentů (metadata)

GetInboxDocument

Získání kompletního inbox dokumentu podle ExternalId

GetInboxDocumentStatus

Vyžádání aktuálního stavu přijatého dokumentu

SetInboxDocumentStatus

Změna stavu přijatého dokumentu

Koncepty a PDF

Endpoint

Funkce

GetDocuments

Vyžádání konceptových dokumentů

GetDocument

Získání kompletního konceptového dokumentu podle DocumentId

GetDocumentPdf

Stažení PDF dokumentu jako base64

Ostatní

Endpoint

Funkce

GetAdvisedInvoiceRecipientId

Doporučení nejlepšího Peppol ID příjemce

RequestAppIntegration

Spuštění žádosti o integraci aplikace (tok pro účetní)

SOAP vs. REST: hlavní rozdíly

SOAP API v3.1

PSB REST API

Protokol

SOAP 1.1

REST (JSON)

Autentizace

Consumer Key/Secret + SecurityToken

OAuth 2.0

Dokumentace

WSDL (na vyžádání)

Swagger UI / OpenAPI

SDK

Žádné

PHP a .NET (open source)

Webhooky

Nejsou k dispozici

Plně podporované

Stav

Deprecated (žádná nová připojení)

Aktivně vyvíjené

Vyžádání WSDL

WSDL není veřejně dostupné. Máte stávající SOAP připojení a potřebujete WSDL? Kontaktujte support@econnect.eu. Pro nové integrace WSDL není dostupné; použijte REST API.

Chcete přejít na moderní REST API? Podívejte se na PSB dokumentaci na psb.econnect.eu s kompletním Swagger UI a návodem na začátek.

Migrace na REST API

Související