Value chains › Coffee
Coffee wet mill (pulping station)
Cherry delivered by farmers is pulped, fermented, washed and dried to parchment at the society's factory; floats dry to mbuni; pulp goes to compost. Farmers are paid per kg of cherry after the coffee is sold.
agri.coffee.wet_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 cherry | COFFEE-CHERRY | kg | 0901.11 |
Units besides kg: bag60 = 60 kg bag (60 kg)
What the factory makes
Pulping and drying
| In | Code | Share |
|---|---|---|
| Coffee cherry | COFFEE-CHERRY | 100 % |
| Out | Code | Kind | Yield |
|---|---|---|---|
| Coffee parchment | COFFEE-PARCHMENT | Main product | 16–20 % |
| Mbuni (dried cherry) | COFFEE-MBUNI | By-product | 1–5 % |
| Coffee pulp (compost) | COFFEE-PULP | By-product | 38–45 % |
| Waste | WASTE | Waste | 32–42 % |
Steps: Sorting and floating → Pulping → Fermentation (24–36 h) → Washing and grading in channels → Drying on tables to 10–12 % moisture
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 |
|---|---|---|---|
| Coffee parchment | COFFEE-PARCHMENT | kg | 0901.11 |
| Mbuni (dried cherry) | COFFEE-MBUNI | kg | |
| Coffee pulp (compost) | COFFEE-PULP | kg |
Quality checks
Cherry intake intake
Each delivery, by the clerk at the cherry reception
| Parameter | Accepted | |
|---|---|---|
| Ripe red cherry | ≥ 95 % | critical: a failure holds the lot |
| Foreign matter and leaves | ≤ 1 % |
Parchment before delivery to the dry mill release
One sample per lot
| Parameter | Accepted | |
|---|---|---|
| Moisture | 10–12 % | critical: a failure holds the lot |
| Visible defects (insect, black) | ≤ 5 % |
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-CHERRY"
},
"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": "COFFEE-PARCHMENT",
"completed_at": "2026-11-16T17:30:00+03:00",
"outturn_no": "LOT-…",
"yield_pct": 18,
"outputs": [
{
"item": "COFFEE-PARCHMENT",
"grade": null,
"role": "main",
"qty": 180,
"unit": "kg",
"lot_no": "LOT-…",
"yield_flag": null,
"bags": 3,
"bag_unit": "bag60",
"packets": null
},
{
"item": "COFFEE-MBUNI",
"grade": null,
"role": "by_product",
"qty": 30,
"unit": "kg",
"lot_no": "LOT-…",
"yield_flag": null,
"bags": null,
"bag_unit": null,
"packets": null
},
{
"item": "COFFEE-PULP",
"grade": null,
"role": "by_product",
"qty": 415,
"unit": "kg",
"lot_no": "LOT-…",
"yield_flag": null,
"bags": null,
"bag_unit": null,
"packets": null
},
{
"item": "WASTE",
"grade": null,
"role": "waste",
"qty": 370,
"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.
