Value chains › Cosmetics Soap
Soap and cosmetics (batch)
Formulas by % scaled to the batch; in-process pH check; lots held until the lab releases them; labels with GTIN; certificate of analysis on dispatch.
mfg.cosmetics_soap
Formulation and mixing 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 |
|---|---|---|---|
| Palm oil (RBD) | PALM-OIL | kg | |
| Coconut oil | COCONUT-OIL | kg | |
| Caustic soda flakes | CAUSTIC-SODA | kg | |
| Glycerin | GLYCERIN | kg | |
| Lavender fragrance | FRAGRANCE-LAV | kg | |
| Violet colour | COLOUR-VIOLET | kg |
What the factory makes
Soap base (formula by %)
| In | Code | Share |
|---|---|---|
| Palm oil (RBD) | PALM-OIL | 62 % |
| Coconut oil | COCONUT-OIL | 20 % |
| Caustic soda flakes | CAUSTIC-SODA | 14 % |
| Glycerin | GLYCERIN | 4 % |
| Out | Code | Kind | Yield |
|---|---|---|---|
| Soap noodles (saponified base) | SOAP-BASE | Main product | 94–99 % |
| Waste | WASTE | Waste | 1–6 % |
Steps: Saponification → Drying to noodles
Lavender bath soap 200 g
| In | Code | Share |
|---|---|---|
| Soap noodles (saponified base) | SOAP-BASE | |
| Lavender fragrance | FRAGRANCE-LAV | |
| Violet colour | COLOUR-VIOLET | |
| Soap wrapper 200 g | WRAPPER-200G |
| Out | Code | Kind | Yield |
|---|---|---|---|
| Lavender bath soap 200 g | SOAP-LAV-200G | Main product |
Steps: Mixing, plodding and stamping → Wrapping 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 |
|---|---|---|---|
| Soap noodles (saponified base) | SOAP-BASE | kg | |
| Lavender bath soap 200 g | SOAP-LAV-200G | pcs | 3401.11 |
Quality checks
Soap base in process in_process
Each kettle batch
| Parameter | Accepted | |
|---|---|---|
| pH (1 % solution) | 9–10.5 pH | critical: a failure holds the lot |
| Free caustic alkali | ≤ 0.05 % | critical: a failure holds the lot |
Bath soap release release
One sample per lot; lot held until released
| Parameter | Accepted | |
|---|---|---|
| Total fatty matter | ≥ 76 % | critical: a failure holds the lot |
| Moisture | ≤ 14 % | critical: a failure holds the lot |
| Bar weight | ≥ 200 g | 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 Supplier Ltd"
},
"item": {
"code": "PALM-OIL"
},
"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": "SOAP-BASE",
"completed_at": "2026-11-16T17:30:00+03:00",
"outturn_no": "LOT-…",
"yield_pct": 96.5,
"outputs": [
{
"item": "SOAP-BASE",
"grade": null,
"role": "main",
"qty": 965,
"unit": "kg",
"lot_no": "LOT-…",
"yield_flag": null,
"bags": null,
"bag_unit": null,
"packets": null
},
{
"item": "WASTE",
"grade": null,
"role": "waste",
"qty": 35,
"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 |
|---|---|---|---|
| Soap wrapper 200 g | WRAPPER-200G | pcs |
