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

Služba je dostupná metódami PUT a POST na adrese /c/{firma}/danova-evidence/prepocet, kde {firma} je databázový identifikátor firmy. Podporovanými výstupnými formátmi sú XML a JSON.


Parametre

  • ucetniObdobi — povinný parameter, ktorým sa identifikuje obdobie, za ktoré chcete evidenciu prepočítať (napr. ucetniObdobi=code:2024).

  • dry-run — voliteľný parameter, ktorým 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 sa vracia HTTP status 200 a dokument zodpovedajúci štandardnému formátu, pozri návratové hodnoty. V prípade neúspechu sa vracia status 4xx alebo 5xx a správa o dôvode neúspechu.


Ukážky volania

1. Volanie v XML

POST https://demo.flexibee.eu/c/demo/danova-evidence/prepocet.xml?ucetniObdobi=code:2024

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

PUT https://demo.flexibee.eu/c/demo/danova-evidence/prepocet.json?ucetniObdobi=code:2024&dry-run=true

3. Určenie formátu v hlavičke, nie príponou

PUT https://demo.flexibee.eu/c/demo/danova-evidence/prepocet?ucetniObdobi=code:2024

V tomto prípade sa formát volí hlavičkou Accept: application/xml, prípadne Accept: application/json.


Neúspešné požiadavky

Už beží iný prepočet

Ak prepočet práve spustil iný používateľ, napríklad v aplikácii, vráti sa hlásenie v tomto tvare:

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

Firma nevedie daňovú evidenciu

Vo firme, ktorá účtuje v podvojnom účtovníctve, nie je akcia k dispozícii a volanie vracia 400 s kódom akcePristupOdepren a hlásením K této akci nemáte přístup. Na kontrolu zostatkov v podvojnom účtovníctve použite prepočet stavu účtov.


FAQ

Čo je prepočet daňovej evidencie?

Prepočet zabezpečuje kontrolu správnosti zostatkov na jednotlivých členeniach (paragrafoch) evidencie. Analógiou v podvojnom účtovníctve je prepočet stavu účtov.

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

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


Súvisiace

Ste s tem dobili odgovor na svoje vprašanje?