This article describes the settings under "Barcode scanner", which control how the agent on the POS receives and interprets scans from a connected barcode scanner.
The settings are used by the local CRS Agent running on the POS. When a barcode is scanned, the agent receives the scan from the physical device, optionally processes the text and forwards it to the POS, where the product is looked up. Most businesses only need to enable receiving; the fields for interpreting barcodes (character replacement and regular expressions) are advanced and should only be changed in agreement with support.
1. From the hamburger menu in the top-left corner of Sapera, select "Financial".
2. Go to "Setup" → "Settings" → "Point of Sales" → "Agent application" → "Barcode scanner".
Is Barcode Receiving Allowed: Determines whether the agent receives and forwards scans from the barcode scanner to the POS. Set to No (default), scans are not received via the agent. Set to Yes the agent listens for scans from the specified device and forwards them to the POS. Turn this on when the POS should be able to use a connected barcode scanner.
Device Id: Specifies which connected barcode device the agent should listen for when several devices are connected. The default is empty, which means scans from all devices are accepted. If the field is filled in, scans from devices whose id does not match are ignored. Normally leave the field empty, and only enter an id if several devices are connected and you want to limit which one is used.
These fields control how the raw text from the scanner is processed and interpreted before the product is looked up. They are filled with sensible default values and should normally not be changed. Contact support if you find that scans are not interpreted correctly.
Replace Char Pattern: Replaces certain characters in the raw scan before it is forwarded. The default is `+=-;.=-;»=-`. Each rule pair is separated by a semicolon and specifies "character=replacement", so for example `+=-` replaces a plus with a hyphen. Used to correct unwanted characters that a particular scanner sends.
Product BarCode Regular Expression: A regular expression that interprets the scanned text as a barcode and optionally a quantity. The default is `(?<barcode>[^#]+)#?(?<quantity>\d+)?`. The "barcode" group captures the barcode itself, and "quantity" captures an optional quantity after a # character. Should normally not be changed.
Message processing delay, ms: Delay in milliseconds between processing incoming scan messages. The default is 0 (no delay). Can be increased if the scanner sends data so fast that the messages need to be more clearly separated from one another.
Want to know more?
Read more in these related articles:
POS checkout
Settings for the POS sales experience: sales flow, payments, security codes, cart and screen layout.
Point of Sales
An overview of the setting categories under Point of Sales in Sapera — from POS behavior and receipts to payment terminals, reconciliation and reports.
