Public API a SAPI+
Kedy použiť SAPI+ a kedy Doklado Public API?
SAPI+ použite, keď má váš ERP posielať a prijímať e-Faktúry cez Doklado poštára. Doklado Public REST API použite, keď chcete pracovať s dátami v Doklado: čítať doklady do ERP alebo BI, vystavovať faktúry z e-shopu, čítať bankové transakcie.
| SAPI+ | Doklado Public API | |
|---|---|---|
| Účel | výmena e-Faktúr cez sieť Peppol | práca s dátami Doklado |
| Čo robí | odoslanie XML e-Faktúry, prijaté e-Faktúry, vyhľadanie príjemcu podľa DIČ, webhooky | doklady a prílohy, vystavené faktúry (PDF, e-mail), nespracované doklady, firmy a partneri, bankové transakcie |
| Autentifikácia | OAuth 2.0, Client ID a Client Secret, hlavička Authorization: Bearer | API kľúč v hlavičke api_key |
| Kde získate prístup | Prehľad účtu → SAPI+ prepojenia, po aktivácii cez efaktura@doklado.sk | Prehľad účtu → API prepojenia |
| Podmienky | firma musí mať aktivovanú e-Faktúru, jedna firma = jedno SAPI+ pripojenie | Doklado PLUS 1 € za 1 000 operácií; vystavovanie faktúr cez API 14,90 € mesačne (až 1 000 faktúr denne) |
| Dokumentácia | docs.doklado.sk/sapi-plus/overview, testovanie v sandboxe efaktura-sandbox.doklado.sk | docs.doklado.sk/doklado-public-api |
Pri SAPI+ si váš systém zabezpečuje rozhranie, schvaľovanie a spracovanie, Doklado zabezpečí technický prenos. Podľa dohody sa to dá doplniť o webový archív a mobilnú aplikáciu Doklado.
Viac v návode: Doklado SAPI+, Doklado Public API
Kde nájdem dokumentáciu k Doklado Public API?
Dokumentácia k Doklado REST API (Public API) je na docs.doklado.sk/doklado-public-api: autentifikácia, prvé volanie, stránkovanie a chyby, spotreba a referencia endpointov. Technická špecifikácia (OpenAPI) je na api-doc.doklado.sk. Všetky operácie používajú metódu POST cez HTTPS.
Viac v návode: Doklado Public API
Ako získať API kľúč pre Doklado REST API?
- Vo webovej aplikácii otvorte Prehľad účtu → API prepojenia.
- Kliknite na + Nové API prepojenie a zadajte názov.
- Nastavte denný alebo mesačný limit, prípadne Neobmedzený limit využitia.
- Kliknite na Vygenerovať nové prepojenie a kľúč si uložte.
API kľúč posielajte v hlavičke api_key, bez predpony Bearer. Po vyčerpaní limitu API vráti 429. Spotrebu vidíte v karte História aktivity. Kľúč na bankové transakcie musí byť viazaný na konkrétnu firmu, ten vydáva podpora.
Viac v návode: API prepojenia, Autentifikácia
Koľko stojí Doklado API a vystavovanie faktúr cez API?
- Doklado API: 1 000 operácií mesačne je v cene Doklado PLUS, ďalších 1 000 stojí 1 € bez DPH. Integrácia na API je zadarmo, úpravy na mieru sú na individuálnej dohode.
- Modul Vystavovanie faktúr cez API: mesačný balík stojí 14,90 € bez DPH a zahŕňa vystavenie až 1 000 faktúr denne. Pri prekročení denného limitu sa aktivuje ďalší mesačný balík za 14,90 € bez DPH. Cena za vystavenie B2B faktúry cez API je 0,10 € za kus.
API kľúč vytvoríte v Prehľad účtu → API prepojenia → + Nové API prepojenie. Pri každom kľúči si môžete nastaviť denný alebo mesačný limit a v Histórii aktivity sledovať spotrebu.
Viac v návode: API prepojenia, Pricing (Doklado Public API)