Doklado SAPI+
REST API na odosielanie a prijímanie eFaktúr cez sieť Peppol.
Doklado SAPI+ umožňuje vášmu ERP, účtovnému systému alebo DMS odosielať a prijímať eFaktúry cez REST API. Nadväzuje na SAPI 1.0 a dopĺňa ho o rozšírenia Doklado, najmä webhooky, idempotenciu a vyhľadanie účastníkov v sieti Peppol.
Začnite integráciu
- Založte si testovaciu firmu a požiadajte o aktiváciu podľa návodu Sandbox a aktivácia.
- Získajte klientské prístupy a access token.
- Vyskúšajte prvé volanie na načítanie prijatých dokumentov.
- Zapojte odosielanie, prijímanie a voliteľné webhooky.
Čo rozhranie poskytuje
| Oblasť | Použitie |
|---|---|
| Autentifikácia | OAuth 2.0 client_credentials a kontrola platnosti tokenu |
| Odosielanie | Odovzdanie XML eFaktúry na spracovanie s Idempotency-Key |
| Prijímanie | Stránkovaný zoznam, stiahnutie XML a potvrdenie prevzatia |
| Účastníci | Vyhľadanie príjemcu podľa DIČ a kontrola podporovaných dokumentov |
| Webhooky | Podpísané notifikácie o dokumentoch a stavoch |
Režimy integrácie
Pri integrácii iba cez REST API si váš systém zabezpečuje používateľské rozhranie, spracovanie, schvaľovanie a nadväzné postupy. Doklado zabezpečuje technický prenos, sprístupnenie dokumentov, stavov a auditných udalostí v dohodnutom rozsahu.
Integráciu môžete podľa dohodnutej služby doplniť o webový digitálny archív a mobilnú aplikáciu Doklado na manuálnu kontrolu a prácu s eFaktúrami.
Prostredia a adresy
| Nastavenie | Sandbox | Produkcia |
|---|---|---|
Základná API URL (baseUrl) | https://einvoice-v1-ynyiur6quq-ey.a.run.app/v1 | https://einvoice-v1-yuw5qbwq4a-ey.a.run.app/v1 |
Autentifikácia (authBasePath) | /sapi/auth | /sapi/auth |
Dokumenty SAPI (sapiBasePath) | /sapi | /sapi |
Vyhľadanie účastníka SAPI+ (sapiPlusBasePath) | /sapi-plus | /sapi-plus |
Základná URL už obsahuje /v1. Napríklad zoznam dokumentov volajte na baseUrl + /sapi/document/receive. V REST API referencii sú cesty uvedené celé od /v1; verziu do URL nevkladajte dvakrát.
Webová aplikácia sandboxu: efaktura-sandbox.doklado.sk.
Webová aplikácia produkcie: app.doklado.sk.
Požiadavky posielajte cez HTTPS na API server zvoleného prostredia. Telá požiadaviek a odpovedí sú JSON; XML faktúra sa prenáša ako reťazec v JSON poli payload. Kompletné cesty nájdete v prehľade endpointov.
Produkčné prístupy získate pri aktivácii produkčnej integrácie od Doklado. Sandbox používajte s testovacími údajmi.
SAPI+ a Doklado Public API
SAPI+ používa Authorization: Bearer a slúži na výmenu eFaktúr. Doklado Public API používa hlavičku api_key a poskytuje samostatné operácie práce s údajmi Doklado. Prístupy, cesty a dátové modely používajte podľa príslušného rozhrania.
SAPI a SAPI+ endpointy
Odosielanie, zoznam, detail a potvrdenie prijatia dokumentov sú operácie SAPI pod /v1/sapi/document/.... Vyhľadanie účastníka je rozšírenie SAPI+ na GET /v1/sapi-plus/participant/lookup. Verifikácia používaná interne webovou aplikáciou nie je súčasťou verejnej referencie.
Rozsah referencie
Verejná REST API referencia obsahuje 9 operácií: získanie, kontrolu, obnovu a zrušenie tokenu, štyri dokumentové operácie SAPI a vyhľadanie účastníka SAPI+. Klientské prístupy získate pri aktivácii; interná správa prístupov nie je súčasťou verejného rozhrania.