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

Create 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

The Create Simplified Shipping Settings API enables sellers and solution providers to seamlessly onboard to Simplified Shipping Settings by creating a default shipping configuration. The default configuration covers the majority of your assortments in your fulfillment centers, applying automatically to eligible items, and eliminating any template-to-item mappings. You can add custom configurations for specific items or fulfillment centers with different shipping rules.

Function

Call this endpoint to create an account-level shipping rule for Simplified Shipping Settings. This rule applies to every fulfillment center in your network and specifies:

  • Which carriers you want to use.
  • The regions you want the carriers to cover.
  • Your shipping priority: The fastest delivery or cost savings

Optionally, in the same call, you can direct Walmart to migrate any offers that qualify for Simplified Shipping Settings free shipping in the 48 contiguous US states, Alaska, Hawaii, Puerto Rico, Guam, American Samoa, US Virgin Islands, and the Northern Mariana Islands.

Endpoint

POST https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account

Sample requests

Sample Request

curl --request POST \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "accountConfigs": { "migrateEligibleOffers": false, "carrierConfigs": [ { "shippingMethod": "VALUE", "carriers": [ { "carrierName": "USPS", "carrierService": "USPS_GROUND" }, { "carrierName": "Fedex", "carrierService": "FEDEX_GROUND_ECONOMY" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET", "PO_BOX" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } }, { "regions": [ { "regionCode": "H", "regionName": "AK and HI" }, { "regionCode": "P", "regionName": "US Protectorates" } ], "addressTypes": [ "STREET", "PO_BOX" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 5, "currency": "USD" }, "chargePerWeight": { "amount": 1, "currency": "USD" } } } }, { "regions": [ { "regionCode": "A", "regionName": "APO/FPO" } ], "addressTypes": [ "MILITARY" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 5, "currency": "USD" }, "chargePerWeight": { "amount": 1, "currency": "USD" } } } } ] }, { "shippingMethod": "STANDARD", "carriers": [ { "carrierName": "UPS", "carrierService": "UPS_GROUND" }, { "carrierName": "Fedex", "carrierService": "FEDEX_HOME_DELIVERY" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 5, "currency": "USD" }, "chargePerWeight": { "amount": 1, "currency": "USD" } } } } ] }, { "shippingMethod": "EXPEDITED", "carriers": [ { "carrierName": "UPS", "carrierService": "UPS_2DAY_AIR" }, { "carrierName": "Fedex", "carrierService": "FEDEX_2DAY_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 12.99, "currency": "USD" }, "chargePerWeight": { "amount": 2, "currency": "USD" } } } } ] }, { "shippingMethod": "RUSH", "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_OVERNIGHT" }, { "carrierName": "UPS", "carrierService": "UPS_NEXTDAY_AIR" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 24.99, "currency": "USD" }, "chargePerWeight": { "amount": 3, "currency": "USD" } } } } ] } ] } }
}
'

Sample Request - Duplicate shippingMethod (account level)

curl --request POST \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "accountConfigs": { "carrierConfigs": [ { "shippingMethod": "VALUE", "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_HOME_DELIVERY" } ], "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" } } } } ] }, { "shippingMethod": "VALUE", "carriers": [ { "carrierName": "UPS", "carrierService": "UPS_SUREPOST" } ], "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" } } } } ] } ] } }
}
'

Sample Request - Carrier / shippingMethod mismatch

curl --request POST \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "accountConfigs": { "carrierConfigs": [ { "shippingMethod": "STANDARD", "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_HOME_DELIVERY" } ], "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 - Conflicting regions within same shippingMethod (VALUE)

curl --request POST \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "accountConfigs": { "carrierConfigs": [ { "shippingMethod": "VALUE", "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_GROUND_ECONOMY" } ], "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": 5, "currency": "USD" }, "chargePerWeight": { "amount": 2, "currency": "USD" } } } } ] } ] } }
}
'

Sample Request - 48 States + DC free shipping not covered across shipping methods

curl --request POST \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "accountConfigs": { "carrierConfigs": [ { "shippingMethod": "VALUE", "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_GROUND_ECONOMY" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "WE", "states": [ { "stateCode": "CA", "stateName": "California" } ] } ] } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } } ] }, { "shippingMethod": "STANDARD", "carriers": [ { "carrierName": "UPS", "carrierService": "UPS_GROUND" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "NE", "states": [ { "stateCode": "NY", "stateName": "New York" } ] } ] } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 3, "currency": "USD" }, "chargePerWeight": { "amount": 1, "currency": "USD" } } } } ] } ] } }
}
'

Sample - Carrier Configuration

curl --request POST \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "accountConfigs": { "carrierConfigs": [ { "shippingMethod": "VALUE", "carriers": [ { "carrierName": "UPS", "carrierService": "UPS_SUREPOST" } ], "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" } } } } ] }, { "shippingMethod": "EXPEDITED", "carriers": [ { "carrierName": "UPS", "carrierService": "UPS_2DAY_AIR" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "WE", "states": [ { "stateCode": "NM", "stateName": "New Mexico" }, { "stateCode": "MT", "stateName": "Montana" }, { "stateCode": "NV", "stateName": "Nevada" }, { "stateCode": "WA", "stateName": "Washington" }, { "stateCode": "CO", "stateName": "Colorado" }, { "stateCode": "OR", "stateName": "Oregon" }, { "stateCode": "ID", "stateName": "Idaho" }, { "stateCode": "WY", "stateName": "Wyoming" }, { "stateCode": "AZ", "stateName": "Arizona" }, { "stateCode": "CA", "stateName": "California" }, { "stateCode": "UT", "stateName": "Utah" } ] }, { "subRegionCode": "SO", "states": [ { "stateCode": "DE", "stateName": "Delaware" }, { "stateCode": "MS", "stateName": "Mississippi" }, { "stateCode": "FL", "stateName": "Florida" }, { "stateCode": "AL", "stateName": "Alabama" }, { "stateCode": "DC", "stateName": "District of Columbia" }, { "stateCode": "TX", "stateName": "Texas" }, { "stateCode": "KY", "stateName": "Kentucky" }, { "stateCode": "MD", "stateName": "Maryland" }, { "stateCode": "GA", "stateName": "Georgia" }, { "stateCode": "OK", "stateName": "Oklahoma" }, { "stateCode": "SC", "stateName": "South Carolina" }, { "stateCode": "LA", "stateName": "Louisiana" }, { "stateCode": "AR", "stateName": "Arkansas" }, { "stateCode": "VA", "stateName": "Virginia" }, { "stateCode": "NC", "stateName": "North Carolina" }, { "stateCode": "TN", "stateName": "Tennessee" }, { "stateCode": "WV", "stateName": "West Virginia" } ] } ] } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } } ] } ] } }
}
'curl --request POST \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "accountConfigs": { "carrierConfigs": [ { "shippingMethod": "VALUE", "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_GROUND_ECONOMY" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionCode": "H", "regionName": "AK and HI" }, { "regionCode": "P", "regionName": "US Protectorates" } ], "addressTypes": [ "STREET", "PO_BOX" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } }, { "regions": [ { "regionCode": "A", "regionName": "APO/FPO" } ], "addressTypes": [ "MILITARY" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } } ] }, { "shippingMethod": "RUSH", "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_OVERNIGHT" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "SO", "states": [ { "stateCode": "DE", "stateName": "Delaware" }, { "stateCode": "MS", "stateName": "Mississippi" }, { "stateCode": "FL", "stateName": "Florida" }, { "stateCode": "AL", "stateName": "Alabama" }, { "stateCode": "DC", "stateName": "District of Columbia" }, { "stateCode": "TX", "stateName": "Texas" }, { "stateCode": "KY", "stateName": "Kentucky" }, { "stateCode": "MD", "stateName": "Maryland" }, { "stateCode": "GA", "stateName": "Georgia" }, { "stateCode": "OK", "stateName": "Oklahoma" }, { "stateCode": "SC", "stateName": "South Carolina" }, { "stateCode": "LA", "stateName": "Louisiana" }, { "stateCode": "AR", "stateName": "Arkansas" }, { "stateCode": "VA", "stateName": "Virginia" }, { "stateCode": "NC", "stateName": "North Carolina" }, { "stateCode": "TN", "stateName": "Tennessee" }, { "stateCode": "WV", "stateName": "West Virginia" } ] }, { "subRegionCode": "MW", "states": [ { "stateCode": "ND", "stateName": "North Dakota" }, { "stateCode": "IA", "stateName": "Iowa" }, { "stateCode": "KS", "stateName": "Kansas" }, { "stateCode": "NE", "stateName": "Nebraska" }, { "stateCode": "MO", "stateName": "Missouri" }, { "stateCode": "IL", "stateName": "Illinois" }, { "stateCode": "IN", "stateName": "Indiana" }, { "stateCode": "MN", "stateName": "Minnesota" }, { "stateCode": "OH", "stateName": "Ohio" }, { "stateCode": "MI", "stateName": "Michigan" }, { "stateCode": "WI", "stateName": "Wisconsin" }, { "stateCode": "SD", "stateName": "South Dakota" } ] } ] } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } } ] } ] } }
}
'curl --request POST \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "accountConfigs": { "carrierConfigs": [ { "shippingMethod": "VALUE", "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_GROUND_ECONOMY" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionCode": "H", "regionName": "AK and HI" }, { "regionCode": "P", "regionName": "US Protectorates" } ], "addressTypes": [ "STREET", "PO_BOX" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } }, { "regions": [ { "regionCode": "A", "regionName": "APO/FPO" } ], "addressTypes": [ "MILITARY" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } } ] }, { "shippingMethod": "RUSH", "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_OVERNIGHT" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "SO", "states": [ { "stateCode": "DE", "stateName": "Delaware" }, { "stateCode": "MS", "stateName": "Mississippi" }, { "stateCode": "FL", "stateName": "Florida" }, { "stateCode": "AL", "stateName": "Alabama" }, { "stateCode": "DC", "stateName": "District of Columbia" }, { "stateCode": "TX", "stateName": "Texas" }, { "stateCode": "KY", "stateName": "Kentucky" }, { "stateCode": "MD", "stateName": "Maryland" }, { "stateCode": "GA", "stateName": "Georgia" }, { "stateCode": "OK", "stateName": "Oklahoma" }, { "stateCode": "SC", "stateName": "South Carolina" }, { "stateCode": "LA", "stateName": "Louisiana" }, { "stateCode": "AR", "stateName": "Arkansas" }, { "stateCode": "VA", "stateName": "Virginia" }, { "stateCode": "NC", "stateName": "North Carolina" }, { "stateCode": "TN", "stateName": "Tennessee" }, { "stateCode": "WV", "stateName": "West Virginia" } ] }, { "subRegionCode": "MW", "states": [ { "stateCode": "ND", "stateName": "North Dakota" }, { "stateCode": "IA", "stateName": "Iowa" }, { "stateCode": "KS", "stateName": "Kansas" }, { "stateCode": "NE", "stateName": "Nebraska" }, { "stateCode": "MO", "stateName": "Missouri" }, { "stateCode": "IL", "stateName": "Illinois" }, { "stateCode": "IN", "stateName": "Indiana" }, { "stateCode": "MN", "stateName": "Minnesota" }, { "stateCode": "OH", "stateName": "Ohio" }, { "stateCode": "MI", "stateName": "Michigan" }, { "stateCode": "WI", "stateName": "Wisconsin" }, { "stateCode": "SD", "stateName": "South Dakota" } ] } ] } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } } ] } ] } }
}
'curl --request POST \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "accountConfigs": { "carrierConfigs": [ { "shippingMethod": "VALUE", "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_GROUND_ECONOMY" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionCode": "H", "regionName": "AK and HI" }, { "regionCode": "P", "regionName": "US Protectorates" } ], "addressTypes": [ "STREET", "PO_BOX" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } }, { "regions": [ { "regionCode": "A", "regionName": "APO/FPO" } ], "addressTypes": [ "MILITARY" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } } ] }, { "shippingMethod": "RUSH", "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_OVERNIGHT" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "SO", "states": [ { "stateCode": "DE", "stateName": "Delaware" }, { "stateCode": "MS", "stateName": "Mississippi" }, { "stateCode": "FL", "stateName": "Florida" }, { "stateCode": "AL", "stateName": "Alabama" }, { "stateCode": "DC", "stateName": "District of Columbia" }, { "stateCode": "TX", "stateName": "Texas" }, { "stateCode": "KY", "stateName": "Kentucky" }, { "stateCode": "MD", "stateName": "Maryland" }, { "stateCode": "GA", "stateName": "Georgia" }, { "stateCode": "OK", "stateName": "Oklahoma" }, { "stateCode": "SC", "stateName": "South Carolina" }, { "stateCode": "LA", "stateName": "Louisiana" }, { "stateCode": "AR", "stateName": "Arkansas" }, { "stateCode": "VA", "stateName": "Virginia" }, { "stateCode": "NC", "stateName": "North Carolina" }, { "stateCode": "TN", "stateName": "Tennessee" }, { "stateCode": "WV", "stateName": "West Virginia" } ] }, { "subRegionCode": "MW", "states": [ { "stateCode": "ND", "stateName": "North Dakota" }, { "stateCode": "IA", "stateName": "Iowa" }, { "stateCode": "KS", "stateName": "Kansas" }, { "stateCode": "NE", "stateName": "Nebraska" }, { "stateCode": "MO", "stateName": "Missouri" }, { "stateCode": "IL", "stateName": "Illinois" }, { "stateCode": "IN", "stateName": "Indiana" }, { "stateCode": "MN", "stateName": "Minnesota" }, { "stateCode": "OH", "stateName": "Ohio" }, { "stateCode": "MI", "stateName": "Michigan" }, { "stateCode": "WI", "stateName": "Wisconsin" }, { "stateCode": "SD", "stateName": "South Dakota" } ] } ] } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } } ] } ] } }
}
'

Sample 2 - Carrier Configuration

curl --request POST \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "accountConfigs": { "carrierConfigs": [ { "shippingMethod": "VALUE", "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_GROUND_ECONOMY" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionCode": "H", "regionName": "AK and HI" }, { "regionCode": "P", "regionName": "US Protectorates" } ], "addressTypes": [ "STREET", "PO_BOX" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } }, { "regions": [ { "regionCode": "A", "regionName": "APO/FPO" } ], "addressTypes": [ "MILITARY" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } } ] }, { "shippingMethod": "RUSH", "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_OVERNIGHT" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "SO", "states": [ { "stateCode": "DE", "stateName": "Delaware" }, { "stateCode": "MS", "stateName": "Mississippi" }, { "stateCode": "FL", "stateName": "Florida" }, { "stateCode": "AL", "stateName": "Alabama" }, { "stateCode": "DC", "stateName": "District of Columbia" }, { "stateCode": "TX", "stateName": "Texas" }, { "stateCode": "KY", "stateName": "Kentucky" }, { "stateCode": "MD", "stateName": "Maryland" }, { "stateCode": "GA", "stateName": "Georgia" }, { "stateCode": "OK", "stateName": "Oklahoma" }, { "stateCode": "SC", "stateName": "South Carolina" }, { "stateCode": "LA", "stateName": "Louisiana" }, { "stateCode": "AR", "stateName": "Arkansas" }, { "stateCode": "VA", "stateName": "Virginia" }, { "stateCode": "NC", "stateName": "North Carolina" }, { "stateCode": "TN", "stateName": "Tennessee" }, { "stateCode": "WV", "stateName": "West Virginia" } ] }, { "subRegionCode": "MW", "states": [ { "stateCode": "ND", "stateName": "North Dakota" }, { "stateCode": "IA", "stateName": "Iowa" }, { "stateCode": "KS", "stateName": "Kansas" }, { "stateCode": "NE", "stateName": "Nebraska" }, { "stateCode": "MO", "stateName": "Missouri" }, { "stateCode": "IL", "stateName": "Illinois" }, { "stateCode": "IN", "stateName": "Indiana" }, { "stateCode": "MN", "stateName": "Minnesota" }, { "stateCode": "OH", "stateName": "Ohio" }, { "stateCode": "MI", "stateName": "Michigan" }, { "stateCode": "WI", "stateName": "Wisconsin" }, { "stateCode": "SD", "stateName": "South Dakota" } ] } ] } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } } ] } ] } }
}
'

Sample V2 - Multiple shippingMethods (Explode)

curl --request POST \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "accountConfigs": { "carrierConfigs": [ { "shippingMethod": "VALUE", "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_GROUND_ECONOMY" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionCode": "H", "regionName": "AK and HI" }, { "regionCode": "P", "regionName": "US Protectorates" } ], "addressTypes": [ "STREET", "PO_BOX" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } }, { "regions": [ { "regionCode": "A", "regionName": "APO/FPO" } ], "addressTypes": [ "MILITARY" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } } ] }, { "shippingMethod": "STANDARD", "carriers": [ { "carrierName": "UPS", "carrierService": "UPS_GROUND" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionCode": "H", "regionName": "AK and HI" } ], "addressTypes": [ "STREET", "PO_BOX" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } } ] }, { "shippingMethod": "EXPEDITED", "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" } } } } ] } ] } }
}
'

Sample 3 - Invalid Carrier Name

curl --request POST \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "accountConfigs": { "carrierConfigs": [ { "shippingMethod": "STANDARD", "carriers": [ { "carrierName": "test", "carrierService": "testService" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionName": "AK and HI", "regionCode": "H" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerItem": { "amount": 0, "currency": "USD" } } } } ] }, { "shippingMethod": "VALUE", "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_GROUND_ECONOMY" } ], "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 4 - Shipping Charge is empty

curl --request POST \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "accountConfigs": { "carrierConfigs": [ { "shippingMethod": "STANDARD", "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_HOME_DELIVERY" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionName": "AK and HI", "regionCode": "H" } ], "addressTypes": [ "STREET" ] } ] } ] } }
}
'

Sample 5 - Valid subtype of shippingCharge object not present

curl --request POST \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "accountConfigs": { "carrierConfigs": [ { "shippingMethod": "STANDARD", "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_HOME_DELIVERY" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionName": "AK and HI", "regionCode": "H" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING" } } ] } ] } }
}
'

Sample 6 - Shipping charge amount cannot exceed 700

curl --request POST \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "accountConfigs": { "carrierConfigs": [ { "shippingMethod": "STANDARD", "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_HOME_DELIVERY" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" }, { "regionName": "AK and HI", "regionCode": "H" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerItem": { "amount": 780, "currency": "USD" } } } } ] } ] } }
}
'

Sample 8 - Duplicate regions for same carrier is not allowed at account level

curl --request POST \ --url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "simplifiedShippingSettings": { "accountConfigs": { "carrierConfigs": [ { "shippingMethod": "STANDARD", "carriers": [ { "carrierName": "UPS", "carrierService": "UPS_GROUND" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerItem": { "amount": 0, "currency": "USD" } } } }, { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 10, "currency": "USD" }, "chargePerWeight": { "amount": 20, "currency": "USD" } } } } ] } ] } }
}
'

Modify your request

To successfully create settings, make the following modifications:

  1. Authentication: Include your token header (example header used elsewhere: WM_SEC.ACCESS_TOKEN: <YourAccessToken> or use your agreed auth header).
  2. Required headers: Include WM_GLOBAL_VERSION and WM_MARKET as shown. Always set Accept: application/json and Content-Type: application/json.
  3. Payload validity: Copy-paste one of the sample JSON bodies above (exactly as supplied) into data or a file and reference it (--data @payload.json). Do not insert duplicate braces or syntax errors.
  4. Carrier/service validation. Ensure carrierService values are supported for the specified carrierName. Unsupported combos can return an invalid carrier configuration error.
  5. Coverage rules. If the selected carrier requires full state coverage, include all 48 states + DC or adjust carrier choices accordingly to avoid All 48 states + DC are not covered errors.
  6. No duplicate state codes. Make sure stateCode values are unique. Duplicate state codes produce astateCodes error.
  7. Seller eligibility constraints: If your seller account has 3PL nodes, bundles, international nodes, or is enrolled in major applications, the request will be rejected. Remove unsupported configurations or contact support.

Example:

curl --request POST \ --url 'https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account' \ --header 'WM_GLOBAL_VERSION: 3.1' \ --header 'WM_MARKET: us' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --header 'WM_SEC.ACCESS_TOKEN: <YourAccessToken>' \ --data @create_simplified_shipping_payload.json

Sample responses

application/json

200 - Sample Response

{ "simplifiedShippingSettings": { "accountConfigs": { "migrateEligibleOffers": false, "carrierConfigs": [ { "shippingMethod": "VALUE", "carriers": [ { "carrierName": "USPS", "carrierService": "USPS_GROUND" }, { "carrierName": "Fedex", "carrierService": "FEDEX_GROUND_ECONOMY" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET", "PO_BOX" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } }, { "regions": [ { "regionCode": "H", "regionName": "AK and HI" }, { "regionCode": "P", "regionName": "US Protectorates" } ], "addressTypes": [ "STREET", "PO_BOX" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 5, "currency": "USD" }, "chargePerWeight": { "amount": 1, "currency": "USD" } } } }, { "regions": [ { "regionCode": "A", "regionName": "APO/FPO" } ], "addressTypes": [ "MILITARY" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 5, "currency": "USD" }, "chargePerWeight": { "amount": 1, "currency": "USD" } } } } ] }, { "shippingMethod": "STANDARD", "carriers": [ { "carrierName": "UPS", "carrierService": "UPS_GROUND" }, { "carrierName": "Fedex", "carrierService": "FEDEX_HOME_DELIVERY" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 5, "currency": "USD" }, "chargePerWeight": { "amount": 1, "currency": "USD" } } } } ] }, { "shippingMethod": "EXPEDITED", "carriers": [ { "carrierName": "UPS", "carrierService": "UPS_2DAY_AIR" }, { "carrierName": "Fedex", "carrierService": "FEDEX_2DAY_EXPRESS" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 12.99, "currency": "USD" }, "chargePerWeight": { "amount": 2, "currency": "USD" } } } } ] }, { "shippingMethod": "RUSH", "carriers": [ { "carrierName": "Fedex", "carrierService": "FEDEX_OVERNIGHT" }, { "carrierName": "UPS", "carrierService": "UPS_NEXTDAY_AIR" } ], "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "shippingCharge": { "rateModelType": "PER_SHIPMENT_PRICING", "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 24.99, "currency": "USD" }, "chargePerWeight": { "amount": 3, "currency": "USD" } } } } ] } ] } }
}

200 - Sample - Duplicate State Codes

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "stateCode", "description": "Duplicate stateCodes for: CT", "info": "Duplicate stateCodes for: CT", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

200 - Sample - Conflicting Regions Within Same ShippingMethod (VALUE)

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "carrierConfigs", "description": "Multiple shipping rules cannot be set across the same carrier service and region combination.", "info": "Ensure no conflicting carrier configurations exist for the same shippingMethod, carrierService, region, and addressType combination.", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

200 - Sample - 48 States + DC Free Shipping Not Covered Across Shipping Methods

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "configurations", "description": "Free shipping must cover all 48 states + DC at account level. Ensure at least one carrier configuration offers free (zero-charge) shipping across all 48 contiguous states and Washington DC.", "info": "Free shipping must cover all 48 states + DC at account level. Ensure at least one carrier configuration offers free (zero-charge) shipping across all 48 contiguous states and Washington DC.", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

200 - Sample - Invalid Carrier Configs

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

200 - Sample - Invalid Coverage

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "carrierConfigs", "description": "The provided coverage for the given carrier service is not supported: `USPS_PRIORITY_MAIL_EXPRESS`", "info": "The provided coverage for the given carrier service is not supported: `USPS_PRIORITY_MAIL_EXPRESS`", "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 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 - Settings Already Exists

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "simplifiedShippingSettings", "description": "Simplified Shipping Settings already exists at account level for seller: ", "info": "Simplified Shipping Settings already exists at account level for seller: ", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

200 - Sample - 3PL Node

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "sellerEligibility", "description": "Your account has 3PL fulfillment centers, which Simplified Shipping Settings does not currently support. Support for 3PL fulfillment centers is in development. Check back later for updates.", "info": "Your account has 3PL fulfillment centers, which Simplified Shipping Settings does not currently support. Support for 3PL fulfillment centers is in development. Check back later for updates.", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

200 - Sample - Bundle Items

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "sellerEligibility", "description": "Your account has bundle items, which Simplified Shipping Settings does not currently support. Support for bundle items is in development. Check back later for updates", "info": "Your account has bundle items, which Simplified Shipping Settings does not currently support. Support for bundle items is in development. Check back later for updates", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

200 - Sample - International Nodes

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "sellerEligibility", "description": "Your account has international fulfillment centers, which Simplified Shipping Settings currently do not support. Support for international fulfillment centers is in development. Check back later for updates.", "info": "Your account has international fulfillment centers, which Simplified Shipping Settings currently do not support. Support for international fulfillment centers is in development. Check back later for updates.", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

200 - Sample - Major Appliances

{ "errors": [ { "code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST", "field": "sellerEligibility", "description": "Your account is enabled for Major Appliances program, which Simplified Shipping Settings currently do not support. Support for Major Appliances is in development. Check back later for updates.", "info": "Your account is enabled for Major Appliances program, which Simplified Shipping Settings currently do not support. Support for Major Appliances is in development. Check back later for updates.", "severity": "ERROR", "category": "DATA", "causes": [], "errorIdentifiers": {} } ]
}

200 - Sample - Duplicate ShippingMethod (Account Level)

200 - Sample - Duplicate ShippingMethod (FC Level)

200 - Sample - Carrier / ShippingMethod Mismatch

200 - Sample - Carrier / ShippingMethod Mismatch (FC Level)

200 - Sample - Invalid Carrier Name

200 - Sample - Shipping Charge Object Is Empty

200 - Sample - Valid Subtype Of ShippingCharge Object Not Present

200 - Sample - Shipping Charge Amount Cannot Exceed 700

200 - Sample - Duplicate Regions Not Allowed At Account Level

401

application/problem+json

400

403

500

Result

  • Success: Returns a simplifiedShippingSettings object reflecting account-level settings (carriers, configurations, regions, address types, shipping priority, migration flags). This setting become the global default for shipping unless overridden by fulfillment center level configurations.
  • Failure / Validation errors: The response includes any errors array describing the problem and the fields to fix.

Next steps

After you create your Simplified Shipping Settings configuration, use the Orders Management API to retrieve released orders and shipping recommendations:

Updated 8 days ago

Did this page help you?