Mosce ERP · Help Center
Accounting

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-period permission.
  • 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 OPEN period.
  • 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

  1. Go to Accounting → Fiscal periods and click New period.
  2. Fill in:
    • A descriptive Name (Enero 2026).
    • Start date (format YYYY-MM-DD, e.g. 2026-01-01).
    • End date (2026-01-31).
  3. 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

  1. Open the period detail and click Close period.
  2. The dialog shows you how many entries are in the period (e.g. 18 entries).
  3. Confirm. Mosce ERP marks the period as Closed, records closedAt and closedById, and from then on any attempt to post or edit an entry within the range returns JE_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).

  1. Open the period for the last month of the fiscal year.
  2. Click Year-end close.
  3. The dialog shows you:
    • Total revenue for the year.
    • Total expenses for the year.
    • Net to Retained Earnings (Revenue − Expenses).
  4. 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

ErrorCauseFix
PERIOD_OVERLAPThe range overlaps an existing periodAdjust the dates or close the old period
PERIOD_ALREADY_CLOSEDYou tried to close a period that is already closedReload the list; another user may have closed it
PERIOD_NOT_FOUNDThe period was deletedRefresh and create a new one if needed
YEAR_END_NOT_AT_FISCAL_YEAR_ENDYou requested the year-end close in a month that is not the end of the fiscal yearOnly run the year-end close in the period that ends on December 31
ACCOUNTING_MAPPING_MISSING when running the year-end closeThe Retained earnings account is missing in SettingsMap it in Accounting settings and retry