Přeskočit na hlavní obsah

Přepočet daňové evidence - REST API

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

Autor: Petr Pech

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í

Služba je dostupná metodami PUT a POST na adrese /c/{firma}/danova-evidence/prepocet, kde {firma} je databázový identifikátor firmy. Podporovanými výstupními formáty jsou XML a JSON.


Parametry

  • ucetniObdobi — povinný parametr, kterým se identifikuje období, za které chcete evidenci přepočítat (např. ucetniObdobi=code:2024).

  • dry-run — volitelný parametr, kterým 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 nebo 5xx a zpráva o důvodu neúspěchu.


Ukázky volání

1. Volání v XML

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

2. Volání v JSON včetně testovacího režimu dry-run

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

3. Určení formátu v hlavičce, nikoli příponou

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

V tomto případě se formát volí hlavičkou Accept: application/xml, případně Accept: application/json.


Neúspěšné požadavky

Již běží jiný přepočet

Pokud přepočet právě spustil jiný uživatel, například v aplikaci, vrátí se hlášení v tomto tvaru:

"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 nevede daňovou evidenci

Ve firmě, která účtuje v podvojném účetnictví, není akce k dispozici a volání vrací 400 s kódem akcePristupOdepren a hlášením K této akci nemáte přístup. Pro kontrolu zůstatků v podvojném účetnictví použijte přepočet stavu účtů.


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. Analogií v podvojném účetnictví je přepočet stavu účtů.

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.


Související

Dostali jste odpověď na svou otázku?