Parcel Status Update

Parcel status update allows you to sync delivery status from your logistics platform back to EasyStore, keeping merchants and customers informed about their shipment progress.

How It Works

When there are status updates from your logistics platform (e.g., parcel picked up, in transit, delivered), you can use the Update Fulfillment API to sync the status back to EasyStore.

Your logistics platform receives a delivery status update
Your app calls the EasyStore Update Fulfillment API with the new status
EasyStore updates the order's fulfillment status in the merchant's admin panel
Customers can see the updated tracking status

Update Fulfillment API


      curl --location --request PUT 'https://{shop}/api/3.0/orders/:order_id/fulfillments/:fulfillment_id.json' \
--header 'EasyStore-Access-Token: {app_access_token}' \
--header 'Content-Type: application/json' \
--data '{
    "courier": "AllSome",
    "tracking_number": "EN813659438MY",
    "tracking_url": "https://tracking_url.com/EN813659438MY",
    "status": "delivered",
    "service": "AllSome Fulfillment Malaysia",
    "message": "Delivered"
}'

URL Parameters

Parameter	Description
`:order_id`	The ID of the order
`:fulfillment_id`	The ID of the fulfillment to update

Request Body Parameters

Parameter	Type	Description
`courier`	string	Name of the courier/logistics provider
`tracking_number`	string	Parcel tracking number
`tracking_url`	string	URL for tracking the parcel
`status`	string	Current status of the parcel
`service`	string	Name of the shipping service
`message`	string	Status message or description

📖 Full documentation on Update Fulfillment API: EasyStore Postman Collection

Status Values

Common status values you can use:

Status	Description
`pending`	Shipment created, awaiting pickup
`in_transit`	Parcel is on the way
`out_for_delivery`	Parcel is out for delivery
`delivered`	Parcel has been delivered
`failed`	Delivery attempt failed
`returned`	Parcel returned to sender

Next Steps

Ready to test your integration? Check out the Testing & Debugging guide to ensure everything works correctly.