Fiscal Periods
Per-module soft and hard close enforced by the database, flux analysis with reviewed explanations, two-person reopen, consolidation with NCI and the equity method, and year-end close.
Fiscal Periods controls when the books accept postings. Each period closes module by module (AP, AR, payroll, job cost, cash management and GL). The close cockpit runs the task list, flux analysis explains what moved, balance sheet reconciliations prove each account, and the close checklist gathers the evidence a reviewer signs off. Close > Consolidation holds the group structure, intercompany disputes and settlement, and the equity method. Open it from the company app launcher under Accounting > Fiscal Periods; it appears when your accounting access includes it.
- Who uses it
- Controllers close and reopen; a different controller approves the close review; accountants explain variances and prepare consolidation work for a second person to approve.
- When
- Month end, year end and when an audit adjustment lands.
- What it holds
- Fiscal years, periods with per-module status, close reviews, flux explanations and reviews, the ownership tree, intercompany disputes and settlements, equity-method runs, the adjusting period and the year-end closing entry.
Key workflow
- Generate the year. Create a fiscal year and its twelve periods from the configured start month.
- Soft-close, then close. Soft-close a module so only users who can close periods may post, then close it. A closed period refuses postings, enforced again by a database trigger.
- Work the checklist. Resolve the blockers the close reports, such as an ACH correction past its due date or a failed integrity check, review documents self-approved under small-team mode, and record the evidence. A different controller approves the close review.
- Run the close cockpit. Generate the period’s close tasks from a template, for all entities or one. Tasks have owners, reviewers, business-day due dates and dependencies; a task cannot be prepared until its dependencies are reviewed, and its preparer cannot review it. Tasks tied to a subledger tie-out or the reconciliations complete from that evidence. Required tasks can gate the module close they belong to.
- Explain the flux. For each entity and account, flux analysis compares the period with the prior period, the same period last year and the approved budget, split by a required dimension where one applies. Set an amount and a percent threshold (both or either), a materiality floor, and overrides by account type or account. Every row above threshold needs an explanation; a different user reviews it and signs the text and figures. A later posting, a changed comparison or a rewrite makes the review stale. Turn on require flux (off by default) and a GL or whole-period close waits until every row above threshold is explained, reviewed and current.
- Reconcile the balance sheet. The reconciliation workspace covers every balance sheet account by entity and period, rated low, medium or high risk. An account whose subledger tie-out passes with nothing unexplained reconciles automatically, high-risk accounts need two independent reviewers, and posted activity after sign-off makes a reconciliation stale.
- Eliminate and settle intercompany. Post one auto-reversing entry in the elimination entity that nets matched intercompany due-to and due-from balances. Matching runs per entity pair and currency against a tolerance. A mismatch becomes a dispute with an assignee, the responsible entity, comments and a proposed adjusting entry that a second person approves. Settle matched pairs in cash or by netting, prepared by one person and approved by another.
- Consolidate the group. Record who owns whom: effective-dated ownership and voting percent, and the method for each relationship (full, equity, cost or none). Ownership versions are append-only and refused in a closed period. Consolidated statements then compute the noncontrolling interest in net income, OCI and equity, eliminate the parent’s investment, defer unrealized profit on equipment and inventory sold between members until it is depreciated or sold on, and handle entities joining or leaving the group during the year. For an equity-method investee, prepare the period’s share of income and OCI from its books or reported figures; losses stop at a zero carrying amount, and a second person approves before it posts. The Consolidation page links the group reports: the consolidated balance sheet and income statement, the consolidated statement of cash flows, consolidated changes in equity, the worksheet, the NCI roll-forward, equity-method investments and the intercompany reconciliation.
- Close the year. Post the year-end closing entry into retained earnings, balanced per entity. Add period 13 for audit adjustments after later months have closed.
Controls
- Reopening is two-person: one user requests it with a reason and a second user who can close periods confirms it, and both steps are audited. Reopening a period while a later one is closed requires an explicit cascade, which invalidates those close reviews.
- A failed nightly integrity check blocks a hard close.
- The preparer of a flux explanation, an equity-method run, a settlement or a dispute adjustment cannot approve it, and an approval recomputes the evidence and is refused if anything moved.
- Consolidation spans the group, so every consolidation operation refuses a grant limited to some entities or projects.
- Close readiness at scale. On a synthetic 3.35-million-line ledger, full close readiness (every blocker, integrity check, subledger tie-out and close cockpit gate) took 1.6 s median and 1.7 s at the 95th percentile warm, under a 2-second gate; a later re-run measured 1.9 s at the 95th percentile. It was measured on a shared development machine, not production. The speed comes from reading one database snapshot over parallel connections; on a single connection the same check takes 7 to 8 seconds. No close verdict is cached to get there.
Current boundaries
For the full procedure, exceptions and examples, read the Periods and close workflow guide.
API operations
76 operations · 28 read · 48 write · base path /rest/v1.0/companies/{company_id}/accounting
- GET
/close/alert_testsAlert delivery tests - POST
/close/alert_testsSend a test alert - GET
/close/cockpitClose cockpit - POST
/close/cockpit/generateGenerate close tasks - POST
/close/cockpit/syncRefresh close evidence - GET
/close/fluxFlux analysis of a period - POST
/close/flux/explanationsExplain a flux row - GET
/close/flux/explanations/{id}Show a flux explanation - POST
/close/flux/explanations/{id}/reviewReview a flux explanation - GET
/close/flux/settingsFlux settings - PUT
/close/flux/settingsSave flux settings - GET
/close/flux/thresholdsList flux thresholds - POST
/close/flux/thresholdsCreate a flux threshold - PATCH
/close/flux/thresholds/{id}Update a flux threshold - GET
/close/rec_rulesList reconciliation rules - POST
/close/rec_rulesCreate a reconciliation rule - PATCH
/close/rec_rules/{id}Update a reconciliation rule - GET
/close/reconciliationsList account reconciliations - GET
/close/reconciliations/{id}Show an account reconciliation - GET
/close/reconciliations/{id}/attachmentsList attachments on an account reconciliation - POST
/close/reconciliations/{id}/attachmentsAttach a workpaper to an account reconciliation - POST
/close/reconciliations/{id}/itemsAdd a reconciling item or schedule line - PATCH
/close/reconciliations/{id}/items/{item_id}Update or clear a reconciliation item - POST
/close/reconciliations/{id}/preparePrepare an account reconciliation - POST
/close/reconciliations/{id}/reviewReview an account reconciliation - POST
/close/reconciliations/{id}/unsignUnsign an account reconciliation - POST
/close/reconciliations/generateGenerate account reconciliations - GET
/close/settingsClose cockpit settings - PUT
/close/settingsSave close cockpit settings - GET
/close/tasks/{id}Show a close task - POST
/close/tasks/{id}/preparePrepare a close task - POST
/close/tasks/{id}/reviewReview a close task - POST
/close/tasks/{id}/startStart a close task - POST
/close/tasks/{id}/unsignUnsign a close task - GET
/close/templatesList close templates - POST
/close/templatesCreate a close template - GET
/close/templates/{id}Show a close template - PUT
/close/templates/{id}Replace a close template - GET
/consolidation/equity_method/runsList equity-method runs - POST
/consolidation/equity_method/runsPrepare an equity-method run - GET
/consolidation/equity_method/runs/{id}Get an equity-method run - POST
/consolidation/equity_method/runs/{id}/decisionApprove or cancel an equity-method run - GET
/consolidation/ic/disputesList intercompany disputes - POST
/consolidation/ic/disputesRaise an intercompany dispute - GET
/consolidation/ic/disputes/{id}Get an intercompany dispute - POST
/consolidation/ic/disputes/{id}/adjustmentPropose the adjusting entry - POST
/consolidation/ic/disputes/{id}/assignAssign an intercompany dispute - POST
/consolidation/ic/disputes/{id}/commentsComment on an intercompany dispute - POST
/consolidation/ic/disputes/{id}/decisionApprove or reject the adjusting entry - POST
/consolidation/ic/disputes/{id}/resolveResolve or withdraw an intercompany dispute - GET
/consolidation/ic/settlementsList intercompany settlement runs - POST
/consolidation/ic/settlementsPrepare an intercompany settlement - GET
/consolidation/ic/settlements/{id}Get an intercompany settlement run - POST
/consolidation/ic/settlements/{id}/decisionApprove or cancel an intercompany settlement - GET
/consolidation/ic/transfersList intercompany asset transfers - POST
/consolidation/ic/transfersRegister an intercompany asset transfer - GET
/consolidation/ic/transfers/{id}Get an intercompany asset transfer - POST
/consolidation/ic/transfers/{id}/eventsRecord a sale on or a disposal - POST
/consolidation/ic/transfers/{id}/voidVoid an intercompany asset transfer - GET
/consolidation/ownershipList ownership versions - POST
/consolidation/ownershipRecord an ownership version - GET
/consolidation/ownership/{id}Get an ownership version - POST
/consolidation/ownership/{id}/voidVoid an ownership version - GET
/consolidation/settingsConsolidation settings - PATCH
/consolidation/settingsUpdate consolidation settings - GET
/consolidation/structureConsolidation group on a date - POST
/fiscal_yearsGenerate a fiscal year - POST
/fiscal_years/{id}/adjusting_periodAdd the adjusting period (period 13) - POST
/fiscal_years/{id}/year_end_closePost the year-end close - POST
/fiscal_years/{id}/year_end_close/reverseReverse the year-end close - GET
/periodsList fiscal periods - GET
/periods/{id}Show a fiscal period - POST
/periods/{id}/closeClose or soft-close a period - POST
/periods/{id}/eliminate_intercompanyEliminate intercompany at a period end - POST
/periods/{id}/reopenReopen a period - POST
/periods/rebuild_balancesRebuild period balance snapshots
Parameters, request and response fields, errors and a generated example for each operation are in the REST reference for this app. Read scopes, step-up and permissions in the Accounting API guide.
Keep exploring
Related across os.construction
- DocsClose the monthClose company periods with the close cockpit, flux review, account reconciliations, consolidation and independent approval of the close checklist.
- GlossaryIntercompany transactionA transaction between two legal entities in the same group, such as an equipment company billing an operating company, recorded in both entities' books with due-to and due-from balances.
- GlossaryFiscal periodA defined slice of the fiscal year, usually a month, that entries post into and that can be opened, soft-closed or closed.
- DocsFinancial reportsReview company financial statements and understand reconciliation coverage.
- BlogHow to close the month in construction accounting: a step list from cutoff to lockA construction month-end close gets every cost and every billing into the right month, proves cash and the subledgers against the ledger, updates the WIP schedule from current cost-to-complete, has someone else review it, and then locks the period. Here is the step list, an example close calendar and a worked example of what one late invoice does to WIP.
- BlogYour first accounting cycle: setup, transactions and closeA practical learning path through the Accounting module's apps, with the people, evidence and review gates needed from opening balances to month-end.
Was this helpful?
Run it on your own project.
Start a 14-day free trial. Want a say in what ships next? Join the founding program.
14-day free trial. Pricing for paid plans isn't set yet. Talk to us. Already have an account? Sign in →