In this article
Feature flags are used extensively in the Self-Checkout (SCO) functionality. These flags can be set and used to control the behavior of the Self-Checkout (SCO) Connector. Feature flags can be set on an item, SCO Device, ro the SCO Connector, depending on the context of the feature flag.
LS Retail publishes a Rapidstart package with the feature flags that have been implemented and their default values. Here is a list of all possible feature flags, the values they can take, and if they apply to any specific devices.
SCO Connector
| Feature flag | Values | SCO | Comment |
|---|---|---|---|
| Demo-SimulatePayment | true/false | Any | Enables simulated payment processing for testing or demonstration purposes. When set to true, the system bypasses real payment terminals and returns a predefined successful payment response. Not intended for use in production. |
| VoidUnconcludedSalesAtStartup | true/false | Any | A sale is considered to be "unconcluded" when it has items in it but no payment. When an SCO Device is starting itself up, it usually asks for the latest sales information from the SCO Connector, and if the first sale that is sent from LS Central is an "unconcluded" transaction, this feature flag will decide if the SCO Connector will automatically void this transaction or display it as is with the items on it for the customer or attendant to finalize the sale in a normal way. |
SCO Device Type
| Feature flag | Values | SCO | Comment |
|---|---|---|---|
| AskCustomerToPrintReceipt | true/false | DN | If set to true, the SCO prompts the customer with an option to print their receipt at the end of the transaction. If false, no prompt is shown—receipt behavior is determined by defaults or backend settings. Default is usually true. |
| AgeVerificationLimits | 18,21 | DN | A list of all age limits a customer age could have to be checked with >= for age verification. |
| CancelHostName | localhost | DN | A connection configuration for the Diebold Nixdorf SCO Device. |
| CancelPortNumber | 17003 | DN | A connection configuration for the Diebold Nixdorf SCO Device. |
| DiscountText | Discount | DN/NCR | A customizable text string shown to customers when a discount is applied. This could be used for visual or printed confirmation that a discount has been given. |
| DisplayTaxInformation | true/false | DN | If set to true, the SCO will show tax-related details on the user interface and/or printed receipt during and after the transaction. This can include breakdowns of tax rates, amounts per item, and total tax. If set to false, tax amounts may still be calculated internally but are not displayed to the customer. Default behavior is usually false unless regulations or customer requirements dictate otherwise. |
| GrayHairAge | 50 | DN | For easing the process of verifying customer ages. Attendants might be allowed to pass customer age restriction checks by simply confirming that customers are at least this ("gray hair") age old. For customers that appear younger, rules might require that attendants must ask the customers for an age proof (e.g. id card). |
| MainHostName | localhost | DN | A connection configuration for the Diebold Nixdorf SCO Device. |
| MainPortNumber | 17002 | DN | A connection configuration for the Diebold Nixdorf SCO Device. |
| PaperBagItemCode | 1234 | DN | Item code used by the POS system to ring up a paper shopping bag. When the customer selects a paper bag, this item code is added to the transaction. Must correspond to a valid item in the POS. |
| PlasticBagItemCode | 1234 | DN | Item code used by the POS system to ring up a plastic shopping bag. Same rules as PaperBagItemCode. |
| PrintReceiptLayoutID | layoutID | DN | The layout ID that defines how printed receipts appear. This ID is used by the printing module to retrieve the correct template. An optional id for the specific customer screen view to be used for the dialog. If omitted, a default screen view is used. Must consist of letters, digits, and '_' only. This field is ignored if the object is referenced from a FormFieldDescriptor. |
| PrintReceiptLayoutTimeoutInSeconds | 5 | DN | How long the SCO waits for the customer to respond to the "Print Receipt?" prompt. After this timeout, the system proceeds with a default action (usually "don’t print"). Value is specified in seconds. |
| POSEventsCancelHostName | localhost | DN | A connection configuration for the Diebold Nixdorf SCO Device. |
| PosEventsCancelPortNumber | 17005 | DN | A connection configuration for the Diebold Nixdorf SCO Device. |
| PosEventsHostName | localhost | DN | A connection configuration for the Diebold Nixdorf SCO Device. |
| POSEventsPortNumber | 17004 | DN | A connection configuration for the Diebold Nixdorf SCO Device. |
| ShoppingBagSingleLayoutID | layoutID | DN | ID referencing the UI layout used when prompting the customer to enter the quantity of a single bag type. This layout is passed to the dialog component to define the appearance or configuration of the quantity input screen. |
| ShoppingBagMultipleLayoutID | layoutID | DN | ID referencing the UI layout to be used when displaying the bag selection dialog. This layout is passed to the dialog component to define its appearance or configuration when prompting the customer to choose between different bag types (e.g., paper or plastic). |
| UseCoupons, UseRefunds, UseVouchers, UseCustomerCard, UseCustomerOwnBag | true/false | DN | Optional. By sending some "property settings", the POS may indicate that some functionalities be generally turned off on the SCO side. Properties named "Use..." indicate by their name what functionality to turn on or off. Understood values for these are: true (default) or false. |
| WeighingUnit | kg/lbs/none | DN | The weighing unit used by the product scale on the SCO Device. |
SCO Item Profile
| Feature flag | Values | SCO | Comment |
|---|---|---|---|
| AgeLimit | Any number | DN | Specifies the minimum age required to purchase a particular item. If set to a valid integer, this value is used to enforce age restrictions during the checkout process. If not set or invalid, no age restriction is applied. |
See also