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.
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 Interface#
- Log into your SmartERP instance at
https://smarterp.et/odoo. - Open the main App Switcher (grid icon in the top-left corner).
- Navigate to Settings → Technical.
Step 2: Operational Data Parameters & Controls#
Ensure all mandatory parameters comply with enterprise operational standards:
- Authorized Operator: Action executed under assigned RBAC permissions (System Administrator, Certified Specialist).
- Relational Integrity: Linked to upstream master records, approval requests, or transactional ledgers.
- Statutory & Quality Controls: Verified against Ethiopian statutory regulations and corporate governance standards.
Step 3: Operational Execution & State Progression#
- State Progression Gate: Advance record from Draft through Audited to Confirmed / Certified.
- Integrated System Impact: Automatically updates real-time operational states and posts financial/inventory journal moves.
- Audit Verification: System registers tamper-evident audit records logging user ID, timestamp, and cryptographic transaction digests.
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. |
Last updated: 2026-11-15