Feature Flags for SCO Connector

SCO Connector Feature Flags | SCO Device Type Feature Flags | SCO Item Profile Feature Flags

Feature flags are configuration switches used by the Self-Checkout (SCO) Connector to control behavior without code changes. They can be set at the level of the SCO Connector, Device Type, or Item Profile, depending on the scope of the feature.

LS Retail publishes a RapidStart package containing default feature flags and values. Partners can adjust these flags to match store-specific or terminal-specific requirements. Flags can be overridden per terminal or item if needed.

SCO Connector Feature Flags

Feature flag Values Default Applies To Description / Comment
Demo-SimulatePayment true/false 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 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 Flags

Feature flag Values Default Applies To Description / Comment
AskCustomerToPrintReceipt true/false true DN If true, prompts the customer to print a receipt at the end of a transaction. If false, receipt behavior follows backend or default settings.
AgeVerificationLimits 18,20,21,... 18,20,40 DN Defines customer age limits for verification. SCO will prompt if customer age is below any configured threshold.
CancelHostName hostname / IP localhost DN Hostname or IP address used by the SCO to connect to the Cancel service of the Diebold Nixdorf device.
CancelPortNumber numeric port 17003 DN Port used to connect to the Cancel service of the Diebold Nixdorf device.
DiscountText text Discount DN/NCR Customizable text shown to customers when a discount is applied.
DisplayTaxInformation true/false false DN If true, tax details are displayed on-screen and on receipts. Default is false unless required.
GrayHairAge integer 50 DN Attendants can bypass age verification for customers appearing at least this age. Younger customers require ID verification.
MainHostName hostname / IP localhost DN Hostname or IP address used by SCO to connect to the main method group of Diebold Nixdorf devices.
MainPortNumber numeric port 17002 DN Port used for the main connection to Diebold Nixdorf devices.
PaperBagItemCode item code 1234 DN POS item code used for paper bags. Must exist in POS catalog.
PlasticBagItemCode item code 1234 DN POS item code used for plastic bags. Same rules as PaperBagItemCode.
PrintReceiptLayoutID layoutID default DN Defines receipt layout template. Must contain only letters, digits, or '_'. Ignored if referenced from a FormFieldDescriptor.
PrintReceiptLayoutTimeoutInSeconds numeric 5 DN Time the SCO waits for customer response on "Print Receipt?" prompt. Defaults to 5 seconds before proceeding with the default action.
POSEventsCancelHostName hostname / IP localhost DN Hostname used to connect to POS Events Cancel service.
PosEventsCancelPortNumber numeric port 17005 DN Port used to connect to POS Events Cancel service.
PosEventsHostName hostname / IP localhost DN Hostname used to connect to POS Events service.
POSEventsPortNumber numeric port 17004 DN Port used to connect to POS Events service.
ShoppingBagSingleLayoutID layoutID default DN Layout for prompting quantity of a single bag type.
ShoppingBagMultipleLayoutID layoutID default DN Layout for prompting selection of multiple bag types.
UseCoupons true/false true DN Enables coupon functionality.
UseRefunds true/false true DN Enables refund functionality.
UseVouchers true/false true DN Enables voucher functionality.
UseCustomerCard true/false true DN Enables customer card functionality.
UseCustomerOwnBag true/false true DN Enables use of customer-provided bags.
WeighingUnit kg/lbs/none kg DN Unit used by product scale on the SCO device.

SCO Item Profile Feature Flags

Feature flag Values Default Applies To Description / Comment
AgeLimit any integer not set DN Minimum age required to purchase this item. If not set, no age restriction applies.

Tip: Feature flags can be overridden per SCO Device or Item Profile for custom behavior. Always test changes in a development environment before applying to production.

See Also