Book a delivery

post https://developer.api.us.walmart.com/api-proxy/service/supplychain/transportation/v1/daas/deliveries/

This request books a delivery using Walmart GoLocal service. Call this request when the customer has finalized and submitted their order. Walmart GoLocal can be booked to complete the delivery. This request books the delivery. If the delivery details are not complete or are not feasible, this request fails and returns error codes and descriptions.

This request supports different delivery types, such as general items, refrigerated items, frozen groceries, and alcohol. Depending on the delivery type, there may be different fields to complete. The delivery can include only the delivery types agreed to in our business contract, and set up during onboarding.

The following notes may apply:

The customer’s address must be provided as the delivery destination.
The time and the location that the order will be ready at the pickup point for our Walmart GoLocal delivery driver.
The size, weight, value, and handling information of all items collectively in the order (and not for each item).
This allows delivery drivers to be appropriately selected.
The maximum size, weight, cost, and handling values eligible for a Walmart GoLocal delivery will be configured by each delivery client basis.
This request returns a deliveryId. A deliveryId is a Walmart GoLocal generated value used to track and manage that specific delivery.
The order status at the pickup point can be passed as READY_FOR_PICKUP in real time as a value to the orderStatus parameter.
This lets the delivery driver know that the order has been prepared at the location. This status will be implemented in future and not ready for use.
The Book Delivery request response can provide a tracking URL, or a URL that tracks the status of the delivery.
The tracking URL is format:

https://deliverytracking.walmart.com/{deliveryId}?token={token}.

The Walmart Client Center settings control its inclusion in the Book Delivery request response.

Property Type and Location Preference Validation

For property type and location preference values, the following combinations are allowed:

Enum of locationPreference	HOUSE	APARTMENT	BUSINESS	OTHER	null
FRONT_DOOR	Optional	Optional	Optional	Optional	Not Allowed
BACK_DOOR	Optional	Not Allowed	Not Allowed	Optional	Not Allowed
SIDE_PORCH	Optional	Not Allowed	Not Allowed	Optional	Not Allowed
BUILDING_RECEPTION	Not Allowed	Optional	Optional	Optional	Not Allowed
MAILROOM_OR_PROPERTY_STAFF	Not Allowed	Optional	Optional	Optional	Not Allowed
GARAGE_DOOR	Optional	Not Allowed	Not Allowed	Optional	Not Allowed
NO_PREFERENCE	Optional	Optional	Optional	Optional	Not Allowed

Example

This request books a delivery.

POST <baseURL>/deliveries

Request body:

{ "deliveries": { "clientId": "49304", "externalOrderId": "10208877499-208925547882099", "deliveryMethod": "SCHEDULED_DELIVERY", "orderPickupReadyTime": "2024-09-06T19:00:00.000Z", "orderPickupDueTime": "2024-09-06T21:00:00.000Z", "requestedMinDeliverySlotTime": "2024-09-06T19:00:00.000Z", "requestedMaxDeliverySlotTime": "2024-09-06T21:00:00.000Z", "customer": { "firstName": "John", "lastName": "Doe", "email": "[email protected]", "phone": { "number": "(650) 8375000", "countryCode": "1" } }, "addOnServices": { "returnable": true, "attendedDelivery": true, "proofOfDelivery": true, "capturePhotoProof": true, "isDropOffOTPRequired": false, "captureSignatureProof": false, "chainOfCustody": true }, "pickupDetails": { "pickupPointId": "101979", "externalPickupPointId": "4969" }, "instructions": [ { "instructionText": "Ring bell when arriving.", "instructionType": "CUSTOMER" } ], "deliveryDetails": { "address": { "line1": "853 W California Ave", "line2": "Apt 10", "city": "Sunnyvale", "state": "CA", "zipCode": "94086", "countryCode": "US" }, "latLong": { "type": "CUSTOMER_PINDROP", "lat": 37.12345, "lng": -122.12345 }, "propertyDetails": { "gateCode": "C-1278", "propertyType": "BUSINESS", "locationPreference": "BUILDING_RECEPTION" } }, "scanDetails": [ { "scanDetail": [ { "scanId": "W1321433777-1" } ], "scanType": "CODE128" } ], "associateScans": [ { "scanDetail": [ { "scanId": "21" } ], "scanType": "CODE128" } ], "orderManifest": { "summary": { "totalItems": 4, "orderSize": "S", "dimensions": [ { "length": 25, "width": 5.25, "height": 4.25, "unitOfMeasure": "IN" } ], "totalOrderWeight": { "measurementValue": 20, "unitOfMeasure": "OZ" }, "totalValueOfItems": { "currencyAmount": 36.45, "currencyUnit": "USD" }, "specialHandlingAttributes": { "hasHazmatItems": false, "hasAlcoholItems": false, "hasColdchainItems": true, "coldChain": { "temperatureType": "CHILLED" }, "hasFragileItems": false, "hasPharmacyItems": false } }, "itemDetails": [ { "itemId": "string", "itemDescription": "Milk Shake", "dimensions": { "length": 3.75, "width": 4.25, "height": 6, "unitOfMeasure": "IN" }, "quantity": 4, "itemWeight": { "measurementValue": 5, "unitOfMeasure": "OZ" }, "itemTotal": { "currencyAmount": 36.45, "currencyUnit": "USD" } } ] }, "communicationPreferences": { "customerNotifications": { "allowAll": true } }, "quoteDetails": { "quoteId": "b4c3bd7e-c60f-4ea2-8ef3-9059a60bd07c" } }
}

Response body:

{ "deliveries": { "externalOrderId": "10208877499-208925547882099", "deliveryId": "4e9cf4d5-be96-4b30-a76e-073b5f912345", "trackingURL": "https://deliverytracking.walmart.com/4e9cf4d5-be96-4b30-a76e-073b5f912345?token=MDky...Wk%3D" }
}