Mobile GS1-128 RF Barcode Scanner Client Action
Touch-first OWL 2.0 mobile RF scanner client action with Ventor Dark UI design, GS1-128 barcode parsing, and Web Audio API feedback chimes.
1. Overview & Business Value#
This comprehensive operational guide details the architecture, business workflows, configuration parameters, and execution steps for Mobile GS1-128 RF Barcode Scanner Client Action within SmartERP.
Mobile GS1-128 RF Barcode Scanner#
The SmartERP Mobile RF Barcode Scanner (smarterp_wms_barcode_scanner) is an OWL 2.0 Client Action optimized for rugged handheld terminals (Zebra, Honeywell, Datalogic) and modern mobile smartphones.
{screenshot:mobile-rf-barcode-scanner-overview-dashboard}
2. Prerequisites & Security Access Groups#
- Required Modules:
stock, smarterp_wms_enterprise - Security Groups:
Warehouse Clerk(Technical ID:stock.group_stock_user)Warehouse Manager(Technical ID:stock.group_stock_manager)
- Master Data Dependencies: Multi-warehouse aisles, racks, shelves, bins, putaway rules, cycle count schedules, and barcode terminal profiles.
3. Step-by-Step Configuration & Execution#
Step 1: Navigating to the Module Interface#
- Log into your SmartERP instance at
https://smarterp.et/odoo. - Open the main App Switcher (grid icon in the top-left corner).
- Select the Inventory app icon.
- From the top navigation bar, open Inventory → Operations → Multi-Warehouse Operations / Putaway Rules / Wave Picking.
{screenshot:mobile-rf-barcode-scanner-app-switcher-navigation}
Step 2: Creating and Parameterizing Records#
- Click the New button in the top-left control panel.
- Complete the mandatory fields in the record form:
- Source Location (Mandatory): Warehouse physical bin or staging zone
- Destination Location (Mandatory): Target storage shelf or dispatch bay
- Product & Quantity (Mandatory): Inventory items with standard units of measure
- Operation Type (Mandatory): Internal transfer, putaway, wave pick, or delivery order
- Configure optional operational parameters and localized tags as required:
- Barcode Scan Verification (Optional): Mandatory barcode scanning confirmation
- Pallet / SSCC Package ID (Optional): Serialized shipping container code
- Assigned Warehouse Equipment (Optional): Forklift, reach truck, or manual pallet jack
- Click the Save icon in the control bar to commit the record.
{screenshot:mobile-rf-barcode-scanner-record-creation-form}
Step 3: Validating and Processing Transactions#
- State Transitions: Execute operational state progression (Draft Picking → Waiting Availability → Reserved → Wave Pick In Progress → Pack Checked → Done).
- Ledger & System Impact: Updates stock valuation layers dynamically and adjusts inventory lot quantities across designated warehouse storage locations.
- Audit Verification: Automated recording of author ID, timestamp, and immutable revision history.
{screenshot:mobile-rf-barcode-scanner-transaction-processing-state}
Key Features#
- Ventor Dark UI Standard:
- Ultra-high contrast layout designed for harsh industrial lighting and outdoor yards.
- Large touch targets (minimum 48px height) with tactile quantity increment buttons (+1, +5, +All).
- Web Audio API Feedback Engine:
- Synthesizes real-time acoustic feedback directly via browser audio oscillators without external sound file dependencies:
- Success Beep (Positive Chime): Two-tone arpeggio (587 Hz $\to$ 880 Hz) on valid location/product scans.
- Error Buzzer: Low-frequency tone (180 Hz) accompanied by haptic device vibration (
navigator.vibrate) on scan mismatch.
- Synthesizes real-time acoustic feedback directly via browser audio oscillators without external sound file dependencies:
- GS1-128 Application Identifier (AI) Parser:
- Parses composite multi-element barcodes in a single scan:
(01): Global Trade Item Number (GTIN / Barcode).(10): Batch / Lot Number.(17): Expiration Date ($YYMMDD$).(21): Serial Number.
- Parses composite multi-element barcodes in a single scan:
- Guided 3-Step Scan Workflow:
- Step 1 - Scan Location: Picker scans the bin shelf barcode (
LOC-A01-B04-L02). The scanner validates that the bin matches the active serpentine pick line. - Step 2 - Scan Product / Lot: Picker scans the SKU or GS1 composite label.
- Step 3 - Confirm Quantity: Picker confirms count and clicks "Confirm Pick".
- Upon confirmation, the line updates on the server and the app automatically advances to the next location along the serpentine path.
- Step 1 - Scan Location: Picker scans the bin shelf barcode (
4. Advanced Configuration Points#
- Automated Actions & Scheduled Tasks (Crons):
Inventory: Cycle count schedule trigger(stock.ir_cron_cycle_count): Runs weekly to select locations for scheduled physical cycle countingWMS: Auto-replenish forward pick bins(stock.ir_cron_replenish): Runs daily to trigger internal moves from bulk storage to picking faces
- Custom Print Templates & Reports:
- Warehouse Storage Bin Location Map & Occupancy
- Stock Valuation Summary by Storage Location
- Wave Picking & Packing Slip with Barcode Verification
- Multi-Company Rules: Record-level security isolation under Company 1 (
Ashewa Technology Solutions S.C.), preventing cross-company ledger leakage across parent and subsidiary legal entities.
5. Comprehensive Troubleshooting Matrix#
| Error Symptom / Exception | Probable Root Cause | Corrective Action / Resolution |
|---|---|---|
Stock Reservation Error: Insufficient available balance | Requested product quantity is already allocated to another confirmed order. | Replenish pick location from bulk overstock or verify physical stock count. |
Putaway Rule Conflict: Incompatible product storage | Attempting to place hazardous or refrigerated goods in standard dry bin. | Select a destination location configured for the product category specification. |
Barcode Scan Mismatch: Scanned code does not match item | Scanned barcode belongs to a different product variant or lot. | Verify physical item label and scan the correct SKU barcode. |