Preskoči na glavno vsebino

API pre účtovné stavy a pohyby za minulé obdobia

Výber účtovného obdobia pri stavoch účtov, pohyboch na účtoch a obratovej predvahe

Avtor: Petr Pech

Účtovné výstupy — stavy účtov, pohyby na účtoch aj obratovú predvahu — možno cez REST API čítať rovnako ako ktorúkoľvek inú evidenciu. Líši sa len spôsob, akým sa pri nich vyberá účtovné obdobie.


Stavy účtov

Bez ďalších parametrov vráti evidencia stav-uctu stavy pre obdobie platné k dnešnému dňu. Iné obdobie sa vyberá parametrom:

Adresa

Čo vráti

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

Aktuálne účtovné obdobie.

…/stav-uctu.xml?ucetniObdobi=2024

Obdobie podľa skratky.

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

Obdobie podľa identifikátora; má prednosť pred ucetniObdobi.

…/stav-uctu.xml?groupByStredisko=true

Stavy členené podľa stredísk.

…/stav-uctu.xml?groupByCinnost=true

Stavy členené podľa činností.

Filtrovanie funguje bežným spôsobom, takže stav jedného konkrétneho účtu získate takto:

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

⚠️ Skratka obdobia musí existovať — neznáma hodnota v ucetniObdobi skončí odpoveďou 404. Zoznam období vydá evidencia ucetni-obdobi.


Pohyby na účtoch

Evidencia pohyb-na-uctech parameter pre účtovné obdobie nemá — obdobie sa vyberá filtrom cez dátum:

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

Pre výber účtovného obdobia býva presnejšie datUcto (dátum zaúčtovania) než datVyst. Každý riadok nesie aj pole postingPeriod v tvare 2024/10, podľa ktorého sa dá výstup ďalej triediť.


Obratová predvaha

Obratová predvaha má účtovné obdobie priamo ako vlastnosť, takže sa filtruje:

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

ℹ️ Parameter ?ucetniObdobi= pri obratovej predvahe nefunguje — vracia 404. Platí len pri stavoch účtov; pri predvahe použite filter, ako je uvedené vyššie.

💡 Filtre v adrese musia byť zakódované — medzera ako %20, znak < ako %3C. Nezakódovaný filter vráti namiesto dát HTML stránku.


Súvisiace

Ste s tem dobili odgovor na svoje vprašanje?