Preskoči na glavno vsebino

Prepočet daňovej evidencie – REST API

Ako pomocou API spustiť prepočet daňovej evidencie?

Avtor: Petr Pech

Prepočet daňovej evidencie zabezpečuje kontrolu správnosti zostatkov na jednotlivých členeniach (paragrafoch) evidencie. Analógiu môžeme vidieť v prepočte stavu účtov v podvojnom účtovníctve.

Spôsob volania

Možno využiť HTTP metódu: PUT alebo POST.

Služba je dostupná na adrese: /c/{firma}/danova-evidence/prepocet, kde {firma} je databázový identifikátor firmy.

Sú podporované výstupné formáty: XML alebo JSON.

Parametre

Služba povinne očakáva parameter ucetniObdobi, aby bolo možné identifikovať časové obdobie, za ktoré chcete účty prepočítať.

Voliteľne umožňuje použiť parameter dry-run. Pomocou tohto parametra možno zistiť, či bol prepočet dokončený. Ak áno, vráti HTTP status 200. Ak nie, vráti HTTP status 409 s informáciou o tom, kedy a kým bol prepočet spustený.

Výsledok

Na rozpoznanie, či bola služba vykonaná úspešne, možno kontrolovať HTTP status odpovede alebo vlastnosť success v získanom dokumente.

V prípade úspešného vykonania služby je vrátený HTTP status 200 a dokument zodpovedajúci štandardnému formátu, viz. návratové hodnoty.

V prípade neúspechu je vrátený status 4xx/5xx a správa o dôvode neúspechu.

Ukážky volania

1. volanie v XML

POST https://localhost:5434/c/firma_s_r_o_/danova-evidence/prepocet.xml?ucetniObdobi=code:2023

2. volanie v JSON vrátane testovacieho režimu dry-run:

PUT https://localhost:5434/c/firma_s_r_o_/danova-evidence/prepocet.json?ucetniObdobi=code:2023&dry-run=true

3. určenie formátu v hlavičke, nie formou prípony

PUT /c/demo/danova-evidence/prepocet?ucetniObdobi=code:2023

(s hlavičkou Accept: application/xml alebo Accept: application/json)

Neúspešné requesty

1. V prípade, že prebieha iný prepočet, spustený napríklad používateľom v aplikácii

"message": "Aktuálně běžící operace 'Přepočet daňové evidence' špuštěná uživatelem dba v 16.4.2023, 15:21:39 nedovoluje současně spustit 'Přepočet daňové evidence'."

FAQ

Čo je prepočet daňovej evidencie?

Prepočet zabezpečuje kontrolu správnosti zostatkov na jednotlivých členeniach (paragrafoch) evidencie. Analógiu môžeme vidieť v prepočte stavu účtov v podvojnom účtovníctve.

Je potrebné prepočet daňovej evidencie pravidelne volať?

Zvyčajne nie, na kontrolu správnosti zostatkov na konci účtovného obdobia však jeho spustenie odporúčame.

Potrebujete poradiť?

V prípade otázok k aplikácii nás kontaktujte na podporaflexi@abra.eu, prípadne prostredníctvom chat okna v pravom dolnom rohu.

Ste s tem dobili odgovor na svoje vprašanje?