Skip to main content

Recalculation of Tax Records - REST API

How to trigger a tax record recalculation using the API?

Written by Petr Pech

The tax records recalculation ensures verification of the correctness of balances in individual sections (paragraphs) of the records. An analogy can be found in the account balance recalculation in double-entry accounting.

Calling Method

You can use the HTTP method: PUT or POST.

The service is available at: /c/{firma}/danova-evidence/prepocet, where {firma} is the database identifier of the company.

The following output formats are supported: XML or JSON.

Parameters

The service requires the mandatory parameter ucetniObdobi in order to identify the time period for which you want to recalculate the accounts.

Optionally, the parameter dry-run can be used. This parameter allows you to check whether the recalculation has been completed. If so, it returns HTTP status 200. If not, it returns HTTP status 409 with information about when and by whom the recalculation was started.

Result

To determine whether the service was executed successfully, you can check the HTTP status of the response or the success property in the returned document.

In the case of successful execution, the service returns HTTP status 200 and a document conforming to the standard format — see return values.

In the case of failure, a 4xx/5xx status is returned along with a message describing the reason for the failure.

Call Examples

1. call in XML

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

2. call in JSON including test mode dry-run:

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

3. specifying the format in the header rather than as a file extension

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

(with header Accept: application/xml or Accept: application/json)

Failed Requests

1. In the event that another recalculation is already running, started for example by a user within the application

"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

What is the tax records recalculation?

The recalculation ensures verification of the correctness of balances in individual sections (paragraphs) of the records. An analogy can be found in the account balance recalculation in double-entry accounting.

Does the tax records recalculation need to be called regularly?

Generally no, however we recommend running it to verify the correctness of balances at the end of an accounting period.

Need help?

If you have any questions about the application, please contact us at podporaflexi@abra.eu or via the chat window in the bottom right corner.

Did this answer your question?