Mapping Distributor Operations Onto Odoo, With Custom Scope Fenced

The Challenge

A central blending plant selling bulk and packaged goods through dealers breaks standard ERP assumptions. Prices and discounts differ by dealer tier. Stock sits at the plant, at depots and at dealers, and only the first two are visible to the system. Bulk goods lose volume in transit, and credit has to be controlled per dealer. Field sales visits happen on poor networks, so data arrives late and dirty by design.

What We Designed

The design runs on one Odoo Enterprise instance. Manufacturing, inventory, sales, purchasing, accounting, quality and a dealer portal cover the core. Order-to-cash is a single flow: dealers order through the portal, field sales through a mobile app, or customer service by hand, and all three land in the same sales order.

• Forecast to blending order to quality check to tank stock
• Credit hold with approval and an audit log of who released it
• Delivery by trip, with compartments and seal numbers
• Invoice from actual delivered quantity, not ordered quantity

Key Design Decisions

Custom code is limited to six items, and each has a stated reason standard Odoo does not cover it. Everything outside that list uses standard configuration, which keeps upgrade cost low. The module list is the main scope control in the whole design.

• Dealer-tier promotion engine with cumulative volume and deferred rebates
• Delivery trip management for multi-compartment tankers
• Bulk loss reconciliation with tolerance rules and investigation cases
• Territory-based access from region to route
• Tank-gauge integration to compare book stock with measured stock
• Offline-first mobile app for visits, orders, stock checks and collections

Why the Distribution Side Is Designed First

Four lessons from distribution projects shaped the design. Retail data is slow and dirty, so the mobile app works offline and reconciles later. Promotions drive most change requests, so the engine is configurable rather than hard-coded. Territory access matters as much as function access. Dealer stock reconciliation is the biggest friction between brand and distributor, so it sits in the core design, not in a later release.

Rollout Approach

The plan has six phases, and each ends with real business running on the system, not a demo. Order-to-cash goes first, because it is the lifeblood of a distributor and delivers value from the first phase. Production, advanced distribution, the dealer and field channel, and integrations follow. Data migration has its own acceptance track throughout.