Change fulfillment center configurations

Sellers and approved Solution Providers can use this API endpoint to override fulfillment-center configurations. The endpoint uses a shipNodeConfigs array of objects to specify the fulfillment centers configurations to override. These settings take precedence over the configurations set by the POST Create Simplified Shipping Settings account configurations API endpoint.

shipNodeConfigs: The list of all fulfillment center IDs and configurations. Review the example response to understand what settings are in the shipNodeConfigs array of objects.

Throttling

Request limits: 25 calls per minute per seller. You may receive an HTTP 429 error if you exceed this limit. You can refer to the Throttling guide to learn more about the throttling guidelines.

Request example

The request requires authentication with an API token (WM_SEC.ACCESS_TOKEN), consumer ID, and channel type. These credentials ensure that only authorized sellers and approved Solution Providers can override fulfillment center configurations.

The endpoint https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/fulfillmentcenter specifies that you are making a request to override fulfillment-center settings for specific fulfillment centers.

Encoding for spaces: This request requires encoding if spaces are present in the query. The endpoint uses %20 for spaces.

Before you use the example code, replace the example access token and correlation ID (a randomly generated GUID used to track and debug issues) with your own values.

curl -X 'PUT' \ 'https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/fulfillmentcenter' \ -H 'accept: application/json' \ -H ‘WM_SEC.ACCESS_TOKEN: eyABCDEFGHI123456789…’ \ -H ‘WM_QOS.CORRELATION_ID: AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD’ \ -H 'WM_SVC.NAME: Walmart Service Name' \ -H 'Content-Type: application/json' \ -d '{ "simplifiedShippingSettings": { "shipNodeConfigs": [ { "shipNodes": [ "1234567616356" ], "isOverridden": false }, { "shipNodes": [ "1234567616357" ], "isOverridden": true, "carrierConfigs": [ { "carriers": [ { "carrierName": "UPS", "carrierService": "UPS_GROUND" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionCode": "H", "regionName": "AK and HI" } ], "addressTypes": [ "STREET", "PO_BOX" ] } ] } ] } ] }
}'

Response example

This API endpoint responds with a body response that contains a shipNodeConfigs array of objects with the new fulfillment-center configurations.

{ "simplifiedShippingSettings": { "shipNodeConfigs": [ { "shipNodes": [ "1234567616357" ], "isOverridden": true, "carrierConfigs": [ { "configurations": [ { "regions": [ { "regionCode": "H", "regionName": "AK and HI" }, { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET", "PO_BOX" ] } ], "carriers": [ { "carrierName": "UPS", "carrierService": "UPS_GROUND" } ] } ] }, { "shipNodes": [ "1234567616356" ], "isOverridden": false, "carrierConfigs": [ { "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "WE", "states": [ { "stateCode": "NV", "stateName": "Nevada" }, { "stateCode": "CA", "stateName": "California" } ] } ] } ], "addressTypes": [ "STREET" ] }, { "regions": [ { "regionCode": "H", "regionName": "AK and HI" } ], "addressTypes": [ "STREET" ] } ], "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" } ] }, { "configurations": [ { "regions": [ { "regionCode": "P", "regionName": "US Protectorates" }, { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET", "PO_BOX" ] } ], "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_OVERNIGHT" } ] } ] } ] }
}

Next steps

This API overview guide shows you how to override fulfillment-center configurations with only the required parameters. You can refer to the full Reference guide to learn how to use the optional parameters.