Skip to main content

VAT Return Lines - API

Exporting Rows of Saved Declarations via REST API

Written by Petr Pech

Lines of already saved VAT returns can be exported from ABRA Flexi using the /radek-priznani-dph record. It contains the individual return lines as they were saved to the database when the return was generated.


How to call it

The record is available via the method GET at the address /c/{firma}/radek-priznani-dph.{přípona}, where {firma} is the database company identifier.

GET https://demo.flexibee.eu/c/demo/radek-priznani-dph.xml

Since this is a standard record, all the usual REST API options can be used — output formats (xml, json, csv), detail levels, filtering, and pagination.


VAT return line fields

Field

Meaning

rok, mesic, ctvrtleti

The period for which the return was generated. For monthly filings, ctvrtleti is zero, and vice versa.

datum

Date the return was calculated.

stavK

Type of return: stavPriznaniDph.radne, stavPriznaniDph.opravne, or stavPriznaniDph.dodatecne.

zaklad, dph

Tax base and VAT amount for the given line.

typSzbDphK

VAT rate: typSzbDph.dphOsv (exempt), typSzbDph.dphSniz (reduced), typSzbDph.dphSniz2 (second reduced), typSzbDph.dphZakl (standard).

clenDph

Reference to the VAT return line code list.

stat

The country whose legislation the return was processed under.

uzivatel

The user who generated the return.

ℹ️ Summary records for individual returns (without a breakdown into lines) can be found in the /ulozene-priznani-dph record, which contains the same information about the period, return type, country, and user.


Finding a specific return

You can find the summary line of a specific return — i.e., the one without a filled-in breakdown or VAT rate — by filtering:

GET https://demo.flexibee.eu/c/demo/radek-priznani-dph/((rok eq "2024") and ((mesic eq "8") and ((clenDph is null) and (typSzbDphK is null)))).xml

For quarterly filings, the quarter is used instead of the month. The ID of the line found this way is used as the value of the dodatecneOproti parameter when generating an additional (supplementary) return.


Related

Did this answer your question?