Přeskočit na hlavní obsah

Účetní stavy a pohyby za minulá období přes API

Výběr účetního období u stavů účtů, pohybů na účtech a obratové předvahy

Autor: Petr Pech

Účetní výstupy — stavy účtů, pohyby na účtech i obratovou předvahu — lze přes REST API číst stejně jako jakoukoli jinou evidenci. Liší se jen způsob, jakým se u nich vybírá účetní období.


Stavy účtů

Bez dalších parametrů vrátí evidence stav-uctu stavy pro období platné k dnešnímu dni. Jiné období se vybírá parametrem:

Adresa

Co vrátí

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

Aktuální účetní období.

…/stav-uctu.xml?ucetniObdobi=2024

Období podle zkratky.

…/stav-uctu.xml?idUcetniObdobi=code:2024

Období podle identifikátoru; má přednost před ucetniObdobi.

…/stav-uctu.xml?groupByStredisko=true

Stavy členěné po střediscích.

…/stav-uctu.xml?groupByCinnost=true

Stavy členěné po činnostech.

Filtrace funguje běžným způsobem, takže stav jednoho konkrétního účtu vytáhnete takto:

GET /c/{firma}/stav-uctu/(ucet='code:311001').xml?idUcetniObdobi=code:2024

⚠️ Zkratka období musí existovat — neznámá hodnota v ucetniObdobi skončí odpovědí 404. Seznam období vydá evidence ucetni-obdobi.


Pohyby na účtech

Evidence pohyb-na-uctech parametr pro účetní období nemá — období se vybírá filtrem přes datum:

GET /c/{firma}/pohyb-na-uctech/(datVyst < 2019-01-01).xml?detail=full

GET /c/{firma}/pohyb-na-uctech/(datUcto < 2019-01-01).xml?detail=full

Pro výběr účetního období bývá přesnější datUcto (datum zaúčtování) než datVyst. Každý řádek nese i pole postingPeriod ve tvaru 2024/10, podle kterého se dá výstup dál třídit.


Obratová předvaha

Obratová předvaha má účetní období přímo jako vlastnost, takže se filtruje:

GET /c/{firma}/obratova-predvaha/(ucetniObdobi='code:2026').xml?detail=full

ℹ️ Parametr ?ucetniObdobi= u obratové předvahy nefunguje — vrací 404. Platí jen u stavů účtů; u předvahy použijte filtr, jak je uvedeno výše.

💡 Filtry v adrese musí být zakódované — mezera jako %20, znak < jako %3C. Nezakódovaný filtr vrátí místo dat HTML stránku.


Související

Dostali jste odpověď na svou otázku?