Fulfilment
Understand how seller shipments and tracking return to the consumer order.
Fulfilment
Fulfilment carries shipment information from the seller back to the original
consumer order.
Two directions
| Flow | Direction | Purpose |
|---|---|---|
| Seller shipment | Your platform to SKUU | Report one shipped package and its tracking |
| Consumer tracking | SKUU to your platform | Add seller tracking to the original order |
Seller shipment flow
The seller sends one signed event per package. It reuses the SKUU order and
line references received during order creation so SKUU can reconcile the
package with the correct consumer order.
A package may contain several complete order lines. Connect v1 does not split
the quantity of one line across multiple packages.
Consumer tracking flow
SKUU sends the package tracking to the origin platform and identifies the
original consumer order and affected lines. The origin platform updates only
those lines and sends at most one customer shipment notification for the
logical package.
The request identity makes exact retries safe. An exact retry returns the same
result without another tracking update or customer notification.
Testing the flow
In TESTING, both teams prove one seller package, one consumer tracking update
and one exact replay. The result must be one package, one tracking update and no
duplicate customer notification.
Technical reference
- Deliver a signed Connect event
defines the exactfulfillment.shippedevent. - Add tracking to a consumer order
defines the exact tracking write.
Updated 12 days ago
