SOAP odosielanie | eConnect

Prostredníctvom endpointu SendDocument legacy SOAP API odosielate faktúry a ďalšie dokumenty cez platformu eConnect. Platforma automaticky určí najlepšiu trasu: cez samotný platform eConnect, cez Peppol, alebo ako fallback e-mailom.

Dôležité: Toto je legacy SOAP API. Pre nové integrácie odporúčame REST API.

Ako SendDocument funguje

Pri volaní SendDocument odošlete zdrojový dokument spolu s údajmi o odosielateľovi a príjemcovi. Platforma potom vyhľadá príjemcu v troch krokoch:

Platforma eConnect: je príjemca tiež používateľom platformy? V takom prípade sa dokument doručí priamo do inboxu.
Peppol: je príjemca nájditeľný v sieti Peppol? V takom prípade sa dokument smeruje cez Peppol.
E-mail (fallback): ak nie je možný ani jeden z predchádzajúcich spôsobov a bola zadaná e-mailová adresa, dokument sa odošle e-mailom.

Povinné parametre

Parameter

Popis

Via/ReferenceId

Identifikácia odosielateľa (Vaše vlastné EConnectPartyId, XCNL číslo)

To/ReferenceId

Identifikácia príjemcu (EConnectPartyId alebo Peppol identifikátor ako 0106:KVK-číslo)

To/EmailAddress

E-mailová adresa príjemcu (použije sa ako fallback, keď nie je možné smerovanie cez platformu ani Peppol)

Subject

Predmet dokumentu

Payload

Samotný dokument ako UBL-XML. Pozor: odošlite XML bez XML prologu (<?xml ...?>)

TemplateId

ID šablóny označujúce typ dokumentu

Príklad volania

<SendDocument>
  <Document>
    <Via>
      <ReferenceId>XCNL-123456</ReferenceId>
    </Via>
    <To>
      <ReferenceId>0106:12345678</ReferenceId>
      <EmailAddress>facturatie@voorbeeld.nl</EmailAddress>
    </To>
    <Subject>Factuur 2026-001</Subject>
    <Payload><!-- UBL-XML zonder prolog --></Payload>
    <TemplateId>GLDT9223370666504283001RA000000006DTP2000001</TemplateId>
  </Document>
</SendDocument>

TemplateId GLDT9223370666504283001RA000000006DTP2000001 je MasterTemplateId pre štandardnú faktúru. Vždy používajte MasterTemplateId (nie kód verzie), pretože zostáva stabilné medzi verziami šablón.

Response a ExternalId

Po úspešnom volaní API vráti ExternalId. Ide o unikátne ID odoslaného dokumentu na platforme eConnect. Ak odpoveď neobsahuje ExternalId, dokument nebol odoslaný. V takom prípade skontrolujte chybové hlásenie v odpovedi.

ExternalId si vždy uložte: budete ho potrebovať na neskoršie zisťovanie stavu dokumentu.

DeliveryMethod

API v odpovedi vracia aj DeliveryMethod, aby ste vedeli, cez aký kanál bol dokument doručený:

Hodnota

Význam

ToInbox

Doručené do inboxu príjemcu na platforme eConnect

ToPeppol

Odoslané cez sieť Peppol

ToEmail

Odoslané e-mailom

OutboxOnly

Uložené iba vo Vašom outboxe (nedoručené)

None

Doručenie nebolo možné

Sledovanie stavu

Po odoslaní môžete sledovať stav Vášho dokumentu cez dva endpointy:

Endpoint

Funkcia

GetOutboxDocuments

Získanie zoznamu odoslaných dokumentov. Filtrujte podľa ModifiedOn na zobrazenie len nedávno zmenených dokumentov.

GetOutboxDocument

Vyžiadanie konkrétneho dokumentu na základe ExternalId.

GetOutboxDocumentStatus

Vyžiadanie iba stavu bez kompletného dokumentu.

Tipy

UBL-XML bez prologu: Payload musí obsahovať UBL-XML bez deklarácie <?xml version="1.0" encoding="UTF-8"?>. Ak prolog odošlete, dokument nemusí byť správne spracovaný.

Používajte MasterTemplateId: vždy filtrujte podľa Template/MasterId namiesto špecifického template ID. MasterTemplateId sa nemení pri aktualizáciách verzií šablóny.

Spracovanie chýb: skontrolujte odpoveď na chybové kódy. Série chybových kódov 400 (validácia) a 200 (funkčné) sa najčastejšie vyskytujú pri chybách odosielania. Pozrite si stránku o autentifikácii pre kompletný prehľad sérií chybových kódov.

REST API ponúka pri odosielaní ďalšie možnosti ako webhooky pre stavové notifikácie a automatické opakovanie pri chybách. Pozrite si psb.econnect.eu pre moderný prístup.

Migrácia na REST API

Súvisiace