GET
View official balance sheet (client account)
Client space Accounting module For: Accountant, Administrator · Permission: journal_entries.viewreports Conditions
  • The accounting module must be part of the organization’s plan.
  • In the organization space, the caller must have access to the book.
  • The fiscal_year_id is required and must be a fiscal year of the book.
  • An account with activity that no line of the statement layout claims makes the call fail with a business-rule error naming the account, rather than silently leaving it out.
Part of Official annual statements.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

fiscal_year_id
string
required

Identifier of the fiscal year to report on (27-character KSUID string). Required. It must be a fiscal year of the selected book; a year of another book fails validation.

with_accounts
boolean | null

Opt-in so a filed statement keeps the plain document, without the per-line detail.

Response

book
object
required

The book (accounting owner) the statement was computed for.

fiscal_year
object
required

The fiscal year the statement covers, as requested by fiscal_year_id.

prior_fiscal_year
object | null
required

The fiscal year of the same book that ended before this one started (the most recent one), used for the N-1 comparative column. Null when the book has no earlier year.

lines
tuple
required

Lines of the official balance sheet, in layout order, each with code, label, note reference, section, level (line or subtotal), brut, amort, net and net_n_1, plus an accounts list (account_id, code, name, signed debit-minus-credit balance) only when with_accounts is true. Amounts are integers in minor units. Totals of the actif and passif sections are summed from the lines of level 'line' only.

result
object
required

The provisional result: balances still sitting in result classes 6, 7 and 8 that have not been posted to the result accounts. It is added to the result line so the balance sheet can balance.

totals
object
required

Totals of the balance sheet sides, computed from the lines.

coherence
object
required

Balance check of the statement: total_actif, total_passif and ok. A mismatch is reported here, not refused.

currency_code
string
required

ISO currency code of the fiscal year. All amounts of the response are in this currency.

currency_exponent
integer
required

Number of decimal places of the currency (0 for XOF). An amount in minor units divided by 10 to this power gives the amount in the currency.