Esc

↑↓ move↵ openIndex · Pagefind
Accounting apps / Fiscal Periods

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.

On this page

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

  1. Generate the year. Create a fiscal year and its twelve periods from the configured start month.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
  7. 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.
  8. 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.
  9. 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

  1. GET /close/alert_testsAlert delivery tests
  2. POST /close/alert_testsSend a test alert
  3. GET /close/cockpitClose cockpit
  4. POST /close/cockpit/generateGenerate close tasks
  5. POST /close/cockpit/syncRefresh close evidence
  6. GET /close/fluxFlux analysis of a period
  7. POST /close/flux/explanationsExplain a flux row
  8. GET /close/flux/explanations/{id}Show a flux explanation
  9. POST /close/flux/explanations/{id}/reviewReview a flux explanation
  10. GET /close/flux/settingsFlux settings
  11. PUT /close/flux/settingsSave flux settings
  12. GET /close/flux/thresholdsList flux thresholds
  13. POST /close/flux/thresholdsCreate a flux threshold
  14. PATCH /close/flux/thresholds/{id}Update a flux threshold
  15. GET /close/rec_rulesList reconciliation rules
  16. POST /close/rec_rulesCreate a reconciliation rule
  17. PATCH /close/rec_rules/{id}Update a reconciliation rule
  18. GET /close/reconciliationsList account reconciliations
  19. GET /close/reconciliations/{id}Show an account reconciliation
  20. GET /close/reconciliations/{id}/attachmentsList attachments on an account reconciliation
  21. POST /close/reconciliations/{id}/attachmentsAttach a workpaper to an account reconciliation
  22. POST /close/reconciliations/{id}/itemsAdd a reconciling item or schedule line
  23. PATCH /close/reconciliations/{id}/items/{item_id}Update or clear a reconciliation item
  24. POST /close/reconciliations/{id}/preparePrepare an account reconciliation
  25. POST /close/reconciliations/{id}/reviewReview an account reconciliation
  26. POST /close/reconciliations/{id}/unsignUnsign an account reconciliation
  27. POST /close/reconciliations/generateGenerate account reconciliations
  28. GET /close/settingsClose cockpit settings
  29. PUT /close/settingsSave close cockpit settings
  30. GET /close/tasks/{id}Show a close task
  31. POST /close/tasks/{id}/preparePrepare a close task
  32. POST /close/tasks/{id}/reviewReview a close task
  33. POST /close/tasks/{id}/startStart a close task
  34. POST /close/tasks/{id}/unsignUnsign a close task
  35. GET /close/templatesList close templates
  36. POST /close/templatesCreate a close template
  37. GET /close/templates/{id}Show a close template
  38. PUT /close/templates/{id}Replace a close template
  39. GET /consolidation/equity_method/runsList equity-method runs
  40. POST /consolidation/equity_method/runsPrepare an equity-method run
  41. GET /consolidation/equity_method/runs/{id}Get an equity-method run
  42. POST /consolidation/equity_method/runs/{id}/decisionApprove or cancel an equity-method run
  43. GET /consolidation/ic/disputesList intercompany disputes
  44. POST /consolidation/ic/disputesRaise an intercompany dispute
  45. GET /consolidation/ic/disputes/{id}Get an intercompany dispute
  46. POST /consolidation/ic/disputes/{id}/adjustmentPropose the adjusting entry
  47. POST /consolidation/ic/disputes/{id}/assignAssign an intercompany dispute
  48. POST /consolidation/ic/disputes/{id}/commentsComment on an intercompany dispute
  49. POST /consolidation/ic/disputes/{id}/decisionApprove or reject the adjusting entry
  50. POST /consolidation/ic/disputes/{id}/resolveResolve or withdraw an intercompany dispute
  51. GET /consolidation/ic/settlementsList intercompany settlement runs
  52. POST /consolidation/ic/settlementsPrepare an intercompany settlement
  53. GET /consolidation/ic/settlements/{id}Get an intercompany settlement run
  54. POST /consolidation/ic/settlements/{id}/decisionApprove or cancel an intercompany settlement
  55. GET /consolidation/ic/transfersList intercompany asset transfers
  56. POST /consolidation/ic/transfersRegister an intercompany asset transfer
  57. GET /consolidation/ic/transfers/{id}Get an intercompany asset transfer
  58. POST /consolidation/ic/transfers/{id}/eventsRecord a sale on or a disposal
  59. POST /consolidation/ic/transfers/{id}/voidVoid an intercompany asset transfer
  60. GET /consolidation/ownershipList ownership versions
  61. POST /consolidation/ownershipRecord an ownership version
  62. GET /consolidation/ownership/{id}Get an ownership version
  63. POST /consolidation/ownership/{id}/voidVoid an ownership version
  64. GET /consolidation/settingsConsolidation settings
  65. PATCH /consolidation/settingsUpdate consolidation settings
  66. GET /consolidation/structureConsolidation group on a date
  67. POST /fiscal_yearsGenerate a fiscal year
  68. POST /fiscal_years/{id}/adjusting_periodAdd the adjusting period (period 13)
  69. POST /fiscal_years/{id}/year_end_closePost the year-end close
  70. POST /fiscal_years/{id}/year_end_close/reverseReverse the year-end close
  71. GET /periodsList fiscal periods
  72. GET /periods/{id}Show a fiscal period
  73. POST /periods/{id}/closeClose or soft-close a period
  74. POST /periods/{id}/eliminate_intercompanyEliminate intercompany at a period end
  75. POST /periods/{id}/reopenReopen a period
  76. 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

Run it on your own project.

Start a 14-day free trial. Want a say in what ships next? Join the founding program.

Your role (optional)

14-day free trial. Pricing for paid plans isn't set yet. Talk to us. Already have an account? Sign in →

Ask the OS

Reading this page

Ask anything about this page. Answers use what you're reading as context.

Suggested

    AI · may be imperfect · sample data where shown

    Open file