---
id: SCR-ACC-BKS-008
title: Fiscal years
route: '/console/{tenantId}/configuration/accounting/fiscalYears'
surface: console
product_area: accounting
module: books
revision: 1
status: draft
design_intent: proposed
implementation_evidence: observed
inference: []
source_sha:
  react-console: baf6dae382d6f41dce976c7f848667ccc37e076f
  services-accounting: f47cb263875bbc0c5640fba7dae6785ec32695f8
purpose: >-
  Inspect fiscal coverage, extend it explicitly, rename a year or remove an
  eligible latest year.
supports:
  - JNY-ACC-BKS-001
  - JNY-ACC-BKS-003
  - JNY-ACC-BKS-005
  - CAP-ACC-BKS-009
  - CAP-ACC-BKS-010
permission: accounting.fiscal-years.read
entry_from:
  - >-
    '/console/{tenantId}/configuration' (Accounting group in the configuration
    catalogue)
  - Navigation between Accounting setup screens
exits_to:
  - >-
    '/console/{tenantId}/configuration' (Accounting group in the configuration
    catalogue)
displays:
  - field: >-
      Years ordered by start date with expandable monthly periods, dates and
      standing
    source: listFiscalYears
  - field: >-
      Description of the next generated span derived from the latest year and
      founding month
    source: listFiscalYears (latest year) and the unit's fiscal start month
actions:
  - label: Generate Fiscal Year
    operation_id: generateFiscalYears
    permission: accounting.fiscal-years.create
    confirm: false
  - label: Rename
    operation_id: updateFiscalYear
    permission: accounting.fiscal-years.update
    confirm: false
  - label: Delete
    operation_id: deleteFiscalYear
    permission: accounting.fiscal-years.delete
    confirm: true
states:
  - empty
  - loading
  - error
  - read-only
validation:
  - BR-CAP-ACC-BKS-009-01
  - BR-CAP-ACC-BKS-009-03
  - BR-CAP-ACC-BKS-009-05
  - BR-CAP-ACC-BKS-009-06
  - BR-CAP-ACC-BKS-009-07
patterns:
  - Dedicated Standard-width fiscal page with a unit selector
  - Expandable year-and-period table
  - Generate and rename dialogs
  - Confirmation for an eligible year deletion
  - Accounting loading and error panels
component: components/accounting-config/fiscal-years/fiscal-years-page.tsx
evidence:
  - >-
    react-console at baf6dae3:
    components/accounting-config/fiscal-years/fiscal-years-page.tsx
  - >-
    react-console:components/configuration/config-list-screen.tsx:changeStatus;
    components/configuration/standard.tsx:standardCapabilities (shared-list
    behavior where applicable)
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-DAT-004, TC-LOG-001, TC-LOG-002, TC-LOG-003, TC-LOG-004, TC-LOG-005, TC-PI-001]
---

# Fiscal years

## What the Screen Is For

Inspect fiscal coverage, extend it explicitly, rename a year or remove an eligible latest year.

## What It Shows and Lets People Do

After selecting a unit, staff can expand a year to inspect its twelve periods. Generate extends coverage, Rename changes a year’s label, and Delete removes an eligible latest year. These actions require their corresponding fiscal-year permissions. The page provides no period close or reopen action.

## States and Errors

Generation accepts the permitted count and displays horizon refusals from the service. Rename saves the loaded version. Delete is limited to the latest year with all periods open; dependent financial work can still prevent it. Loading and failed reads are shown on the dedicated page. This screen has no shared-list search, availability filter or bulk action bar.

## Patterns It Must Respect

Dedicated Standard-width fiscal page with a unit selector. Expandable year-and-period table. Generate and rename dialogs. Confirmation for an eligible year deletion. Accounting loading and error panels.