Preskoči na glavno vsebino

Priznanie DPH - REST API

Ako získať priznanie DPH cez API vo formáte XML alebo PDF?

Avtor: Petr Pech

Rovnako ako v aplikácii, priznanie DPH je možné získať v XML/PDF aj prostredníctvom API Flexi.

Spôsob volania

Možno využiť HTTP metódu: POST

Priznanie DPH je dostupné na adrese:

https://demo.flexibee.eu/c/{firma}/priznani-dph.pdf/xml , kde {firma} je databázový identifikátor firmy.

Sú podporované výstupné formáty: XML alebo PDF.

Parametre

Pre generovanie výstupu sú dostupné parametre, ktoré uvedieme do tela požiadavky:

  • koeficient - nepovinný parameter, koeficient pre výpočet pomernej časti odpočtu dane (§ 76). Predvolené hodnoty: Česko 100, Slovensko 0

  • rok - povinný parameter, uveďte rok, za ktorý generujete priznanie (napr. 2020, 2021 a pod.)

  • mesic - povinný parameter, uveďte počiatočný mesiac, od ktorého sa priznanie generuje (napr. 1, 3 a pod.) alebo uveďte kvartál, za ktorý generujete priznanie - Q1, Q2, Q3 alebo Q4

  • druh - nepovinný parameter, určuje druh priznania k DPH, možnosti, ktoré nadobúda (implicitne nemáva hodnotu radne):

    • Česko: radne, radneOpravne, dodatecne, dodatecneOpravne

    • Slovensko: radne, opravne, dodatecne

  • vyporadaciKoeficient - nepovinný parameter, tento koeficient nie je prepočítavaný programom, preto je potrebné si ho vypočítať a zadať ručne

  • kodZdanObd - nepovinný String Kód zdaniteľného obdobia

  • zmenaOdpoctu - nepovinný parameter, zmenou odpočtu sa rozumie rozdiel medzi vypočítaným odpočtom a uplatneným odpočtom. (r. 53)

  • dodatecneOproti - povinný parameter v prípade dodatočných priznaní, ide o odkaz na riadky priznania DPH, kde sú uložené predchádzajúce priznania, odkaz je pomocou ID predchádzajúceho priznania.

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

  • datumZjisteni - nepovinný parameter v prípade dodatočných priznaní, dátum zistenia zmien vo formáte YYYY-MM-DD

  • danKUhrade - nepovinný parameter, celé číslo, daň k úhrade pre riadok 38. Len pre druh priznania dodatecne

  • ulozit - nepovinný, nadobúda true/false , či sa má vygenerované priznanie uložiť do databázy, predvolené false

  • report-name - nepovinný parameter, názov reportu (iba pre formát PDF)

  • stat - nepovinný: Možné hodnoty CZ, SK. Ak nie je uvedený, použije sa štát legislatívy.

Dostupné druhy priznaní

Dostupné druhy priznaní DPH vo formáte xml:

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

Výsledkom sú všeobecné form-data v tvare:

<?xml version="1.0" ?>
<form-data>
    <statyDph>
        <statDph>
            <kod>CZ</kod>
            <nazev>Česká republika</nazev>
            <nazevA>Czech republic</nazevA>
            <nazevB></nazevB>
            <nazevC></nazevC>
            <dostupneDruhy>
                <druh>
                    <kod>radne</kod>
                    <nazev>Řádné</nazev>
                    <povinneParametry>
                        <povinnyParametr>rok</povinnyParametr>
                        <povinnyParametr>mesic</povinnyParametr>
                    </povinneParametry>
                </druh>
                <druh>
                    <kod>radneOpravne</kod>
                    <nazev>Řádné/opravné</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>
                    </povinneParametry>
                </druh>
                <druh>
                    <kod>dodatecneOpravne</kod>
                    <nazev>Dodatečné/opravné</nazev>
                    <povinneParametry>
                        <povinnyParametr>rok</povinnyParametr>
                        <povinnyParametr>mesic</povinnyParametr>
                        <povinnyParametr>dodatecneOproti</povinnyParametr>
                    </povinneParametry>
                </druh>
            </dostupneDruhy>
        </statDph>
    </statyDph>
</form-data>

Ukážka volania

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

GET

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

Výstup:

PDF soubor Přiznání

2. Slovenské dodatočné priznanie k DPH v XML za január 2023:

GET

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

Výstup:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Pisemnost nazevSW="ABRA Flexi" verzeSW="SNAPSHOT">
    <DPHDP3 verzePis="02.01.03">
        <VetaD c_okec="" d_poddp="01.12.2023" d_zjist="13.06.2023" dapdph_forma="D" dokument="DP3" k_uladis="DPH" mesic="3" rok="2015" trans="A" typ_platce="P"/>
        <VetaP c_pop="277" c_pracufo="3104" c_ufo="462" dic="02230607" email="info@abra.eu" naz_obce="Praha" opr_postaveni="jednatelka" psc="10100" stat="ČESKÁ REPUBLIKA" typ_ds="P" ulice="Jívová" zkrobchjm="ABRA Flexi s.r.o."/>
        <Veta1 dan23="0.0" dan5="0.0" dan_dzb23="0.0" dan_dzb5="0.0" dan_pdop_nrg="0.0" dan_psl23_e="0.0" dan_psl23_z="0.0" dan_psl5_e="0.0" dan_psl5_z="0.0" dan_pzb23="0.0" dan_pzb5="0.0" dan_rpren23="0.0" dan_rpren5="0.0" dov_zb23="0.0" dov_zb5="0.0" obrat23="0.0" obrat5="0.0" p_dop_nrg="0.0" p_sl23_e="0.0" p_sl23_z="0.0" p_sl5_e="0.0" p_sl5_z="0.0" p_zb23="0.0" p_zb5="0.0" rez_pren23="0.0" rez_pren5="0.0"/>
        <Veta2 dod_dop_nrg="0.0" dod_zb="0.0" pln_ost="0.0" pln_rez_pren="0.0" pln_sluzby="0.0" pln_vyvoz="0.0" pln_zaslani="0.0"/>
        <Veta3 dov_osv="0.0" opr_dluz="0.0" opr_verit="0.0" tri_dozb="0.0" tri_pozb="0.0"/>
        <Veta4 dov_cu="0.0" nar_maj="0.0" nar_zdp23="0.0" nar_zdp5="0.0" od_maj="0.0" od_zdp23="0.0" od_zdp5="0.0" odkr_maj="0.0" odkr_zdp23="0.0" odkr_zdp5="0.0" odp_cu="0.0" odp_cu_nar="0.0" odp_rez_nar="0.0" odp_rezim="0.0" odp_sum_kr="0.0" odp_sum_nar="0.0" odp_tuz23="0.0" odp_tuz23_nar="0.0" odp_tuz5="0.0" odp_tuz5_nar="0.0" pln23="0.0" pln5="0.0"/>
        <Veta5 koef_p20_nov="0.00" odp_uprav_kf="0.0" pln_nkf="0.0" plnosv_kf="0.0" plnosv_nkf="0.0"/>
        <Veta6 dan_vrac="0.0" dan_zocelk="0.0" dano="0.0" odp_zocelk="0.0"/>
    </DPHDP3>
</Pisemnost>

Výsledok volania

Pre rozpoznanie, či bola služba vykonaná úspešne, možno kontrolovať HTTP status odpovede.

V prípade úspešného vykonania služby je vrátený HTTP status 200 a dokument zodpovedajúci vybranému formátu XML alebo PDF.

V prípade neúspechu je vrátený status 4xx/5xx a správa o dôvode neúspechu.

Príklady neplatných volaní

V prípade neplatných volaní je obsahom popis chyby.

1. Nesprávne zadaný parameter zadania obdobia

GET https://demo.flexibee.eu/c/demo/priznani-dph.xml?koeficient=0&rok=2015&mesic=1&druh=opravny&dodatecneOproti=1&datumZjisteni=2023-06-13

Výsledkom chyby je odpoveď HTTP Status 400 Bad request a popis chyby:

<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. Chyba v prípade, že pôvodné priznanie je v inom období ako je zadané obdobie požiadavky.

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

Výsledkom chyby je odpoveď HTTP Status 400 Bad request a popis chyby:

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

3. Chýbajúci povinný parameter

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

Výsledkom chyby je odpoveď HTTP Status 400 Bad request a popis chyby:

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

Uložené priznania DPH

Už vygenerované priznania sú uložené. Zoznam uložených priznaní možno získať na adrese

GET

https://demo.flexibee.eu/c/demo/ulozene-priznani-dph/(rok={rok} AND mesic={mesic} AND ctvrtleti={ctvrtleti}).xml

Prípadne pomocou /query a parametrov v tele:

GET

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

Telo:

"rok":"2023","mesic":"1"

FAQ

Tvorba priznania k DPH v aplikácii ABRA Flexi

Slovenské priznanie DPH

Export riadkov uložených priznaní cez REST API

Legislatívne daný číselník obsahujúci jednotlivé riadky DPH


​Potrebujete poradiť?

V prípade otázok k aplikácii nás kontaktujte na podporaflexi@abra.eu prípadne prostredníctvom okna chatu v pravom dolnom rohu.


​

Sorodni članki
Účtovné zostavy v API
Zmluvy v API
Súhrnný výkaz k DPH - REST API
Kontrolné hlásenie - REST API
Práca pre strediská - REST API
Ste s tem dobili odgovor na svoje vprašanje?