Skip to content

Fiscal Periods

Fiscal Periods defines the date ranges that the portal uses to organize transactions and reporting. Administrators use it to generate a full year of periods automatically, open individual custom periods, edit period notes, and close periods at the end of each accounting cycle.

Fiscal Periods list with populated rows showing period label, year, date range, granularity, and status

  • Route: /fiscal-periods
  • Menu Path: Settings → Finance → Fiscal Periods
  • Primary audience: Tenant administrators (superusers). Account administrators do not have access.
  • Generate all periods for a fiscal year at once using the Generate Periods dialog.
  • Open a single custom period manually with specific date boundaries using the Open Period dialog.
  • Edit the notes on any existing period.
  • Close an open period to prevent new documents from being posted to it.
  • Filter the list by fiscal year, status, or free-text search.
  1. Open Settings → Finance → Fiscal Periods.
  2. Click Generate Periods to open the generation dialog.
  3. Select the Fiscal Year, Granularity (Monthly, Quarterly, Yearly, or Weekly), and the Start Date.
  4. Click Generate — the portal creates all periods for the year and reloads the list.
  5. To close a period at month end, open its row actions and select Close Period, add optional closing notes, check the confirmation checkbox, and click Close Period.
  • Fiscal periods are shown filtered to Open status by default. Use the Status filter to view Closed or Locked periods.
  • When the tenant is in Managed Mode (synced from an external ERP), fiscal periods are read-only and cannot be modified from the portal.
  • Only tenant superusers can access this page. Account administrators see an access-denied message.
  • Closing a period can be reversed by a system administrator if needed.

Click Generate Periods in the page header to open the generation dialog. The portal calculates the correct number of periods based on the selected granularity and creates them all at once.

Generate Fiscal Periods dialog with Fiscal Year, Granularity, and Start Date fields filled in

FieldRequiredTypeDescriptionDefaultValidation
Fiscal YearYesSelectCalendar year for which to generate periodsCurrent yearRequired
GranularityYesSelectPeriod length: Monthly (12), Quarterly (4), Yearly (1), or Weekly (52)MonthlyRequired
Start DateYesDateFirst day of the fiscal year; determines period boundariesJanuary 1 of selected yearRequired; must be a valid date

Steps:

  1. Click Generate Periods in the page header.
  2. Select the Fiscal Year from the dropdown.
  3. Choose the Granularity — the helper text shows how many periods will be created.
  4. Confirm or adjust the Start Date (defaults to January 1 of the selected year).
  5. Click Generate. The portal generates all periods and displays a success toast with the count.

Note: If periods already exist for the selected year and granularity, the system may create duplicates. Review the list before generating to avoid overlapping periods.

Click Open Period in the page header to manually create one period with custom date boundaries. Use this when you need a non-standard period that does not fit the automatic generation pattern.

FieldRequiredTypeDescriptionDefaultValidation
Fiscal YearYesSelectYear this period belongs toCurrent yearRequired
Period NumberYesNumberSequential number of the period within the year1Required; must be a positive integer
GranularityYesSelectPeriod type: Monthly, Quarterly, Yearly, or WeeklyMonthlyRequired
Start DateYesDateFirst day of the periodJanuary 1 of current yearRequired
End DateYesDateExclusive end date — the first day after the period endsFebruary 1 of current yearRequired; must be after Start Date
NotesNoTextareaOptional description or context for this period

Open row actions on any period and select Edit to update the period’s notes. The period’s date range, fiscal year, granularity, and status are read-only in the edit dialog.

Edit Fiscal Period dialog pre-filled with period info and a Notes field

FieldRequiredTypeDescriptionDefaultValidation
NotesNoTextareaInternal notes or comments about this period

The following fields are displayed as read-only in the edit dialog: Fiscal Year, Granularity, Date Range, Status, and Closed At (if applicable).

Open row actions on an open period and select Close Period to prevent new documents from being posted to it.

Fiscal Periods row actions menu showing Edit and Close Period options

  1. Open row actions on the target period.
  2. Select Close Period.
  3. Optionally enter Closing Notes to record why the period is being closed.
  4. Check the confirmation checkbox: “I understand that closing this period will affect document numbering.”
  5. Click Close Period to confirm. The period status changes to Closed.

Note: Closing a period prevents any new documents from being assigned to it. The action can be reversed by a system administrator.

  • Document Numbering — configure number formats that use fiscal period granularity for sequence resets