Inventory Item¶
entity inventory
Item-level inventory reference used by basket, order, shipment, reservation, and allocation records.
Business Purpose: Provide the item granularity needed for inventory visibility and fulfillment decisions.
Attributes¶
| Attribute | Description |
|---|---|
inventory-item-id Inventory Item ID |
Stable inventory item identifier. |
item-id Item ID |
Item reference. |
location-id Location ID |
Inventory location reference. |
status Status |
Current inventory item state. |
updated-at Updated At |
Date and time when the inventory item was last updated. |
Lifecycle¶
created → active → unavailable → inactive → retired
Relationships¶
| Type | Target |
|---|---|
belongs-to |
inventory inventory |
Semantic Constraints¶
| Constraint | Type | Rule |
|---|---|---|
order-line-references-product |
association |
Every Order Line must reference exactly one Product. An order line wit… |
basket-line-references-product |
association |
Every Basket Line must reference exactly one Product. |
Note
Current repository models reference inventory but do not directly model inventory-item.
Referenced by APIs¶
| Endpoint | Method | Role | Capability |
|---|---|---|---|
/inventory/items/{sku} |
GET | response |
inventory-visibility |
/stock/{sku}/locations |
GET | response |
store-inventory |
/inventory/{sku}/availability |
GET | response |
inventory-visibility |