Přeskočit na hlavní obsah

Stavy účtů

Jak vyvolat výstup stavů účtu přes REST API?

Autor: Petr Pech

Přes REST API lze získat účetní výstup „Stavy účtů". Chceme-li získat stavy účtů pro účetní období platné k aktuálnímu datu, použijeme následující URL:

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

Lze použít i úroveň detailu a filtraci.


Volba účetního období

Pokud potřebujeme stavy 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í:

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

Další možností je parametr idUcetniObdobi, který umožňuje využití identifikátorů účetního období — tedy jak interní ID, tak zápis code:. 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. Oba parametry lze zkombinovat.

ℹ️ Pole stredisko a cinnost jsou součástí výstupu při detail=full. Bez členění obsahují hodnotu z účtu, s členěním určují, ke kterému středisku či činnosti daný řádek patří.


Příklady použití

URL

Popis

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

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

/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ě


Související

Dostali jste odpověď na svou otázku?