Fetch delivery promise details

Call this endpoint to fetch delivery promise related information for up to 30 active SKUs at once. You can retrieve details including promised date, eligibility, availability, and SLA tier across all valid fulfillment paths. Results are returned only for SKUs with available inventory; ineligible or out-of-stock SKUs won't include promise details.

This page describes an example using only the required parameters and inputs to retrieve fulfillment and delivery promise information. For a full list of customization options and additional capabilities, refer to the Marketplace WFS Multichannel solutions API Reference.

Endpoint

POST https://marketplace.walmartapis.com/v3/fulfillment/orders-fulfillments/fetchOrderPromiseOptions

Sample request

This sample request fetches the delivery promise options for a single destination and SKU before creating an order.

curl --location --request POST 'https://marketplace.walmartapis.com/v3/fulfillment/orders-fulfillments/fetchOrderPromiseOptions' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --header 'WM_SEC.ACCESS_TOKEN: <access_token>' \ --header 'WM_QOS.CORRELATION_ID: <uuid>' \ --header 'WM_SVC.NAME: Walmart Marketplace' \ --data '
{ "header": { "headerAttributes": { "martId": "202", "buId": "0" } }, "payload": { "requestId": "6261274564_1677576988850", "destinations": [ { "address": { "city": "Springfield", "addressType": "RESIDENTIAL", "postalCode": "95035", "addressLineOne": "123 main Ln", "addressLineTwo": "222", "isPOBox": false, "countryCode": "US", "stateCode": "CA" }, "fulfillmentType": "DELIVERY" } ], "offerSelections": [ { "offers": [ { "sku": "WH40DDD", "lineId": "5615355772_1677576988850", "salesUnit": "Each", "requestedQuantity": { "measurementValue": 1, "unitOfMeasure": "EA" } } ] } ] }
}'

import requests url = "https://marketplace.walmartapis.com/v3/fulfillment/orders-fulfillments/fetchOrderPromiseOptions" headers = { "Accept": "application/json", "Content-Type": "application/json", "WM_SEC.ACCESS_TOKEN": "<access_token>", "WM_QOS.CORRELATION_ID": "<uuid>", "WM_SVC.NAME": "Walmart Marketplace",
} json_data = { "header": { "headerAttributes": { "martId": "202", "buId": "0" } }, "payload": { "requestId": "6261274564_1677576988850", "destinations": [ { "address": { "city": "Springfield", "addressType": "RESIDENTIAL", "postalCode": "95035", "addressLineOne": "123 main Ln", "addressLineTwo": "222", "isPOBox": False, "countryCode": "US", "stateCode": "CA" }, "fulfillmentType": "DELIVERY" } ], "offerSelections": [ { "offers": [ { "sku": "WH40DDD", "lineId": "5615355772_1677576988850", "salesUnit": "Each", "requestedQuantity": { "measurementValue": 1, "unitOfMeasure": "EA" } } ] } ] }
} response = requests.post(url, headers=headers, json=json_data)
print(response.status_code)
print(response.text)

Modify your code

Use a unique WM_QOS.CORRELATION_ID for each request.
Replace WM_SEC.ACCESS_TOKEN with your valid access token obtained through authentication.
You can include up to 30 SKUs total in offerSelections.
Replace sku with the item's actual SKU. Ensure that the WFS SKU has ATS > 0.

Sample response

The API returns a successful response when all SKUs and offers are valid and the requested quantity is available for each SKU.

{ "status": "ACCEPTED", "header": { "headerAttributes": { "buId": "0", "martId": "202" } }, "payload": { "offers": [ { "availableQuantity": { "measurementValue": 1, "unitOfMeasure": "EA" }, "requestedQuantity": { "measurementValue": 1, "unitOfMeasure": "EA" }, "lineId": "249ac8e1-e6c2-4806-81a5-54215eb16b99", "salesUnit": "Each", "sku": "FFUW0127PTY" } ], "destinations": [ { "address": { "city": "Milpitas", "addressType": "RESIDENTIAL", "postalCode": "11111", "addressLineOne": "261 Odyssey Ln", "addressLineTwo": "222", "isPOBox": false, "countryCode": "US", "stateCode": "CA" }, "fulfillmentType": "DELIVERY", "destinationId": "0" } ], "fulfillmentPlans": [ { "fulfillmentModules": [ { "fulfillmentGroups": [ { "fulfillmentOptions": [ { "fulfillments": [ { "lineItemAttributesList": [ { "availableQuantity": { "measurementValue": 1, "unitOfMeasure": "EA" }, "fulfillmentChannel": [ "WFS_FULFILLED" ], "lineId": "249ac8e1-e6c2-4806-81a5-54215eb16b99" } ], "sla": { "tier": "TWO_DAY", "speed": "EXPEDITED" }, "accessMode": { "mode": "NATIONAL_CARRIER" }, "fulfillmentTime": { "date": { "minPromiseDate": "2023-03-03T22:59:00.000Z", "maxPromiseDate": "2023-03-03T22:59:00.000Z" } }, "fulfillmentId": "9e5ad7a4-385e-49ba-bb9b-b1b680d5542e", "nodeType": "FC" } ], "fulfillmentMode": "UNSCHEDULED", "accessType": "DELIVERY_ADDRESS", "isDefault": true, "fulfillmentType": "DELIVERY" } ] } ], "name": "UNSCHEDULED_DELIVERY" } ] } ], "prepurchaseHandle": "0208c5cc-a4e1-446e-b09a-af397afcec6f" }
}

The API returns a partially successful sample response when at least one SKU or offer has an error. For example, the requested quantity is not available for any SKU.

{ "status": "FAIL", "errors": [ { "code": "206.WSAAS.100", "description": "Partial content found", "info": "Partial content found", "severity": "ERROR", "category": "REQUEST" } ], "header": { "headerAttributes": { "buId": "0", "martId": "202" } }, "payload": { "offers": [ { "requestedQuantity": { "measurementValue": 10, "unitOfMeasure": "EA" }, "lineId": "249ac8e1-e6c2-4806-81a5-54215eb16b98", "salesUnit": "Each", "sku": "FFLA-XL" }, { "availableQuantity": { "measurementValue": 1, "unitOfMeasure": "EA" }, "requestedQuantity": { "measurementValue": 1, "unitOfMeasure": "EA" }, "lineId": "249ac8e1-e6c2-4806-81a5-54215eb16b99", "salesUnit": "Each", "sku": "FFLA-L" } ], "destinations": [ { "address": { "city": "Milpitas", "addressType": "RESIDENTIAL", "postalCode": "95035", "addressLineOne": "261 Odyssey Ln", "addressLineTwo": "222", "isPOBox": false, "countryCode": "US", "stateCode": "CA" }, "fulfillmentType": "DELIVERY", "destinationId": "0" } ], "fulfillmentPlans": [ { "fulfillmentModules": [ { "fulfillmentGroups": [ { "fulfillmentOptions": [ { "fulfillments": [ { "lineItemAttributesList": [ { "availableQuantity": { "measurementValue": 1, "unitOfMeasure": "EA" }, "fulfillmentChannel": [ "WFS_FULFILLED" ], "lineId": "249ac8e1-e6c2-4806-81a5-54215eb16b99" } ], "sla": { "tier": "TWO_DAY", "speed": "EXPEDITED" }, "accessMode": { "mode": "NATIONAL_CARRIER" }, "fulfillmentTime": { "date": { "minPromiseDate": "2023-03-03T22:59:00.000Z", "maxPromiseDate": "2023-03-03T22:59:00.000Z" } }, "fulfillmentId": "115e6236-48a6-4e99-a64b-2b73397f315c", "nodeType": "FC" } ], "fulfillmentMode": "UNSCHEDULED", "accessType": "DELIVERY_ADDRESS", "isDefault": true, "fulfillmentType": "DELIVERY" } ] } ], "name": "UNSCHEDULED_DELIVERY" }, { "fulfillmentGroups": [ { "fulfillmentOptions": [ { "fulfillments": [ { "lineItemAttributesList": [ { "lineId": "249ac8e1-e6c2-4806-81a5-54215eb16b98" } ], "errors": [ { "code": "500.UP_MCF.108", "field": "field_1", "description": "INVENTORY_NOT_FOUND", "severity": "ERROR", "category": "APPLICATION" } ], "fulfillmentId": "9fa7a3b8-27ed-457c-a71e-1116b49c4c11" } ], "fulfillmentMode": "UNSCHEDULED", "isDefault": true, "fulfillmentType": "DELIVERY" } ] } ], "name": "ERROR" } ] } ], "prepurchaseHandle": "96d672ef-e6eb-4037-9a52-1d9562f19493" }
}

The API returns an error response in case of failures. Use the error code and description of the error to diagnose and resolve the issue.

{ "status": "FAIL", "errors": [ { "code": "ERR_EXT_DATA_0021001", "description": "The payload structure is not valid. Please correct the payload.", "info": "[Error [code=400.WSAAS.100, field=offerSelections[0].offers[0].requestedQuantity.measurementValue, description=Bad Request, info=measurementValue must be greater than zero, severity=ERROR, category=DATA, causes=null]]", "severity": "ERROR", "category": "REQUEST" } ]
}

Result

The fetch delivery promise API returns the deliver promise options per destination and per SKU or offer. This call is quote-only, no inventory is reserved or order is created.

Next steps

Use the create customer order for WFS item API to create a WFS fulfilled customer order for your Walmart MCS channels. This API is available only if you are onboarded to MCS.

Updated 18 days ago