Wave Fulfillment, Cluster Carts & Serpentine Routing
Batch wave generation, multi-tote cluster cart assignment, and S-Shape serpentine route sequencing for maximum pick travel efficiency.
1. Overview & Business Value#
This comprehensive operational guide details the architecture, business workflows, configuration parameters, and execution steps for Wave Fulfillment, Cluster Carts & Serpentine Routing within SmartERP.

Wave Fulfillment & Cluster Picking#
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.
S-Shape Serpentine Route Algorithm#
To prevent picker backtracking across warehouse aisles, each bin location calculates a deterministic serpentine sequence:
- Odd Aisles ($A_1, A_3, \dots$): Traversed in ascending bay order ($B_1 \to B_n$).
- Even Aisles ($A_2, A_4, \dots$): Traversed in descending bay order ($B_n \to B_1$).
$$\text{Pick Sequence} = (\text{Aisle} \times 1,000,000) + (\text{EffectiveBay} \times 1,000) + \text{Level}$$
When a wave is released, all move lines across all batched delivery orders are sorted strictly by x_pick_sequence ASC, providing the warehouse picker with an optimal single-pass path.
Automated Wave Generation Wizard#
The Batch Wave Wizard (stock.picking.wave.wizard) enables supervisors to:
- Select target warehouse and outgoing delivery operation type.
- Filter orders by zone or priority.
- Automatically batch up to $N$ ready orders (default 8).
- Assign to a Cluster Cart with multi-tote slots.
Multi-Tote Cluster Carts#
A Cluster Cart (stock.cluster.cart) contains individual tote compartments (stock.cluster.cart.bin), each equipped with a unique barcode (CART-01-T01) and visual pick-to-light color identifier:
- As the picker moves along the serpentine path, the scanner prompts: "Pick 3 units of SKU A into Cyan Tote 1 (Order SO001)".
- This enables picking multiple customer orders simultaneously with zero cross-contamination.
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. |