Shipment¶
aggregate-root fulfillment
Fulfillment movement or collection unit used to complete customer delivery or pickup.
Business Purpose: Track packing, dispatch, delivery, and collection outcomes for fulfillment execution.
Identity¶
| Type | Field | Description |
|---|---|---|
global |
shipment-id |
Globally unique identifier for the shipment, stable across its fulfillment lifecycle. |
Attributes¶
| Attribute | Description |
|---|---|
shipment-id Shipment ID |
Stable shipment identifier. |
order-id Order ID |
Related order reference. |
fulfillment-order-id Fulfillment Order ID |
Related fulfillment order reference when available. |
status Status |
Current shipment state. |
shipped-at Shipped At |
Date and time when the shipment was dispatched. |
Lifecycle¶
created → packed → dispatched → delivered → collected → cancelled
Invariants¶
stable-shipment-id— Shipment ID must remain stable for the lifetime of the shipment.fulfillment-order-reference— A shipment must reference a fulfillment order.
Relationships¶
| Type | Target |
|---|---|
derives-from |
fulfillment-order fulfillment-order |
contains |
shipment-line shipment-line |
fulfills |
order order |
uses |
store store |
references |
address address |
Events¶
| Event | Classification | Terminal |
|---|---|---|
ShipmentPacked |
transitioned | — |
ShipmentDispatched |
transitioned | — |
ShipmentDelivered |
transitioned | ✓ |
Used by Capabilities¶
- fulfillment-execution Fulfillment Execution
Used by Processes¶
Used by Applications¶
- Carrier Platform
carrier-platform - SIM
sim - POS
pos
Semantic Constraints¶
| Constraint | Type | Rule |
|---|---|---|
shipment-references-address |
association |
A Shipment must have exactly one delivery Address. Fulfillment without… |
shipment-has-lines |
association |
A Shipment must contain at least one Shipment Line. An empty shipment … |
shipment-in-fulfillment-domain |
domain-containment |
The Shipment Business Object is owned by the Fulfillment domain. |
Note
Aligned with existing shipment object and fulfillment services.
Referenced by APIs¶
| Endpoint | Method | Role | Capability |
|---|---|---|---|
/shipments/{id}/tracking |
GET | response |
fulfillment-execution |
/shipments/{id}/label |
POST | response |
fulfillment-execution |