SmartERP Documentation An Ashewa Technology Solutions Platform

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.

Module map showing dependencies between SmartERP Supply Chain Core, Tenders, Store Vouchers, Landed Costs, and WMS.
SmartERP Supply Chain and Sourcing architectural module map.

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#

  1. Log into your SmartERP instance at https://smarterp.et/odoo.
  2. Open the main App Switcher (grid icon in the top-left corner).
  3. 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#

  1. 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).
  2. 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.
  3. 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.
  4. 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.

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 counting
    • WMS: 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 / ExceptionProbable Root CauseCorrective Action / Resolution
Stock Reservation Error: Insufficient available balanceRequested 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 storageAttempting 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 itemScanned barcode belongs to a different product variant or lot.Verify physical item label and scan the correct SKU barcode.
Last updated: 2026-11-15