Guides
My Account
  1. Simplified Shipping Settings
  2. Simplified Shipping Settings API overview (Deprecated)

Update FC level Simplified Shipping Settings (Deprecated)

Deprecation notice: We heard your feedback and are making Simplified Shipping Settings (SSS) more flexible, giving you the ability to rate shop across carrier services. As we prepare for this launch, the current SSS v1 APIs are temporarily deprecated. API support will be restored with the upcoming release on August 31st. In the meantime, you can continue to manage your Simplified Shipping Settings through the Seller Center UI.


Use this API to override configurations for one or more fulfillment centers.

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

  1. Verify the override exists by calling  GET <https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings> and checking the updated fulfillment center appears under shipNodeConfigs.
  2. 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 17 days ago

Did this page help you?