Skip to main content

Account States

How to trigger account status output via REST API?

Written by Lenka Haringerová

The "Account Balances" accounting output can be obtained via the REST API. To get account balances for the accounting period valid as of the current date, use the following URL:

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

You can also use detail levels and filtering.


Selecting the accounting period

If you need balances for an accounting period other than the current one, you must add the ucetniObdobi parameter to the URL. The value of this parameter is the code of the desired accounting period:

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

Another option is the idUcetniObdobi parameter, which allows the use of identifiers for the accounting period — both the internal ID and the code: notation. If this parameter is used, it takes precedence over the ucetniObdobi parameter.


Breaking down account balances

Account balances can be broken down by cost center using the groupByStredisko=true parameter, or by activity using groupByCinnost=true. Each line will then contain the account balance for a specific cost center or activity. Both parameters can be combined.

ℹ️ The stredisko and cinnost fields are part of the output when detail=full is used. Without breakdown, they contain the value from the account; with breakdown, they indicate which cost center or activity the given line belongs to.


Usage examples

URL

Description

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

Account balances for the current accounting period

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

Account balances for the accounting period with ID 3

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

Account balances for the accounting period with the code 2016

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

Account balances for the accounting period with the code 2016

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

Account balances broken down by cost center

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

Account balances broken down by activity

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

Account balances broken down by both cost center and activity simultaneously


Related

Did this answer your question?