System Calendar and Operational days

27. 12. 2024

System calendar – configurable sequence of operating days for a specified period.

Operational day – defined time period when the system accepts and processes transactions from users.

Operational day has the following parameters:

Operational day number: sequence from 1 with step = 1: 0,1,2,3…
Begin date and time
End date and time
Operational day status: Closed, Open, Future

Status	Transition	Description
Open	Closed	the operational day is open for processing
Closed	–	the operational day is closed for processing, balances already calculated and stored
Future	Open Closed	operational day is in the future period

To set up the system calendar the following parameters should be specified:

begin date (each period starts from the date set up as begin date for the last operational day)
end date
time shift (hh:mm:ss – this period will be added to the operational day begin date, for example, if 02:15:00 is specified, day will be started and the specified date at 02:15:00, for example, 19.12.2023 02:15:00; and date will be ended 1 second before this time shift)
- begin date time = calendar date with time 00:00:00 + time shift
- end date time = calendar date with time 23:59:59 + time shift

After the creation of the system calendar, operational days with status: Future can be deleted.

Manual How to set-up System Calendar:

Perform system authorization as a service user with appropriate permission
Open the menu “CFO“ → “System Calendar”, see the current calendar table, and choose the option “Create calendar”
Choose Begin date and End date
Choose time shift (hh:mm:ss – this period will be added to the operational day start)
Press “Confirm“

Delete the System calendar for future periods:

Perform system authorization as a service user with appropriate permission
Open the menu “CFO“ →“System Calendar”, and see the current calendar table
Choose “Delete calendar” and “Choose date” (choose any operational day in the current calendar starting from the opened day + 1 (only future days)
Press “Delete calendar“
The whole calendar starting from the selected day will be deleted

View operational day balances:

Perform system authorization as a service user with appropriate permission
Open the menu “CFO“ → “Operational days” and see operational day balances for the current system calendar

Operational day balances

The system stores the following data for each wallet (accounting and circulation) for the end of each operational day in a separate table (stored balance data is used for asset and transaction reconciliation):

operational day number
wallet number
currency (to omit join of wallet table if it is required to have balance by currencies)
begin balance
debit
credit
end balance

Begin balance is equal to the end balance of the previous operational day.

The 0th operational day will be created automatically during system initialization and continues until the next operational day is set. Until the next day is set up, the system will store balances within the 0th day. This 0th day can’t be deleted.

Debit (income) – represents the inflow of funds into the wallet, increasing the overall balance from the wallet owner’s perspective over a specified period.
Credit (outcome) – represents the outflow of funds from the wallet, reducing the overall balance from the wallet owner’s perspective over a specified period.

Related APIs

Operational days management

Check the Back office description for System Calendar and Operational Days.