/settings/erp/finance/payroll-periods — the old /payroll/setup/periods redirects here.
📷 Screenshot: the Payroll Periods list with the “New Period” button and Open/Closed badges — to be added.
Multi-business: a period belongs to a business and posts to that business’s default accounting book. Confirm the business switcher first.
Creating a period
Choose New Period. The form asks for:
The accounting book is resolved automatically from the business’s default book — you don’t pick it. If the business has no default book yet, creation is refused with a clear message; set up the book first.
No overlapping open periods. A new period cannot overlap an existing open period in the same business — the system blocks it. (Overlaps with already-closed periods are allowed, so an off-cycle or separation run can target a closed window.)
Period status: Open vs Closed
A period is either Open or Closed.
Actions on the list:
Closing is a paired action: it closes the accounting period first, then flags the payroll period. Reopening is the higher-risk action and needs the dedicated
payroll:period-reopen permission — typically held only by HR managers and SuperAdmins.
How a run scopes to a period
When you create a payroll run you pick a period. The run records the period (itspayrollPeriodId) and copies down the period’s business, accounting book and currency so the run is self-contained. The period’s open/closed state decides whether new runs can post into it.
A run can only post into an open period. If you need to correct pay in a closed period you either reopen it (with the right permission) or use an off-cycle / correction route — see Running payroll.
Permissions
Behind the scenes — closing and the ledger
Closing a payroll period also closes the corresponding accounting period for the same book. That means once closed, no payroll journal entry — accrual, payment, or statutory — can post into those dates until the period is reopened. This keeps payroll and your financial statements in lockstep, so a “closed” month really is closed in both places.Related
- Running payroll — runs are created for a period
- Income-tax slabs — slabs are resolved by the run date within the period
- Payroll overview — the whole chain
- Accounting periods — the accounting side of period close