Přeskočit na hlavní obsah

Účetní výstupy v REST API

Jakým způsobem generovat účetní výstupy v API?

Petr Pech avatar
Autor: Petr Pech
Aktualizováno před více než 2 týdny

Účetní výstupy není nutno generovat pouze přes desktopovou aplikaci či webové rozhraní. Stejně tak, jako ostatní data, je můžete získat pomocí REST API ABRA Flexi.

V dokumentaci naleznete veškeré nové účetní výstupy s možností generace přes REST API. Účetní výstupy lze generovat jak do PDF, tak do XLS (a to včetně tiskových sestav, viz dokumentace).

Stavy účtů

Adresa

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

Parametry

Pokud potřebujeme stavu pro jiné než aktuální účetní období je nutné do URL doplnit parametr ucetniObdobi. Hodnotou tohoto parametru je zkratka požadovaného účetního období. Výsledné URL tedy bude vypadat například .../c/{firma}/stav-uctu[.xml]?ucetniObdobi=2016.

Další možností, jak získat stavy účtů pro jiné než aktuální účetní období, je doplnit parametr idUcetniObdobi. Tento parametr umožňuje využití identifikátorů účetního období. Pokud je tento parametr použit, má přednost před parametrem ucetniObdobi.

Členění stavů účtů

Stavy účtů lze dělit podle středisek pomocí parametru groupByStredisko=true nebo podle činností pomocí groupByCinnost=true. Každý řádek pak bude obsahovat stav účtu pro konkrétní středisko nebo činnost.

Příklady použití

URL

Popis

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

Stavy účtů pro aktuální účetní obdobi

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

Stavy účtů pro účetní období s ID 3

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

Stavy účtů pro účetní období se zkratkou 2016

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

Stavy účtů pro účetní období se zkratkou 2016

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

Stavy účtů členěné podle středisek

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

Stavy účtů členěné podle činností

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

Stavy účtů členěné podle středisek i činností současně

Souhrnné hlášení k DPH

Adresa

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

firma - nahraďte za identifikátor firmy

Parametry

Dva parametry pro období jsou vždy povinné (buďto rok a ctvrtleti, nebo rok a mesic).

  • rok - rok přiznání (např. 2018)

  • ctvrtleti - pro čtvrtletní podání (hodnoty 1 až 4)

  • mesic - pro měsíční podání (hodnoty 1 až 12)

  • statId - stát pro zpracování přiznání (id objektu z evidence /stat), výchozí je stát legislativy z nastavení firmy

Příklady

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

V případě odpovědi 200 OK dojde k vygenerování příslušného PDF souboru.

Účetní analýza zakázky

Adresa

/c/firma/analyza-zakazky.pdf

firma - nahraďte za identifikátor firmy

Parametry

Povinné jsou pouze parametry období (uctovaniOd a uctovaniDo).

  • report-name - výchozí je analyzaZakazky, pokud není parametr uveden

  • uctovaniOd - počáteční datum účtování ve formátu "yyyy-MM-dd" (např. 2017-01-01)

  • uctovaniDo - koncový datum účtování ve formátu "yyyy-MM-dd" (např. 2017-12-31)

  • zakazka - "kod" objektu z evidence /zakazka (lze použít více těchto parametrů - např. zakazka=code:ZAK1&zakazka=code=ZAK2)

  • stredisko - "kod" objektu z evidence /stredisko (lze použít více těchto parametrů - např. stredisko=code:C&stredisko=code:B)

  • cinnost - "kod" objektu z evidence /cinnost (lze použít více těchto parametrů - např. cinnost=code:1&cinnost=code:2)

Příklady

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

V případě odpovědi 200 OK dojde k vygenerování příslušného PDF souboru.

Neuhrazené pohledávky/závazky po splatnosti

Adresa

/c/firma/po-splatnosti.pdf

firma - nahraďte za identifikátor firmy

Parametry

Pokud jsou uvedeny parametry rozmezi1-6, musí být každá hodnota stejná nebo větší, než hodnota předešlá. Parametr datumVypoctu je povinný.

  • report-name - výchozí je poSplatnosti, pokud není parametr uveden

  • datumVypoctu - datum výpočtu reportu ve formátu "yyyy-MM-dd" (např. 2018-09-01)

  • modul - kódy účetních modulů (FAP, FAV, PHL, ZAV), lze použít více těchto parametrů - např. modul=FAV&modul=PHL

  • rozmezi1 - rozmezí splatností ve dnech (výchozí 30)

  • rozmezi2 - rozmezí splatností ve dnech (výchozí 60)

  • rozmezi3 - rozmezí splatností ve dnech (výchozí 90)

  • rozmezi4 - rozmezí splatností ve dnech (výchozí 180)

  • rozmezi5 - rozmezí splatností ve dnech (výchozí 360)

  • rozmezi6 - rozmezí splatností ve dnech (výchozí 720)

Příklady

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

V případě odpovědi 200 OK dojde k vygenerování příslušného PDF souboru.

Soupis nákladů a výnosů

Adresa

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

firma - nahraďte za identifikátor firmy

Parametry

  • report-name

  • ucetniObdobi - kód účetního období (např. 2018), výchozí je aktuální účetní období

  • filtrUcty - kódy účtů, případně jejich prefix nebo rozsah, oddělené čárkou (např. 311000,32,3-4)

  • ucet - kód účtu (lze použít více těchto parametrů - např. ucet=code:211001&ucet=code:112001)

  • danoveUcty - pokud není uveden, jsou zahrnuty daňové i nedaňové účty

  • stredisko - "kod" objektu z evidence /stredisko (lze použít více těchto parametrů - např. stredisko=code:C&stredisko=code:B)

  • cinnost - "kod" objektu z evidence /cinnost (lze použít více těchto parametrů - např. cinnost=code:1&cinnost=code:2)

  • mena - kód měny (lze použít více těchto parametrů - např. mena=code:CZK&mena=code:EUR)

  • groupByStredisko - true / false (aktivuje / deaktivuje členění dle středisek)

  • groupByCinnost - true / false (aktivuje / deaktivuje členění dle činností)

Příklady

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

V případě odpovědi 200 OK dojde k vygenerování příslušného PDF souboru.

Soupis aktiv a pasiv

Adresa

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

firma - nahraďte za identifikátor firmy

Parametry

  • report-name

  • ucetniObdobi - kód účetního období (např. 2018), výchozí je aktuální účetní období

  • filtrUcty - kódy účtů, případně jejich prefix nebo rozsah, oddělené čárkou (např. 311000,32,3-4)

  • ucet - kód účtu (lze použít více těchto parametrů - např. ucet=code:211001&ucet=code:112001)

  • stredisko - "kod" objektu z evidence /stredisko (lze použít více těchto parametrů - např. stredisko=code:C&stredisko=code:B)

  • cinnost - "kod" objektu z evidence /cinnost (lze použít více těchto parametrů - např. cinnost=code:1&cinnost=code:2)

  • mena - kód měny (lze použít více těchto parametrů - např. mena=code:CZK&mena=code:EUR)

  • groupByStredisko - true / false (aktivuje / deaktivuje členění dle středisek)

  • groupByCinnost - true / false (aktivuje / deaktivuje členění dle činností)

Příklady

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

V případě odpovědi 200 OK dojde k vygenerování příslušného PDF souboru.

Výkaz hospodaření

Adresa

/c/firma/vykaz-hospodareni.pdf

firma - nahraďte za identifikátor firmy

Parametry

  • report-name - hodnota vykazHospodareni (povinná)

  • ucetniObdobi - kód účetního období (např. 2018), výchozí je aktuální účetní období

  • filtrUcty - kódy účtů, případně jejich prefix nebo rozsah, oddělené čárkou (např. 311000,32,3-4)

  • ucet - kód účtu (lze použít více těchto parametrů - např. ucet=code:211001&ucet=code:112001)

  • mesicRok - měsíc a rok ve formátu "mm/yyyy” (měsíc hodnoty 1-12, rok odpovídající účetnímu období) - např. 04/2018 (parametr je povinný)

  • stredisko - "kod" objektu z evidence /stredisko (lze použít více těchto parametrů - např. stredisko=code:C&stredisko=code:B)

  • cinnost - "kod" objektu z evidence /cinnost (lze použít více těchto parametrů - např. cinnost=code:1&cinnost=code:2)

  • mena - kód měny (lze použít více těchto parametrů - např. mena=code:CZK&mena=code:EUR)

Příklady

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

V případě odpovědi 200 OK dojde k vygenerování příslušného PDF souboru.

Rozvaha a výkaz zisku a ztráty v XML

Adresa

/c/firma/rozvaha-vykaz.xml

Parametry (povinné):

  • druh

  • rozsah

  • typ (účetní jednotky)

Příklady

Chyba při nevypočtení sestavy

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ávný 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 zisku a ztráty

Adresa

/c/firma/sestava.pdf

Parametry

report-name

  • vysledovka$$SUM - Výkaz zisku a ztráty ve zjednodušeném rozsahu

  • vysledovka$$NES - Výkaz zisku a ztráty v plném rozsahu

Příklady

V případě odpovědi 200 OK dojde k vygenerování příslušného PDF souboru.

V případě odpovědi 200 OK dojde k vygenerování příslušného PDF souboru.

Přehled o peněžních tocích

Adresa

/c/firma/sestava.pdf

Parametry

report-name

  • cashFlow$$NES - Přehled o peněžních tocích

  • cashFlow$$MIN_OBDOBI - Přehled o peněžních tocích (včetně údajů za minulé období)

Příklady

V případě odpovědi 200 OK dojde k vygenerování příslušného PDF souboru.

V případě odpovědi 200 OK dojde k vygenerování příslušného PDF souboru.

Rozvaha

Adresa

/c/firma/sestava.pdf

Parametry

report-name

  • rozvaha$$SUM_ZAKL - Rozvaha v základním rozsahu

  • rozvaha$$SUM - Rozvaha ve zjednodušeném rozsahu

  • rozvaha$$NES - Rozvaha v plném rozsahu

Příklady

V případě odpovědi 200 OK dojde k vygenerování příslušného PDF souboru.

V případě odpovědi 200 OK dojde k vygenerování příslušného PDF souboru.

V případě odpovědi 200 OK dojde k vygenerování příslušného PDF souboru.

Obratová předvaha

Adresa

/c/firma/obratova-predvaha.pdf

Parametry

Pokud nejsou uvedeny, tak je výchozí Obratová předvaha (na výšku) za aktuální účetní období.

  • report-name

  • ucetniObdobi - kód účetního období ve tvaru s code: (např. code:2019)

  • koncovyMesicRok - pouze obraty do zadaného měsíce ve formátu MM/yyyy “měsíc/rok” (např. 06/2019 pro obraty do června roku 2019)

  • pocetMesicu - počet měsíců v obratu

  • stredisko - "kod" objektu z evidence /stredisko (lze použít více těchto parametrů - např. stredisko=code:C&stredisko=code:B)

  • mena - kód měny ve tvaru s code: (lze použít více těchto parametrů - např. mena=code:CZK&mena=code:EUR)

  • filtrUcty - kódy účtů, případně jejich prefix nebo rozsah, oddělené čárkou (např. 311000,32,3-4)

  • ucet - kód účtu (lze použít více těchto parametrů - např. ucet=code:211001&ucet=code:112001)

Příklady

GET https://demo.flexibee.eu:5434/c/demo/obratova-predvaha.pdf?report-name=Predvaha&ucetniObdobi=code:2020&koncovyMesicRok=06/2020&pocetMesicu=12&stredisko=1&mena=code:USD&filtrUcty=3&ucet=code:211001&ucet=code:112001

V případě odpovědi 200 OK dojde k vygenerování příslušného PDF souboru.

Dostali jste odpověď na svou otázku?