Přiznání k DPH lze získat v XML i PDF nejen v aplikaci, ale i prostřednictvím REST API ABRA Flexi.

Způsob volání

Přiznání DPH je dostupné na adrese /c/{firma}/priznani-dph.{přípona}, kde {firma} je databázový identifikátor firmy. Podporovanými výstupními formáty jsou xml a pdf.

Použít lze HTTP metodu GET i POST. Parametry se uvádějí v dotazu URL.

ℹ️ Výstup přiznání k DPH je k dispozici pouze pro českou a slovenskou legislativu. Přehled podporovaných států vrací form-data v příznacích supportXml a supportPdf.

Parametry

Parametr	Povinnost	Význam
`rok`	povinný	Rok, za který přiznání generujete (např. `2024`).
`mesic`	povinný	Měsíc, za který se přiznání generuje (např. `1`, `3`). Pro čtvrtletní podání uveďte do stejného parametru kvartál `Q1`, `Q2`, `Q3` nebo `Q4`.
`koeficient`	nepovinný	Koeficient pro výpočet poměrné části odpočtu daně (§ 76). Výchozí hodnoty: Česko `100`, Slovensko `0`.
`druh`	nepovinný	Druh přiznání k DPH, implicitně `radne`. Česko: `radne`, `radneOpravne`, `dodatecne`, `dodatecneOpravne`. Slovensko: `radne`, `opravne`, `dodatecne`.
`dodatecneOproti`	povinný u dodatečných přiznání	Odkaz na řádky přiznání DPH, kde jsou uložena předchozí přiznání, a to pomocí ID předchozího přiznání.
`duvodyProDodatecne`	u dodatečných přiznání v CZ	Důvody pro podání dodatečného přiznání. U české legislativy jej form-data uvádí mezi povinnými parametry druhů `dodatecne` a `dodatecneOpravne`.
`datumZjisteni`	nepovinný	Datum zjištění změn u dodatečných přiznání ve formátu `yyyy-MM-dd`.
`vyporadaciKoeficient`	nepovinný	Vypořádací koeficient. Program jej nepřepočítává, je nutné si jej vypočítat a zadat ručně.
`zmenaOdpoctu`	nepovinný	Rozdíl mezi vypočteným a uplatněným odpočtem (ř. 53).
`danKUhrade`	nepovinný	Celé číslo, daň k úhradě pro řádek 38. Pouze pro druh přiznání `dodatecne`.
`kodZdanObd`	nepovinný	Kód zdanitelného období (text).
`ulozit`	nepovinný	`true` / `false` — zda se má vygenerované přiznání uložit do databáze. Výchozí je `false`.
`report-name`	nepovinný	Název reportu, pouze pro formát PDF (např. `priznaniDPH2026$$SUM`). Neexistující název vrátí `400`.
`stat`	nepovinný	Hodnoty `CZ` a `SK`. Pokud není uveden, použije se stát legislativy firmy.

ID předchozího přiznání pro parametr dodatecneOproti najdete v evidenci /radek-priznani-dph. Pro vyhledání konkrétního předchozího přiznání lze použít filtraci:

/radek-priznani-dph/((rok eq "2024") and ((mesic eq "8") and ((clenDph is null) and (typSzbDphK is null))))

U čtvrtletního podání se ve filtru místo měsíce použije ctvrtleti eq "Q3".

Dostupné druhy přiznání

Dostupné druhy přiznání, podporované formáty a dostupné reporty vrací pro jednotlivé státy adresa /c/{firma}/priznani-dph/form-data.xml:

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

Výsledkem jsou form-data, jejichž zkrácená podoba pro českou legislativu vypadá takto:

<?xml version="1.0" ?>
<form-data>
  <statyDph>
    <statDph>
      <dostupneReporty>
        <report>
          <reportId>priznaniDPH2026$$SUM</reportId>
          <reportName>Přiznání DPH vzor č. 26 (od 01.01.2026)</reportName>
          <isDefault>true</isDefault>
          <statCodes>CZ</statCodes>
        </report>
      </dostupneReporty>
      <parametry>
        <zalohovyKoeficient>100.0</zalohovyKoeficient>
      </parametry>
      <kod>CZ</kod>
      <nazev>Česká republika</nazev>
      <supportXml>true</supportXml>
      <supportPdf>true</supportPdf>
      <dostupneDruhy>
        <druh>
          <kod>radne</kod>
          <nazev>Řádné</nazev>
          <povinneParametry>
            <povinnyParametr>rok</povinnyParametr>
            <povinnyParametr>mesic</povinnyParametr>
          </povinneParametry>
        </druh>
        <druh>
          <kod>dodatecne</kod>
          <nazev>Dodatečné</nazev>
          <povinneParametry>
            <povinnyParametr>rok</povinnyParametr>
            <povinnyParametr>mesic</povinnyParametr>
            <povinnyParametr>dodatecneOproti</povinnyParametr>
            <povinnyParametr>duvodyProDodatecne</povinnyParametr>
          </povinneParametry>
        </druh>
      </dostupneDruhy>
    </statDph>
  </statyDph>
</form-data>

Ukázky volání

1. Řádné přiznání k DPH v PDF za leden 2024

GET https://demo.flexibee.eu/c/demo/priznani-dph.pdf?koeficient=100&rok=2024&mesic=1

Výstupem je PDF soubor přiznání:

2. Řádné přiznání k DPH v XML za leden 2024

GET https://demo.flexibee.eu/c/demo/priznani-dph.xml?koeficient=100&rok=2024&mesic=1

Výstupem je XML písemnosti pro finanční správu (hodnoty jsou ilustrativní):

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Pisemnost nazevSW="ABRA Flexi" verzeSW="2026.5.2">
  <DPHDP3 verzePis="02.01.03">
    <VetaD c_okec="" d_poddp="15.02.2024" dapdph_forma="B" dokument="DP3" k_uladis="DPH" mesic="1" rok="2024" trans="A" typ_platce="P"/>
    <VetaP c_pop="1" c_pracufo="2301" dic="CZ12345678" naz_obce="Praha" opr_postaveni="jednatel" psc="10000" stat="ČESKÁ REPUBLIKA" typ_ds="P" ulice="Ulice 1" zkrobchjm="Vzorová firma s.r.o."/>
    <Veta1 dan23="0.0" dan5="0.0" obrat23="0.0" obrat5="0.0"/>
    <Veta2 dod_zb="0.0" pln_ost="0.0" pln_sluzby="0.0" pln_vyvoz="0.0"/>
    <Veta3 dov_osv="0.0" opr_dluz="0.0" opr_verit="0.0"/>
    <Veta4 odp_sum_kr="0.0" odp_sum_nar="0.0" pln23="0.0" pln5="0.0"/>
    <Veta5 koef_p20_nov="0.00" odp_uprav_kf="0.0" pln_nkf="0.0"/>
    <Veta6 dan_vrac="0.0" dan_zocelk="0.0" dano="0.0" odp_zocelk="0.0"/>
  </DPHDP3>
</Pisemnost>

3. Slovenské přiznání k DPH v XML za leden 2024

GET https://demo.flexibee.eu/c/demo/priznani-dph.xml?koeficient=0&rok=2024&mesic=1&stat=SK

Slovenské přiznání má odlišnou strukturu XML (hodnoty jsou ilustrativní):

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<dokument xsi:noNamespaceSchemaLocation="universal.xsd">
  <hlavicka>
    <identifikacneCislo>
      <kodStatu>SK</kodStatu>
      <cislo>12345678</cislo>
    </identifikacneCislo>
    <typDP>
      <rdp>1</rdp>
      <odp>0</odp>
      <ddp>0</ddp>
    </typDP>
    <zdanObd>
      <mesiac>1</mesiac>
      <stvrtrok/>
      <rok>2024</rok>
    </zdanObd>
  </hlavicka>
  <telo>
    <r01>0.00</r01>
    <r02>0.00</r02>
  </telo>
</dokument>

Výsledek volání

Pro rozpoznání, zda byla služba vykonána úspěšně, lze kontrolovat HTTP status odpovědi. V případě úspěchu je vracen status 200 a dokument odpovídající vybranému formátu XML nebo PDF, v případě neúspěchu status 4xx nebo 5xx a zpráva o důvodu neúspěchu.

Příklady nevalidních volání

1. Nepodporovaná hodnota parametru druh

GET https://demo.flexibee.eu/c/demo/priznani-dph.xml?koeficient=0&rok=2024&mesic=1&druh=opravny

Odpovědí je 400 Bad Request a popis chyby s kódem unsupported_param_value_exception:

<winstrom version="1.0">
  <success>false</success>
  <message>Parametr 'druh' má nepodporovanou hodnotu! Zvolte jednu z následujících možností: [radne, radneOpravne, dodatecne, dodatecneOpravne].</message>
</winstrom>

2. Původní přiznání je v jiném období, než je období požadavku

GET https://demo.flexibee.eu/c/demo/priznani-dph.xml?koeficient=100&rok=2024&mesic=1&druh=dodatecne&dodatecneOproti=15&datumZjisteni=2024-06-13

Odpovědí je 400 Bad Request:

<?xml version="1.0" ?>
<winstrom version="1.0">
  <success>false</success>
  <message>Opravované přiznání musí být ve stejném období (202301) jako opravné přiznání (202401).</message>
</winstrom>

3. Chybějící povinný parametr

GET https://demo.flexibee.eu/c/demo/priznani-dph.xml?koeficient=100&rok=2024&mesic=1&druh=dodatecne

Odpovědí je 400 Bad Request s kódem missing_param_exception:

<winstrom version="1.0">
  <success>false</success>
  <message>K provedení operace je vyžadován parametr 'dodatecneOproti'</message>
</winstrom>

Chybějící rok nebo mesic vrací 400 s kódem parametrPovinny a hlášením Parametr rok je povinný., respektive Parametr mesic je povinný.

Uložené přiznání DPH

Vygenerovaná přiznání se ukládají do evidence ulozene-priznani-dph. Seznam uložených přiznání získáte s využitím filtrace:

GET https://demo.flexibee.eu/c/demo/ulozene-priznani-dph/(rok eq 2024 and mesic eq 1).xml

Případně pomocí dotazu /query s parametry v těle požadavku:

POST https://demo.flexibee.eu/c/demo/ulozene-priznani-dph/query

Tělo požadavku:

{"rok":"2024","mesic":"1"}

FAQ

Jak se přiznání k DPH tvoří v aplikaci?

Postup popisuje článek Přiznání DPH, slovenským specifikům se věnuje SLOVENSKO - Přiznání DPH.

Jak exportovat řádky uložených přiznání?

Slouží k tomu evidence popsaná v článku Řádky přiznání DPH - API.

Kde najdu číselník jednotlivých řádků DPH?

Legislativně daný číselník obsahující jednotlivé řádky DPH popisuje článek Řádky přiznání DPH.

Související

Související články

Přiznání DPH - REST API