accounting-settings

Build Balance Sheet From Gl

Build the closing balance sheet of a Zeno-closed FY from the posted GL (accountant).

The GL → snapshot bridge (gap #14, doc/pipeline.md §"Opening balances"): a company that ran the year inside Zeno and sealed it produces the accepted prior-year balance_sheet_snapshot the opening-entries generator requires — no upload. First sheet for the FY → accepted; a different accepted sheet exists → a proposed snapshot + pending change set (consent in the change-set UI); repeat click → hash-idempotent no-op (the existing snapshot is returned). 409 when the year is still open, the trial balance is unbalanced, or non-zero unclassified accounts exist; 404 when the FY has no GL calendar.

post/companies/{company_id}/balance-sheets/from-gl

Request

Base URL: https://app.zeno-works.ch (the document declares no server; this is the origin it was published from)
URL: https://app.zeno-works.ch/companies/{company_id}/balance-sheets/from-gl
Auth: none declared

Path parameters

company_idstring required

Headers

authorizationstring nullable

Cookies

access_tokenstring nullable

Request body

fiscal_yearinteger required

Response

Successful Response

idstring required

company_idstring required

fiscal_yearinteger required

as_of_datestring date nullable

currencystring required

status'accepted' | 'proposed' | 'superseded' | 'founding' required

Lifecycle of a balance-sheet snapshot.

accepted is the single live snapshot per (company, fiscal_year); proposed is a consent-gated replacement awaiting the user's decision; superseded is a retired snapshot (replaced by a newer accepted one, or a discarded proposal).

founding (ZCT-843) is a different KIND of sheet, not a lifecycle stage of a closing sheet: the founding balance sheet (Gründungsbilanz) a newly founded company's FIRST fiscal year opens from, filed under that year. It is deliberately a status value: every reader of "the accepted sheet of year N" — the consent lifecycle, the one-accepted-per-year index, the next year's opening, reconciliation, staleness — filters accepted/proposed, so none of them can ever take a founding sheet for a closing one. At most one is live per company; a replacement marks it superseded.

sourcestring required

source_document_idstring nullable

totalsobject

snapshot_hashstring required

created_atstring date-time required

superseded_atstring date-time nullable

resolution_jsonobject nullable

equity_rolesobject nullable

Changes

No recorded changes to this operation across all 1 revision of this API.