This call is deprecated. We recommend to use Point of Sale API instead.

The corresponding new call is: GET /v1/shift/openlist.

Can be used to check if a day is opened for the POS or user.

Input parameters

Parameter name Description Possible value Required
pointOfSaleID Point of sale ID. Only required when register based shift counting is enabled. Integer yes
employeeID Employee opening the day. If omitted, Erply assumes day was opened by the user who sent the API call. Integer

Specify the currency in which you want to open the day in the register.

Note: by default, this field should not be used. In a default configuration, Erply allows to count the cash in the register only in the default currency. The cashier should just set aside any cash received in foreign currencies, and remove it from the register at the end of the day. From back office, it is possible to manually print a Z Report that lists transactions made in a different currency, but the counted amount cannot be recorded in POS, neither when opening nor when closing the day.

Therefore, in the default setup, it is not possible to use the "currencyCode" field. API will return error code 1028 if you attempt to set it.

However, customer support can enable an extra module, "POS multicurrency". With this extra module, it becomes possible to count other currencies and record the counts.

In that configuration, a separate "POSOpenDay" call must be sent for each currency. If the shop accepts EUR, USD and JPY, three "POSOpenDay" calls must be made in the morning and three corresponding "POSCloseDay" calls in the evening, to store the end-of-day counts.

At the end of the day, it is possible to print three Z Reports, one for each currency. Each report will list the transactions, amount of cash in the beginning and at the end of the day, and overage/shortage.

Accepted value: for example "EUR" or "USD". The currency must be defined on your Erply account, in the "Currencies" module.

Nullable String (3)


Field name Type Description
pointOfSaleID Integer Point of sale ID. Will return 0 when day is using drawer shifts.
openedUnixTime Unix timestamp The time when POS was opened.
dayID Integer ID of the POS day.
shiftType string The type of shift used when the day was opened. Either drawer or register (point of sale).