Pricing
Koľko jednotiek spotreby započítajú jednotlivé endpointy Doklado Public API.
Spotreba Doklado Public API sa počíta v jednotkách („čiarkach“). Jedno volanie môže započítať viac jednotiek: záleží na endpointe a počte spracovaných dokladov alebo transakcií.
Pri načítaní zoznamu sa spravidla počíta každá prečítaná položka. Pri operáciách s pevnou spotrebou sa započíta jedna jednotka za operáciu. Spotreba sa eviduje k použitému API kľúču.
Doklady a bankové transakcie
Všetky uvedené endpointy používajú metódu POST. N označuje počet položiek, z ktorých sa počíta spotreba.
| Endpoint | Spotreba | Za čo sa započítava |
|---|---|---|
/v2/documents | N | Počet prečítaných dokladov; zohľadnite pravidlá filtrovania nižšie. |
/v2/documents/get | 1 | Načítanie detailu jedného dokladu, aj pri chybe validácie, chýbajúcom oprávnení alebo neexistujúcom doklade. |
/v2/documents/changes | N | Počet požadovaných dokladov, nie počet jednotlivých zmien. Pri chybe sa započíta 1. |
/v2/documents/setExported | N | Počet dokladov v operácii označenia exportu. |
/v2/documents/attachments/get | 0 alebo 1 | 1 za doklad s prílohami alebo nespracovaný doklad; pri spracovanom doklade bez príloh 0. Nepočíta sa každá príloha zvlášť. |
/v1/unprocessed-documents | N | Počet prečítaných nespracovaných dokumentov pred dodatočným filtrovaním. |
/v1/organization/bank-transactions | N | Počet načítaných bankových transakcií. |
Vystavené faktúry
| Endpoint | Spotreba API | Za čo sa započítava |
|---|---|---|
/v1/documents/invoice-issue | 0 | Vystavenie faktúry podlieha dodatočnému pricingu modulu Vystavovanie faktúr cez API, pozri vysvetlenie nižšie. |
/v1/documents/issued-invoice-update | 1 | Úspešná úprava vystavenej faktúry. |
/v1/documents/get-invoice-pdf | 1 | Úspešné získanie PDF faktúry. |
/v1/documents/send-invoice-by-email | 1 | Úspešné odoslanie faktúry emailom. |
Modul Vystavovanie faktúr cez API
Modul umožňuje automatizovať vystavovanie faktúr z objednávok, e-shopov alebo interných systémov. V rámci prepojenia môžete zabezpečiť vytvorenie faktúry v Doklado, jej uloženie, prenos do účtovníctva a odoslanie zákazníkovi.
Cena mesačného balíka je 14,90 € 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 €.
Vystavenie faktúry cez /v1/documents/invoice-issue podlieha dodatočnému pricingu modulu Vystavovanie faktúr cez API. Cena tejto služby nie je zahrnutá v sadzbe 1 € za 1 000 jednotiek bežnej API spotreby.
Do spotreby API kľúča sa pri vystavení faktúry započíta 0 jednotiek, ale samostatne sa eviduje 1 jednotka vystavenia faktúry cez API v rámci modulu. Nulová spotreba API preto neznamená bezplatné vystavenie faktúry.
Cena modulu Vystavovanie faktúr cez API sa ešte bude upravovať v súvislosti s eFaktúrou. Konečná cena modulu pre eFaktúru bude doplnená po jej stanovení.
Organizácie a účtovné nastavenia
| Endpoint | Spotreba | Za čo sa započítava |
|---|---|---|
/v2/organization/accounting-settings/import | 1 | Import účtovných nastavení. |
/v3/organization/manage/list | 1 | Načítanie zoznamu organizácií, bez ohľadu na počet organizácií. |
/v3/organization/manage/create | 0 alebo 1 | Pri úspešnom vytvorení 1. Väčšina chýb tiež započíta 1, niektoré validačné odmietnutia 0. |
/v3/organization/manage/update | 1 | Úprava organizácie. |
/v3/organization/manage/assign-member | 1 | Priradenie člena organizácie. |
/v3/organization/manage/accounting-settings/sync | 1 | Úspešná synchronizácia účtovných nastavení. |
Zastarané endpointy
Pre existujúce integrácie platí tento prehľad. Pri novej integrácii použite ich náhrady uvedené v prehľade endpointov.
| Endpoint | Spotreba | Za čo sa započítava |
|---|---|---|
/v1/documents | N | Počet prečítaných dokladov. |
/v1/documents/setExported | N | Počet odovzdaných identifikátorov dokladov. |
/v1/documents/getAttachments | 0 alebo 1 | 1 za doklad s prílohami, bez príloh 0. |
/v1/organization/accounting-settings/import | 1 | Import účtovných nastavení; jednotka sa môže započítať aj pri chybe spracovania. |
Čo môže ovplyvniť spotrebu
Počet vrátených položiek nemusí byť počet jednotiek
Pri zoznamoch dokladov sa spotreba počíta z prečítaných položiek ešte pred niektorými dodatočnými filtrami, napríklad kontrolou schválenia. Započítať sa preto môžu aj doklady, ktoré sa napokon neobjavia v odpovedi.
Pri nespracovaných dokladoch môže mať aj prázdna odpoveď nenulovú spotrebu. Pri načítaní dokladov sa môžu prečítané položky započítať aj vtedy, keď požiadavka skončí chybou prekročenia maximálneho rozsahu exportu.
Chyba automaticky neznamená nulovú spotrebu
Záleží na tom, aká operácia už prebehla. Napríklad detail dokladu započítava 1 jednotku aj pri uvedených chybách a história zmien započítava pri chybe 1 jednotku.
Požiadavka odmietnutá pre prekročený denný limit API kľúča ešte pred vykonaním operácie vráti 429 a nezapočíta spotrebu.
Opakované volania sa počítajú znova
Každé opakované načítanie zvyšuje spotrebu, aj keď sa doklady nezmenili.
Pri zbytočnom opakovaní volaní môže spotreba DRamaticky narásť.
Jednotky sa sčítavajú za jednotlivé operácie. Načítanie dokladu a jeho následné označenie ako exportovaného sú dve samostatné operácie. Rovnako sa samostatne počítajú ďalšie strany výsledkov a opakované načítania.
Napríklad načítanie rovnakých 70 dokladov každých 15 minút znamená 96 načítaní denne, teda 6 720 jednotiek denne a 201 600 jednotiek za 30 dní - iba za načítanie zoznamu, ak každé volanie prečíta presne 70 dokladov. Ďalšie volania detailov, príloh alebo označenia exportu spotrebu ďalej zvyšujú.
Pri pravidelnej synchronizácii načítavajte iba nové alebo zmenené doklady pomocou filtrov príslušného endpointu a ukladajte si stav poslednej úspešnej synchronizácie. Nastavte denný alebo mesačný limit API kľúča a kontrolujte Históriu aktivity, aby chybná slučka alebo príliš časté opakovanie nevytvorili nečakanú spotrebu.
Príklady
| Scenár | Spotreba |
|---|---|
| Načítanie 100 dokladov a označenie tých istých 100 dokladov ako exportovaných | 200 jednotiek API: 100 + 100. |
| Načítanie histórie zmien pre 10 dokladov | 10 jednotiek API, bez ohľadu na počet zmien pri jednotlivých dokladoch. |
| Získanie odkazov na prílohy jedného dokladu s tromi prílohami | 1 jednotka API. |
| Načítanie 50 bankových transakcií | 50 jednotiek API. |
| Vystavenie faktúry, následné získanie PDF a odoslanie emailom | 2 jednotky API + 1 jednotka vystavenia faktúry podľa dodatočného pricingu modulu Vystavovanie faktúr cez API. |
Príklady predpokladajú úspešné volania a pri zoznamoch žiadne ďalšie prečítané položky vyradené dodatočným filtrovaním.
Kde sledovať spotrebu
Vo webovej aplikácii otvorte Prehľad účtu → API prepojenia → História aktivity. Spotrebu sledujte podľa API kľúča a endpointu. Postup nastavenia limitov nájdete v návode API prepojenia.
Cena za jednotku
Cena API je 1 € za 1 000 jednotiek spotreby (operácií). Jednotkou sa rozumie spotreba podľa tabuliek vyššie, nie samotný počet HTTP požiadaviek. Napríklad načítanie 100 dokladov započíta 100 jednotiek, aj keď ich načítate jedným volaním.
Vystavenie faktúry cez API sa účtuje osobitne podľa dodatočného pricingu modulu Vystavovanie faktúr cez API. Cena modulu sa ešte bude upravovať v súvislosti s eFaktúrou.
TODO: Doplniť upravenú cenu modulu pre eFaktúru, informáciu o DPH, prípadný zahrnutý objem bežnej API spotreby a fakturačné podmienky vrátane účtovania necelých 1 000 jednotiek bežnej API spotreby.