gl-actions

Reopen Gl Period

Reopen a closed period so a correction can be booked — accountant, reason required.

The explicit way back down the period-status ladder (ZET-161): returns a soft_closed/closed/year_closed period to open so postings dated inside it are accepted again. This is a correction tool, not an undo button — every reopen is recorded durably in the close-run ledger (GET …/gl/close-runs: status reopened, who, when, and your required reason), and the expectation is reopen → book the correction → re-close it with gl_period_close_run (or with close_gl_period, the same close), which writes a fresh balance-snapshot generation that supersedes the pre-correction one.

Refusals:

  • 409 — the fiscal year is sealed. Unseal it first (POST …/gl/fiscal-years/{fiscal_year_id}/unseal); unsealing reopens the year but leaves every period closed — this operation is the per-period second step. Re-seal after re-closing.
  • 409 — the period is already open.
  • 409 — a filed/paid/corrected VAT return covers the period, unless acknowledge_vat_sealed=true. VAT sealing has no undo, so this is an acknowledgement rather than a hard wall: VAT-bearing postings into the window stay individually guarded (manual ones refused, automated ones carry their declaration forward to the next open VAT window), so acknowledge only when the correction is VAT-neutral. The acknowledgement lands in the run's record.

Know the aftermath: a posting made after reopening draws the next journal number (out of date order — numbering gaps and ordering are tolerated by design), the superseded balance snapshot stays until the re-close writes a new generation, and statements always recompute live. A year_closed period comes back as closed on a default re-close — pass new_status=year_closed to restore it, and re-run the year-end steps (balance-sheet bridge, seal) if the correction changed the year's numbers.

post/companies/{company_id}/gl/periods/{period_id}/reopen

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}/gl/periods/{period_id}/reopen
  • Auth: none declared

Path parameters

company_idstring required
period_idstring required

Headers

authorizationstring nullable

Cookies

access_tokenstring nullable

Request body

reasonstring required
acknowledge_vat_sealedboolean

Response

Successful Response

idstring required
company_idstring required
period_idstring required
statusstring required
reasonstring nullable
started_bystring nullable
started_atstring date-time nullable
completed_atstring date-time nullable

Changes

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