Prodaksha Developers

Value chains › Nuts

Groundnut shelling and grading

Groundnuts in shell from growers are decorticated and sorted into whole edible kernels (GROUNDNUT-KERNEL) and splits/small kernels (GROUNDNUT-SPLITS); both feed agri.groundnut.oil_press. Shells are a by-product (fuel, litter).

agri.groundnut.shelling Nut shelling and cracking yields confirmed

What the factory receives

Raw material your system can send as a consignment (item.code):

ItemCodeUnitHS code
Groundnuts in shellGROUNDNUT-INSHELLkg1202.41

Units besides kg: bag50 = 50 kg bag (50 kg) , bag90 = 90 kg bag (90 kg)

What the factory makes

Groundnut shelling and kernel grading

InCodeShare
Groundnuts in shellGROUNDNUT-INSHELL100 %
OutCodeKindYield
Groundnut kernels (whole, shelled)GROUNDNUT-KERNELMain product50–62 %
Groundnut splits and small kernels (oil grade)GROUNDNUT-SPLITSCo-product8–15 %
Groundnut shellsGROUNDNUT-SHELLBy-product25–32 %
WasteWASTEWaste1–4 %

Steps: Pre-cleaning (stones, soil) → Decortication → Aspiration of shells → Hand sorting (mouldy, shrivelled kernels out) → Grading whole kernels and splits → Bagging

Yield is the share of the input weight, as a range seen in practice. The factory records the real weights on every run.

All products and intermediates

ItemCodeUnitHS code
Groundnut kernels (whole, shelled)GROUNDNUT-KERNELkg1202.42
Groundnut splits and small kernels (oil grade)GROUNDNUT-SPLITSkg1202.42
Groundnut shellsGROUNDNUT-SHELLkg

Quality checks

Groundnut in-shell intake intake

One composite sample per delivery; shell a 1 kg sample for the kernel test

ParameterAccepted
Moisture (in shell)≤ 9 %critical: a failure holds the lot
Kernel outturn on 1 kg sample≥ 65 %
Total aflatoxin (kernels)≤ 10 ppbcritical: a failure holds the lot
Foreign matter≤ 2 %

Kernel release release

One sample per bagged lot

ParameterAccepted
Moisture≤ 7 %critical: a failure holds the lot
Total aflatoxin≤ 10 ppbcritical: a failure holds the lot
Aflatoxin B1≤ 5 ppbcritical: a failure holds the lot
Mouldy, shrivelled, discoloured kernels≤ 3 %

Results travel in run.completed (quality) and a hold in lot.hold_changed.

Example messages

1. You send a consignment

POST /api/v1/consignments. Here as toll work (the sender keeps ownership and pays for processing); leave out mode to sell the goods to the factory.

{
    "reference_no": "VAB-26-7",
    "source": "society_api",
    "kind": "value_addition",
    "mode": "toll",
    "sender": {
        "external_system": "your-system",
        "society_id": 39,
        "name": "Example Farmers Co-operative"
    },
    "item": {
        "code": "GROUNDNUT-INSHELL"
    },
    "declared_qty": 1000,
    "unit": "kg",
    "dispatched_at": "2026-11-15T08:10:00+03:00",
    "lots": [
        {
            "lot_no": "LOT-001",
            "qty": 1000
        }
    ]
}

2. You receive the results

Webhook run.completed, for 1,000 kg in (the middle of each yield range). Main products and co-products carry their grade when the item is one of a graded family; quality carries the checks recorded on the run.

{
    "type": "run.completed",
    "data": {
        "reference_no": "VAB-26-7",
        "work_order_ref": "WO-26-0042",
        "item": "GROUNDNUT-KERNEL",
        "completed_at": "2026-11-16T17:30:00+03:00",
        "outturn_no": "LOT-…",
        "yield_pct": 56,
        "outputs": [
            {
                "item": "GROUNDNUT-KERNEL",
                "grade": "KERNEL",
                "role": "main",
                "qty": 560,
                "unit": "kg",
                "lot_no": "LOT-…",
                "yield_flag": null,
                "bags": 11,
                "bag_unit": "bag50",
                "packets": null
            },
            {
                "item": "GROUNDNUT-SPLITS",
                "grade": "SPLITS",
                "role": "co_product",
                "qty": 115,
                "unit": "kg",
                "lot_no": "LOT-…",
                "yield_flag": null,
                "bags": 2,
                "bag_unit": "bag50",
                "packets": null
            },
            {
                "item": "GROUNDNUT-SHELL",
                "grade": null,
                "role": "by_product",
                "qty": 285,
                "unit": "kg",
                "lot_no": "LOT-…",
                "yield_flag": null,
                "bags": null,
                "bag_unit": null,
                "packets": null
            },
            {
                "item": "WASTE",
                "grade": null,
                "role": "waste",
                "qty": 25,
                "unit": "kg",
                "lot_no": "LOT-…",
                "yield_flag": null,
                "bags": null,
                "bag_unit": null,
                "packets": null
            }
        ],
        "quality": []
    }
}

Before and after the run you also receive consignment.received (weighed in), and then statement.issued, sale.proceeds or invoice.issued and payment.recorded. See Connecting a supplier or society system.

Groundnut oil pressing