Product & Packaging
A Product is the template for what is tracked — the trade item or asset class. A Product is not the physical thing in your warehouse; that is an Instance.
Product
| Field | Type | Notes |
|---|---|---|
id | integer | Stockaj internal id |
gtin | string(14) | Canonicalised GTIN, optional, validated Mod-10 |
name | string | |
uom | string | UN/CEFACT Rec 20 unit code (PCE, KGM, LTR, EA) |
tracking_mode | enum | NONE, LOT, SERIAL, AGGREGATE |
ilmd_schema | object | Optional ILMD field schema for child instances |
Tracking modes
| Mode | When to use | Instance kind generated |
|---|---|---|
NONE | Bulk consumables, no per-unit identity | BULK (one bucket per location) |
LOT | Batch-tracked consumables, expiry matters | LOT |
SERIAL | Each unit individually identified | SERIAL |
AGGREGATE | Logistic units (pallet, returnable container) | SSCC |
Packaging levels
A product can have multiple packaging levels, each with its own GTIN:
Each (PCE) — GTIN-14 starting "0..."
Inner case (10x) — GTIN-14 starting "1..."
Outer case (50x) — GTIN-14 starting "2..."
Pallet (1000x) — GTIN-14 starting "3..."
Levels are recorded in packaging_levels rows attached to the
product.