Fiscal periods
Open and close accounting periods, lock movements in closed periods, and run the year-end closing entry.
A fiscal period is the window of time during which you accept accounting records. Mosce ERP requires every journal entry to be assigned to an open period: if it is closed, the system rejects the posting. This guide covers creating periods, the monthly close, the exceptional reopening, and the year-end close with its automatic entry.
Reading time: ~6 min
When to use this
- You are opening the new fiscal year and need to load all twelve months.
- You closed the month and want to lock changes to past entries.
- Your accountant spotted an error in an already-closed month and needs to reopen it.
- You reach year-end and are going to run the annual close to zero out Revenue and Expenses.
Before you start
- The Accounting module is active.
- Your role includes the
accounting:fiscal-periodpermission. - The Accounting settings have the Retained earnings account mapped - the year-end close needs it.
- For the year-end close: every entry of the fiscal year is recorded (not in draft).
How the model works
A fiscal period carries:
- Name (e.g.
Enero 2026,Q1-2026,2026). - Start date and end date.
- Status Open (
OPEN) or Closed (CLOSED). - Closed on and Closed by when applicable.
Operating rules:
- An entry posts only if its date falls within an
OPENperiod. - Mosce ERP detects date overlap at the service level - you cannot create two periods with overlapping ranges.
- A closed period accepts no new entries nor edits to existing ones until you reopen it.
Step by step
Create a period
- Go to Accounting → Fiscal periods and click New period.
- Fill in:
- A descriptive Name (
Enero 2026). - Start date (format
YYYY-MM-DD, e.g.2026-01-01). - End date (
2026-01-31).
- A descriptive Name (
- Save. The period stays in Open status and appears in the list and in the entry selectors.
Tip: open all twelve months of the fiscal year at once when the year begins. That way the team is never blocked by a future month that has not been opened.
Close a monthly period
- Open the period detail and click Close period.
- The dialog shows you how many entries are in the period (e.g. 18 entries).
- Confirm. Mosce ERP marks the period as Closed, records
closedAtandclosedById, and from then on any attempt to post or edit an entry within the range returnsJE_PERIOD_CLOSED.
Reopen a period
If you need to correct an entry inside a closed period and your role allows it, open the period from the list and switch it back to OPEN. It is good practice to document the reopening - it is traced by closedAt = null but there is no reason log in the model.
Reopening a period that already went through the year-end close does not bring back the zeroed-out balances - it only lets you post adjustments.
Year-end close
The year-end close is a special close that zeroes out the Revenue and Expense accounts and moves the net result to Retained earnings. It is only available when the period end date matches the end of the fiscal year (by default, 31 de diciembre).
- Open the period for the last month of the fiscal year.
- Click Year-end close.
- The dialog shows you:
- Total revenue for the year.
- Total expenses for the year.
- Net to Retained Earnings (Revenue − Expenses).
- Click Run year-end close.
Mosce ERP generates a journal entry with source = YEAR_END_CLOSE that:
- Debits each Revenue account by its balance (leaving them at zero).
- Credits each Expense account by its balance (leaving them at zero).
- Credits or debits the Retained earnings account by the net.
The entry is recorded and the period moves to Closed.
List filters
The main screen brings filters by Status and a From / To range to quickly locate open or closed periods.
Expected result
- A coherent fiscal calendar with no gaps or overlaps.
- Closed periods that protect historical reports against accidental edits.
- Year-end close executed with an automatic entry traceable in the general ledger.
Common errors
| Error | Cause | Fix |
|---|---|---|
PERIOD_OVERLAP | The range overlaps an existing period | Adjust the dates or close the old period |
PERIOD_ALREADY_CLOSED | You tried to close a period that is already closed | Reload the list; another user may have closed it |
PERIOD_NOT_FOUND | The period was deleted | Refresh and create a new one if needed |
YEAR_END_NOT_AT_FISCAL_YEAR_END | You requested the year-end close in a month that is not the end of the fiscal year | Only run the year-end close in the period that ends on December 31 |
ACCOUNTING_MAPPING_MISSING when running the year-end close | The Retained earnings account is missing in Settings | Map it in Accounting settings and retry |