| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Invoicing (account) • Purchase (purchase) • Inventory (stock) |
| Community Apps Dependencies | Show |
| Lines of code | 12636 |
| Technical Name |
grev_od_commodity_suite |
| License | OPL-1 |
| Website | https://www.grevlin.com |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Invoicing (account) • Purchase (purchase) • Inventory (stock) |
| Community Apps Dependencies | Show |
| Lines of code | 12636 |
| Technical Name |
grev_od_commodity_suite |
| License | OPL-1 |
| Website | https://www.grevlin.com |
🌾 Commodity Procurement SuiteEnd-to-End Commodity Management — Suppliers, Contracts, Deliveries, Quality, Warehousing, Settlement & Payments
|
|
|
|
|
|
|
📞 Need Help?
|
|
Grevlin Procurement Suite Enterprise-Grade Commodity Procurement for Odoo © 2026 Grevlin Global Corp. All Rights Reserved. Compatible with Odoo 19.0 | Licensed under OPL-1 |
Commodity Procurement Suite
The Commodity Procurement Suite is a meta-module that installs the complete commodity procurement platform for Odoo in a single click. It deploys seven specialised modules covering supplier management, trading contracts, weighbridge delivery, laboratory quality inspection, silo warehousing, and automated settlement with payment tracking. Bridge models activate cross-module integrations that only exist when the full suite is installed.
Overview
This suite targets grain elevators, agro-processors, commodity traders, and cooperatives that need end-to-end commodity procurement management inside Odoo. Each module works independently, but the suite connects them into a unified workflow where quality penalties flow into settlement pricing, delivery schedules link to contracts, and weighbridge pickings carry commodity grades.
Included Modules
- Commodity Base -- commodity types, grades, quality parameters, forms, origins, seasons, packaging, and conversion factors across all commodity domains (grains, meat, fish, dairy, oils, industrial). Pre-loaded with 33 commodity types.
- Commodity Supplier Management -- farmer, trader, cooperative, and broker profiles with KYC document verification, certifications, credit limits, and mobile money payment preferences.
- Commodity Contracts -- spot, forward, futures, option, term, and swap contracts with pricing formula engine, Black-Scholes option Greeks, mark-to-market, margin management, rollover, and washout workflows.
- Delivery & Weighbridge -- multi-step weighbridge workflow on stock pickings with gate registration, gross/tare weighing, scale calibration audit logs, and immutable weighing records.
- Quality Inspection -- laboratory testing with automatic grading based on quality parameters. Threshold-based accept/reject workflow with penalty calculation and immutable verified records.
- Warehouse & Silo Management -- silos and bins as native stock locations with commodity intake, fumigation tracking, temperature monitoring, and capacity utilisation from Odoo quants.
- Settlement & Pricing -- automated pricing engine with quality penalty and grade adjustment deductions, six-state approval workflow, vendor bill creation, advance payments, FX hedges, and SQL procurement analytics.
Bridge Integrations
The suite installs bridge models that connect the decoupled modules:
- Picking bridge -- adds commodity type, contract, grade, and intake fields to stock.picking, extending the weighbridge form.
- Intake bridge -- links grev.commodity.intake back to stock.picking for bidirectional navigation.
- Settlement bridge -- connects settlements to quality tests, grades, washouts, and swap legs. Extends pricing to apply quality penalties and grade adjustments as deduction lines.
- Quality bridge -- auto-populates test lines from commodity type parameters and computes grades from quality scores.
- Contract delivery schedule bridge -- links delivery schedules to stock pickings with computed delivered quantity.
Configuration
Installation
- Go to :menuselection:`Apps --> Apps`.
- Search for Commodity Procurement Suite.
- Click :guilabel:`Install`.
The suite automatically installs all seven commodity modules and their dependencies. No additional configuration is needed beyond what each module requires individually.
Important
The suite depends on purchase, stock, and account modules. Ensure these are installed before installing the suite.
Security Groups
All commodity modules share centralised security groups defined in grev_od_commodity_base:
Commodity User (group_commodity_user)
- Read-only access across all commodity models.
Commodity Officer (group_commodity_officer)
- Create and edit access to suppliers, contracts, deliveries, quality tests, warehouse intakes, and settlements.
- Cannot delete records or approve settlements.
Commodity Manager (group_commodity_manager)
- Full CRUD including delete on all commodity models.
- Approve settlements, create vendor bills, manage payments.
Note
Multi-company record rules apply to all models using the pattern ['|', ('company_id', '=', False), ('company_id', 'in', company_ids)].
Usage
End-to-End Workflow
The commodity procurement workflow follows these steps:
- Register supplier -- create a supplier profile with KYC documents and commodity specialisation via :menuselection:`Commodity --> Suppliers`.
- Create contract -- negotiate terms, pricing formulas, quality rules, and delivery schedules via :menuselection:`Commodity --> Contracts`.
- Receive delivery -- register truck arrival, perform gross/tare weighing on the weighbridge via :menuselection:`Commodity --> Deliveries`.
- Run quality tests -- take samples and record lab results. The suite auto-populates test lines from commodity type parameters and computes the grade automatically.
- Store in warehouse -- create an intake record to route the commodity into a silo or bin via :menuselection:`Commodity --> Warehouse --> Intakes`.
- Settle and pay -- calculate settlement pricing with quality penalties and grade adjustments, submit for approval, create vendor bills, and record payments via :menuselection:`Commodity --> Settlements`.
Tip
With the full suite installed, quality test penalties and grade adjustments automatically flow into settlement deduction lines during pricing calculation -- no manual entry needed.
Contract Types
The contracts module supports multiple contract types:
| Type | Description |
|---|---|
| Spot | Immediate delivery at current market price. |
| Forward | Future delivery at a pre-agreed fixed price. |
| Futures | Exchange-traded standardised forward contracts. |
| Option | Right (not obligation) to buy/sell with Greeks. |
| Term | Long-term supply agreement with periodic delivery. |
| Swap | Exchange of cash flows based on price indices. |
Settlement Workflow
Settlements follow a six-state approval workflow:
- draft -- settlement created, awaiting calculation.
- calculated -- pricing computed, deductions generated.
- submitted -- submitted for manager approval.
- approved -- approved with final payable amount set.
- invoiced -- vendor bill created in Odoo Accounting.
- paid -- all payments received, settlement closed.
Technical Details
Suite Bridge Models
| Model / Extension | Bridge File | Purpose |
|---|---|---|
| stock.picking (extended) | picking_commodity_bridge | Commodity type, contract, grade, intake fields |
| grev.commodity.intake (extended) | warehouse_picking_bridge | Picking backlink for bidirectional navigation |
| grev.commodity.settlement (extended) | settlement_commodity_bridge | Quality test, grade, washout, swap references and extended pricing with penalty/grade deductions |
| grev.commodity.quality.test (extended) | quality_commodity_bridge | Auto-populate lines from commodity type; compute grade from quality scores |
| stock.picking (extended) | contract_delivery_schedule | Delivery schedule linkage with computed delivered quantity |
| grev.commodity.purchase.bridge | purchase_bridge | Abstract model aggregating KPIs for dashboard |
Commodity Domains
The base module ships with pre-configured commodity domains:
- Grains & Cereals -- wheat, maize, rice, barley, sorghum
- Oilseeds & Oils -- soybean, sunflower, palm, canola
- Meat & Poultry -- beef, poultry, pork, lamb
- Fish & Seafood -- tilapia, shrimp, tuna, salmon
- Dairy -- milk, butter, cheese, yoghurt
- Industrial Crops -- cotton, rubber, tobacco, sisal
Troubleshooting
Bridge Fields Not Visible on Pickings
Symptom: commodity type, contract, and grade fields do not appear on the weighbridge form.
Checks:
- Verify the suite module grev_od_commodity_suite is installed (not just the individual modules).
- Clear browser cache and reload the page.
- Check that grev_od_commodity_delivery is installed, as the bridge view inherits from its weighbridge form.
Quality Penalties Not Applied to Settlement
Symptom: settlement calculation shows no quality deduction lines.
Checks:
- Verify the quality test linked to the settlement has verified results with penalty amounts greater than zero.
- Confirm the settlement has a quality_test_id set (this bridge field is only available when the suite is installed).
- Check the commodity grade's price_adjustment_pct value for grade-based deductions.
See Also
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module