Update FC level Simplified Shipping Settings

Overview

Default fulfillment center settings are applied automatically across all your fulfillment centers, simplifying setup and eliminating the need for manual mappings. However, if a specific fulfillment center operates differently than others, for example, you have non-sortable or oversized items that require a different carrier or service level, then you can create a fulfillment center–specific configuration. The Update FC level Simplified Shipping Settings API offers a customizable configuration to tailor carrier settings and transit rules to specific fulfillment centers, without impacting your broader default setup.

Endpoint

PUT <https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/fulfillmentcenter>

Functionality

This call performs the following:

Setting carrier and service combinations by fulfillment center
Defining region-based shipping coverage
Configuring shipping charge models (per shipment, per weight, per item)
Overriding default account-level settings
Enforcing geographic shipping logic

Sample request

curl --request PUT \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/fulfillmentcenter \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "shipNodeConfigs": [ { "shipNodes": [ "677756464221356033" ], "isOverridden": true, "carrierConfigs": [ { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } } ] }, { "carriers": [ { "carrierName": "USPS", "carrierService": "USPS_PRIORITY_MAIL_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 5, "currency": "USD" }, "chargePerItem": { "amount": 3, "currency": "USD" } } } } ] }, { "carriers": [ { "carrierName": "USPS", "carrierService": "USPS_PRIORITY_MAIL" } ], "configurations": [ { "regions": [ { "regionCode": "H", "regionName": "AK and HI" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 5, "currency": "USD" }, "chargePerItem": { "amount": 3, "currency": "USD" } } } } ] } ] } ] }
}
'

Sample Request - All 48 states + DC are not covered for fulfillment center

curl --request PUT \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/fulfillmentcenter \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "shipNodeConfigs": [ { "shipNodes": [ "832541431719002113" ], "isOverridden": true, "carrierConfigs": [ { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" } ], "configurations": [ { "regions": [ { "regionName": "APO/FPO", "regionCode": "A" }, { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 5, "currency": "USD" }, "chargePerItem": { "amount": 3, "currency": "USD" } } } } ] }, { "carriers": [ { "carrierName": "UPS", "carrierService": "UPS_GROUND" } ], "configurations": [ { "addressTypes": [ "STREET" ], "regions": [ { "regionCode": "H", "regionName": "AK and HI" } ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 13, "currency": "USD" }, "chargePerWeight": { "amount": 9, "currency": "USD" } } } }, { "addressTypes": [ "STREET" ], "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 9, "currency": "USD" }, "chargePerItem": { "amount": 12, "currency": "USD" } } } } ] } ] } ] }
}
'

Sample Request - Invalid carrier name

curl --request PUT \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/fulfillmentcenter \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "shipNodeConfigs": [ { "shipNodes": [ "677756464221356033" ], "carrierConfigs": [ { "carriers": [ { "carrierName": "Test", "carrierService": "Test_1" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } } ] } ] } ] }
}
'

Sample Request - Empty shipping charge

curl --request PUT \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/fulfillmentcenter \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "shipNodeConfigs": [ { "shipNodes": [ "677756464221356033" ], "carrierConfigs": [ { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ] } ] } ] } ] }
}
'

Sample Request - Valid subtype of `shippingCharge` object not present

curl --request PUT \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/fulfillmentcenter \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "shipNodeConfigs": [ { "shipNodes": [ "677756464221356033" ], "carrierConfigs": [ { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING" } } ] } ] } ] }
}
'

Sample Request - Shipping charge amount cannot exceed 700

curl --request PUT \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/fulfillmentcenter \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "shipNodeConfigs": [ { "shipNodes": [ "677756464221356033" ], "carrierConfigs": [ { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 780, "currency": "USD" } } } } ] } ] } ] }
}
'

Sample Request - Duplicate regions not allowed at FC level

curl --request PUT \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/fulfillmentcenter \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "shipNodeConfigs": [ { "shipNodes": [ "677756464221356033" ], "carrierConfigs": [ { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } }, { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 8, "currency": "USD" }, "chargePerWeight": { "amount": 3, "currency": "USD" } } } } ] } ] } ] }
}
'

Modify your request

Replace <YourAccessToken> with your WM_SEC.ACCESS_TOKEN.
List the fulfillment center IDs you want to override in shipNodes.
Set isOverridden to true and provide carrierConfigs for each center that needs custom rules.

200 - Sample response

{ "simplifiedShippingSettings": { "shipNodeConfigs": [ { "shipNodes": [ "677756464221356033" ], "isOverridden": true, "carrierConfigs": [ { "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } } ] }, { "carriers": [ { "carrierName": "USPS", "carrierService": "USPS_PRIORITY_MAIL_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 5, "currency": "USD" }, "chargePerItem": { "amount": 3, "currency": "USD" } } } } ] }, { "carriers": [ { "carrierName": "USPS", "carrierService": "USPS_PRIORITY_MAIL" } ], "configurations": [ { "regions": [ { "regionCode": "H", "regionName": "AK and HI" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } } ] } ] } ] }
}

200 - Sample response invalid carrier configs

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "carrierName", "description": "Provided carrier service is not valid.", "info": "Please provide a valid carrier service.", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

200 - Sample response invalid coverage 2

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "states/stateCode", "description": "All 48 states + DC are not covered at account level", "info": "All 48 states + DC are not covered at account level", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

200 - Sample response invalid region combination

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "regionCode and regionName", "description": "Invalid region code: P and region name: US Protectorate 6s combination", "info": "Invalid region code: P and region name: US Protectorate 6s combination", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

200 - Sample - Invalid carrier name

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "carrierName", "description": "Invalid Carrier Name", "info": "Invalid Carrier Name", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

200 - Sample - Empty shipping charge

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "shippingCharges", "description": "Shipping charge object cannot be empty", "info": "Shipping charge object cannot be empty", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

200 - Sample - Valid subtype of shipping charge object not present

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "shippingCharges", "description": "Provide the shipping charges in perShippingCharges", "info": "Provide the shipping charges in perShippingCharges", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

200 - Sample - Shipping charge amount cannot exceed 700

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "perShippingCharge", "description": "Shipping charge amount can't exceed the max allowed limit 700", "info": "Shipping charge amount can't exceed the max allowed limit 700", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

200 - Sample - Duplicate regions not allowed at FC Level

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "shippingCharges", "description": "Duplicate regions are not allowed at FC Level for carrier and node", "info": "Duplicate regions are not allowed at FC Level for carrier and node", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

Result

A successful response confirms the fulfillment center level override has been applied.
Invalid configurations return structured error messages.
Fulfillment center level configurations override account-level settings.
Carrier, region, and coverage rules directly affect delivery promises and shipping calculations.

Next steps

Verify the override exists by calling  GET <https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings> and checking the updated fulfillment center appears under shipNodeConfigs.
Confirm the override is used by pulling a new order with GET /orders (or GET /orders/{purchaseOrderId}) and make sure:

recommendedShipFromNodeId matches the overridden fulfillment center.
recommendedCarrierMethod lists one of the carriers allowed in the override.

Updated about 1 month ago