Value chains › Fish
Fish filleting (tilapia and Nile perch)
Whole tilapia (lake or cage) and Nile perch received on ice from beach management units or farms are filleted and skinned; fillets are sold chilled or IQF-frozen. Frames (mgongo wazi), skins and Nile perch maws are by-products; guts and scales are waste.
agri.fish.filleting
Slaughter yields confirmed
What the factory receives
Raw material your system can send as a consignment (item.code):
| Item | Code | Unit | HS code |
|---|---|---|---|
| Tilapia, whole fresh on ice | TILAPIA-WHOLE | kg | 0302.71 |
| Nile perch, whole fresh on ice | NILE-PERCH-WHOLE | kg | 0302.79 |
Units besides kg: ctn10 = 10 kg carton (10 kg)
What the factory makes
Tilapia filleting (whole fish basis)
| In | Code | Share |
|---|---|---|
| Tilapia, whole fresh on ice | TILAPIA-WHOLE | 100 % |
| Out | Code | Kind | Yield |
|---|---|---|---|
| Tilapia fillets, skinless, chilled | TILAPIA-FILLET | Main product | 30–35 % |
| Tilapia heads and frames | TILAPIA-FRAMES | By-product | 40–50 % |
| Fish skins (for leather, gelatine or feed) | FISH-SKIN | By-product | 4–7 % |
| Waste | WASTE | Waste | 10–18 % |
Steps: Receiving, temperature and sensory check → Washing and scaling → Filleting → Skinning and trimming → Pin-bone check (candling) → Chilling on ice and packing
Nile perch filleting (whole fish basis)
| In | Code | Share |
|---|---|---|
| Nile perch, whole fresh on ice | NILE-PERCH-WHOLE | 100 % |
| Out | Code | Kind | Yield |
|---|---|---|---|
| Nile perch fillets, skinless, chilled | NILE-PERCH-FILLET | Main product | 40–45 % |
| Nile perch frames and heads (mgongo wazi) | NILE-PERCH-FRAMES | By-product | 30–38 % |
| Fish skins (for leather, gelatine or feed) | FISH-SKIN | By-product | 4–6 % |
| Nile perch maws (swim bladders, fresh) | NILE-PERCH-MAW | Co-product | 1–2 % |
| Waste | WASTE | Waste | 8–15 % |
Steps: Receiving, temperature and sensory check → Washing → Maw removal → Filleting → Skinning and trimming → Chilling on ice and packing
Tilapia fillet IQF freezing and packing (per kg)
| In | Code | Share |
|---|---|---|
| Tilapia fillets, skinless, chilled | TILAPIA-FILLET |
| Out | Code | Kind | Yield |
|---|---|---|---|
| Tilapia fillets, IQF frozen | TILAPIA-FILLET-FZ | Main product | 97–99.5 % |
Steps: IQF freezing to -18 °C core → Glazing, bagging and cartoning
Nile perch fillet IQF freezing and packing (per kg)
| In | Code | Share |
|---|---|---|
| Nile perch fillets, skinless, chilled | NILE-PERCH-FILLET |
| Out | Code | Kind | Yield |
|---|---|---|---|
| Nile perch fillets, IQF frozen | NILE-PERCH-FILLET-FZ | Main product | 97–99.5 % |
Steps: IQF freezing to -18 °C core → Glazing, bagging and cartoning
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 |
|---|---|---|---|
| Tilapia fillets, skinless, chilled | TILAPIA-FILLET | kg | 0304.31 |
| Nile perch fillets, skinless, chilled | NILE-PERCH-FILLET | kg | 0304.33 |
| Tilapia fillets, IQF frozen | TILAPIA-FILLET-FZ | kg | 0304.61 |
| Nile perch fillets, IQF frozen | NILE-PERCH-FILLET-FZ | kg | 0304.63 |
| Tilapia heads and frames | TILAPIA-FRAMES | kg | |
| Nile perch frames and heads (mgongo wazi) | NILE-PERCH-FRAMES | kg | |
| Fish skins (for leather, gelatine or feed) | FISH-SKIN | kg | |
| Nile perch maws (swim bladders, fresh) | NILE-PERCH-MAW | kg | 0302.99 |
Quality checks
Whole fish intake intake
Every consignment: temperature on 5 fish, sensory on 10 fish
| Parameter | Accepted | |
|---|---|---|
| Fish core temperature | ≤ 4 °C | critical: a failure holds the lot |
| Freshness grade A or better (eyes, gills, odour, firmness) | pass / fail | critical: a failure holds the lot |
| Landing site / BMU or cage farm, catch date, fish movement permit | text | critical: a failure holds the lot |
| No undersize fish (Nile perch slot size) | pass / fail |
Chilled fillet release release
One sample per lot; micro samples per production day
| Parameter | Accepted | |
|---|---|---|
| Core temperature at dispatch | ≤ 2 °C | critical: a failure holds the lot |
| No bones, parasites or blood spots on candling | pass / fail | critical: a failure holds the lot |
| Micro results within limits (TVC, E. coli, Salmonella, Listeria) | pass / fail | critical: a failure holds the lot |
| Catch certificate / export health certificate number (export lots) | text |
Frozen fillet release release
One sample per lot; micro samples per production day
| Parameter | Accepted | |
|---|---|---|
| Core temperature | ≤ -18 °C | critical: a failure holds the lot |
| Glaze (net weight declared without glaze) | ≤ 10 % | |
| No bones, parasites or blood spots on candling | pass / fail | critical: a failure holds the lot |
| Micro results within limits (TVC, E. coli, Salmonella, Listeria) | pass / fail | critical: a failure holds the lot |
| Catch certificate / export health certificate number (export lots) | text |
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": "TILAPIA-WHOLE"
},
"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": "TILAPIA-FILLET",
"completed_at": "2026-11-16T17:30:00+03:00",
"outturn_no": "LOT-…",
"yield_pct": 32.5,
"outputs": [
{
"item": "TILAPIA-FILLET",
"grade": null,
"role": "main",
"qty": 325,
"unit": "kg",
"lot_no": "LOT-…",
"yield_flag": null,
"bags": null,
"bag_unit": null,
"packets": null
},
{
"item": "TILAPIA-FRAMES",
"grade": null,
"role": "by_product",
"qty": 450,
"unit": "kg",
"lot_no": "LOT-…",
"yield_flag": null,
"bags": null,
"bag_unit": null,
"packets": null
},
{
"item": "FISH-SKIN",
"grade": null,
"role": "by_product",
"qty": 55,
"unit": "kg",
"lot_no": "LOT-…",
"yield_flag": null,
"bags": null,
"bag_unit": null,
"packets": null
},
{
"item": "WASTE",
"grade": null,
"role": "waste",
"qty": 140,
"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 |
|---|---|---|---|
| Poly bag / carton liner for fillets | FILLET-BAG | pcs |
