Priznanie k DPH je možné získať v XML aj PDF nielen v aplikácii, ale aj prostredníctvom REST API ABRA Flexi.

Spôsob volania

Priznanie 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átmi sú xml a pdf.

Použiť možno HTTP metódu GET aj POST. Parametre sa uvádzajú v dotaze URL.

ℹ️ Výstup priznania k DPH je k dispozícii iba pre českú a slovenskú legislatívu. Prehľad podporovaných štátov vracia form-data v príznakoch supportXml a supportPdf.

Parametre

Parameter	Povinnosť	Význam
`rok`	povinný	Rok, za ktorý priznanie generujete (napr. `2024`).
`mesic`	povinný	Mesiac, za ktorý sa priznanie generuje (napr. `1`, `3`). Pre štvrťročné podanie uveďte do rovnakého parametra kvartál `Q1`, `Q2`, `Q3` alebo `Q4`.
`koeficient`	nepovinný	Koeficient pre výpočet pomernej časti odpočtu dane (§ 76). Východiskové hodnoty: Česko `100`, Slovensko `0`.
`druh`	nepovinný	Druh priznania k DPH, implicitne `radne`. Česko: `radne`, `radneOpravne`, `dodatecne`, `dodatecneOpravne`. Slovensko: `radne`, `opravne`, `dodatecne`.
`dodatecneOproti`	povinný pri dodatočných priznaniach	Odkaz na riadky priznania DPH, kde sú uložené predchádzajúce priznania, a to pomocou ID predchádzajúceho priznania.
`duvodyProDodatecne`	pri dodatočných priznaniach v CZ	Dôvody na podanie dodatočného priznania. Pri českej legislatíve ich form-data uvádza medzi povinnými parametrami druhov `dodatecne` a `dodatecneOpravne`.
`datumZjisteni`	nepovinný	Dátum zistenia zmien pri dodatočných priznaniach vo formáte `yyyy-MM-dd`.
`vyporadaciKoeficient`	nepovinný	Vyrovnávací koeficient. Program ho neprepočítava, je potrebné si ho vypočítať a zadať ručne.
`zmenaOdpoctu`	nepovinný	Rozdiel medzi vypočítaným a uplatneným odpočtom (r. 53).
`danKUhrade`	nepovinný	Celé číslo, daň na úhradu pre riadok 38. Iba pre druh priznania `dodatecne`.
`kodZdanObd`	nepovinný	Kód zdaňovacieho obdobia (text).
`ulozit`	nepovinný	`true` / `false` — či sa má vygenerované priznanie uložiť do databázy. Východiskové je `false`.
`report-name`	nepovinný	Názov reportu, iba pre formát PDF (napr. `priznaniDPH2026$$SUM`). Neexistujúci názov vráti `400`.
`stat`	nepovinný	Hodnoty `CZ` a `SK`. Ak nie je uvedený, použije sa štát legislatívy firmy.

ID predchádzajúceho priznania pre parameter dodatecneOproti nájdete v evidencii /radek-priznani-dph. Na vyhľadanie konkrétneho predchádzajúceho priznania možno použiť filtráciu:

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

Pri štvrťročnom podaní sa vo filtri namiesto mesiaca použije ctvrtleti eq "Q3".

Dostupné druhy priznania

Dostupné druhy priznania, podporované formáty a dostupné reporty vracia pre jednotlivé štáty adresa /c/{firma}/priznani-dph/form-data.xml:

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

Výsledkom sú form-data, ktorých skrátená podoba pre českú legislatívu vyzerá 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ážky volania

1. Riadne priznanie k DPH v PDF za január 2024

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

Výstupom je PDF súbor priznania:

2. Riadne priznanie k DPH v XML za január 2024

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

Výstupom je XML písomnosti pre finančnú správu (hodnoty sú ilustratívne):

<?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é priznanie k DPH v XML za január 2024

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

Slovenské priznanie má odlišnú štruktúru XML (hodnoty sú ilustratívne):

<?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ýsledok volania

Na rozpoznanie, či bola služba vykonaná úspešne, možno kontrolovať HTTP status odpovede. V prípade úspechu je vrátený status 200 a dokument zodpovedajúci vybranému formátu XML alebo PDF, v prípade neúspechu status 4xx alebo 5xx a správa o dôvode neúspechu.

Príklady nevalidných volaní

1. Nepodporovaná hodnota parametra druh

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

Odpoveďou je 400 Bad Request a popis chyby s kódom 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é priznanie je v inom období, než je obdobie požiadavky

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

Odpoveďou 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. Chýbajúci povinný parameter

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

Odpoveďou je 400 Bad Request s kódom missing_param_exception:

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

Chýbajúci rok alebo mesic vracia 400 s kódom parametrPovinny a hlásením Parametr rok je povinný., respektíve Parametr mesic je povinný.

Uložené priznanie DPH

Vygenerované priznania sa ukladajú do evidencie ulozene-priznani-dph. Zoznam uložených priznaní získate s využitím filtrácie:

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

Prípadne pomocou dotazu /query s parametrami v tele požiadavky:

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

Telo požiadavky:

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

FAQ

Ako sa priznanie k DPH tvorí v aplikácii?

Postup popisuje článok Priznanie DPH, slovenským špecifikám sa venuje SLOVENSKO - Priznanie DPH.

Ako exportovať riadky uložených priznaní?

Slúži na to evidencia popísaná v článku Riadky priznania DPH - API.

Kde nájdem číselník jednotlivých riadkov DPH?

Legislatívne daný číselník obsahujúci jednotlivé riadky DPH popisuje článok Riadky priznania DPH.

Súvisiace

Sorodni članki

Priznanie DPH - REST API