Preskoči na glavno vsebino

Účtovné výstupy v REST API

Akým spôsobom generovať účtovné výstupy v API?

Avtor: Petr Pech

Účtovné výstupy nie je potrebné generovať iba cez desktopovú aplikáciu alebo webové rozhranie. Rovnako ako ostatné dáta, môžete ich získať pomocou REST API ABRA Flexi.

V dokumentácii nájdete všetky nové účtovné výstupy s možnosťou generovania cez REST API. Účtovné výstupy je možné generovať do PDF aj do XLS (vrátane tlačových zostáv, pozri dokumentáciu).

Stavy účtov

Adresa

.../c/{firma}/stav-uctu[.xml]

Parametre

Ak potrebujeme stav pre iné ako aktuálne účtovné obdobie, je potrebné doplniť do URL parameter ucetniObdobi. Hodnotou tohto parametra je skratka požadovaného účtovného obdobia. Výsledné URL bude vyzerať napríklad takto: .../c/{firma}/stav-uctu[.xml]?ucetniObdobi=2016.

Ďalšou možnosťou, ako získať stavy účtov pre iné ako aktuálne účtovné obdobie, je doplniť parameter idUcetniObdobi. Tento parameter umožňuje využitie identifikátorov účtovného obdobia. Ak je tento parameter použitý, má prednosť pred parametrom ucetniObdobi.

Členenie stavov účtov

Stavy účtov je možné deliť podľa stredísk pomocou parametra groupByStredisko=true alebo podľa činností pomocou groupByCinnost=true. Každý riadok potom bude obsahovať stav účtu pre konkrétne stredisko alebo činnosť.

Príklady použitia

URL

Popis

/c/{firma}/stav-uctu[.xml]

Stavy účtov pre aktuálne účtovné obdobie

/c/{firma}/stav-uctu[.xml]?idUcetniObdobi=3

Stavy účtov pre účtovné obdobie s ID 3

/c/{firma}/stav-uctu[.xml]?idUcetniObdobi=code:2016

Stavy účtov pre účtovné obdobie so skratkou 2016

/c/{firma}/stav-uctu[.xml]?ucetniObdobi=2016

Stavy účtov pre účtovné obdobie so skratkou 2016

/c/{firma}/stav-uctu[.xml]?groupByStredisko=true

Stavy účtov členené podľa stredísk

/c/{firma}/stav-uctu[.xml]?groupByCinnost=true

Stavy účtov členené podľa činností

/c/{firma}/stav-uctu[.xml]?groupByStredisko=true&groupByCinnost=true

Stavy účtov členené podľa stredísk aj činností súčasne

Súhrnné hlásenie k DPH

Adresa

/c/firma/souhrnne-hlaseni-dph.pdf

firma - nahraďte za identifikátor firmy

Parametre

Dva parametre pre obdobie sú vždy povinné (buď rok a ctvrtleti, alebo rok a mesic).

  • rok - rok priznania (napr. 2018)

  • ctvrtleti - pre štvrťročné podanie (hodnoty 1 až 4)

  • mesic - pre mesačné podanie (hodnoty 1 až 12)

  • statId - štát pre spracovanie priznania (id objektu z evidencie /stat), predvolený je štát legislatívy z nastavenia firmy

Príklady

GET/c/firma/souhrnne-hlaseni-dph.pdf?rok=2018&mesic=2&statId=38

V prípade odpovede 200 OK dôjde k vygenerovaniu príslušného PDF súboru.

Účtovná analýza zákazky

Adresa

/c/firma/analyza-zakazky.pdf

firma - nahraďte za identifikátor firmy

Parametre

Povinné sú iba parametre obdobia (uctovaniOd a uctovaniDo).

  • report-name - predvolená je analyzaZakazky, ak parameter nie je uvedený

  • uctovaniOd - počiatočný dátum účtovania vo formáte "yyyy-MM-dd" (napr. 2017-01-01)

  • uctovaniDo - koncový dátum účtovania vo formáte "yyyy-MM-dd" (napr. 2017-12-31)

  • zakazka - "kod" objektu z evidencie /zakazka (možno použiť viac týchto parametrov - napr. zakazka=code:ZAK1&zakazka=code=ZAK2)

  • stredisko - "kod" objektu z evidencie /stredisko (možno použiť viac týchto parametrov - napr. stredisko=code:C&stredisko=code:B)

  • cinnost - "kod" objektu z evidencie /cinnost (možno použiť viac týchto parametrov - napr. cinnost=code:1&cinnost=code:2)

Príklady

GET/c/firma/analyza-zakazky.pdf?uctovaniOd=2017-01-01&uctovaniDo=2017-12-31&zakazkaId=4&zakazkaId=6

V prípade odpovede 200 OK dôjde k vygenerovaniu príslušného PDF súboru.

Neuhradené pohľadávky/záväzky po splatnosti

Adresa

/c/firma/po-splatnosti.pdf

firma - nahraďte za identifikátor firmy

Parametre

Ak sú uvedené parametre rozmezi1-6, každá hodnota musí byť rovnaká alebo väčšia ako predchádzajúca hodnota. Parameter datumVypoctu je povinný.

  • report-name - predvolená je poSplatnosti, ak parameter nie je uvedený

  • datumVypoctu - dátum výpočtu reportu vo formáte "yyyy-MM-dd" (napr. 2018-09-01)

  • modul - kódy účtovných modulov (FAP, FAV, PHL, ZAV), možno použiť viac týchto parametrov - napr. modul=FAV&modul=PHL

  • rozmezi1 - rozmedzie splatností v dňoch (predvolené 30)

  • rozmezi2 - rozmedzie splatností v dňoch (predvolené 60)

  • rozmezi3 - rozmedzie splatností v dňoch (predvolené 90)

  • rozmezi4 - rozmedzie splatností v dňoch (predvolené 180)

  • rozmezi5 - rozmedzie splatností v dňoch (predvolené 360)

  • rozmezi6 - rozmedzie splatností v dňoch (predvolené 720)

Príklady

GET/c/firma/po-splatnosti.pdf?report-name=poSplatnostiDleDokladu&datumVypoctu=2018-09-01&rozmezi1=0&modul=FAP&modul=PHL

V prípade odpovede 200 OK dôjde k vygenerovaniu príslušného PDF súboru.

Súpis nákladov a výnosov

Adresa

/c/firma/vysledovka-po-uctech.pdf

firma - nahraďte za identifikátor firmy

Parametre

  • report-name

  • ucetniObdobi - kód účtovného obdobia (napr. 2018), predvolené je aktuálne účtovné obdobie

  • filtrUcty - kódy účtov, prípadne ich prefix alebo rozsah, oddelené čiarkou (napr. 311000,32,3-4)

  • ucet - kód účtu (možno použiť viac týchto parametrov - napr. ucet=code:211001&ucet=code:112001)

  • danoveUcty - ak nie je uvedený, sú zahrnuté daňové aj nedaňové účty

  • stredisko - "kod" objektu z evidencie /stredisko (možno použiť viac týchto parametrov - napr. stredisko=code:C&stredisko=code:B)

  • cinnost - "kod" objektu z evidencie /cinnost (možno použiť viac týchto parametrov - napr. cinnost=code:1&cinnost=code:2)

  • mena - kód meny (možno použiť viac týchto parametrov - napr. mena=code:CZK&mena=code:EUR)

  • groupByStredisko - true / false (aktivuje / deaktivuje členenie podľa stredísk)

  • groupByCinnost - true / false (aktivuje / deaktivuje členenie podľa činností)

Príklady

GET/c/firma/vysledovka-po-uctech.pdf?report-name=vysledovkaPoUctechStavy&ucetniObdobi=2018&mena=code:CZK&danoveUcty=true&stredisko=code:C

V prípade odpovede 200 OK dôjde k vygenerovaniu príslušného PDF súboru.

Súpis aktív a pasív

Adresa

/c/firma/rozvaha-po-uctech.pdf

firma - nahraďte za identifikátor firmy

Parametre

  • report-name

  • ucetniObdobi - kód účtovného obdobia (napr. 2018), predvolené je aktuálne účtovné obdobie

  • filtrUcty - kódy účtov, prípadne ich prefix alebo rozsah, oddelené čiarkou (napr. 311000,32,3-4)

  • ucet - kód účtu (možno použiť viac týchto parametrov - napr. ucet=code:211001&ucet=code:112001)

  • stredisko - "kod" objektu z evidencie /stredisko (možno použiť viac týchto parametrov - napr. stredisko=code:C&stredisko=code:B)

  • cinnost - "kod" objektu z evidencie /cinnost (možno použiť viac týchto parametrov - napr. cinnost=code:1&cinnost=code:2)

  • mena - kód meny (možno použiť viac týchto parametrov - napr. mena=code:CZK&mena=code:EUR)

  • groupByStredisko - true / false (aktivuje / deaktivuje členenie podľa stredísk)

  • groupByCinnost - true / false (aktivuje / deaktivuje členenie podľa činností)

Príklady

GET/c/firma/rozvaha-po-uctech.pdf?report-name=rozvahaPoUctechObraty&mena=code:CZK&filtrUcty=2,32,022001&ucet=code:082001&stredisko=1

V prípade odpovede 200 OK dôjde k vygenerovaniu príslušného PDF súboru.

Výkaz hospodárenia

Adresa

/c/firma/vykaz-hospodareni.pdf

firma - nahraďte za identifikátor firmy

Parametre

  • report-name - hodnota vykazHospodareni (povinná)

  • ucetniObdobi - kód účtovného obdobia (napr. 2018), predvolené je aktuálne účtovné obdobie

  • filtrUcty - kódy účtov, prípadne ich prefix alebo rozsah, oddelené čiarkou (napr. 311000,32,3-4)

  • ucet - kód účtu (možno použiť viac týchto parametrov - napr. ucet=code:211001&ucet=code:112001)

  • mesicRok - mesiac a rok vo formáte "mm/yyyy" (mesiac hodnoty 1-12, rok zodpovedajúci účtovnému obdobiu) - napr. 04/2018 (parameter je povinný)

  • stredisko - "kod" objektu z evidencie /stredisko (možno použiť viac týchto parametrov - napr. stredisko=code:C&stredisko=code:B)

  • cinnost - "kod" objektu z evidencie /cinnost (možno použiť viac týchto parametrov - napr. cinnost=code:1&cinnost=code:2)

  • mena - kód meny (možno použiť viac týchto parametrov - napr. mena=code:CZK&mena=code:EUR)

Príklady

GET/c/firma/vykaz-hospodareni.pdf?report-name=vykazHospodareni&ucetniObdobi=2018&mesicRok=04/2018&mena=code:CZK

V prípade odpovede 200 OK dôjde k vygenerovaniu príslušného PDF súboru.

Súvaha a výkaz ziskov a strát v XML

Adresa

/c/firma/rozvaha-vykaz.xml

Parametre (povinné):

  • druh

  • rozsah

  • typ (účtovnej jednotky)

Príklady

Chyba pri nevypočítaní zostavy

GET https://demo.flexibee.eu:5434/c/demo/rozvaha-vykaz.xml?druh=B&rozsah=P&typ=M

400 Bad Request

<?xml version="1.0"?> <success>false</success>

<?xml version="1.0" ?>
<winstrom version="1.0">
<success>false</success>
<message>Pro vygenerování Rozvaha a výkaz zisku a ztráty v XML musí být vypočtené sestavy Rozvaha v plném rozsahu od r. 2018 a Výkaz zisku a ztráty - druhové členění od r.2016.</message>
</winstrom>

Správny request

GET  https://demo.flexibee.eu:5434/c/demo/rozvaha-vykaz.xml?druh=B&rozsah=P&typ=M

200 OK

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Pisemnost nazevSW="ABRA Flexi" verzeSW="2020.3.0.3-SNAPSHOT-20201118-r29393">
<DPPDP8 verzePis="05.01.01">
<VetaD c_nace="582000" c_ufo_cil="451" dapdpp_forma="B" dokument="DP8" k_uladis="DPP" kat_uj="M" typ_dapdpp="A" typ_popldpp="1" typ_zo="A" uv_vyhl="500" zdobd_do="30.06.2019" zdobd_od="01.07.2018"/>
<VetaP c_orient="7b" c_pop="1422" c_pracufo="2005" c_telef="371124340" dic="28019920" naz_obce="Praha 15" opr_jmeno="Stanislav" opr_postaveni="Jednatel" opr_prijmeni="Kurinec" psc="15500" ulice="Jeremiášova 1422/7b" zkrobchjm="ABRA Flexi s.r.o."/>
<VetaO/>
<VetaUA c_radku="1" kc_brutto="0" kc_korekce="0" kc_netto="0" kc_netto_min="0"/>
<VetaUA c_radku="2" kc_brutto="0" kc_korekce="0" kc_netto="0" kc_netto_min="0"/>
<VetaUA c_radku="3" kc_brutto="0" kc_korekce="0" kc_netto="0" kc_netto_min="0"/>
...

<VetaUB c_radku="1" kc_min="13817245.31" kc_sled="3788007.63"/>
<VetaUB c_radku="2" kc_min="0" kc_sled="0"/>
<VetaUB c_radku="3" kc_min="2987294.06" kc_sled="664191.27"/>
...

<VetaUD c_radku="64" kc_min="0" kc_sled="0"/>
<VetaUD c_radku="65" kc_min="0" kc_sled="0"/>
<VetaUD c_radku="66" kc_min="0" kc_sled="0"/>
</DPPDP8>
</Pisemnost>

Výkaz ziskov a strát

Adresa

/c/firma/sestava.pdf

Parametre

report-name

  • vysledovka$$SUM - Výkaz ziskov a strát v zjednodušenom rozsahu

  • vysledovka$$NES - Výkaz ziskov a strát v plnom rozsahu

Príklady

V prípade odpovede 200 OK dôjde k vygenerovaniu príslušného PDF súboru.

V prípade odpovede 200 OK dôjde k vygenerovaniu príslušného PDF súboru.

Prehľad o peňažných tokoch

Adresa

/c/firma/sestava.pdf

Parametre

report-name

  • cashFlow$$NES - Prehľad o peňažných tokoch

  • cashFlow$$MIN_OBDOBI - Prehľad o peňažných tokoch (vrátane údajov za minulé obdobie)

Príklady

V prípade odpovede 200 OK dôjde k vygenerovaniu príslušného PDF súboru.

V prípade odpovede 200 OK dôjde k vygenerovaniu príslušného PDF súboru.

Súvaha

Adresa

/c/firma/sestava.pdf

Parametre

report-name

  • rozvaha$$SUM_ZAKL - Súvaha v základnom rozsahu

  • rozvaha$$SUM - Súvaha v zjednodušenom rozsahu

  • rozvaha$$NES - Súvaha v plnom rozsahu

Príklady

V prípade odpovede 200 OK dôjde k vygenerovaniu príslušného PDF súboru.

V prípade odpovede 200 OK dôjde k vygenerovaniu príslušného PDF súboru.

V prípade odpovede 200 OK dôjde k vygenerovaniu príslušného PDF súboru.

Obratová predvaha

(rovnaký postup platí aj pre výstup Hlavná kniha).

Adresa

/c/firma/obratova-predvaha.pdf

Parametre

Ak nie sú uvedené, predvolená je Obratová predvaha (na výšku) za aktuálne účtovné obdobie.

  • report-name

  • ucetniObdobi - kód účtovného obdobia v tvare s code: (napr. code:2019)

  • koncovyMesicRok - iba obraty do zadaného mesiaca vo formáte MM/yyyy "mesiac/rok" (napr. 06/2019 pre obraty do júna roku 2019)

  • pocetMesicu - počet mesiacov v obrate

  • stredisko - "kod" objektu z evidencie /stredisko (možno použiť viac týchto parametrov - napr. stredisko=code:C&stredisko=code:B)

  • mena - kód meny v tvare s code: (možno použiť viac týchto parametrov - napr. mena=code:CZK&mena=code:EUR)

  • filtrUcty - kódy účtov, prípadne ich prefix alebo rozsah, oddelené čiarkou (napr. 311000,32,3-4)

  • ucet - kód účtu (možno použiť viac týchto parametrov - napr. ucet=code:211001&ucet=code:112001)

Príklady

V prípade odpovede 200 OK dôjde k vygenerovaniu príslušného PDF súboru.

Ste s tem dobili odgovor na svoje vprašanje?