Driver status notification
Driver status notifications report key milestones in a last‑mile delivery: pickup, transit, drop‑off, and returns. Walmart sends a JSON payload to your destination URL for each status change. Use these events to update order tracking, notify customers, and reconcile delivery Service Level Agreements (SLAs).
Event metadata
- Event type: DRIVER_STATUS
- Event version: V1
- Resource name: ORDER
Response parameters
| Name | Description | Type |
|---|---|---|
| source | Metadata about the event | Object |
| eventType | Event for which the notification is received. Example: DRIVER_STATUS | String |
| eventTime | Timestamp of when the event occurred in ISO 8601 UTC | String |
| eventId | Unique identifier for the event | String |
| eventFilters | Reserved for future use; may be null | Object or null |
| payload | Event-specific details | Object |
| partnerId | Seller’s partner ID | String |
| sellerId | Seller’s account identifier | String |
| purchaseOrderId | A unique identifier associated with the seller’s purchase order | String |
| customerOrderId | A unique identifier associated with the sales order for a specified customer | String |
| orderDate | The date the customer submitted the sales order | String |
| orderStatus | Current order status. Example: LOADED | String |
| deliveryId | Unique delivery identifier | String |
| deliveryStatus | Driver status value. See the Supported delivery statuses table. | String (enum) |
| orderPickupReadyTime | Earliest time the order is ready for pickup. ZonedDateTime. ISO 8601 UTC | String |
| minDeliverySlotTime | Start of promised delivery window. ZonedDateTime. ISO 8601 UTC | String |
| maxDeliverySlotTime | End of promised delivery window. ZonedDateTime. ISO 8601 UTC | String |
| actualDeliveryPickupTime | Time the driver picked up the order in epoch milliseconds | Long |
| actualDeliveryTime | Time the delivery was completed. ZonedDateTime. ISO 8601 UTC if present | String |
| undeliverableReasons | If not delivered, reason details. The reason that was selected during the return creation | String |
| reasonCode | Exception code when not delivered. Example: 3P629, LMD1505 | String |
| description | Human‑readable reason. Example: Can't Access, Found a better offer | String |
| driverFirstName | Driver’s first name | String |
| driverLastName | Driver’s last name | String |
| driverPhoneNo | Driver’s phone number | String |
Supported delivery statuses (deliveryStatus)
deliveryStatus)| Value | When it occurs | Typical use |
|---|---|---|
| ENROUTE_TO_PICKUP | Driver is heading to the pickup location. | Show driver ETA to pickup; prep order. |
| ARRIVED_AT_PICKUP | Driver has arrived at the pickup location. | Signal handoff to driver. |
| DISPATCHED | Driver departed pickup with order. | Start customer tracking; mark order as on the way. |
| ENROUTE_TO_DROPOFF | In transit to customer. | Update customer ETA. |
| ARRIVED_AT_DROPOFF | Driver reached the drop‑off location. | Prepare for delivery confirmation. |
| DELIVERED | Delivery completed. | Close shipment; trigger post‑delivery flows. |
| ENROUTE_TO_RETURN | Driver is returning undelivered items. | Inform customer and ops; start exception flow. |
| ARRIVED_TO_RETURN | Driver arrived at the return location. | Receive returned goods. |
| RETURNED | Return to facility is complete. | Reconcile inventory and refund if applicable. |
Sample payloads by delivery status
ENROUTE_TO_PICKUP
{ "source": { "eventType": "DRIVER_STATUS", "eventFilters": null, "eventTime": "2024-09-09T19:03:46.929Z", "eventId": "3dbbd610-6ede-11ef-957a-bf6d1de809fa" }, "payload": { "customerOrderId": "100000312331630", "orderStatus": "LOADED", "minDeliverySlotTime": "2024-09-09T23:00:00Z", "deliveryId": "7c24f274-7f86-42f6-919b-e20a76adb4e1", "maxDeliverySlotTime": "2024-09-10T03:00:00Z", "sellerId": "B9B9CE8389BA485EA057D862AB334CD4", "purchaseOrderId": "108925441672969", "driverFirstName": "Test", "driverPhoneNo": "8888888888", "orderPickupReadyTime": "2024-09-09T23:00:00Z", "undeliverableReasons": "", "driverLastName": "jones9", "partnerId": "10900063103", "orderDate": "", "deliveryStatus": "ENROUTE_TO_PICKUP", "actualDeliveryPickupTime": "1725908620304" }
}
ARRIVED_AT_PICKUP
{ "source": { "eventType": "DRIVER_STATUS", "eventFilters": null, "eventTime": "2024-09-09T19:03:50.044Z", "eventId": "3f9725c0-6ede-11ef-957a-bf6d1de809fa" }, "payload": { "customerOrderId": "100000312331630", "orderStatus": "LOADED", "minDeliverySlotTime": "2024-09-09T23:00:00Z", "deliveryId": "7c24f274-7f86-42f6-919b-e20a76adb4e1", "maxDeliverySlotTime": "2024-09-10T03:00:00Z", "sellerId": "B9B9CE8389BA485EA057D862AB334CD4", "purchaseOrderId": "108925441672969", "driverFirstName": "Test", "driverPhoneNo": "8888888888", "orderPickupReadyTime": "2024-09-09T23:00:00Z", "undeliverableReasons": "", "driverLastName": "jones9", "partnerId": "10900063103", "orderDate": "", "deliveryStatus": "ARRIVED_AT_PICKUP", "actualDeliveryPickupTime": "1725908624330" }
}
DISPATCHED
{ "source": { "eventType": "DRIVER_STATUS", "eventFilters": null, "eventTime": "2024-09-09T19:06:26.788Z", "eventId": "9d046240-6ede-11ef-957a-bf6d1de809fa" }, "payload": { "customerOrderId": "100000312331630", "orderStatus": "LOADED", "minDeliverySlotTime": "2024-09-09T23:00:00Z", "deliveryId": "7c24f274-7f86-42f6-919b-e20a76adb4e1", "maxDeliverySlotTime": "2024-09-10T03:00:00Z", "sellerId": "B9B9CE8389BA485EA057D862AB334CD4", "purchaseOrderId": "108925441672969", "driverFirstName": "Test", "driverPhoneNo": "8888888888", "orderPickupReadyTime": "2024-09-09T23:00:00Z", "undeliverableReasons": "", "driverLastName": "jones9", "partnerId": "10900063103", "orderDate": "", "deliveryStatus": "DISPATCHED", "actualDeliveryPickupTime": "1725908784385" }
}
ENROUTE_TO_DROPOFF
{ "source": { "eventType": "DRIVER_STATUS", "eventFilters": null, "eventTime": "2024-09-09T19:06:33.022Z", "eventId": "a0bb9de0-6ede-11ef-957a-bf6d1de809fa" }, "payload": { "customerOrderId": "100000312331630", "orderStatus": "LOADED", "minDeliverySlotTime": "2024-09-09T23:00:00Z", "deliveryId": "7c24f274-7f86-42f6-919b-e20a76adb4e1", "maxDeliverySlotTime": "2024-09-10T03:00:00Z", "sellerId": "B9B9CE8389BA485EA057D862AB334CD4", "purchaseOrderId": "108925441672969", "driverFirstName": "Test", "driverPhoneNo": "8888888888", "orderPickupReadyTime": "2024-09-09T23:00:00Z", "undeliverableReasons": "", "driverLastName": "jones9", "partnerId": "10900063103", "orderDate": "", "deliveryStatus": "ENROUTE_TO_DROPOFF", "actualDeliveryPickupTime": "1725908790448" }
}
ARRIVED_AT_DROPOFF
{ "source": { "eventType": "DRIVER_STATUS", "eventFilters": null, "eventTime": "2024-09-09T19:06:36.340Z", "eventId": "a2b5e740-6ede-11ef-957a-bf6d1de809fa" }, "payload": { "customerOrderId": "100000312331630", "orderStatus": "LOADED", "minDeliverySlotTime": "2024-09-09T23:00:00Z", "deliveryId": "7c24f274-7f86-42f6-919b-e20a76adb4e1", "maxDeliverySlotTime": "2024-09-10T03:00:00Z", "sellerId": "B9B9CE8389BA485EA057D862AB334CD4", "purchaseOrderId": "108925441672969", "driverFirstName": "Test", "driverPhoneNo": "8888888888", "orderPickupReadyTime": "2024-09-09T23:00:00Z", "undeliverableReasons": "", "driverLastName": "jones9", "partnerId": "10900063103", "orderDate": "", "deliveryStatus": "ARRIVED_AT_DROPOFF", "actualDeliveryPickupTime": "1725908794079" }
}
DELIVERED
{ "source": { "eventType": "DRIVER_STATUS", "eventFilters": null, "eventTime": "2024-08-23T21:04:42.968Z", "eventId": "51a5c580-6193-11ef-8e16-49386c1678f4" }, "payload": { "customerOrderId": "100000541744685", "orderStatus": "LOADED", "description": "Found a better offer", "minDeliverySlotTime": "2024-08-24T13:00:00Z", "deliveryId": "28a04c11-df87-4473-8f00-af937832be2a", "maxDeliverySlotTime": "2024-08-25T03:00:00Z", "sellerId": "B9B9CE8389BA485EA057D862AB334CD4", "purchaseOrderId": "108923741462824", "driverFirstName": "Test", "driverPhoneNo": "+19314888475", "orderPickupReadyTime": "2024-08-24T13:00:00Z", "actualDeliveryTime": "2024-08-23T21:04:41.409Z", "undeliverableReasons": "", "driverLastName": "jones9", "reasonCode": "LMD1505", "partnerId": "10900063103", "orderDate": "", "deliveryStatus": "DELIVERED", "actualDeliveryPickupTime": "1724447081409" }
}
ENROUTE_TO_RETURN
{ "source": { "eventType": "DRIVER_STATUS", "eventFilters": null, "eventTime": "2024-09-09T19:10:01.995Z", "eventId": "1d4a5db0-6edf-11ef-957a-bf6d1de809fa" }, "payload": { "customerOrderId": "100000312331630", "orderStatus": "LOADED", "description": "Can't Access", "minDeliverySlotTime": "2024-09-09T23:00:00Z", "deliveryId": "7c24f274-7f86-42f6-919b-e20a76adb4e1", "maxDeliverySlotTime": "2024-09-10T03:00:00Z", "sellerId": "B9B9CE8389BA485EA057D862AB334CD4", "purchaseOrderId": "108925441672969", "driverFirstName": "Test", "driverPhoneNo": "8888888888", "orderPickupReadyTime": "2024-09-09T23:00:00Z", "undeliverableReasons": "", "driverLastName": "jones9", "reasonCode": "3P629", "partnerId": "10900063103", "orderDate": "", "deliveryStatus": "ENROUTE_TO_RETURN", "actualDeliveryPickupTime": "1725908999322" }
}
ARRIVED_TO_RETURN
{ "source": { "eventType": "DRIVER_STATUS", "eventFilters": null, "eventTime": "2024-09-09T19:10:07.955Z", "eventId": "20d7ca30-6edf-11ef-957a-bf6d1de809fa" }, "payload": { "customerOrderId": "100000312331630", "orderStatus": "LOADED", "description": "Can't Access", "minDeliverySlotTime": "2024-09-09T23:00:00Z", "deliveryId": "7c24f274-7f86-42f6-919b-e20a76adb4e1", "maxDeliverySlotTime": "2024-09-10T03:00:00Z", "sellerId": "B9B9CE8389BA485EA057D862AB334CD4", "purchaseOrderId": "108925441672969", "driverFirstName": "Test", "driverPhoneNo": "8888888888", "orderPickupReadyTime": "2024-09-09T23:00:00Z", "undeliverableReasons": "", "driverLastName": "jones9", "reasonCode": "3P629", "partnerId": "10900063103", "orderDate": "", "deliveryStatus": "ARRIVED_TO_RETURN", "actualDeliveryPickupTime": "1725909004207" }
}
RETURNED
{ "source": { "eventType": "DRIVER_STATUS", "eventFilters": null, "eventTime": "2024-09-09T19:10:17.479Z", "eventId": "26850970-6edf-11ef-957a-bf6d1de809fa" }, "payload": { "customerOrderId": "100000312331630", "orderStatus": "LOADED", "description": "Can't Access", "minDeliverySlotTime": "2024-09-09T23:00:00Z", "deliveryId": "7c24f274-7f86-42f6-919b-e20a76adb4e1", "maxDeliverySlotTime": "2024-09-10T03:00:00Z", "sellerId": "B9B9CE8389BA485EA057D862AB334CD4", "purchaseOrderId": "108925441672969", "driverFirstName": "Test", "driverPhoneNo": "8888888888", "orderPickupReadyTime": "2024-09-09T23:00:00Z", "undeliverableReasons": "", "driverLastName": "jones9", "reasonCode": "3P629", "partnerId": "10900063103", "orderDate": "", "deliveryStatus": "RETURNED", "actualDeliveryPickupTime": "1725909013887" }
}
Updated about 7 hours ago