Basket Line¶
entity commerce
Line-level item entry within a basket.
Business Purpose: Represent the item, quantity, price, tax, promotion, and fulfillment-relevant details selected before checkout.
Aliases: basket-item
Attributes¶
| Attribute | Description |
|---|---|
basket-line-id Basket Line ID |
Stable basket line identifier. |
basket-id Basket ID |
Reference to the parent basket. |
item-id Item ID |
Reference to the item being purchased. |
quantity Quantity |
Quantity selected. |
status Status |
Current basket line state. |
Lifecycle¶
created → active → updated → removed → converted
Relationships¶
| Type | Target |
|---|---|
belongs-to |
basket basket |
references |
inventory-item inventory-item |
contains |
price price |
contains |
tax-rate tax-rate |
Semantic Constraints¶
| Constraint | Type | Rule |
|---|---|---|
basket-may-have-lines |
association |
A Basket may contain zero or more Basket Lines. An empty basket is val… |
basket-line-references-product |
association |
Every Basket Line must reference exactly one Product. |
Note
Existing models use basket-item; this catalog uses basket-line per OBJ-001 target structure.
Referenced by APIs¶
| Endpoint | Method | Role | Capability |
|---|---|---|---|
/baskets/{id}/lines |
POST | request-body |
basket-management |