Webhook – Order Status Push

Logistiq uses webhooks to push real-time order status updates to client systems.
Clients can configure their webhook URL in our system, which will then be used to send updates for all order statuses.

📩 Sample Request Payload

{
    "waybill": "MACMSASAF000003044",
    "SellerOrganizationCode": "AE",
    "OrderNo": "",
    "ShipNode": "Mahmoud Mohamed",
    "ShipmentNo": "1008975850_20250518120507",
    "Status": "PICKED_UP",
    "StatusCode": 126,
    "time_stamp": "2025-05-19 09:50:30.278287+00:00", // YYYY-MM-DD HH:MM:SS.ssssss±HH:MM (ISO 8601)
    "scan_time": "2025-05-19 09:50:29.738086+00:00", // YYYY-MM-DD HH:MM:SS.ssssss±HH:MM (ISO 8601)
    "scan_location": "LOGFUJ",
    "items": [
        {
            "sku": 166813137,
            "mode": "Manual",
            "price": 45.0,
            "quantity": 1,
            "description": "Plus Size Striped Polo T-shirt with Short Sleeves - Blue -",
            "isExtraItem": false,
            "total_quantity": 1
        }
    ],
    "remarks": "Return Order Picked Up",
    "additional_remarks": "Picked Up",
    "additional_info": {
        "pod_url": "https://storage-googleapis.com/lorem-ipsum/MACMSASAF000003044",
        "otp": "",
        "driver_details": {
            "name": "P_TEX_NDD_FUJ_Rajeep Tamang",
            "phone_number": 971562885041
        }
    },
"Source": "Logistiq"
}

✅ Expected Response (from Client Webhook)

{
  "status": true
}

⚠️ The webhook URL must be publicly accessible and support POST requests with JSON content.

Status mapping

Below is the complete list of all the order statuses we send.
To enhance readability and responsiveness, the statuses are split into Forward and Return shipment directions.

Forward Shipment Statuses

Status ID	Status Name	Description	Shipment Direction
101	BOOKED	Order has been created in the system.	Forward
104	CANCELLED	Order cancelled before pickup.	Forward
105	PICKED_UP	Package picked up from origin.	Forward
106	IN_HUB	Package has been unscanned in the hub/warehouse and is in the unplanned state.	Forward
107	MANIFESTED	Shipment has been listed for dispatch.	Forward
110	INTRANSIT	Package is in transit between hubs.	Forward
111	OUT_FOR_DELIVERY	Package is out with delivery agent.	Forward
112	DELIVERED	Successfully delivered to the customer.	Forward
113	PARTIALLY_RETURNED	Only some items were returned.	Forward
114	RETURNED	Complete order was returned.	Forward
115	ON_HOLD	Shipment is temporarily paused.	Forward
116	LOST	Shipment was lost in transit.	Forward
117	DAMAGED	Shipment was found damaged.	Forward
118	SHIPMENT_DELAYED	Delay due to unforeseen circumstances.	Forward
119	SHIPMENT_HELD	Held due to documentation or address issues.	Forward
121	NOT_SERVICEABLE	Area not covered by courier.	Forward
122	FAILED_DELIVERY	Delivery attempt failed.	Forward
147	RTO_REQUESTED	Return to origin requested.	Forward
148	RTO_OUT_FOR_DELIVERY	RTO package out for delivery back to origin.	Forward
149	RTO_DELIVERED	Returned package received at origin.	Forward
150	RTO_FAILED	RTO delivery failed.	Forward
153	RTO_INTRANSIT	RTO package in transit.	Forward
154	OUT_FOR_PICKUP	Pickup agent en route.	Forward
168	RTO	Generic Return to Origin.	Forward
169	RTO_SHIPMENT_DELAY	RTO delayed in transit.	Forward
182	HANDED_OVER_AT_ORIGIN_PORT	Given to carrier at origin port.	Forward
183	DEPARTED_FROM_ORIGIN_PORT	Left the origin port.	Forward
184	ARRIVED_AT_DESTINATION_PORT	Reached destination port.	Forward
185	CLEARED_FROM_DESTINATION_PORT	Cleared customs at destination.	Forward
186	HELD_BY_CUSTOMS	Held by customs for inspection.	Forward
187	CONFISCATED_BY_CUSTOMS	Seized by customs.	Forward
188	PROHIBITED_BY_CUSTOMS	Contains prohibited items.	Forward
189	RE-EXPORT_BACK_TO_ORIGIN	Returned to origin country.	Forward
190	AIRLINE_DELAY	Delayed due to airline issues.	Forward
191	LOST_AT_GATEWAY	Lost at transit hub.	Forward
192	DAMAGED_AT_GATEWAY	Damaged at transit hub.	Forward

Return Shipment Statuses

Status ID	Status Name	Description	Shipment Direction
124	CREATED	Return order created.	Return
125	OUT_FOR_PICKUP	Agent dispatched for return pickup.	Return
126	PICKED_UP	Return item collected.	Return
127	INTRANSIT	Return item in transit.	Return
128	IN_HUB	Return package at hub.	Return
129	MANIFESTED	Listed for return dispatch.	Return
130	UNASSIGNED	No agent assigned for return.	Return
131	ASSIGNED	Agent assigned for return.	Return
132	DELIVERED	Return completed.	Return
133	RETURN_CANCELLED	Return process cancelled.	Return
134	ON HOLD	Return is paused.	Return
135	LOST	Return shipment lost.	Return
136	DAMAGED	Return item damaged.	Return
137	SHIPMENT_DELAYED	Return delayed.	Return
138	SHIPMENT_HELD	Return held for issues.	Return
139	PICKUP_FAILED	Failed to collect return.	Return
140	OUT_FOR_DELIVERY	Return out for delivery.	Return
142	UNMAPPED_RETURN	Unknown return status.	Return
144	PICKUP_PENDING	Pickup pending scheduling.	Return
152	CONTACT_CUSTOMER_CARE	Manual action needed.	Return
156	RTO_CONACT_CUSTOMER_CARE	Customer care involved.	Return
158	AWB_REGISTERED	Waybill created for return.	Return
160	EXPIRED	Return order expired.	Return
162	EXCHANGE_PICKUP	Scheduled for exchange.	Return
164	EXCHANGE_INTRANSIT	Exchange item en route.	Return
166	EXCHANGE_DELIVERED	Exchange delivered.	Return
167	FAILED_DELIVERY	Return delivery failed.	Return
170	NOT_SERVICEABLE	Location not serviceable for return.	Return