Rovnako ako v aplikácii je možné získať v XML (PDF) aj prostredníctvom API Flexi.
Spôsob volania
Možno využiť HTTP metódu: GET.
Služba je dostupná na adrese: /c/{firma}/souhrnne-hlaseni, kde {firma} je databázový identifikátor firmy.
Sú podporované výstupné formáty: XML alebo PDF.
Parametre
Služba má 3 parametre, na poradí parametrov nezáleží:
rok(povinný), v tvare?stat=2023mesic(povinný, ak nie je zadaný parameterctvrtleti), v tvare?mesic=1možné hodnoty sú 1 - 12
ctvrtleti(povinný, ak nie je zadaný parametermesic), v tvare?ctvrtleti=1možné hodnoty sú 1 - 4
stat(nepovinný), v tvare ?stat=CZmožné hodnoty CZ alebo SK, ak nie je zadaný, použije sa štát legislatívy
Ukážka volania
Kompletné najjednoduchšie volanie vyzerá nasledovne:
Prípadne pre PDF:
Výsledok volania
Výsledkom je súhrnný výkaz v XML štruktúre pre daňový portál pre CZ legislatívu:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Pisemnost nazevSW="ABRA Flexi" verzeSW="2023.5.6">
<DPHSHV verzePis="01.01">
<VetaD ctvrt="4" d_poddp="29.11.2023" dokument="SHV" k_uladis="DPH" rok="2023" shvies_forma="R"/>
<VetaP c_pop="277" c_pracufo="3104" c_ufo="462" dic="12345678" naz_obce="Praha" opr_postaveni="jednatel" psc="10100" stat="ČESKÁ REPUBLIKA" typ_ds="P" ulice="Jeremiášova" zkrobchjm="ABRA Software a.s."/>
</DPHSHV>
</Pisemnost>
Prípadne obdobne v inej štruktúre pre SK legislatívu:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<dokument>
<hlavicka>
<identifikacneCislo>
<kodStatu>SK</kodStatu>
<dic>141414114</dic>
</identifikacneCislo>
<danovyUrad/>
<druhSV>
<riadny>1</riadny>
<opravny>0</opravny>
<dodatocny>0</dodatocny>
</druhSV>
<obdobie>
<mesiac>1</mesiac>
<stvrtrok/>
<rok>2023</rok>
</obdobie>
<obchodneMeno>
<riadok>ABRA SK s.r.o.</riadok>
atd.
Prípadne celý PDF súbor pri volaní s príponou .pdf
Príklady neplatných volaní
V prípade úspešného vykonania služby je vrátený HTTP status 200 spolu s telom v požadovanom formáte XML alebo PDF.
V prípade neplatných volaní je obsahom popis chyby.
1. Neplatné zadanie obdobia
Výsledkom chyby 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. Neplatné zadanie štátu
Výsledkom chyby je odpoveď HTTP Status 400 Bad request a popis chyby:
<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>
4. Bez zadania všetkých povinných parametrov
Výsledkom chyby 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
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.