intermediate 5 min
Fulfillment Sync
Propagate tracking information from source stores back to customers.
When a source store fulfills an order, the platform automatically syncs tracking information back to the reseller store so customers receive shipping confirmations.
How it works
- A source store marks an order as fulfilled in Shopify
- Shopify sends a
fulfillments/createwebhook toPOST /v1/fulfillments/webhook - The platform looks up the corresponding sync job to find the original reseller order
- Tracking information (number, carrier, URL) is forwarded to the reseller store via the Shopify API
- The customer receives a branded shipping confirmation from the reseller store
Required webhook setup
Configure the fulfillments/create webhook on each source store in Shopify, pointing to:
POST https://api.example.com/v1/fulfillments/webhookThe webhook must include the X-Shopify-Hmac-SHA256 and X-Shopify-Shop-Domain headers for HMAC verification.
Tracking information
The fulfillment webhook extracts:
| Field | Description |
|---|---|
tracking_number | Carrier tracking number |
tracking_company | Carrier name (defaults to “Unknown” if absent) |
tracking_url | Tracking URL (optional) |
Prerequisites
For fulfillment sync to work:
- The source store must have a completed sync job for the order
- The sync job must have a
sourceOrderId(set when the source order was created) - The reseller store’s access token must have fulfillment write permissions