Call this endpoint to confirm and accept the estimated carrier shipping charges when participating in the WFS Preferred Carrier Program (FedEx Parcel or LTL) for inbound inventory shipments to Walmart fulfillment centers.

Note: This page shows examples using only the required parameters and inputs for creating a new booking. For a full list of customization options and additional capabilities, refer to the Marketplace Fulfillment API Reference.

Endpoint

POST https://marketplace.walmartapis.com/v4/fulfillment/inbound-shipments-booking

Parcel quote type

This section demonstrates how to create a new booking for Parcel shipments.

Sample request

This sample request creates a new booking for an inbound shipment on Walmart Marketplace for "Parcel" quoteType.

curl --request POST \ --url https://marketplace.walmartapis.com/v4/fulfillment/inbound-shipments-booking \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic #####' \
--header 'WM_SEC.ACCESS_TOKEN: #####' \
--header 'WM_SVC.NAME: Walmart Marketplace' \
--header 'WM_QOS.CORRELATION_ID: 123456abcdef5' \
--header 'Accept: application/json' \
--data '{ "payload": { "shipmentId": "0729156WFA", "bookingDetails": { "termsAcceptedTime": "2024-03-08T16:08:46.314Z", "quoteType": "PARCEL", "quoteId": "313dfsd", "unitDetails": [ { "noOfSingleSkuBoxes": 1, "noOfMixedSkuBoxes": 1 } ] } }
}'

import requests
import json url = 'https://marketplace.walmartapis.com/v4/fulfillment/inbound-shipments-booking' headers = { 'Content-Type': 'application/json', 'Authorization': 'Basic #####', 'WM_SEC.ACCESS_TOKEN': '#####', 'WM_SVC.NAME': 'Walmart Marketplace', 'WM_QOS.CORRELATION_ID': '123456abcdef5', 'Accept': 'application/json',
} payload = { "payload": { "shipmentId": "0729156WFA", "bookingDetails": { "termsAcceptedTime": "2024-03-08T16:08:46.314Z", "quoteType": "PARCEL", "quoteId": "313dfsd", "unitDetails": [ { "noOfSingleSkuBoxes": 1, "noOfMixedSkuBoxes": 1 } ] } }
} response = requests.post(url, headers=headers, data=json.dumps(payload)) print(response.status_code)
print(response.json())

Modify your code

Authorization - Replace with your actual Base64-encoded credentials.
WM_QOS.CORRELATION_ID - Use a unique correlation UUID to track the request.
WM_SEC.ACCESS_TOKEN - Replace with your valid access token obtained through authentication.

Sample response

This sample response indicates the create booking request was successful; the OK status confirms that the booking was created.

{ "status": "OK"
}

Less Than Truckload (LTL) quote type

This section demonstrates how to create a new booking for Less Than Truckload (LTL) shipments.

Sample request

This sample request creates a new booking for an inbound shipment on Walmart Marketplace for "LTL" quoteType.

curl --request POST \ --url https://marketplace.walmartapis.com/v4/fulfillment/inbound-shipments-booking \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "payload": { "shipmentId": "0645378WFA", "bookingDetails": { "termsAcceptedTime": "2024-07-28T12:22:18-07:00", "quoteId": "1392795189196898304", "quoteType": "LTL", "pickupDetails": { "businessLocationName": "S", "pickupInstruction": "testing", "freightPickUpDate": "2024-07-28T19:19:00.000Z" }, "shipperInfo": { "contactInfo": { "primaryContactPhoneNumber": "1895405102", "primaryContactEmailAddress": "[email protected]" }, "name": "A P", "firstName": "A", "lastName": "P", "requesterType": "IWFS" }, "locations": { "origin": { "locationType": "VNDR", "addressLine1": "3100 E Frontera St,", "addressLine2": "", "city": "Anaheim", "state": "CA", "countryCode": "US", "postalCode": "92806", "locationName": "test1", "operationHours": [ { "dayOfWeekCode": 1, "operationType": "OPR", "openStrTime": "08:00:00", "closeStrTime": "17:00:00" } ] }, "destination": { "locationType": "DC", "addressLine1": "30801 W 500 N", "addressLine2": "", "city": "Edgerton", "state": "KS", "countryCode": "US", "postalCode": "66021", "locationName": "" } }, "unitDetails": [ { "equipmentCode": "VAN53", "equipmentType": "DRYV", "length": 53, "protectionLevel": "DRY", "declaredValue": 0, "totalPalletCount": 2, "noOfSingleSkuBoxes": 2, "noOfMixedSkuBoxes": 2, "shipmentPackages": [ { "isStackable": true, "width": 40, "length": 48, "weightUOM": "LB", "lengthUOM": "IN", "packageType": "PALLET", "height": 2, "packageSequenceNumber": 1, "noOfPackages": 1, "weight": 222 } ] } ] } }
}
'

import requests
import json url = 'https://marketplace.walmartapis.com/v4/fulfillment/inbound-shipments-booking' headers = { 'accept': 'application/json', 'content-type': 'application/json',
} payload = { "payload": { "shipmentId": "0645378WFA", "bookingDetails": { "termsAcceptedTime": "2024-07-28T12:22:18-07:00", "quoteId": "1392795189196898304", "quoteType": "LTL", "pickupDetails": { "businessLocationName": "S", "pickupInstruction": "testing", "freightPickUpDate": "2024-07-28T19:19:00.000Z" }, "shipperInfo": { "contactInfo": { "primaryContactPhoneNumber": "1895405102", "primaryContactEmailAddress": "[email protected]" }, "name": "A P", "firstName": "A", "lastName": "P", "requesterType": "IWFS" }, "locations": { "origin": { "locationType": "VNDR", "addressLine1": "3100 E Frontera St,", "addressLine2": "", "city": "Anaheim", "state": "CA", "countryCode": "US", "postalCode": "92806", "locationName": "test1", "operationHours": [ { "dayOfWeekCode": 1, "operationType": "OPR", "openStrTime": "08:00:00", "closeStrTime": "17:00:00" } ] }, "destination": { "locationType": "DC", "addressLine1": "30801 W 500 N", "addressLine2": "", "city": "Edgerton", "state": "KS", "countryCode": "US", "postalCode": "66021", "locationName": "" } }, "unitDetails": [ { "equipmentCode": "VAN53", "equipmentType": "DRYV", "length": 53, "protectionLevel": "DRY", "declaredValue": 0, "totalPalletCount": 2, "noOfSingleSkuBoxes": 2, "noOfMixedSkuBoxes": 2, "shipmentPackages": [ { "isStackable": True, "width": 40, "length": 48, "weightUOM": "LB", "lengthUOM": "IN", "packageType": "PALLET", "height": 2, "packageSequenceNumber": 1, "noOfPackages": 1, "weight": 222 } ] } ] } }
} response = requests.post(url, headers=headers, data=json.dumps(payload)) print(response.status_code)
print(response.json())

Modify your code

Authorization - Replace with your actual Base64-encoded credentials.
WM_QOS.CORRELATION_ID - Use a unique correlation UUID to track the request.
WM_SEC.ACCESS_TOKEN - Replace with your valid access token obtained through authentication.

Sample response

This sample response indicates the create booking request was successful; the OK status confirms that the booking was created.

{ "status": "OK"
}

Result

If the request is successful, the response returns a 200 OK status.