Overview

The Update fulfillment center API helps you update your existing fulfillment centers (also known as ship nodes) configurations in Marketplace Settings.

Endpoint

PUT https://marketplace.walmartapis.com/v3/settings/shipping/shipnodes

Function

This API helps you:

Activate or deactivate fulfillment centers
Update a fulfillment center name
Modify supported distributor services
Configure or modify fulfillment center processing schedules
Set weekend working days and cutoff times
Define additional non-working days (such as holidays)
Configure carrier weekend behavior

Sample request

Sample 1 Standard processing schedule update

curl --request PUT \ --url https://marketplace.walmartapis.com/v3/settings/shipping/shipnodes \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "shipNodeHeader": { "version": "1.2" }, "shipNode": { "shipNode": "84955660770217985", "shipNodeName": "Seller test-distributor", "status": "ACTIVE", "timeZone": "PST", "distributorSupportedServices": [ "TWO_DAY_DELIVERY" ], "customNodeId": "91ab1234", "postalAddress": { "addressLine1": "111 CALIFORNIA SA", "city": "SC GABRIEL", "state": "CA", "country": "USA", "postalCode": "90706" }, "shippingDetails": [ { "twoDayShipping": [ { "carrierMethodName": "FEDEX", "carrierMethodType": "GROUND" } ] } ], "calendarDayConfiguration": { "standardProcessingSchedule": { "sunday": { "isWorkingDay": true, "cutOffTime": "14:00" }, "monday": { "isWorkingDay": true, "cutOffTime": "14:00" }, "tuesday": { "isWorkingDay": true, "cutOffTime": "14:00" }, "wednesday": { "isWorkingDay": true, "cutOffTime": "14:00" }, "thursday": { "isWorkingDay": true, "cutOffTime": "14:00" }, "friday": { "isWorkingDay": true, "cutOffTime": "14:00" }, "saturday": { "isWorkingDay": true, "cutOffTime": "14:00" } } } }
}
'

Sample 2 Calendar day configurations

curl --request PUT \ --url https://marketplace.walmartapis.com/v3/settings/shipping/shipnodes \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "shipNodeHeader": { "version": "1.2" }, "shipNode": { "shipNode": "84955660770217985", "shipNodeName": "Seller test-distributor", "status": "ACTIVE", "timeZone": "PST", "distributorSupportedServices": [ "TWO_DAY_DELIVERY" ], "customNodeId": "91ab1234", "postalAddress": { "addressLine1": "111 CALIFORNIA SA", "city": "SC GABRIEL", "state": "CA", "country": "USA", "postalCode": "90706" }, "shippingDetails": [ { "twoDayShipping": [ { "carrierMethodName": "FEDEX", "carrierMethodType": "GROUND" } ] } ], "calendarDayConfiguration": { "standardProcessingSchedule": { "sunday": { "isWorkingDay": false, "cutOffTime": "14:00" }, "monday": { "isWorkingDay": true, "cutOffTime": "11:30" }, "tuesday": { "isWorkingDay": true, "cutOffTime": "11:30" }, "wednesday": { "isWorkingDay": false, "cutOffTime": "14:00" }, "thursday": { "isWorkingDay": true, "cutOffTime": "11:30" }, "friday": { "isWorkingDay": true, "cutOffTime": "11:30" }, "saturday": { "isWorkingDay": true, "cutOffTime": "15:45" } }, "additionalDaysOff": [ "2030-12-24", "2030-12-25" ] } }
}
'

Sample 3 — Carrier weekend configuration

curl --request PUT \ --url https://marketplace.walmartapis.com/v3/settings/shipping/shipnodes \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "shipNodeHeader": { "version": "1.2" }, "shipNode": { "shipNode": "84955660770217985", "shipNodeName": "Seller test-distributor", "status": "ACTIVE", "timeZone": "PST", "distributorSupportedServices": [ "TWO_DAY_DELIVERY" ], "customNodeId": "91ab1234", "postalAddress": { "addressLine1": "111 CALIFORNIA SA", "city": "SC GABRIEL", "state": "CA", "country": "USA", "postalCode": "90706" }, "shippingDetails": [ { "twoDayShipping": [ { "carrierMethodName": "FEDEX", "carrierMethodType": "GROUND" } ] } ], "calendarDayConfiguration": { "standardProcessingSchedule": { "sunday": { "isWorkingDay": false, "cutOffTime": "14:00" }, "monday": { "isWorkingDay": true, "cutOffTime": "11:30" }, "tuesday": { "isWorkingDay": true, "cutOffTime": "11:30" }, "wednesday": { "isWorkingDay": false, "cutOffTime": "14:00" }, "thursday": { "isWorkingDay": true, "cutOffTime": "11:30" }, "friday": { "isWorkingDay": true, "cutOffTime": "11:30" }, "saturday": { "isWorkingDay": true, "cutOffTime": "15:45" } }, "additionalDaysOff": [ "2030-12-24", "2030-12-25" ], "carrierWeekendCalendar": { "saturday": { "workingDay": true }, "sunday": { "workingDay": true } } } }
}
'

Modify your code

1. Add authentication

Include your access token.

--header 'Authorization: Bearer <ACCESS_TOKEN>'

Include any required Marketplace headers (consumer ID, correlation ID, and other Marketplace headers) if your integration requires them.

2. Confirm the schedule format

Cutoff times must be in the HH:MM 24-hour format
Dates must be in the YYYY-MM-DD format

Sample response

Sample 1 Standard response

{ "shipNode": "84955660770217985", "nodeType": "PHYSICAL", "shipNodeName": "Seller test-distributor", "status": "ACTIVE", "timeZone": "PST", "distributorSupportedServices": [ "TWO_DAY_DELIVERY" ], "customNodeId": "91ab1234", "postalAddress": { "addressLine1": "111 CALIFORNIA SA", "city": "SC GABRIEL", "state": "CA", "country": "USA", "postalCode": "90706" }, "shippingDetails": [ { "twoDayShipping": [ { "carrierMethodName": "FEDEX", "carrierMethodType": "GROUND" } ] } ]
}

Sample 2 With calendar configuration

{ "shipNode": "84955660770217985", "nodeType": "PHYSICAL", "shipNodeName": "Seller test-distributor", "status": "ACTIVE", "timeZone": "PST", "distributorSupportedServices": [ "TWO_DAY_DELIVERY" ], "customNodeId": "91ab1234", "postalAddress": { "addressLine1": "111 CALIFORNIA SA", "city": "SC GABRIEL", "state": "CA", "country": "USA", "postalCode": "90706" }, "shippingDetails": [ { "twoDayShipping": [ { "carrierMethodName": "FEDEX", "carrierMethodType": "GROUND" } ] } ], "calendarDayConfiguration": { "standardProcessingSchedule": { "sunday": { "isWorkingDay": false }, "monday": { "isWorkingDay": true, "cutOffTime": "11:30" }, "tuesday": { "isWorkingDay": true, "cutOffTime": "11:30" }, "wednesday": { "isWorkingDay": false }, "thursday": { "isWorkingDay": true, "cutOffTime": "11:30" }, "friday": { "isWorkingDay": true, "cutOffTime": "11:30" }, "saturday": { "isWorkingDay": true, "cutOffTime": "15:45" } }, "additionalDaysOff": [ "2021-12-24", "2021-12-25" ] }
}

Result

After a successful update, the:

Fulfillment center status is applied
Processing schedule changes will take effect
Holiday blackout dates will be enforced
Weekend and carrier weekend settings are reflected in the delivery promise logic
Order routing will reflect the updated node configuration

Next steps

The Get shipping template details API gives you specific shipping configurations for a single shipping template.

The Update shipping templates API lets you modify configurations on an existing shipping template, such as shipping methods, regions, transit times, and pricing rules.

The Delete shipping templates API lets you permanently remove existing shipping templates from Walmart Marketplace settings.

The Get all fulfillment centers API retrieves fulfillment centers (also known as ship nodes) information on your account.

The Create fulfillment center API sets up new fulfillment centers (also known as ship nodes) in Walmart Marketplace Settings.

The Get account level settings API retrieves account-level shipping settings such as calendar day configurations, weekends, and additional days off.

The Update account level settings API allows you to configure account-level calendar settings that impact shipping calculations and delivery promise logic.

The Create account level settings API lets you establish account level calendar configuration for your shipping operations.

The Get all shipping templates API retrieves a list of all shipping templates configured on your account.

The Create shipping templates API allows sellers to create custom shipping templates that define shipping methods, transit times, pricing logic, and geographic coverage.

The Third-party fulfillment center association API allows sellers to activate or update the status of 3PL (third-party logistics) ship nodes associated with your Marketplace account.

The Get shipping configurations API retrieves account-level shipping profile settings associated on your account.

The Get shipping template activation status API allows sellers to retrieve the current activation state of shipping templates at the account level.

The Get coverage for fulfillment centers API retrieves the geographic coverage areas associated with each fulfillment center (ship node) configured under a seller account.

The Get carrier methods API retrieves the list of carrier methods available for use in Marketplace shipping configurations

The Get all third-party fulfillment providers API retrieves all third-party fulfillment providers (3PLs) available on the Walmart marketplace.

The Get partner configurations API retrieves seller-level profile information and system configuration settings associated with a Marketplace partner account.