Update FC level Simplified Shipping Settings
Important: Sellers who integrated with these APIs prior to October 14, 2026 will need to update their integration to the latest API version to ensure compatibility.
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 requests
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 yourWM_SEC.ACCESS_TOKEN. - List the fulfillment center IDs you want to override in
shipNodes. - Set
isOverriddentotrueand providecarrierConfigsfor each center that needs custom rules.
Sample Response
application/json
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 - 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 - 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 - Invalid Region Combinatior
{ "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 ShippingCharge 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 undershipNodeConfigs. - Confirm the override is used by pulling a new order with
GET /orders(orGET /orders/{purchaseOrderId}) and make sure:
recommendedShipFromNodeIdmatches the overridden fulfillment center.recommendedCarrierMethodlists one of the carriers allowed in the override.
Updated about 1 month ago

