Daňové priznanie k DPH je možné získať vo formáte XML a prostredníctvom rozhrania Flexi API. Táto funkcia bola vyvinutá pre webové rozhranie a z tohto dôvodu budeme používať rozhranie REST API V2.
Môže sa použiť metóda HTTP POST.
Daňové priznanie k DPH je k dispozícii na adrese:
https://demo.flexibee.eu/v2/c/demo/priznani-dph
Na generovanie výstupu sú k dispozícii parametre, ktoré vložíme do tela požiadavky:
koeficient - povinný parameter, zadajte predvolenú hodnotu 1 (100 %).
year - povinný parameter, uveďte rok, od ktorého generujete výkaz (napr. 2020, 2021 atď.)
period - povinný parameter, zadajte štvrťrok pre štvrťročné výkazy alebo mesiac pre mesačné výkazy
month - povinný parameter v prípade mesačného obdobia, uveďte počiatočný mesiac, od ktorého sa generuje výkaz (napr. 1, 3 atď.)
quarter - povinný parameter pre štvrťročné obdobie, uveďte štvrťrok, za ktorý sa generuje výkaz - Q1, Q2, Q3 alebo Q4.
format - povinný parameter, určujúci výstupný formát, v našom prípade XML, podobne je možné stiahnuť PDF
output - povinný parameter v prípade formátu PDF, je to kód tlačovej zostavy, zvyčajne je hodnota returnDPH2019%24%24SUM (%24 predstavuje $, zostava sa sčíta)
typ - povinný parameter, určuje typ priznania DPH - riadne, riadne opravné, dodatočné, dodatočné opravné, hodnoty parametrov sú - radne, radneOpravne, dodatecne, dodatecneOpravne
vyporadaciKoeficient - nepovinný parameter, tento koeficient program neprepočítava, preto ho treba vypočítať a zadať ručne
changeDeduction - nepovinný parameter , zmena odpočtu znamená rozdiel medzi vypočítaným odpočtom a použitým odpočtom. (ř. 53)
dodatecneOproti - povinný parameter v prípade dodatočných priznaní, je to odkaz na riadky priznania DPH, kde sú uložené predchádzajúce priznania, odkaz je podľa ID predchádzajúceho priznania.
ID predchádzajúceho vrátenia môžete získať v registri https://demo.flexibee.eu/c/demo/radek-priznani-dph/properties.
Filtrovanie na vyhľadanie daného predchádzajúceho výnosu môžete vykonať takto:
/radek-priznani-dph/((year eq "2021") and ((month eq "8") and ((clenDph is null) and (typSzbDphK is null))))
Rovnakým spôsobom sa mesiac opäť zmení na štvrťrok eq "Q3"
DateDetected - povinný parameter v prípade dodatočného vrátenia, dátum zistenia zmeny vo formáte RRRR-MM-DD
Výsledok
Stav HTTP odpovede možno skontrolovať, aby sa zistilo, či bola služba úspešne vykonaná.
V prípade úspešného vykonania služby sa vráti stav HTTP 200 a dokument zodpovedajúci zvolenému formátu XML alebo PDF.
V prípade neúspechu sa vráti stav 4xx/5xx a správa s uvedením dôvodu neúspechu.
Vzorové výzvy
Pravidelné daňové priznanie k DPH v XML za 2. štvrťrok 2021:
URL:
https://demo.flexibee.eu/v2/c/demo/priznani-dph
Body:
year=2021&period=ctvrtleti&ctvrtleti=Q2&type=radne&coefficient=1&format=xml
Riadne opravné priznanie k DPH vo formáte PDF za marec 2021:
URL:
https://demo.flexibee.eu/v2/c/demo/priznani-dph
Body:
rok=2021&perioda=mesic&mesic=3&druh=radneOpravne&koeficient=1&format=pdf
Dodatočné priznanie k DPH v XML za 3. štvrťrok 2021:
URL:
https://demo.flexibee.eu/v2/c/demo/priznani-dph
Body:
year=2021&period=ctvrtleti&ctvrtleti=Q3&druh=addatecne&coefficient=1&format=xml&datumZjisteni=2021-04-04&dodatecneOproti=123