Skip to Content

Commodity Supplier Management

by
Odoo

$ 13.81

v 19.0 Third Party
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies Discuss (mail)
Community Apps Dependencies
Lines of code 4198
Technical Name grev_od_commodity_supplier
LicenseOPL-1
Websitehttps://www.grevlin.com
You bought this module and need support? Click here!
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies Discuss (mail)
Community Apps Dependencies
Lines of code 4198
Technical Name grev_od_commodity_supplier
LicenseOPL-1
Websitehttps://www.grevlin.com

🌱 Commodity Supplier Management

Farmer, Cooperative & Trader Profiles with KYC Verification, Certifications, Ratings & Credit Risk

✓  Odoo 19.0 Community and Enterprise  |  OPL-1 License

🎯 Value Proposition

Commodity Supplier Management extends Odoo’s partner model into a complete commodity supplier onboarding and compliance platform. Profile farmers, traders, cooperatives, and brokers with structured KYC document verification, internationally recognized certifications (Organic, Fairtrade, GlobalG.A.P., HACCP), trade reference checks, cooperative membership hierarchies, credit risk ratings, and delivery performance scoring — everything you need to know your commodity suppliers before the first purchase order.

🔒

Full KYC Workflow

8 document types with verification, expiry alerts & auto-expiration cron
🏅

7 Certification Standards

Organic, Fairtrade, Rainforest Alliance, GlobalG.A.P., UTZ, HACCP, ISO 22000
⭐

Performance Ratings

Quality + reliability scoring with delivery history and overall averages

🌟 Key Benefits

👤

Structured Supplier Profiles

Extend res.partner with commodity-specific fields: supplier type (farmer, trader, cooperative, broker), farm location, farm size in hectares, registration numbers, and parent cooperative linkage. One partner record captures everything from small-holder farmers to large trading houses.

📋

KYC Document Verification

Upload and track national IDs, business registrations, tax certificates, bank statements, export licenses, and phytosanitary certificates. Each document follows a pending → verified / rejected workflow with issuing authority, country, and expiry date. A daily cron auto-expires lapsed documents and schedules 30-day advance alerts.

💰

Credit Limit & Counterparty Risk

Set credit limits per supplier and track used credit automatically against active commodity contracts. Assign a four-level counterparty risk rating (low, medium, high, critical) with full change tracking for audit purposes. Credit exposure is computed live via soft dependency on commodity contracts.

🤝

Cooperative Membership

Model cooperative hierarchies where individual farmers belong to cooperatives. Track membership dates, membership numbers, and share counts. Cooperatives see all their members; farmers see all cooperatives they belong to. Unique constraint prevents duplicate memberships.

⚙ Core Features

👤 Supplier Profiles

  • Extends res.partner with is_commodity_supplier flag
  • Supplier types: farmer, trader, cooperative, broker
  • Farm location and size in hectares
  • Registration number and parent cooperative link
  • Multi-company record rules throughout

🔒 KYC Document Management

  • 8 document types: national ID, business reg, tax cert, export license, etc.
  • States: pending → verified / expired / rejected
  • Issuing authority, country, document number, and expiry tracking
  • Daily cron: auto-expires lapsed docs, 30-day advance alerts
  • Supplier-level KYC status with explicit verify/reject actions

🏅 Supplier Certifications

  • Organic, Fairtrade, Rainforest Alliance, GlobalG.A.P.
  • UTZ, HACCP, ISO 22000, and custom types
  • Certificate number, issuing body, issue/expiry dates
  • States: active → expired / revoked
  • Daily cron for 30-day expiry alerts and auto-expiration

⭐ Performance Ratings

  • Quality score + reliability score per delivery
  • Overall score auto-computed as weighted average
  • Supplier-level aggregate: avg rating, total deliveries, total quantity
  • Full rating history with date and notes
  • Feeds into downstream contract and settlement modules

🤝 Cooperative Membership

  • Link farmers to cooperatives with membership records
  • Membership date, number, and share count
  • Unique constraint prevents duplicate memberships
  • Cooperatives see all members; farmers see all co-ops
  • Cooperative hierarchies via parent cooperative field

📄 Trade References & Credit Risk

  • Trade references: buyer, supplier, logistics, financial
  • Contact details, years of relationship, verification flag
  • Credit limit with live used-credit computation
  • Counterparty risk rating: low / medium / high / critical
  • Full audit trail via chatter on all tracked fields

👥 Who Is This For?

🌱

Commodity Procurement Teams

Onboard and qualify farmers, traders, and cooperatives before purchasing. Ensure every supplier has verified KYC documents and valid certifications before issuing a single purchase contract.

📊

Compliance & Risk Officers

Monitor KYC status, document expiry, counterparty risk ratings, and certification validity across the entire supplier base. Automated cron alerts ensure nothing slips through the cracks.

🏭

Agribusiness Enterprises

Coffee exporters, grain traders, oilseed processors, dairy cooperatives, and any business that procures raw commodities from a network of farmers, brokers, and trading houses.

🗒 Changelog

Version 2.0.0 — April 2026

Complete Supplier Platform — Major Release

  • KYC document management with 8 document types and verification workflow
  • Supplier certifications: Organic, Fairtrade, Rainforest Alliance, GlobalG.A.P., UTZ, HACCP, ISO 22000
  • Trade reference tracking with 4 relationship types and verification flag
  • Cooperative membership management with share counts and unique constraints
  • Credit limit and live credit-used computation from commodity contracts
  • Counterparty risk rating with 4-level classification and chatter tracking
  • Supplier performance ratings: quality, reliability, and overall scores
  • Daily crons for KYC document expiry alerts and certification expiry alerts
  • Centralized security groups from commodity_base
  • Multi-company record rules on all models

Version 1.0.0 — January 2026

Initial Release

  • Commodity supplier partner extension with is_commodity_supplier flag
  • Supplier type selection: farmer, trader, cooperative, broker
  • Basic KYC status tracking: pending, verified, rejected
  • Farm location and size fields
  • Parent cooperative linkage on partner records
  • Three-tier security via centralized commodity_base groups

📞 Need Help?

🎁 30 Days Free Support Included
📧

Email

odoo@grevlin.com
🐦

X (Twitter)

@GrevlinGlobal

Grevlin Agribusiness Suite

Enterprise-Grade Commodity Procurement for Odoo

© 2026 Grevlin Global Corp. All Rights Reserved.

Compatible with Odoo 19.0 | Licensed under OPL-1

Commodity Supplier Management

The Commodity Supplier Management module extends Odoo's res.partner model into a complete commodity supplier onboarding and compliance platform. It adds structured profiles for farmers, traders, cooperatives, and brokers with KYC document verification, internationally recognized certifications, trade references, cooperative membership hierarchies, credit risk ratings, and delivery performance scoring.

Overview

This module provides a governed supplier qualification layer for commodity procurement. Rather than maintaining a separate supplier model, every feature is applied directly to the native res.partner record so that existing Odoo contact flows remain intact.

Key Capabilities

  1. Supplier Profiles -- extend res.partner with supplier type, farm location, farm size, registration number, and cooperative linkage.
  2. KYC Document Management -- 8 document types with a pending to verified/rejected workflow, expiry tracking, and daily cron alerts.
  3. Supplier Certifications -- Organic, Fairtrade, Rainforest Alliance, GlobalG.A.P., UTZ, HACCP, ISO 22000 with expiry management.
  4. Performance Ratings -- quality and reliability scores per delivery with auto-computed overall averages.
  5. Cooperative Membership -- link farmers to cooperatives with membership records, share counts, and uniqueness constraints.
  6. Trade References -- buyer, supplier, logistics, and financial references with verification tracking.
  7. Credit Limit & Risk Rating -- credit limits with live used-credit computation and four-level counterparty risk classification.

Note

Credit-used computation depends softly on grev.commodity.contract. The module degrades gracefully if the contract module is absent.

Configuration

Prerequisites

This module depends on grev_od_commodity_base for centralized security groups and master data. Install grev_od_commodity_base first.

  1. Go to :menuselection:`Apps` and search for Commodity Supplier Management.
  2. Click :guilabel:`Install`.

Marking a Partner as a Commodity Supplier

  1. Open a contact via :menuselection:`Contacts --> Contacts`.
  2. Check the :guilabel:`Commodity Supplier` box.
  3. Select a :guilabel:`Supplier Type`:
    • Farmer -- individual small-holder or commercial farmer.
    • Trader -- commodity trading intermediary.
    • Cooperative -- farmer cooperative or union.
    • Broker -- commodity broker or agent.
  4. Fill in optional fields: :guilabel:`Farm Location`, :guilabel:`Farm Size (Hectares)`, :guilabel:`Registration Number`.
  5. If the supplier belongs to a cooperative, select the :guilabel:`Parent Cooperative`.
  6. Click :guilabel:`Save`.

Setting Credit Limits and Risk Ratings

  1. Open the commodity supplier's partner record.
  2. Set the :guilabel:`Credit Limit` field.
  3. Select a :guilabel:`Counterparty Risk Rating`: low, medium, high, or critical.
  4. The :guilabel:`Credit Used` field is computed automatically from active commodity contracts (if the contract module is installed).

Important

Changes to the counterparty risk rating are tracked in the chatter for audit purposes.

Scheduled Actions

Two crons ship with the module. Both are active by default.

Cron Frequency Purpose
KYC Document Expiry Check Daily Creates activities for documents expiring within 30 days. Auto-expires documents past their expiry date.
Certification Expiry Check Daily Creates activities for certifications expiring within 30 days. Auto-expires certifications past their expiry date.

Security Groups

This module uses the centralized security groups defined in grev_od_commodity_base:

Commodity User (group_commodity_user)

  • Read-only access to supplier profiles, KYC documents, certifications, ratings, trade references, and memberships.
  • Cannot create or edit records.

Commodity Officer (group_commodity_officer)

  • Create and edit supplier profiles, KYC documents, certifications, ratings, trade references, and cooperative memberships.
  • Cannot delete records.
  • Inherits Commodity User permissions.

Commodity Manager (group_commodity_manager)

  • Full CRUD including delete on all supplier models.
  • Can verify and reject KYC documents and supplier KYC status.
  • Inherits Commodity Officer permissions.

Note

Multi-company record rules apply to all models using the pattern ['|', ('company_id', '=', False), ('company_id', 'in', company_ids)].

Usage

Managing KYC Documents

  1. Open a commodity supplier's partner record.
  2. Navigate to the :guilabel:`KYC Documents` tab.
  3. Click :guilabel:`Add a line`.
  4. Select a :guilabel:`Document Type` (national ID, business registration, tax certificate, bank statement, proof of address, export license, phytosanitary certificate, or other).
  5. Fill in :guilabel:`Document Number`, :guilabel:`Issue Date`, :guilabel:`Expiry Date`, :guilabel:`Issuing Authority`, and :guilabel:`Issuing Country`.
  6. Attach the document file via :guilabel:`Attachment`.
  7. Click :guilabel:`Save`.

To verify a document, open the KYC document record and click :guilabel:`Verify`. To reject, fill in :guilabel:`Rejection Reason` and click :guilabel:`Reject`.

Tip

The supplier-level :guilabel:`KYC Expiry Date` is auto-computed as the earliest expiry date among all verified documents. This lets you quickly see when the next document renewal is due.

To verify the supplier overall, click :guilabel:`Verify KYC` on the partner form. To reject, fill in :guilabel:`KYC Rejection Reason` and click :guilabel:`Reject KYC`.

Managing Certifications

  1. Open a commodity supplier's partner record.
  2. Navigate to the :guilabel:`Certifications` tab.
  3. Click :guilabel:`Add a line`.
  4. Select a :guilabel:`Certification Type` (Organic, Fairtrade, Rainforest Alliance, GlobalG.A.P., UTZ, HACCP, ISO 22000, or Other).
  5. Fill in :guilabel:`Certificate Number`, :guilabel:`Issuing Body`, :guilabel:`Issue Date`, and :guilabel:`Expiry Date`.
  6. Attach the certificate file.
  7. Click :guilabel:`Save`.

Certifications start in active state and transition to expired automatically when the daily cron detects they are past their expiry date. They can also be manually set to revoked.

Recording Supplier Ratings

  1. Open a commodity supplier's partner record.
  2. Navigate to the :guilabel:`Rating History` tab.
  3. Click :guilabel:`Add a line`.
  4. Enter :guilabel:`Quality Score` and :guilabel:`Reliability Score` (both on a 0--100 scale).
  5. The :guilabel:`Overall Score` is auto-computed as the average.
  6. Optionally enter :guilabel:`Quantity Delivered` and :guilabel:`Notes`.
  7. Click :guilabel:`Save`.

The supplier-level :guilabel:`Supplier Rating`, :guilabel:`Total Deliveries`, and :guilabel:`Total Quantity Delivered` fields are recomputed automatically from the rating history.

Managing Cooperative Memberships

  1. Open the cooperative's partner record (supplier type must be cooperative).
  2. Navigate to the :guilabel:`Cooperative Members` tab.
  3. Click :guilabel:`Add a line`.
  4. Select the :guilabel:`Member` (a commodity supplier partner).
  5. Fill in :guilabel:`Membership Date`, :guilabel:`Membership Number`, and :guilabel:`Share Count`.
  6. Click :guilabel:`Save`.

Note

A unique constraint prevents adding the same member to a cooperative twice.

Adding Trade References

  1. Open a commodity supplier's partner record.
  2. Navigate to the :guilabel:`Trade References` tab.
  3. Click :guilabel:`Add a line`.
  4. Fill in :guilabel:`Reference Company`, :guilabel:`Relationship Type` (buyer, supplier, logistics, financial), and contact details.
  5. Set :guilabel:`Years of Relationship`.
  6. Toggle :guilabel:`Verified` after contacting the reference.
  7. Click :guilabel:`Save`.

Technical Details

Data Model

Model Type Description
res.partner Extended Commodity supplier fields added via _inherit.
grev.commodity.supplier.kyc.document Model + mail.thread KYC document records with verification workflow.
grev.commodity.supplier.certification Model + mail.thread Certification records with expiry management.
grev.commodity.supplier.rating Model Per-delivery quality and reliability scores.
grev.commodity.supplier.trade.reference Model Trade reference records with verification flag.
grev.commodity.cooperative.member Model Cooperative membership records.

Dependencies

  • base -- core Odoo framework.
  • mail -- chatter and activity tracking.
  • grev_od_commodity_base -- centralized commodity security groups.

Troubleshooting

KYC Status Not Updating

Symptom: Clicking :guilabel:`Verify KYC` has no effect.

Checks:

  1. Ensure the current user has Commodity Officer or Manager group.
  2. Verify the partner record has is_commodity_supplier = True.
  3. Check the chatter for any error messages.

Credit Used Shows Zero

Symptom: :guilabel:`Credit Used` always shows 0.00 despite active contracts.

Checks:

  1. Confirm grev_od_commodity_contract is installed. Without it, the computation returns 0.0 by design (soft dependency).
  2. Verify that commodity contracts for this supplier are in confirmed or active state.
  3. Trigger a manual save on the partner to force recomputation.

Certification Expiry Alerts Not Appearing

Symptom: No activities are created despite certifications nearing expiry.

Checks:

  1. Confirm the Certification Expiry Check scheduled action is active.
  2. Verify certifications are in active state with a non-empty :guilabel:`Expiry Date`.
  3. Check that no existing activity with the same summary already exists (the cron skips duplicates).

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

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author or have a question related to your purchase, please use the support page.