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):
| Item | Code | Unit | HS code |
|---|---|---|---|
| Groundnuts in shell | GROUNDNUT-INSHELL | kg | 1202.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
| In | Code | Share |
|---|---|---|
| Groundnuts in shell | GROUNDNUT-INSHELL | 100 % |
| Out | Code | Kind | Yield |
|---|---|---|---|
| Groundnut kernels (whole, shelled) | GROUNDNUT-KERNEL | Main product | 50–62 % |
| Groundnut splits and small kernels (oil grade) | GROUNDNUT-SPLITS | Co-product | 8–15 % |
| Groundnut shells | GROUNDNUT-SHELL | By-product | 25–32 % |
| Waste | WASTE | Waste | 1–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
| Item | Code | Unit | HS code |
|---|---|---|---|
| Groundnut kernels (whole, shelled) | GROUNDNUT-KERNEL | kg | 1202.42 |
| Groundnut splits and small kernels (oil grade) | GROUNDNUT-SPLITS | kg | 1202.42 |
| Groundnut shells | GROUNDNUT-SHELL | kg |
Quality checks
Groundnut in-shell intake intake
One composite sample per delivery; shell a 1 kg sample for the kernel test
| Parameter | Accepted | |
|---|---|---|
| Moisture (in shell) | ≤ 9 % | critical: a failure holds the lot |
| Kernel outturn on 1 kg sample | ≥ 65 % | |
| Total aflatoxin (kernels) | ≤ 10 ppb | critical: a failure holds the lot |
| Foreign matter | ≤ 2 % |
Kernel release release
One sample per bagged lot
| Parameter | Accepted | |
|---|---|---|
| Moisture | ≤ 7 % | critical: a failure holds the lot |
| Total aflatoxin | ≤ 10 ppb | critical: a failure holds the lot |
| Aflatoxin B1 | ≤ 5 ppb | critical: 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.
