---
updatedAt: 2026-09-28T23:38:13.000Z
---

# Update FC level Simplified Shipping Settings (Deprecated)

<div class="callout-box" role="note" aria-label="Note">

**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.

<br />

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

</div>

# Overview

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

***

# Endpoint

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

***

# Functionality

This call performs the following:

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

***

# Sample request

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

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

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

# Sample Request - Invalid carrier name

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

# Sample Request - Empty shipping charge

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

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

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

# Sample Request - Shipping charge amount cannot exceed 700

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

# Sample Request - Duplicate regions not allowed at FC level

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

***

# Modify your request

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

***

# 200 - Sample response

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

# 200 - Sample response invalid carrier configs

```json
{
  "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
```

# 200 - Sample response invalid coverage 2

```json
{
  "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
```

# 200 - Sample response invalid region combination

```json
{
  "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
```

# 200 - Sample - Invalid carrier name

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

# 200 - Sample - Empty shipping charge

```json
{
  "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
```

# 200 - Sample - Valid subtype of ShippingCharge object not present

```json
{
  "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
```

# 200 - Sample - Shipping charge amount cannot exceed 700

```json
{
  "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
```

# 200 - Sample - Duplicate regions not allowed at FC Level

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

***

# Result

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

***

# Next steps

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

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