Configuring Self Checkout Mode
| Configuration Files |
|
The following steps are necessary for operation of a Self Checkout POS:
Settings on the POS Server
- Create a cash drawer with the following properties on the POS Server: Assignment mode: Drawer for one POS Client.
Alternatively, the cash drawer may be imported via the global configuration dc_import_Till.xml . In this case, the cash drawer will have the following properties:
<till:AssignmentTypeCode>DRAWER_FOR_ONLY_ONE_CASH_REGISTER</till:AssignmentTypeCode> - Create a technical operator for the self checkout on the POS Server:
Configuring POS Client in the Storemanager
Changes must be made to the following files:
- clientSystem.properties
- autoLoginConfigs.properties
- hal.properties
- Set the following in the file clientSystem.properties :
ApplicationConfigs.Default.mainModule=classpath\:/processModels/tpos/SimpleSco.module ... SystemConfig.workstationTypeCode=SCO SystemConfig.workstationTypeConfig.useLoginTypeTechnicalForLoginManager=true - Enable automatic login (autoLoginConfigs.properties):
AutoLoginConfigs.Default.isAutoLoginEnabled=true - In the file autoLoginConfigs.properties , enter the name and password of the technical operator you created on the POS Server, e.g.:
AutoLoginConfigs.Default.autoLoginName=9000 AutoLoginConfigs.Default.autoLoginPassword=$2a$04$7tFbPL7YproL/ceujUxrZeyF2lJI.PBqM4PoBoysjhvoRZZsHCkPmNote:When starting the self checkout, the technical operator will be automatically logged in. - In the file hal.properties , disable the cash drawer via the device editor:
DeviceEntryTypes.VirtualCashDrawer.id=VirtualCashDrawer ... DeviceEntryTypes.VirtualCashDrawer.enabled=false DeviceEntryTypes.VirtualCashDrawer.active=false
Additional Configurations
By default, the customer’s language is selected on the self checkout welcome screen ( services-client.properties):
LocalizationServiceConfig.defaultCustomerLocale=de_DE
In addition, all panels can be maintained via the file mediapanel.properties . This may look as follows:
MediaPanelConfig.channels.0.panels.21.id=gcScanPaymentScoLeftMediaPanel
MediaPanelConfig.channels.0.panels.21.media.0.id=DefaultMediaGroup
MediaPanelConfig.channels.0.panels.21.media.0.schedulerId=DefaultScheduler
MediaPanelConfig.channels.0.panels.21.media.0.images.0.fileName=image/item/550x550/giftcard.png
In this case, the image giftcard.png is downloaded from the Digital Signage Server and displayed in the item info function when payment is made by gift card.
More information on the configuration is found under the section "Graphical customer display configuration".
Menu Configuration
The menu configuration is performed via the Menu Editor.
After configuring the menu via the Menu Editor, enter the variant name in the file tableau.properties . This may look as follows:
TableauConfig.variantNames.0=POS
TableauConfig.variantNames.1=SCO
The following table contains the descriptions of the parameters:
| Parameter | Description |
|---|---|
| variantNames.0 | Enter here the variant name of the tableau you used for the Service mode. |
| variantNames.1 | Enter here the variant name of the tableau you are using for the Self Checkout application. |
The variant names match the ones you already defined on the Menu Editor. The corresponding tableau menus for service and for self checkout mode are also maintained via the Menu Editor.
The variant name can also be configured in Storemanager via the display editor.
OneX Self Checkout Specific Configuration
The following settings are specific for OneX SCO.
| Configuration | Parameter |
|---|---|
| clientSystem.properties | ApplicationConfigs.Default.headlessMainModuleEnabled=false ApplicationConfigs.Default.headlessMainModule= ApplicationConfigs.Default.mainModule= ApplicationConfigs.Default.flowServiceMainModules.0=classpath:/processModels/tpos/SimpleSco.module |
| tableau.properties | TableauConfig.variantNames.0=OneXPOS TableauConfig.variantNames.1=OneXSCO |
| flowService.properties | FlowServiceConfig.flowServiceClientData.transactionPreview.itemImageEnabled=false |
Configuring User Rights
In general, the operator of a Self Checkout POS has the same rights as the technical user. To prevent the operator from executing functions that are not permitted for them, the corresponding rights should NOT be assigned to them. This includes, in particular, the following rights:
| Right | Description |
|---|---|
| S.01020100102.01 | Item Entry SCO Item Not Found |
| S.01020100102.02 | Item Entry SCO Item Locked |
| S.01020100102.03 | Item Entry SCO Item Registration Not Allowed |
| S.01020100102.04 | Item Entry SCO Tax Group |
| S.01020100102.05 | Item Entry SCO Limit Exceeded |
| S.01020100102.06 | Item Entry SCO Serial Number Required |
| S.01020100102.07 | Item Entry SCO Item Type Not Allowed |
| S.01020100102.08 | Item Entry SCO Item Type Age Verification |
| S.01030100900.01 | Payment SCO Not Enough Money in Till |
| S.01030100999.01 | Payment Process SCO Not Enough Money in Till |
| S.01090100309.01 | Promotion Coupon SCO Coupon Entered |
| S.01090100309.02 | Promotion Coupon SCO Privilege Value Required |
| S.01020100130.04 | Sales Restrictions SCO Registration Forbidden |
| S.01020100130.05 | Sales Restrictions SCO Registration Not Allowed |
| S.01020100130.06 | Sales Restrictions Only One Quantity Limit Item Allowed |
| S.01020100130.07 | Sales Restrictions SCO Confirm Registration |
| S.01020100130.08 | Sales Restrictions SCO Age Restriction |
| S.01020100130.09 | Sales Restrictions SCO Items Forbidden |
| S.01070100202.01 | Gift Certificate Sale SCO Too Many GC |
| S.01070100202.02 | Gift Certificate Sale SCO Create Offline GC |
| S.01350101221.01 | Activate SCO Customer Mode |
| S.01350101447.01 | Start SCO Service Mode |
| S.01260100002.01 | Retrieve Scale Transaction SCO Already Redeemed |
| S.01260100002.02 | Retrieve Scale Transaction SCO Enter Receipt Amount |
| S.01260100002.03 | Retrieve Scale Transaction SCO Offline Mode |
| S.01260100002.04 | Retrieve Scale Transaction SCO Receipt Cancelled |
| S.01260100002.05 | Retrieve Scale Transaction SCO Unknown State |
| S.01020100107.02 | Manual Price SCO Price Change Not Allowed |
| S.01020100107.03 | Manual Price SCO Manual Price Required |
| S.01180100902.02 | TerminalPayment_SCO_AuthorizeTerminalEventCheckSecurity |
| S.01180100902.03 | TerminalPayment_SCO_NotEnoughMoney |
| S.01180100902.04 | TerminalPayment_SCO_CommunicationError |
| S.01180100902.05 | TerminalPayment_SCO_Signature |
Configuring Event Service
The Event Service sends messages from the Self Checkout to the SCO Assistant Application. The SCO Assistant is an application to manage the events from the Self Checkout on a mobile device and resolve them, if possible. Events are always sent when the intervention of a cashier is required, e.g. when buying sales-restricted items (alcohol, cigarettes), if the help button is pressed or if other entries are required by the cashier. To resolve the events on the Self Checkout, the sales assistant can confirm the events from the SCO Assistant Application, depending on the type of the event, or handle them directly at the Self Checkout.
In addition, the status of the Self Checkout is displayed on the SCO Assistant Application.
To configure the communication between the Self Checkout and Event Service, the following steps are required:
- Enable the Event Service and set a device group in the eventServiceConfigs.properties :
EventServiceConfigs.Default.eventServiceEnabled=true EventServiceConfigs.Default.eventServiceDeviceGroup=DEFAULT - Configure the communication to the Event Service in the webServiceConfig.properties :
WebServiceConfig.EventServiceConfig.adress=ws://localhost:8080/event-service-war/services/stomp/ WebServiceConfig.EventServiceConfig.username={user name} WebServiceConfig.EventServiceConfig.password={password}The following table contains the description of the parameters:
Parameter Description WebServiceConfig.EventServiceConfig.adress Defines the URL to the Event Service. WebServiceConfig.EventServiceConfig.username Defines the username to connect to the Event Service. WebServiceConfig.EventServiceConfig.password Defines the encrypted password to connect to the Event Service. - Configure the scheduler (optional)In addition, there is an Event Service scheduler. It is used when login and logout of the Self Checkout Station were not successful. In this case, the operation is repeated according to the configuration of the Event Service scheduler. The Event Service scheduler is configured in the scheduler_event-service.properties .
scheduler.repeatInterval=15s scheduler.enabled=trueThe following table contains the description of the parameters:
Parameter Description scheduler.repeatInterval Defines after how many seconds the scheduler should run again if a corresponding event could not be sent successfully. scheduler.enabled Property for enabling/disabling the Event Service scheduler. Note:Event Service Scheduler InfoThe scheduler is only used for login and logout events of the Self Checkout Station. If any other events could not be sent, there will be no attempt to send them again. When offline, however, a different message is displayed to the customer in the event that authorization is required. This means that the customer is aware of the situation and can contact a cashier directly.