Value chains › Dairy
Dairy cooling centre
Raw milk collected from farmers in cans, tested per can at reception, bulked into a cooling tank as one lot per day; transport deducted per litre; farmers paid monthly.
agri.dairy.cooling
Dairy example yields, to be confirmed at the factory
What the factory receives
Raw material your system can send as a consignment (item.code):
| Item | Code | Unit | HS code |
|---|---|---|---|
| Raw cow milk | MILK-RAW | L | 0401.20 |
Units besides kg: can50 = 50 L milk can (50 L) , can20 = 20 L milk can (20 L)
What the factory makes
Day lot into the cooling tank
| In | Code | Share |
|---|---|---|
| Raw cow milk | MILK-RAW | 100 % |
| Out | Code | Kind | Yield |
|---|---|---|---|
| Chilled bulk milk (day lot) | MILK-BULK | Main product | 99–100 % |
| Waste | WASTE | Waste | 0–1 % |
Steps: Filter and bulk → Cool to 4 °C
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 |
|---|---|---|---|
| Chilled bulk milk (day lot) | MILK-BULK | L | 0401.20 |
Quality checks
Raw milk per can at reception intake
Every can: smell and alcohol test at the platform; lactometer and milk analyser on a sample per farmer per delivery
| Parameter | Accepted | |
|---|---|---|
| Smell, colour and appearance | pass / fail | critical: a failure holds the lot |
| Alcohol test (68 % ethanol) | pass / fail | critical: a failure holds the lot |
| Density (lactometer, 20 °C) | 1.026–1.033 g/mL | critical: a failure holds the lot |
| Butterfat | ≥ 3.25 % | |
| Solids-not-fat | ≥ 8.5 % | |
| Antibiotic residues (rapid test) | pass / fail | critical: a failure holds the lot |
| Temperature at reception | ≤ 25 °C |
Bulk tank before dispatch release
One sample per tank per day
| Parameter | Accepted | |
|---|---|---|
| Tank temperature | ≤ 4 °C | critical: a failure holds the lot |
| Alcohol test | pass / fail | critical: a failure holds the lot |
| Antibiotic residues | 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": "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": "MILK-RAW"
},
"declared_qty": 1000,
"unit": "L",
"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": "MILK-BULK",
"completed_at": "2026-11-16T17:30:00+03:00",
"outturn_no": "LOT-…",
"yield_pct": 99.5,
"outputs": [
{
"item": "MILK-BULK",
"grade": null,
"role": "main",
"qty": 995,
"unit": "L",
"lot_no": "LOT-…",
"yield_flag": null,
"bags": null,
"bag_unit": null,
"packets": null
},
{
"item": "WASTE",
"grade": null,
"role": "waste",
"qty": 5,
"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.
