Purpose

The ActivateEntryPeriod transition is used to open (activate) an entry period so that invoices can be booked in it and accounting entries can be created for it. During activation you enter the stock prices (price components and duty taxes) per SKU that apply for the new period, and you confirm that expiring price agreements and exchange rates have been resolved.

When to Use

Use this transition at the start of a new accounting period, after the period has been created with the CreateEntryPeriod transition. It is available on the Entry Periods screen in the Back office for a single selected entry period in the "Not opened" state. See Entry Periods Screen (Back office).

Screen Elements

SKU prices

For every SKU of the administration, a group "Please enter the new prices for <SKU name>" is shown with one row per price component and per duty tax used in price agreements:

The price fields are pre-filled with the prices of the previous entry period, so you only need to change what differs in the new period.

Expiring price agreements

A link "Resolve all expiring price agreements" opens the Back office price agreements page in a new tab. Below it, the checkbox "Mark this checkbox if all price agreements have been resolved" must be ticked before the period can be activated.

Expiring exchange rates

A link "Resolve all expiring exchange rates" opens the exchange rates administration page in a new tab. Below it, the checkbox "Mark this checkbox if all exchange rates have been resolved" must be ticked before the period can be activated.

What Happens When Submitted

1. Confirmation checks: Both confirmation checkboxes are validated.
2. Prices recorded: For each price component and duty tax, a price record for the period is created with the entered unit price, currency and unit. SKU periods are created when they do not exist yet.
3. Period activated: The entry period is marked active, meaning invoices can now be booked in it.
4. Workflow state update: The entry period moves to the transition's next workflow state (normally "Active").
5. Audit log entry: An audit record is created documenting the transition action.

Validations and Error Messages

• "Please verify that all price agreements are checked." - shown when the price agreements checkbox is not ticked.
• "Please verify that all exchange rates are checked." - shown when the exchange rates checkbox is not ticked.
• "Entry period <period> is already active." - shown when the period was already activated.
• When saving an active entry period, the system verifies that every SKU with price components has a SKU period and price records for the period. Example messages: "No SKU period found for SKU <SKU> for entry period <period>'s start date of <date>" and "No SKU price component period found for entry period <period> and SKU price component <component>".
• For duty taxes charged in purchases: "Active entry period must have have a SKU duty tax period: entry period <period>, duty tax <duty tax>. Create the Duty-Tax period before activating the entry period."

Configuration

This transition has no configurable config string settings.

Base transition settings

Default workflow wiring

Entry periods progress through the states Not opened, Active, Closed and (optionally) Re-activated. ActivateEntryPeriod is typically wired from "Not opened" to "Active". The exact state names and wiring are configurable per FBO One installation.

Related Transitions

Notes

• This transition can only be applied to one entry period at a time.
• Multiple entry periods can be active at the same time (for example the current and the next month while the old month is being finished). Overlapping period dates within one administration are not allowed.
• When the administration has no SKUs, no price fields are shown, but the confirmation checkboxes still apply.