Openbravo Commerce Cloud
Breadcrumbs

Scan in SSMS

The SSMS app provides barcode scanning functionality across multiple windows. This guide describes what types of items can be scanned in each window.

Scanning capabilities by window

‘My Assigned Tasks’ window

  1. Tasks

  2. Personalized items

  3. Storage bins

  4. Products

MyAssignedTaskTaskScanning.gif
Scan grouped task document barcodes to quickly navigate to them
MyAssignedTaskTaskScanning.gif
Scan grouped task document barcodes to quickly navigate to them
MyAssignedTaskPersonalizedScanning.gif
Custom scanning behavior that can be extended by other modules
MyAssignedTasksBinScanning.gif
Scan a bin for a selected task

‘Move’ window

  1. Personalized items

  2. Products

  3. Storage bins

MovesPersonalizedScanning.gif
Custom scanning behavior that can be extended by other modules
MovesProductScanning.gif
Scan product barcodes to find related individual tasks
MovesBinScanning.gif
Scan a bin for a selected task

‘Receive’ / ‘Issue’ / ‘Pick’ windows

  1. Tasks

  2. Documents

ReceiveWindowTaskScan.gif
Scan grouped task document barcodes to quickly navigate to them
ReceiveDocumentScanning.gif
Automatically loads existing document information to generate tasks


‘Distribution Order Issue’ window

  1. Distribution orders

DOIScanning.gif
Navigate to a DOI document



‘Individual Packing’ / ‘Individual Unpacking’ / ‘Multi Move’ windows

  1. Storage bins

  2. Storage details

    • If the product is stored in multiple locations and no bin is selected, the app will display a pop-up to allow you to choose the desired bin. If a bin is already selected and the product exists in that bin, it will be automatically added.

  3. Referenced inventories

BoxBinScanning.gif
Scan a bin to filter by it
BoxStorageDetailScanning.gif
Scan and add storaged details.
BoxPackagesScanning.gif
Scan a referenced inventory to add it to the task

‘Grouped Tasks’ window

  1. Personalized items

  2. Products

GroupedTasksPersonalizedScanning.gif
Custom scanning behavior that can be extended by other modules
GroupedTaskProductScanning.gif
Scan product barcodes to increase the quantity


‘Ongoing Document’ window

  1. Storage bins

  2. Products

OngoingDocumentBinScan.gif
Scan a bin to filter by it
OngoingDocumentProductScan.gif
Scan product barcodes to increase the quantity


‘Transform Item’ window

  1. Products

TransformItemsProductScanning.gif
Scan product barcodes to increase the quantity



Scanning priority system

The scanning system uses a priority-based approach where lower numbers indicate higher priority:

  • Priority 125: Task-specific scanning

  • Priority 150: Personalized/custom scanning (extensible by other modules)

  • Priority 175: Storage bin/location scanning

  • Priority 200: Product and document scanning

  • Priority 225: Box/handle unit scanning

  • Priority 9999: Fallback handler for unknown items

When you scan a barcode, the system processes it through each handler in priority order until one successfully handles the scan or all handlers have been tried.

Scanning log

It is possible to view the latest barcode scans by clicking the ‘Scan Log’ button in the top bar:

image-20250722-101849.png
localhost_3000__terminal=SSMS(SSMS) (5).png


Customization

The scanning system supports customization through the Personalized Scan Handler, which allows other modules to extend scanning functionality with custom behaviors specific to their requirements.

The base behaviour for SSMS is a simple EAN128 parser that admit 01 and 30 application identifiers (AI). First one for product upc and second one for the product quantity. This means that a valid EAN128 code would be 0101234567890123302 where 01234567890123 would be the UPC, and 2 the quantity

JavaScript
                              01|01234567890123|30|2
                              AI| Product UPC  |AI|Quantity