Value chains › Nuts
Macadamia cracking and kernel grading
Macadamia nut-in-shell (NIS) from growers is dried in silos, cracked, and the kernels sorted and graded by style (wholes, halves, pieces); oil-grade kernels and shells are by-products. Kernels are dried to 1.5 % moisture or less and vacuum-packed in 25 lb cartons.
agri.macadamia.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 |
|---|---|---|---|
| Macadamia nut-in-shell (NIS) | MACADAMIA-NIS | kg | 0802.61 |
Units besides kg: bag50 = 50 kg bag (50 kg) , ctn25lb = Kernel carton 25 lb (11.34 kg) (11.34 kg)
What the factory makes
Macadamia cracking and style grading
| In | Code | Share |
|---|---|---|
| Macadamia nut-in-shell (NIS) | MACADAMIA-NIS | 100 % |
| Out | Code | Kind | Yield |
|---|---|---|---|
| Macadamia kernels Style 4 (halves) | MAC-KERNEL-S4 | Main product | 10–13 % |
| Macadamia kernels Style 0/1 (wholes) | MAC-KERNEL-S1 | Co-product | 8–11 % |
| Macadamia kernels Style 2 (wholes and halves) | MAC-KERNEL-S2 | Co-product | 2–4 % |
| Macadamia kernels Style 5 (halves and pieces) | MAC-KERNEL-S5 | Co-product | 4–6 % |
| Macadamia kernels Style 6/7 (pieces and chips) | MAC-KERNEL-S7 | Co-product | 2–4 % |
| Macadamia oil-grade kernels (rejects) | MAC-KERNEL-OIL | By-product | 1–3 % |
| Macadamia shells (boiler fuel) | MAC-SHELL | By-product | 62–70 % |
| Waste | WASTE | Waste | 1–4 % |
Steps: NIS sorting (floaters out) → NIS drying in silos → Sizing and cracking → Shell separation → Kernel drying to 1.5 % or less → Colour sorting and style grading → Vacuum packing (25 lb)
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 |
|---|---|---|---|
| Macadamia kernels Style 4 (halves) | MAC-KERNEL-S4 | kg | 0802.62 |
| Macadamia kernels Style 0/1 (wholes) | MAC-KERNEL-S1 | kg | 0802.62 |
| Macadamia kernels Style 2 (wholes and halves) | MAC-KERNEL-S2 | kg | 0802.62 |
| Macadamia kernels Style 5 (halves and pieces) | MAC-KERNEL-S5 | kg | 0802.62 |
| Macadamia kernels Style 6/7 (pieces and chips) | MAC-KERNEL-S7 | kg | 0802.62 |
| Macadamia oil-grade kernels (rejects) | MAC-KERNEL-OIL | kg | 0802.62 |
| Macadamia shells (boiler fuel) | MAC-SHELL | kg |
Quality checks
Macadamia NIS intake intake
Per delivery: float test on 100 nuts; crack 100 nuts for sound kernel recovery
| Parameter | Accepted | |
|---|---|---|
| Immature nuts (float in water) | ≤ 5 % | critical: a failure holds the lot |
| Sound kernel recovery (100-nut crack test) | ≥ 28 % | |
| Mouldy, insect-damaged or germinated kernels | ≤ 5 % | |
| Husk remaining | ≤ 2 % |
Macadamia kernel release (per style) release
One sample per style lot before packing; micro sample per lot
| Parameter | Accepted | |
|---|---|---|
| Kernel moisture | ≤ 1.5 % | critical: a failure holds the lot |
| Kernels outside the style (sieve check) | ≤ 5 % | |
| Kernel defects (discoloured, mould, insect) | ≤ 2 % | critical: a failure holds the lot |
| Salmonella absent in 375 g (lab) | pass / fail | critical: a failure holds the lot |
| Pouch vacuum seal intact | 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": "MACADAMIA-NIS"
},
"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": "MAC-KERNEL-S4",
"completed_at": "2026-11-16T17:30:00+03:00",
"outturn_no": "LOT-…",
"yield_pct": 11.5,
"outputs": [
{
"item": "MAC-KERNEL-S4",
"grade": "S4",
"role": "main",
"qty": 115,
"unit": "kg",
"lot_no": "LOT-…",
"yield_flag": null,
"bags": null,
"bag_unit": null,
"packets": null
},
{
"item": "MAC-KERNEL-S1",
"grade": "S1",
"role": "co_product",
"qty": 95,
"unit": "kg",
"lot_no": "LOT-…",
"yield_flag": null,
"bags": null,
"bag_unit": null,
"packets": null
},
{
"item": "MAC-KERNEL-S2",
"grade": "S2",
"role": "co_product",
"qty": 30,
"unit": "kg",
"lot_no": "LOT-…",
"yield_flag": null,
"bags": null,
"bag_unit": null,
"packets": null
},
{
"item": "MAC-KERNEL-S5",
"grade": "S5",
"role": "co_product",
"qty": 50,
"unit": "kg",
"lot_no": "LOT-…",
"yield_flag": null,
"bags": null,
"bag_unit": null,
"packets": null
},
{
"item": "MAC-KERNEL-S7",
"grade": "S7",
"role": "co_product",
"qty": 30,
"unit": "kg",
"lot_no": "LOT-…",
"yield_flag": null,
"bags": null,
"bag_unit": null,
"packets": null
},
{
"item": "MAC-KERNEL-OIL",
"grade": null,
"role": "by_product",
"qty": 20,
"unit": "kg",
"lot_no": "LOT-…",
"yield_flag": null,
"bags": null,
"bag_unit": null,
"packets": null
},
{
"item": "MAC-SHELL",
"grade": null,
"role": "by_product",
"qty": 660,
"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.
Packaging and consumables
| Item | Code | Unit | HS code |
|---|---|---|---|
| Vacuum foil pouch 25 lb | KERNEL-POUCH-VAC | pcs |
