---
id: SCR-ACC-CLS-004
title: Close History
route: '/console/{tenantId}/accounting/close/history'
surface: console
product_area: accounting
module: close
revision: 1
status: draft
design_intent: proposed
implementation_evidence: observed
inference: []
source_sha:
  react-console: baf6dae382d6f41dce976c7f848667ccc37e076f
  services-accounting: f47cb263875bbc0c5640fba7dae6785ec32695f8
purpose: >-
  Find calendar state and past close or reopen requests across business units,
  within the adapter’s history limits.
supports:
  - JNY-ACC-CLS-001
  - JNY-ACC-CLS-003
  - CAP-ACC-CLS-001
  - CAP-ACC-CLS-013
  - CAP-ACC-CLS-014
  - CAP-ACC-CLS-011
permission: accounting.fiscal-periods.read (the close layout's guard)
entry_from:
  - '/console/{tenantId}/accounting/close (more actions: View Close History)'
  - '/console/{tenantId}/accounting/close/years/{fiscalYearId} (breadcrumb)'
exits_to:
  - '/console/{tenantId}/accounting/close/runs/{runId}'
  - '/console/{tenantId}/accounting/close/periods/{fiscalYearId}/{periodNumber}'
  - '/console/{tenantId}/accounting/close/years/{fiscalYearId}'
displays:
  - field: 'Unit selection and, on the Runs tab, request-kind and outcome filters.'
    source: Console state; kinds and statuses from DOM-ACC-CLS-003
  - field: >-
      Year sections with monthly state, attribution, readiness counts and
      correction count.
    source: listFiscalClosePeriods (DOM-ACC-CLS-001)
  - field: 'Run rows with request kind, month, outcome, requester and timestamps.'
    source: >-
      listFiscalCloseRuns (DOM-ACC-CLS-003), up to twenty pages of one hundred
      runs
  - field: Participant display names resolved by the adapter.
    source: 'Platform user names, resolved by the console'
actions:
  - label: Open Run
    operation_id: getFiscalCloseRun
    permission: accounting.fiscal-periods.read
    confirm: false
  - label: Reopen <latest closed month>
    operation_id: reopenFiscalPeriod
    permission: accounting.fiscal-periods.reopen
    confirm: true
states:
  - loading
  - >-
    empty (there are no selectable units, years or runs, or filters remove every
    run)
  - 'error (failed unit, year or run retrieval offers Retry)'
  - >-
    read-only (reopen targets depend on authority; the component also includes a
    disabled action branch)
validation:
  - BR-CAP-ACC-CLS-013-04
  - BR-CAP-ACC-CLS-013-07
  - BR-CAP-ACC-CLS-011-10
patterns:
  - Full layout (PageLayout and PageHeader)
  - Permission guard (RequirePermission on the close layout)
  - Filter selects and a table with status pills
  - Collapsible fiscal-year sections
  - Notice and Error panel with Retry
  - Tabs for Periods and Runs
component: 'react-console:components/accounting/close/close-history.tsx (CloseHistory)'
evidence:
  - >-
    react-console at baf6dae3:
    app/(console)/console/[tenantId]/accounting/close/history/page.tsx;
    components/accounting/close/close-history.tsx;
    lib/accounting/close/http-service.ts (listRuns).
  - >-
    react-console:components/console/page-layout.tsx:PageLayout;
    lib/layout/page-width.ts:DEFAULT_PAGE_WIDTH (dependencies imported by the
    hosted pages); components/accounting/close/close-dialog.tsx:CloseDialog;
    reopen-dialog.tsx:ReopenDialog
controls: [TC-IAM-001, TC-IAM-002, TC-IAM-004, TC-IAM-005, TC-AZ-001, TC-AZ-002, TC-AZ-003, TC-AZ-004, TC-AZ-005, TC-AZ-006, TC-TEN-001, TC-TEN-002, TC-TEN-003, TC-TEN-004, TC-DAT-001, TC-LOG-001, TC-LOG-002, TC-LOG-003, TC-LOG-004, TC-LOG-005, TC-PI-001, TC-PI-002, TC-PI-003, TC-PI-005]
---

# Close History

## What the Screen Is For

History helps reviewers find monthly closing state and past requests across business units. It also offers an authorized correction for the latest closed month.

## What It Shows and Lets People Do

The Periods tab groups months in collapsible year sections with attribution, captured-readiness counts and reopen counts. Closed months with a run reference link to the run; other months link to their workspace. The Runs tab lists request kind, month, status, requester and times, with unit, kind and status filters.

Reopen appears only after authorization supplies an eligible target. A disabled-permission button branch exists, but absent service authorization normally suppresses that target.

## States and Errors

Units, calendars and run queries expose loading and retry panels. Empty notices distinguish missing calendar data from no matching runs. The adapter follows at most twenty pages per run query and silently returns its accumulated rows if more history remains; this screen cannot promise a complete inventory.

## Patterns It Must Respect

The page uses the inherited read guard, PageLayout, PageHeader, Tabs, filter Select controls, Tables, StatusPill, Collapsible year sections and the shared reopen dialog.