---
updatedAt: 2026-08-03T04:45:31.000Z
---
# Update 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 [Update Simplified Shipping Settings ](https://developer.walmart.com/us-marketplace/reference/updatesimplifiedshippingsettings)API helps sellers and approved solution providers modify their existing default shipping configuration as business needs evolve. Since the default setting typically covers the majority of your assortment and fulfillment centers, updates through this API automatically cascade to all items governed in the configuration. This enables sellers to efficiently adjust carrier selections, regional coverages or shipping charges without manual remapping, while still retaining the flexibility to maintain separate custom configurations where needed.
***
# Functionality
Sellers and approved Solution Providers use this API endpoint to update account-level Simplified Shipping Settings configurations for all fulfillment centers. You can update settings within the `accountConfigs` object to modify configurations, such as changing:
* The carriers that are available for your items.
* The regions that items are available in.
The endpoint returns an updated version of the `simplifiedShippingSettings` map of the Simplified Shipping Settings configurations.
***
# Endpoint
```text
PUT
```
***
## Sample request
```python cURL
curl --request PUT \
--url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '
{
"simplifiedShippingSettings": {
"accountConfigs": {
"shippingPriority": "FASTEST",
"migrateFreeShippingOffers": true,
"carrierConfigs": [
{
"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"
},
"chargePerItem": {
"amount": 0,
"currency": "USD"
}
}
}
}
]
},
{
"carriers": [
{
"carrierName": "Fedex",
"carrierService": "FEDEX_EXPRESS"
}
],
"configurations": [
{
"regions": [
{
"regionName": "AK and HI",
"regionCode": "H"
}
],
"addressTypes": [
"STREET"
],
"shippingCharge": {
"rateModelType": "PER_SHIPMENT_PRICING",
"perShippingCharge": {
"unitOfMeasure": "LB",
"shippingAndHandling": {
"amount": 2,
"currency": "USD"
},
"chargePerWeight": {
"amount": 5,
"currency": "USD"
}
}
}
}
]
},
{
"carriers": [
{
"carrierName": "UPS",
"carrierService": "UPS_3DAY_SELECT"
}
],
"configurations": [
{
"regions": [
{
"regionCode": "P",
"regionName": "US Protectorates"
}
],
"addressTypes": [
"STREET"
],
"shippingCharge": {
"rateModelType": "PER_SHIPMENT_PRICING",
"perShippingCharge": {
"unitOfMeasure": "LB",
"shippingAndHandling": {
"amount": 0,
"currency": "USD"
},
"chargePerWeight": {
"amount": 0,
"currency": "USD"
}
}
}
}
]
}
]
}
}
}
'
```
```python
import requests
import json
# Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account"
# Replace the placeholder values with your own
headers = {
"Accept": "application/json",
"Content-Type": "application/json",
"WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token
"WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call
"WM_SVC.NAME": "Walmart Service Name"
}
payload = {
"simplifiedShippingSettings": {
"accountConfigs": {
"shippingPriority": "FASTEST",
"migrateEligibleOffers": False,
"carrierConfigs": [
{
"carriers": [
{ "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" }
],
"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_OVERNIGHT" }
],
"configurations": [
{
"regions": [
{ "regionCode": "C", "regionName": "48 State" },
{ "regionCode": "P", "regionName": "US Protectorate 6s" }
],
"addressTypes": ["PO_BOX", "STREET"]
}
]
}
]
}
}
}
response = requests.post(url, headers=headers, data=json.dumps(payload))
print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))
```
## Sample 1 - Carrier Configuration
```python cURL
curl --request PUT \
--url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '
{
"simplifiedShippingSettings": {
"accountConfigs": {
"shippingPriority": "FASTEST",
"migrateFreeShippingOffers": true,
"carrierConfigs": [
{
"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": 0,
"currency": "USD"
},
"chargePerWeight": {
"amount": 0,
"currency": "USD"
}
}
}
}
]
}
]
}
}
}
'
```
```python
import requests
import json
# Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account"
# Replace the placeholder values with your own
headers = {
"Accept": "application/json",
"Content-Type": "application/json",
"WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token
"WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call
"WM_SVC.NAME": "Walmart Service Name"
}
payload = {
"simplifiedShippingSettings": {
"accountConfigs": {
"shippingPriority": "FASTEST",
"migrateEligibleOffers": False,
"carrierConfigs": [
{
"carriers": [
{ "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" }
],
"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_OVERNIGHT" }
],
"configurations": [
{
"regions": [
{ "regionCode": "C", "regionName": "48 State" },
{ "regionCode": "P", "regionName": "US Protectorate 6s" }
],
"addressTypes": ["PO_BOX", "STREET"]
}
]
}
]
}
}
}
response = requests.post(url, headers=headers, data=json.dumps(payload))
print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))
```
## Sample 2 - Carrier Configuration
```python cURL
curl --request PUT \
--url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '
{
"simplifiedShippingSettings": {
"accountConfigs": {
"shippingPriority": "FASTEST",
"migrateFreeShippingOffers": true,
"carrierConfigs": [
{
"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": 0,
"currency": "USD"
},
"chargePerWeight": {
"amount": 0,
"currency": "USD"
}
}
}
}
]
}
]
}
}
}
'
```
```python
import requests
import json
# Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account"
# Replace the placeholder values with your own
headers = {
"Accept": "application/json",
"Content-Type": "application/json",
"WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token
"WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call
"WM_SVC.NAME": "Walmart Service Name"
}
payload = {
"simplifiedShippingSettings": {
"accountConfigs": {
"shippingPriority": "FASTEST",
"migrateEligibleOffers": False,
"carrierConfigs": [
{
"carriers": [
{ "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" }
],
"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_OVERNIGHT" }
],
"configurations": [
{
"regions": [
{ "regionCode": "C", "regionName": "48 State" },
{ "regionCode": "P", "regionName": "US Protectorate 6s" }
],
"addressTypes": ["PO_BOX", "STREET"]
}
]
}
]
}
}
}
response = requests.post(url, headers=headers, data=json.dumps(payload))
print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))
```
## Sample 3 - Invalid Carrier Name
```python cURL
curl --request PUT \
--url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '
{
"simplifiedShippingSettings": {
"accountConfigs": {
"shippingPriority": "FASTEST",
"migrateFreeShippingOffers": true,
"carrierConfigs": [
{
"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"
}
}
}
}
]
},
{
"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"
}
}
}
}
]
}
]
}
}
}
'
```
```python
import requests
import json
# Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account"
# Replace the placeholder values with your own
headers = {
"Accept": "application/json",
"Content-Type": "application/json",
"WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token
"WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call
"WM_SVC.NAME": "Walmart Service Name"
}
payload = {
"simplifiedShippingSettings": {
"accountConfigs": {
"shippingPriority": "FASTEST",
"migrateEligibleOffers": False,
"carrierConfigs": [
{
"carriers": [
{ "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" }
],
"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_OVERNIGHT" }
],
"configurations": [
{
"regions": [
{ "regionCode": "C", "regionName": "48 State" },
{ "regionCode": "P", "regionName": "US Protectorate 6s" }
],
"addressTypes": ["PO_BOX", "STREET"]
}
]
}
]
}
}
}
response = requests.post(url, headers=headers, data=json.dumps(payload))
print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))
```
## Sample 4 - Shipping Charge object is empty
```python cURL
curl --request PUT \
--url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '
{
"simplifiedShippingSettings": {
"accountConfigs": {
"shippingPriority": "FASTEST",
"migrateFreeShippingOffers": true,
"carrierConfigs": [
{
"carriers": [
{
"carrierName": "Fedex",
"carrierService": "FEDEX_HOME_DELIVERY"
}
],
"configurations": [
{
"regions": [
{
"regionCode": "C",
"regionName": "48 State"
},
{
"regionName": "AK and HI",
"regionCode": "H"
}
],
"addressTypes": [
"STREET"
]
}
]
}
]
}
}
}
'
```
```python
import requests
import json
# Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account"
# Replace the placeholder values with your own
headers = {
"Accept": "application/json",
"Content-Type": "application/json",
"WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token
"WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call
"WM_SVC.NAME": "Walmart Service Name"
}
payload = {
"simplifiedShippingSettings": {
"accountConfigs": {
"shippingPriority": "FASTEST",
"migrateEligibleOffers": False,
"carrierConfigs": [
{
"carriers": [
{ "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" }
],
"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_OVERNIGHT" }
],
"configurations": [
{
"regions": [
{ "regionCode": "C", "regionName": "48 State" },
{ "regionCode": "P", "regionName": "US Protectorate 6s" }
],
"addressTypes": ["PO_BOX", "STREET"]
}
]
}
]
}
}
}
response = requests.post(url, headers=headers, data=json.dumps(payload))
print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))
```
## Sample 5 - Valid subtype of shippingCharge object not present
```python cURL
curl --request PUT \
--url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '
{
"simplifiedShippingSettings": {
"accountConfigs": {
"shippingPriority": "FASTEST",
"migrateFreeShippingOffers": true,
"carrierConfigs": [
{
"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"
}
}
]
}
]
}
}
}
'
```
```python
import requests
import json
# Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account"
# Replace the placeholder values with your own
headers = {
"Accept": "application/json",
"Content-Type": "application/json",
"WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token
"WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call
"WM_SVC.NAME": "Walmart Service Name"
}
payload = {
"simplifiedShippingSettings": {
"accountConfigs": {
"shippingPriority": "FASTEST",
"migrateEligibleOffers": False,
"carrierConfigs": [
{
"carriers": [
{ "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" }
],
"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_OVERNIGHT" }
],
"configurations": [
{
"regions": [
{ "regionCode": "C", "regionName": "48 State" },
{ "regionCode": "P", "regionName": "US Protectorate 6s" }
],
"addressTypes": ["PO_BOX", "STREET"]
}
]
}
]
}
}
}
response = requests.post(url, headers=headers, data=json.dumps(payload))
print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))
```
## Sample 6 - Shipping charge amount cannot exceed 700
```python cURL
curl --request PUT \
--url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '
{
"simplifiedShippingSettings": {
"accountConfigs": {
"shippingPriority": "FASTEST",
"migrateFreeShippingOffers": true,
"carrierConfigs": [
{
"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"
}
}
}
}
]
}
]
}
}
}
'
```
```python
import requests
import json
# Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account"
# Replace the placeholder values with your own
headers = {
"Accept": "application/json",
"Content-Type": "application/json",
"WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token
"WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call
"WM_SVC.NAME": "Walmart Service Name"
}
payload = {
"simplifiedShippingSettings": {
"accountConfigs": {
"shippingPriority": "FASTEST",
"migrateEligibleOffers": False,
"carrierConfigs": [
{
"carriers": [
{ "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" }
],
"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_OVERNIGHT" }
],
"configurations": [
{
"regions": [
{ "regionCode": "C", "regionName": "48 State" },
{ "regionCode": "P", "regionName": "US Protectorate 6s" }
],
"addressTypes": ["PO_BOX", "STREET"]
}
]
}
]
}
}
}
response = requests.post(url, headers=headers, data=json.dumps(payload))
print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))
```
## Sample request - Duplicate regions are not allowed for same carrier at account level
```python cURL
curl --request PUT \
--url https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '
{
"simplifiedShippingSettings": {
"accountConfigs": {
"shippingPriority": "FASTEST",
"carrierConfigs": [
{
"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"
}
}
}
}
]
}
]
}
}
}
'
```
```python
import requests
import json
# Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account"
# Replace the placeholder values with your own
headers = {
"Accept": "application/json",
"Content-Type": "application/json",
"WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token
"WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call
"WM_SVC.NAME": "Walmart Service Name"
}
payload = {
"simplifiedShippingSettings": {
"accountConfigs": {
"shippingPriority": "FASTEST",
"migrateEligibleOffers": False,
"carrierConfigs": [
{
"carriers": [
{ "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" }
],
"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_OVERNIGHT" }
],
"configurations": [
{
"regions": [
{ "regionCode": "C", "regionName": "48 State" },
{ "regionCode": "P", "regionName": "US Protectorate 6s" }
],
"addressTypes": ["PO_BOX", "STREET"]
}
]
}
]
}
}
}
response = requests.post(url, headers=headers, data=json.dumps(payload))
print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))
```
***
# Modify your code
Follow these steps to call this API and receive the responses provided:
1. Add authentication headers: Include your valid access token header (example, `WM_SEC.ACCESS_TOKEN`: `` or standard Authorization: Bearer depending on your integration).
2. Include required marketplace headers: Samples include `WM_GLOBAL_VERSION` and `WM_MARKET`. Keep Accept: application/json and Content-Type: application/json.
3. Validate the JSON payload. Ensure there are no syntax issues (duplicate opening braces) and the payload conforms to allowed enums for `carrierName`, `carrierService`, `regionCode`, `regionName,` and `addressTypes`.
4. Check region/state coverage rules. Account-level coverage typically must include all 48 states + DC when certain carrier/services require full coverage. If account-level coverage is incomplete, you will receive an `INVALID_REQUEST_CONTENT.INVALID_REQUEST` error.
5. Watch for seller eligibility constraints. Requests may fail if the seller has unsupported conditions (3PL nodes, bundle items, international nodes, etc.).
6. This API may return errors in the response body even with an `HTTP 200` code. Always inspect the response body for an errors array.
#### Example: Add access token and market headers:
```python cURL
curl --request PUT \
--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: ' \
--data @payload.json
```
```python
import requests
import json
# Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account"
# Replace the placeholder values with your own
headers = {
"Accept": "application/json",
"Content-Type": "application/json",
"WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token
"WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call
"WM_SVC.NAME": "Walmart Service Name"
}
payload = {
"simplifiedShippingSettings": {
"accountConfigs": {
"shippingPriority": "FASTEST",
"migrateEligibleOffers": False,
"carrierConfigs": [
{
"carriers": [
{ "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" }
],
"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_OVERNIGHT" }
],
"configurations": [
{
"regions": [
{ "regionCode": "C", "regionName": "48 State" },
{ "regionCode": "P", "regionName": "US Protectorate 6s" }
],
"addressTypes": ["PO_BOX", "STREET"]
}
]
}
]
}
}
}
response = requests.post(url, headers=headers, data=json.dumps(payload))
print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))
```
# 200 – Sample response
```python cURL
{
"simplifiedShippingSettings": {
"accountConfigs": {
"shippingPriority": "FASTEST",
"migrateFreeShippingOffers": true,
"carrierConfigs": [
{
"carriers": [
{
"carrierName": "UPS",
"carrierService": "UPS_3DAY_SELECT"
}
],
"configurations": [
{
"regions": [
{
"regionCode": "P",
"regionName": "US Protectorates"
}
],
"addressTypes": [
"STREET"
],
"shippingCharge": {
"rateModelType": "PER_SHIPMENT_PRICING",
"perShippingCharge": {
"unitOfMeasure": "LB",
"shippingAndHandling": {
"amount": 0,
"currency": "USD"
},
"chargePerWeight": {
"amount": 0,
"currency": "USD"
}
}
}
}
]
},
{
"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"
},
"chargePerItem": {
"amount": 0,
"currency": "USD"
}
}
}
}
]
},
{
"carriers": [
{
"carrierName": "Fedex",
"carrierService": "FEDEX_EXPRESS"
}
],
"configurations": [
{
"regions": [
{
"regionCode": "H",
"regionName": "AK and HI"
}
],
"addressTypes": [
"STREET"
],
"shippingCharge": {
"rateModelType": "PER_SHIPMENT_PRICING",
"perShippingCharge": {
"unitOfMeasure": "LB",
"shippingAndHandling": {
"amount": 2,
"currency": "USD"
},
"chargePerWeight": {
"amount": 5,
"currency": "USD"
}
}
}
}
]
}
]
}
}
}
```
```python
import requests
import json
# Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account"
# Replace the placeholder values with your own
headers = {
"Accept": "application/json",
"Content-Type": "application/json",
"WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token
"WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call
"WM_SVC.NAME": "Walmart Service Name"
}
payload = {
"simplifiedShippingSettings": {
"accountConfigs": {
"shippingPriority": "FASTEST",
"migrateEligibleOffers": False,
"carrierConfigs": [
{
"carriers": [
{ "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" }
],
"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_OVERNIGHT" }
],
"configurations": [
{
"regions": [
{ "regionCode": "C", "regionName": "48 State" },
{ "regionCode": "P", "regionName": "US Protectorate 6s" }
],
"addressTypes": ["PO_BOX", "STREET"]
}
]
}
]
}
}
}
response = requests.post(url, headers=headers, data=json.dumps(payload))
print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))
```
# 200 – Sample response duplicate state codes
```python cURL
{
"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": {}
}
]
}
```
```python
import requests
import json
# Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account"
# Replace the placeholder values with your own
headers = {
"Accept": "application/json",
"Content-Type": "application/json",
"WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token
"WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call
"WM_SVC.NAME": "Walmart Service Name"
}
payload = {
"simplifiedShippingSettings": {
"accountConfigs": {
"shippingPriority": "FASTEST",
"migrateEligibleOffers": False,
"carrierConfigs": [
{
"carriers": [
{ "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" }
],
"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_OVERNIGHT" }
],
"configurations": [
{
"regions": [
{ "regionCode": "C", "regionName": "48 State" },
{ "regionCode": "P", "regionName": "US Protectorate 6s" }
],
"addressTypes": ["PO_BOX", "STREET"]
}
]
}
]
}
}
}
response = requests.post(url, headers=headers, data=json.dumps(payload))
print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))
```
# 200 – Sample response invalid carrier configs
```python cURL
{
"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": {}
}
]
}
```
```python
import requests
import json
# Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account"
# Replace the placeholder values with your own
headers = {
"Accept": "application/json",
"Content-Type": "application/json",
"WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token
"WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call
"WM_SVC.NAME": "Walmart Service Name"
}
payload = {
"simplifiedShippingSettings": {
"accountConfigs": {
"shippingPriority": "FASTEST",
"migrateEligibleOffers": False,
"carrierConfigs": [
{
"carriers": [
{ "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" }
],
"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_OVERNIGHT" }
],
"configurations": [
{
"regions": [
{ "regionCode": "C", "regionName": "48 State" },
{ "regionCode": "P", "regionName": "US Protectorate 6s" }
],
"addressTypes": ["PO_BOX", "STREET"]
}
]
}
]
}
}
}
response = requests.post(url, headers=headers, data=json.dumps(payload))
print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))
```
# 200 – Sample response invalid coverage
```python cURL
{
"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": {}
}
]
}
```
```python
import requests
import json
# Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account"
# Replace the placeholder values with your own
headers = {
"Accept": "application/json",
"Content-Type": "application/json",
"WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token
"WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call
"WM_SVC.NAME": "Walmart Service Name"
}
payload = {
"simplifiedShippingSettings": {
"accountConfigs": {
"shippingPriority": "FASTEST",
"migrateEligibleOffers": False,
"carrierConfigs": [
{
"carriers": [
{ "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" }
],
"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_OVERNIGHT" }
],
"configurations": [
{
"regions": [
{ "regionCode": "C", "regionName": "48 State" },
{ "regionCode": "P", "regionName": "US Protectorate 6s" }
],
"addressTypes": ["PO_BOX", "STREET"]
}
]
}
]
}
}
}
response = requests.post(url, headers=headers, data=json.dumps(payload))
print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))
```
# 200 – Sample response invalid coverage 2
```python cURL
{
"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": {}
}
]
}
```
```python
import requests
import json
# Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account"
# Replace the placeholder values with your own
headers = {
"Accept": "application/json",
"Content-Type": "application/json",
"WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token
"WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call
"WM_SVC.NAME": "Walmart Service Name"
}
payload = {
"simplifiedShippingSettings": {
"accountConfigs": {
"shippingPriority": "FASTEST",
"migrateEligibleOffers": False,
"carrierConfigs": [
{
"carriers": [
{ "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" }
],
"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_OVERNIGHT" }
],
"configurations": [
{
"regions": [
{ "regionCode": "C", "regionName": "48 State" },
{ "regionCode": "P", "regionName": "US Protectorate 6s" }
],
"addressTypes": ["PO_BOX", "STREET"]
}
]
}
]
}
}
}
response = requests.post(url, headers=headers, data=json.dumps(payload))
print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))
```
# 200 – Sample response invalid region combination
```python cURL
{
"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": {}
}
]
}
```
```python
import requests
import json
# Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account"
# Replace the placeholder values with your own
headers = {
"Accept": "application/json",
"Content-Type": "application/json",
"WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token
"WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call
"WM_SVC.NAME": "Walmart Service Name"
}
payload = {
"simplifiedShippingSettings": {
"accountConfigs": {
"shippingPriority": "FASTEST",
"migrateEligibleOffers": False,
"carrierConfigs": [
{
"carriers": [
{ "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" }
],
"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_OVERNIGHT" }
],
"configurations": [
{
"regions": [
{ "regionCode": "C", "regionName": "48 State" },
{ "regionCode": "P", "regionName": "US Protectorate 6s" }
],
"addressTypes": ["PO_BOX", "STREET"]
}
]
}
]
}
}
}
response = requests.post(url, headers=headers, data=json.dumps(payload))
print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))
```
# 200 – Sample response 3PL node
```python cURL
{
"errors": [
{
"code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST",
"field": "sellerEligibility",
"description": "We noticed you have 3PL fulfillment centers which Simplified Shipping Settings currently do not support. We are working on bringing that support in. Please check back later.",
"info": "We noticed you have 3PL fulfillment centers which Simplified Shipping Settings currently do not support. We are working on bringing that support in. Please check back later.",
"severity": "ERROR",
"category": "DATA",
"causes": [],
"errorIdentifiers": {}
}
]
}
```
```python
import requests
import json
# Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account"
# Replace the placeholder values with your own
headers = {
"Accept": "application/json",
"Content-Type": "application/json",
"WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token
"WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call
"WM_SVC.NAME": "Walmart Service Name"
}
payload = {
"simplifiedShippingSettings": {
"accountConfigs": {
"shippingPriority": "FASTEST",
"migrateEligibleOffers": False,
"carrierConfigs": [
{
"carriers": [
{ "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" }
],
"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_OVERNIGHT" }
],
"configurations": [
{
"regions": [
{ "regionCode": "C", "regionName": "48 State" },
{ "regionCode": "P", "regionName": "US Protectorate 6s" }
],
"addressTypes": ["PO_BOX", "STREET"]
}
]
}
]
}
}
}
response = requests.post(url, headers=headers, data=json.dumps(payload))
print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))
```
# 200 – Sample response bundle items
```python cURL
{
"errors": [
{
"code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST",
"field": "sellerEligibility",
"description": "Seller with Bundles: We noticed you have Bundle items which Simplified Shipping Settings currently do not support. We are working on bringing that support in. Please check back later",
"info": "Seller with Bundles: We noticed you have Bundle items which Simplified Shipping Settings currently do not support. We are working on bringing that support in. Please check back later",
"severity": "ERROR",
"category": "DATA",
"causes": [],
"errorIdentifiers": {}
}
]
}
```
```python
import requests
import json
# Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account"
# Replace the placeholder values with your own
headers = {
"Accept": "application/json",
"Content-Type": "application/json",
"WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token
"WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call
"WM_SVC.NAME": "Walmart Service Name"
}
payload = {
"simplifiedShippingSettings": {
"accountConfigs": {
"shippingPriority": "FASTEST",
"migrateEligibleOffers": False,
"carrierConfigs": [
{
"carriers": [
{ "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" }
],
"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_OVERNIGHT" }
],
"configurations": [
{
"regions": [
{ "regionCode": "C", "regionName": "48 State" },
{ "regionCode": "P", "regionName": "US Protectorate 6s" }
],
"addressTypes": ["PO_BOX", "STREET"]
}
]
}
]
}
}
}
response = requests.post(url, headers=headers, data=json.dumps(payload))
print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))
```
# 200 – Sample response international nodes
```python cURL
{
"errors": [
{
"code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST",
"field": "sellerEligibility",
"description": "We noticed you have international fulfillment centers which Simplified Shipping Settings currently do not support. We are working on bringing that support in. Please check back later.",
"info": "We noticed you have international fulfillment centers which Simplified Shipping Settings currently do not support. We are working on bringing that support in. Please check back later.",
"severity": "ERROR",
"category": "DATA",
"causes": [],
"errorIdentifiers": {}
}
]
}
```
```python
import requests
import json
# Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account"
# Replace the placeholder values with your own
headers = {
"Accept": "application/json",
"Content-Type": "application/json",
"WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token
"WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call
"WM_SVC.NAME": "Walmart Service Name"
}
payload = {
"simplifiedShippingSettings": {
"accountConfigs": {
"shippingPriority": "FASTEST",
"migrateEligibleOffers": False,
"carrierConfigs": [
{
"carriers": [
{ "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" }
],
"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_OVERNIGHT" }
],
"configurations": [
{
"regions": [
{ "regionCode": "C", "regionName": "48 State" },
{ "regionCode": "P", "regionName": "US Protectorate 6s" }
],
"addressTypes": ["PO_BOX", "STREET"]
}
]
}
]
}
}
}
response = requests.post(url, headers=headers, data=json.dumps(payload))
print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))
```
# 200 – Sample response major applications
```python cURL
{
"errors": [
{
"code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST",
"field": "sellerEligibility",
"description": "We noticed you are enabled for Major Appliances program which Simplified Shipping Settings currently do not support. We are working on bringing that support in. Please check back later.",
"info": "We noticed you are enabled for Major Appliances program which Simplified Shipping Settings currently do not support. We are working on bringing that support in. Please check back later.",
"severity": "ERROR",
"category": "DATA",
"causes": [],
"errorIdentifiers": {}
}
]
}
```
```python
import requests
import json
# Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account"
# Replace the placeholder values with your own
headers = {
"Accept": "application/json",
"Content-Type": "application/json",
"WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token
"WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call
"WM_SVC.NAME": "Walmart Service Name"
}
payload = {
"simplifiedShippingSettings": {
"accountConfigs": {
"shippingPriority": "FASTEST",
"migrateEligibleOffers": False,
"carrierConfigs": [
{
"carriers": [
{ "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" }
],
"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_OVERNIGHT" }
],
"configurations": [
{
"regions": [
{ "regionCode": "C", "regionName": "48 State" },
{ "regionCode": "P", "regionName": "US Protectorate 6s" }
],
"addressTypes": ["PO_BOX", "STREET"]
}
]
}
]
}
}
}
response = requests.post(url, headers=headers, data=json.dumps(payload))
print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))
```
# 200 - Sample - Invalid Carrier Name
```python cURL
{
"errors": [
{
"code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST",
"field": "carrierName",
"description": "Invalid Carrier Name",
"info": "Invalid Carrier Name",
"severity": "ERROR",
"category": "DATA",
"causes": [],
"errorIdentifiers": {}
}
]
}
```
```python
import requests
import json
# Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account"
# Replace the placeholder values with your own
headers = {
"Accept": "application/json",
"Content-Type": "application/json",
"WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token
"WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call
"WM_SVC.NAME": "Walmart Service Name"
}
payload = {
"simplifiedShippingSettings": {
"accountConfigs": {
"shippingPriority": "FASTEST",
"migrateEligibleOffers": False,
"carrierConfigs": [
{
"carriers": [
{ "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" }
],
"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_OVERNIGHT" }
],
"configurations": [
{
"regions": [
{ "regionCode": "C", "regionName": "48 State" },
{ "regionCode": "P", "regionName": "US Protectorate 6s" }
],
"addressTypes": ["PO_BOX", "STREET"]
}
]
}
]
}
}
}
response = requests.post(url, headers=headers, data=json.dumps(payload))
print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))
```
# 200 - Sample - Shipping Charge Object Is Empty
```python cURL
{
"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": {}
}
]
}
```
```python
import requests
import json
# Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account"
# Replace the placeholder values with your own
headers = {
"Accept": "application/json",
"Content-Type": "application/json",
"WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token
"WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call
"WM_SVC.NAME": "Walmart Service Name"
}
payload = {
"simplifiedShippingSettings": {
"accountConfigs": {
"shippingPriority": "FASTEST",
"migrateEligibleOffers": False,
"carrierConfigs": [
{
"carriers": [
{ "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" }
],
"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_OVERNIGHT" }
],
"configurations": [
{
"regions": [
{ "regionCode": "C", "regionName": "48 State" },
{ "regionCode": "P", "regionName": "US Protectorate 6s" }
],
"addressTypes": ["PO_BOX", "STREET"]
}
]
}
]
}
}
}
response = requests.post(url, headers=headers, data=json.dumps(payload))
print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))
```
# 200 - Sample - Valid Subtype Of Shipping Charge Object Not Present
```python cURL
{
"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": {}
}
]
}
```
```python
import requests
import json
# Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account"
# Replace the placeholder values with your own
headers = {
"Accept": "application/json",
"Content-Type": "application/json",
"WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token
"WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call
"WM_SVC.NAME": "Walmart Service Name"
}
payload = {
"simplifiedShippingSettings": {
"accountConfigs": {
"shippingPriority": "FASTEST",
"migrateEligibleOffers": False,
"carrierConfigs": [
{
"carriers": [
{ "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" }
],
"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_OVERNIGHT" }
],
"configurations": [
{
"regions": [
{ "regionCode": "C", "regionName": "48 State" },
{ "regionCode": "P", "regionName": "US Protectorate 6s" }
],
"addressTypes": ["PO_BOX", "STREET"]
}
]
}
]
}
}
}
response = requests.post(url, headers=headers, data=json.dumps(payload))
print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))
```
# 200 - Sample - Shipping Charge Amount Cannot Exceed 700
```python cURL
{
"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": {}
}
]
}
```
```python
import requests
import json
# Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account"
# Replace the placeholder values with your own
headers = {
"Accept": "application/json",
"Content-Type": "application/json",
"WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token
"WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call
"WM_SVC.NAME": "Walmart Service Name"
}
payload = {
"simplifiedShippingSettings": {
"accountConfigs": {
"shippingPriority": "FASTEST",
"migrateEligibleOffers": False,
"carrierConfigs": [
{
"carriers": [
{ "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" }
],
"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_OVERNIGHT" }
],
"configurations": [
{
"regions": [
{ "regionCode": "C", "regionName": "48 State" },
{ "regionCode": "P", "regionName": "US Protectorate 6s" }
],
"addressTypes": ["PO_BOX", "STREET"]
}
]
}
]
}
}
}
response = requests.post(url, headers=headers, data=json.dumps(payload))
print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))
```
# 200 - Sample - Duplicate Regions Not Allowed at FC Level
```python cURL
{
"errors": [
{
"code": "INVALID_REQUEST_CONTENT.INVALID_REQUEST",
"field": "shippingCharges",
"description": "Duplicate regions are not allowed at account Level for carrier and node",
"info": "Duplicate regions are not allowed at account Level for carrier and node",
"severity": "ERROR",
"category": "DATA",
"causes": [],
"errorIdentifiers": {}
}
]
}
```
```python
import requests
import json
# Endpoint to create the account-level Simplified Shipping Settings rule
url = "https://marketplace.walmartapis.com/v3/settings/shipping/simplifiedshippingsettings/account"
# Replace the placeholder values with your own
headers = {
"Accept": "application/json",
"Content-Type": "application/json",
"WM_SEC.ACCESS_TOKEN": "eyABCDEFGHI123456789…", # Your access token
"WM_QOS.CORRELATION_ID": "AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD", # A new GUID for each call
"WM_SVC.NAME": "Walmart Service Name"
}
payload = {
"simplifiedShippingSettings": {
"accountConfigs": {
"shippingPriority": "FASTEST",
"migrateEligibleOffers": False,
"carrierConfigs": [
{
"carriers": [
{ "carrierName": "Fedex", "carrierService": "FEDEX_EXPRESS" }
],
"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_OVERNIGHT" }
],
"configurations": [
{
"regions": [
{ "regionCode": "C", "regionName": "48 State" },
{ "regionCode": "P", "regionName": "US Protectorate 6s" }
],
"addressTypes": ["PO_BOX", "STREET"]
}
]
}
]
}
}
}
response = requests.post(url, headers=headers, data=json.dumps(payload))
print("Status code:", response.status_code)
print("Response JSON:", json.dumps(response.json(), indent=2))
```
***
# Result
* In a successful response, the API returns an updated account-level `simplifiedShippingSettings` object.
* In validation errors, the API returns structured errors explaining which field and why the request failed (even if HTTP 200 is returned in some integrations).
* Account-level settings establish the default coverage and capabilities. Fulfillment center level overrides can supersede these when configured.
***
# Next steps
* Validate the JSON payload: Fix duplicate braces, invalid enums, and duplicate state codes before calling.
* Confirm seller eligibility: Remove or resolve unsupported conditions (3PL nodes, bundle items, international nodes) or check for upcoming feature support.
* Test via Get Simplified Shipping Settings: Fetch account settings after update to verify changes.
* Test order/checkout scenarios: Ensure delivery promises and rates reflect the new settings.
* Monitor error responses: Implement logging and retries for transient issues and clear validation failures before re-submission.