Barcodes scan

1 Introduction
2 General parameters
- 2.1 Item feature to be scanned
- 2.2 Default scan mode
- 2.3 Scan by camera settings
- 2.4 Restrict manual input
- 2.5 Hide manual input button
3 Set the scan mode on each stock location
4 More advanced settings
- 4.1 Scan preprocess

Introduction

To ensure smoother management and avoid errors, Onestock allows you to scan barcodes on most Store App pages.

Here is an overview of what we offer

Store App Page	Scan supported on on the first view	Scan supported after selecting an element	Compatible with scan by camera

Store App Page	Scan supported on on the first view	Scan supported after selecting an element
Pack scan		a parcel must be selected Focus on the item `scanned_feature`
Bag scan		a parcel must be selected Focus on the item `scanned_feature`
Picking		a set of elements must be selected Focus on the item `scanned_feature`
Receive	Focus on the parcel shipment `tracking_code`
Customer search		Only for returns declaration Focus on the item `scanned_feature`
Catalog	Focus on the `item_id`
Consolidation	Focus on the `container` id	Focus on the item `scanned_feature`
Boxing	Focus on the `box` id	Focus on the item `scanned_feature`
Sorting	Focus on the item `scanned_feature`	Focus on the `container` id
Moving	Focus on the `parcel` id	Focus on the `container` id

General parameters

Scan settings can be accessed from the backoffice on the Configuration > Store App > General settings > Scan parameters page.

Item feature to be scanned

This configuration identifies the product feature that will be checked by the scan in most of the preparation pages mentioned above. By default, if the functionality is not activated, the item ID will be validated by the scan.

However, most products have a different ID from the barcode. In this case, we advise you to send the ean feature in the product information, and to configure this value in the section provided for this purpose. Any other feature can be configured.

Default scan mode

3 scan modes can be defined by default in the Store App:

Direct: basic use of scanning compatible with a handheld scanner. Nothing changes visually on the page, but as soon as a scan is detected, the item will appear as validated. To test this, you can copy and paste the scanned feature.
Input: an input is provided and displayed at the top of the page. For example, this allows you to use an external tool by opening the smartphone keyboard. You can also choose not to use the input, as the page remains compatible with the direct method.
Camera: This method allows you to use the camera on the back of the device to carry out the scan. You will need to authorise the application to use this camera beforehand. You can also decide not to use it, as the page is still compatible with the ‘direct’ method.

Direct mode is used by default.

The configured mode will be selected as long as no configuration is made on the stock location. For more information, see the section below.

Scan by camera settings

To use camera scanning on compatible pages, few conditions need to be followed:

your device must have a back-camera,
the user must authorize OneStock Store Application to access the camera,
the default configuration or store configuration must be set as “camera”
you must be on a page allowing barcode scanning with camera: pack (with scan), bag (with scan), receive, and catalog pages.

Then, you can adjust some settings from the back office

readers is the list of compatible barcode readers. The default settings are EAN13 and Code128, but you can add others.
sampling makes scanning fester but less accurate. False by default.
size is the size of the barcode at a normal scanning distance (~15cm). medium by default.

Here's an overview of the functionality.

If scan mode camera is active, but your device does not have a back-camera, store app will fall back to direct scan mode, which allows scanning with an external device.

If scan mode camera is active on a device which has both a back-camera and a scanning device (external or internal), you will be able to scan using your camera. If you would rather scan with the scanning device, you must configure your store in scan mode direct.

Restrict manual input

By default, the scan can be bypassed by the in-store sales assistant by clicking on the Manual Input button. However, in this case, there is no guarantee that he/she have prepared the right product.

To overcome this problem, we have developed the validation feature below. The in-store sales assistant must enter the start or end of the barcode to validate the preparation.

Here's an overview of the functionality.

Hide manual input button

To go even further in terms of restriction, you can hide the manual input button from certain roles entirely. In the example below, for all vendor users.

Set the scan mode on each stock location

A scan_mode manual tag is set by default when the project is created. It can be configured for each stock location, and is used to bypass the mode configured previously in the general parameters.

More advanced settings

Scan preprocess

Store App pages can receive and process inputs from scanner devices by containing an hidden input field. When scanner devices are sending value, this information are sent to the hidden input field and the method scan_preprocess is triggered.

This configuration can be set only via API call (PATCH/configurations) on the config line scan_options.scan_preproces. The body of a JavaScript function must be entered. This function takes the scanned value as a parameter (under the scanned key) and must return an object of the type {scan_selector: '123456'}, scan_selector being the scanned value used to identify the entity to work on. Other fields can be added to the object, such as the EPC (for RFID) when one is decoded.
By default, the scan_preprocess function returns the scanned value as it is in scan_selector.

Documentation