Súhrnné hlásenie 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

Služba je dostupná metódou GET na adrese /c/{firma}/souhrnne-hlaseni.{přípona}, kde {firma} je databázový identifikátor firmy. Podporovanými výstupnými formátmi sú xml a pdf.

ℹ️ Volanie s príponou pdf server presmeruje (HTTP 307) na adresu /c/{firma}/souhrnne-hlaseni-dph.pdf. Pokiaľ si klient presmerovanie nepreberá automaticky, je nutné ho nasledovať, inak PDF nezískate.

Parametre

Na poradí parametrov nezáleží.

Parameter	Povinnosť	Význam
`rok`	povinný	Rok, pre ktorý má byť súhrnné hlásenie vygenerované, v tvare `?rok=2024`.
`mesic`	povinný, ak nie je zadané `ctvrtleti`	Číslo mesiaca v tvare `?mesic=1`. Možné hodnoty sú 1 až 12.
`ctvrtleti`	povinný, ak nie je zadaný `mesic`	Číslo štvrťroka v tvare `?ctvrtleti=1`. Možné hodnoty sú 1 až 4.
`stat`	nepovinný	Štát, pre ktorý chceme súhrnné hlásenie spracovať, v tvare `?stat=CZ`. Možné hodnoty sú `CZ` a `SK`. Ak nie je zadaný, použije sa štát legislatívy firmy.

Ukážka volania

Kompletné najjednoduchšie volanie vyzerá nasledovne:

GET https://demo.flexibee.eu/c/demo/souhrnne-hlaseni.xml?mesic=1&rok=2024

Prípadne pre PDF:

GET https://demo.flexibee.eu/c/demo/souhrnne-hlaseni.pdf?mesic=1&rok=2024

Výsledok volania

V prípade úspešného vykonania služby je vracaný HTTP status 200 spoločne s telom v požadovanom formáte. Pre českú legislatívu ide o XML štruktúru pre daňový portál (hodnoty sú ilustratívne):

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Pisemnost nazevSW="ABRA Flexi" verzeSW="2026.5.2">
  <DPHSHV verzePis="01.01">
    <VetaD d_poddp="15.02.2024" dokument="SHV" k_uladis="DPH" mesic="1" rok="2024" shvies_forma="R"/>
    <VetaP c_pop="1" c_pracufo="2301" c_ufo="454" 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."/>
    <VetaR c_rad="1" c_vat="SK1234567890" k_pln_eu="0" k_stat="SK" pln_hodnota="25620" pln_pocet="1" por_c_stran="1"/>
  </DPHSHV>
</Pisemnost>

Pre slovenskú legislatívu má výstup odlišnú štruktúru:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<dokument>
  <hlavicka>
    <identifikacneCislo>
      <kodStatu>SK</kodStatu>
      <dic>12345678</dic>
    </identifikacneCislo>
    <danovyUrad/>
    <druhSV>
      <riadny>1</riadny>
      <opravny>0</opravny>
      <dodatocny>0</dodatocny>
    </druhSV>
    <obdobie>
      <mesiac>1</mesiac>
      <stvrtrok/>
      <rok>2024</rok>
    </obdobie>
    <obchodneMeno>
      <riadok>Vzorová firma s.r.o.</riadok>
    </obchodneMeno>
    <celkovaHodnota>0</celkovaHodnota>
  </hlavicka>
  <telo>
    <strana>
      <zaznam>
        <kodStatu/>
        <idCislo/>
        <hodnota/>
        <kod/>
      </zaznam>
    </strana>
  </telo>
</dokument>

Pri volaní s príponou .pdf je výsledkom celý PDF súbor súhrnného hlásenia.

Dáta vygenerovaného hlásenia

Samotné dáta vygenerovaného súhrnného hlásenia — teda jednotlivé riadky, nie písomnosť — sú dostupné na adrese /c/{firma}/souhrnne-hlaseni-dph.{přípona} vo formátoch json a xml. Vyžadované sú rovnaké parametre obdobia, teda rok a mesic alebo ctvrtleti; voliteľne je možné uviesť aj stat. Použiť je možné aj filtráciu.

GET https://demo.flexibee.eu/c/demo/souhrnne-hlaseni-dph.json?rok=2024&ctvrtleti=2

Príklady nevalidných volaní

V prípade nevalidných volaní je vracaný status 4xx alebo 5xx a obsahom odpovede je popis chyby.

1. Nevalidné zadanie obdobia

GET https://demo.flexibee.eu/c/demo/souhrnne-hlaseni.xml?ctvrtleti=5&rok=2024

Výsledkom je odpoveď HTTP status 400 Bad Request a popis chyby:

<winstrom version="1.0">
  <success>false</success>
  <message>Zadaný parametr čtvrtletí není v rozmezí povolených hodnot (1 - 4).</message>
</winstrom>

2. Nevalidné zadanie štátu

GET https://demo.flexibee.eu/c/demo/souhrnne-hlaseni.xml?ctvrtleti=1&rok=2024&stat=CS

Výsledkom je odpoveď HTTP status 400 Bad Request s kódom unsupported_param_value_exception:

<winstrom version="1.0">
  <success>false</success>
  <message>Parametr 'stat' má nepodporovanou hodnotu! Zvolte jednu z následujících možností: [CZ, SK]</message>
</winstrom>

3. Nezadané všetky povinné parametre

GET https://demo.flexibee.eu/c/demo/souhrnne-hlaseni.pdf?rok=2024

Výsledkom je odpoveď HTTP status 400 Bad Request a popis chyby:

<winstrom version="1.0">
  <success>false</success>
  <message>Není zadáno období pro zpracování souhrnného hlášení.</message>
</winstrom>

FAQ

Ako súhrnné hlásenie vytvorím v aplikácii?

Postup nájdete v článku Súhrnné hlásenie k DPH.

Ako zadať faktúru, aby sa premietla do súhrnného hlásenia?

Podmienky popisuje článok Vykazovanie v súhrnnom hlásení, pre slovenskú legislatívu potom Podmienky pre vykazovanie faktúry v súhrnnom hlásení na Slovensku.

Prečo sa hodnoty v hlásení a v priznaní líšia?

Vysvetlenie nájdete v článku V súhrnnom hlásení a daňovom priznaní je rozdiel v zaokrúhľovaní.

Prečo sa do XML nepropisuje DIČ odberateľa a štát?

Odpoveď nájdete v článku Do XML súhrnného hlásenia sa nepropisuje DIČ odberateľa a štát.

Prečo PDF vykazuje menej riadkov?

Dôvod popisuje článok Súhrnné hlásenie vykazuje v PDF menej riadkov, ako v súhrnnom hlásení.

Súvisiace

Sorodni članki

Súhrnné hlásenie k DPH – REST API