Prodaksha Developers

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):

ItemCodeUnitHS code
Coffee parchmentCOFFEE-PARCHMENTkg0901.11

Units besides kg: bag60 = 60 kg bag (60 kg)

What the factory makes

Hulling and grading

InCodeShare
Coffee parchmentCOFFEE-PARCHMENT100 %
OutCodeKindYield
Clean coffee ABCLEAN-ABMain product28–36 %
Clean coffee AACLEAN-AACo-product10–16 %
Clean coffee PB (peaberry)CLEAN-PBCo-product4–8 %
Clean coffee CCLEAN-CCo-product6–11 %
Clean coffee E (elephant)CLEAN-ECo-product1–3 %
Clean coffee TTCLEAN-TTCo-product2–5 %
Clean coffee TCLEAN-TCo-product1–3 %
Coffee husksCOFFEE-HUSKBy-product17–21 %
WasteWASTEWaste1–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

ItemCodeUnitHS code
Clean coffee AACLEAN-AAkg0901.11
Clean coffee ABCLEAN-ABkg0901.11
Clean coffee PB (peaberry)CLEAN-PBkg0901.11
Clean coffee CCLEAN-Ckg0901.11
Clean coffee E (elephant)CLEAN-Ekg0901.11
Clean coffee TTCLEAN-TTkg0901.11
Clean coffee TCLEAN-Tkg0901.11
Coffee husksCOFFEE-HUSKkg

Quality checks

Parchment receipt intake

Each consignment

ParameterAccepted
Moisture10–12.5 %critical: a failure holds the lot

Clean coffee before dispatch release

One sample per outturn and grade

ParameterAccepted
Moisture10–12 %critical: a failure holds the lot
Screen size checkpass / failcritical: 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.

Coffee wet mill (pulping station)