Accounting periods execution
Read the exact action guide for prerequisites, identifier discovery, supported input, effects, captured successful and refused responses, verification and recovery. Synthetic fixture results do not authorize a live mutation or establish a provider outcome.
- List accounting periods: List the monthly accounting periods and their lock status, optionally for one fiscal year.
- Lock an accounting period: Soft-lock (override possible) or hard-lock (nothing posts) a YYYY-MM period. Postings into a locked period are refused with period_locked.
- Unlock an accounting period: Reopen a locked period. The reopen is audited.
- Get month-end close health: What still stands between a month and a clean close: ledger chain verified, unmatched bank lines, draft journals, reversals and recurring journals due, draft invoices and bills, unsent invoices, overdue receivables, the period lock and (in the last month of the year) whether the year end is closed. Each signal carries a count, the money it holds and the screen that clears it, plus the period's sign-off checklist and an overall readiness of ready, attention or blocked.
- Get the continuous-close dashboard: Summarise the current close and up to twelve recent accounting periods: readiness, outstanding signals, checklist progress, and the three highest-priority actions for this week. This is the same live close overview shown on the Books Periods page.
- Sign off a month-end checklist item: Tick or untick one item of a period's month-end checklist (bank_reconciled, receipts_attached, accruals_posted, invoices_issued, tax_reviewed, statements_reviewed) with an optional note. Recorded with who did it and when, and written to the audit trail.
- List fiscal years: List every fiscal year the books touch with its dates, how many periods it holds and are locked, whether it has been closed, and the close journal with the profit it moved to retained earnings.
- Close a fiscal year: Post the year-end close: every income and expense balance still open through the last day of the year moves to retained earnings in one journal dated that day. Refused with fiscal_year_in_progress before the year has ended and nothing_to_close when no balance remains. A year already closed returns the standing close (alreadyClosed true) rather than a second one.
- Reopen a fiscal year: Reverse the year-end close so adjustments can be posted, then close the year again. Refused with fiscal_year_not_closed when there is no close to reverse.
Evidence
Actual Books route handlers and the exported Worker were exercised against five local SQLite D1 concern databases with all committed migrations, the real posting Durable Object and local R2. Route captures use synthetic verified Auth; Worker captures use synthetic Auth transports. Nexus, Brand, Notify, Pay, Mercury and Xero responses are explicitly simulated at the provider transport boundary. Captures prove local request/response behavior and canonical SDK projection, not live bank access, payment movement, email delivery, provider eligibility, tax compliance, encrypted custody, scheduled execution, deployment or production completion. Fixture identities, credentials, addresses and records authorize no live operation.