Value chains › Coffee
Coffee dry mill (toll hulling and grading)
Parchment brought by societies and estates is hulled, graded by screen and density into clean coffee grades on toll; husks are a by-product. Each run's clean coffee carries an outturn number; goods go back with a movement permit.
agri.coffee.dry_mill
Coffee wet and dry milling yields confirmed
What the factory receives
Raw material your system can send as a consignment (item.code):
| Item | Code | Unit | HS code |
|---|---|---|---|
| Coffee parchment | COFFEE-PARCHMENT | kg | 0901.11 |
Units besides kg: bag60 = 60 kg bag (60 kg)
What the factory makes
Hulling and grading
| In | Code | Share |
|---|---|---|
| Coffee parchment | COFFEE-PARCHMENT | 100 % |
| Out | Code | Kind | Yield |
|---|---|---|---|
| Clean coffee AB | CLEAN-AB | Main product | 28–36 % |
| Clean coffee AA | CLEAN-AA | Co-product | 10–16 % |
| Clean coffee PB (peaberry) | CLEAN-PB | Co-product | 4–8 % |
| Clean coffee C | CLEAN-C | Co-product | 6–11 % |
| Clean coffee E (elephant) | CLEAN-E | Co-product | 1–3 % |
| Clean coffee TT | CLEAN-TT | Co-product | 2–5 % |
| Clean coffee T | CLEAN-T | Co-product | 1–3 % |
| Coffee husks | COFFEE-HUSK | By-product | 17–21 % |
| Waste | WASTE | Waste | 1–3 % |
Steps: Pre-cleaning → Hulling and polishing → Screen grading → Density and colour sorting → Bagging by grade (60 kg)
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 |
|---|---|---|---|
| Clean coffee AA | CLEAN-AA | kg | 0901.11 |
| Clean coffee AB | CLEAN-AB | kg | 0901.11 |
| Clean coffee PB (peaberry) | CLEAN-PB | kg | 0901.11 |
| Clean coffee C | CLEAN-C | kg | 0901.11 |
| Clean coffee E (elephant) | CLEAN-E | kg | 0901.11 |
| Clean coffee TT | CLEAN-TT | kg | 0901.11 |
| Clean coffee T | CLEAN-T | kg | 0901.11 |
| Coffee husks | COFFEE-HUSK | kg |
Quality checks
Parchment receipt intake
Each consignment
| Parameter | Accepted | |
|---|---|---|
| Moisture | 10–12.5 % | critical: a failure holds the lot |
Clean coffee before dispatch release
One sample per outturn and grade
| Parameter | Accepted | |
|---|---|---|
| Moisture | 10–12 % | critical: a failure holds the lot |
| Screen size check | pass / fail | critical: a failure holds the lot |
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": "CMB-26-41",
"source": "society_api",
"kind": "coffee",
"mode": "toll",
"sender": {
"external_system": "your-system",
"society_id": 39,
"name": "Example Farmers Co-operative"
},
"item": {
"code": "COFFEE-PARCHMENT"
},
"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": "CMB-26-41",
"work_order_ref": "WO-26-0042",
"item": "CLEAN-AB",
"completed_at": "2026-11-16T17:30:00+03:00",
"outturn_no": "LOT-…",
"yield_pct": 32,
"outputs": [
{
"item": "CLEAN-AB",
"grade": "AB",
"role": "main",
"qty": 320,
"unit": "kg",
"lot_no": "LOT-…",
"yield_flag": null,
"bags": 5,
"bag_unit": "bag60",
"packets": null
},
{
"item": "CLEAN-AA",
"grade": "AA",
"role": "co_product",
"qty": 130,
"unit": "kg",
"lot_no": "LOT-…",
"yield_flag": null,
"bags": 2,
"bag_unit": "bag60",
"packets": null
},
{
"item": "CLEAN-PB",
"grade": "PB",
"role": "co_product",
"qty": 60,
"unit": "kg",
"lot_no": "LOT-…",
"yield_flag": null,
"bags": null,
"bag_unit": null,
"packets": null
},
{
"item": "CLEAN-C",
"grade": "C",
"role": "co_product",
"qty": 85,
"unit": "kg",
"lot_no": "LOT-…",
"yield_flag": null,
"bags": null,
"bag_unit": null,
"packets": null
},
{
"item": "CLEAN-E",
"grade": "E",
"role": "co_product",
"qty": 20,
"unit": "kg",
"lot_no": "LOT-…",
"yield_flag": null,
"bags": null,
"bag_unit": null,
"packets": null
},
{
"item": "CLEAN-TT",
"grade": "TT",
"role": "co_product",
"qty": 35,
"unit": "kg",
"lot_no": "LOT-…",
"yield_flag": null,
"bags": null,
"bag_unit": null,
"packets": null
},
{
"item": "CLEAN-T",
"grade": "T",
"role": "co_product",
"qty": 20,
"unit": "kg",
"lot_no": "LOT-…",
"yield_flag": null,
"bags": null,
"bag_unit": null,
"packets": null
},
{
"item": "COFFEE-HUSK",
"grade": null,
"role": "by_product",
"qty": 190,
"unit": "kg",
"lot_no": "LOT-…",
"yield_flag": null,
"bags": null,
"bag_unit": null,
"packets": null
},
{
"item": "WASTE",
"grade": null,
"role": "waste",
"qty": 20,
"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.
