Přeskočit na hlavní obsah
Všechny sbírkyDokumentace REST APIPokročilé příkazy
Přepočet daňové evidence - REST API
Přepočet daňové evidence - REST API

Jak pomocí API spustit přepočet daňové evidence?

Petr Pech avatar
Autor: Petr Pech
Aktualizováno před více než rokem

Přepočet daňové evidence zajišťuje kontrolu správnosti zůstatků na jednotlivých členěních (paragrafech) evidence. Analogii můžeme vidět v přepočtu stavu účtů v podvojném účetnictví.

Způsob volání

Lze využít HTTP metodu: PUT nebo POST.

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

Jsou podporovány výstupní formáty: XML nebo JSON.

Parametry

Služba očekává povinně parametr ucetniObdobi, aby bylo možno identifikovat časové období, za které chcete účty přepočítat.

Volitelně umožňuje použít parametr dry-run. Pomocí tohoto parametru lze zjistit, zda byl přepočet dokončen. Pokud ano, vrátí HTTP status 200. Pokud ne, vrátí HTTP status 409 s informací o tom, kdy a kým byl přepočet spuštěn.

Výsledek

Pro rozpoznání, zda byla služba vykonána úspěšně, lze kontrolovat HTTP status odpovědi nebo vlastnost success v získaném dokumentu.

V případě úspěšného vykonání služby je vracen HTTP status 200 a dokument odpovídající standardnímu formátu, viz. návratové hodnoty.

V případě neúspěchu je vracen status 4xx/5xx a zpráva o důvodu neúspěchu.

Ukázky volání

1. volání v XML

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

2. volání v JSON včetně testovacího 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čení formátu v hlavičce, nikoliv formou přípony

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

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

Neúspěšné requesty

1. V případě, že běží další jiný přepočet, spuštěný například uživatelem v aplikaci

"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

Co je přepočet daňové evidence?

Přepočet zajišťuje kontrolu správnosti zůstatků na jednotlivých členěních (paragrafech) evidence. Analogii můžeme vidět v přepočtu stavu účtů v podvojném účetnictví.

Je potřeba přepočet daňové evidence pravidelně volat?

Obvykle ne, pro kontrolu správnosti zůstatků na konci účetního období však spuštění doporučujeme.

Potřebujete poradit?

V případě dotazů k aplikaci nás kontaktujte na podporaflexi@abra.eu případně prostřednictvím chat okna v pravém dolním rohu.

Dostali jste odpověď na svou otázku?