---
updatedAt: 2026-08-04T19:13:51.000Z
---

# Bulk Item Migration for Simplified Shipping Configuration

This API is used to bulk migrate offers from Manual templates to Simplified shipping settings and vice-versa. Please ensure to create account level settings before proceeding with item migration to Simplified Shipping Settings.

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Simplified Shipping Settings Management",
    "version": "1.0",
    "description": "The Simplified Shipping Settings APIs allow sellers to manage all the simplified shipping configuration for better shipping and delivery promise experience. 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"
  },
  "x-readme": {
    "samples-languages": [
      "shell"
    ],
    "proxy-enabled": false
  },
  "servers": [
    {
      "url": "https://marketplace.walmartapis.com",
      "description": "Refers to the URL used for accessing the production server."
    },
    {
      "url": "https://sandbox.walmartapis.com",
      "description": "Refers to the URL used for accessing the sandbox server."
    }
  ],
  "paths": {
    "/v3/feeds": {
      "post": {
        "tags": [
          "Simplified Shipping Settings"
        ],
        "summary": "Bulk Item Migration for Simplified Shipping Configuration",
        "description": "This API is used to bulk migrate offers from Manual templates to Simplified shipping settings and vice-versa. Please ensure to create account level settings before proceeding with item migration to Simplified Shipping Settings.",
        "operationId": "bulkMigrateOffersForSimplifiedShippingSettings",
        "parameters": [
          {
            "name": "feedType",
            "in": "query",
            "description": "Feed Type",
            "required": true,
            "schema": {
              "type": "string",
              "default": "PROGRAM_ACTIONS"
            }
          },
          {
            "name": "requestType",
            "in": "query",
            "description": "Request Type",
            "required": true,
            "schema": {
              "type": "string",
              "default": "SHIPPING_CONFIG"
            }
          },
          {
            "in": "header",
            "name": "Authorization",
            "description": "Use a Basic Authorization header by Base64-encoding the Client ID and Client Secret obtained in step two of the integration process. Format the credentials as ClientID:ClientSecret before encoding.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "Basic YzcyOTFjNmItNzI5MC00...."
          },
          {
            "in": "header",
            "name": "WM_SEC.ACCESS_TOKEN",
            "description": "Access token obtained from the Token API. This is required for authenticating requests to Walmart Marketplace APIs.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM....."
          },
          {
            "in": "header",
            "name": "WM_CONSUMER.CHANNEL.TYPE",
            "description": "A unique ID to identify the consumer request by channel. Use the Consumer Channel Type received during onboarding.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "WM_QOS.CORRELATION_ID",
            "description": "A unique ID that identifies each API call and is used to track and debug issues. Use a randomly generated GUID for this ID.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "b3261d2d-028a-4ef7-8602-633c23200af6"
          },
          {
            "in": "header",
            "name": "WM_SVC.NAME",
            "description": "Specifies the name of the Walmart service being called.",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "Walmart Marketplace"
          }
        ],
        "requestBody": {
          "description": "Request fields",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "ProgramActionFeedHeader",
                  "ProgramAction"
                ],
                "properties": {
                  "ProgramActionFeedHeader": {
                    "type": "object",
                    "required": [
                      "version",
                      "locale"
                    ],
                    "properties": {
                      "version": {
                        "type": "string",
                        "description": "This is static spec version."
                      },
                      "locale": {
                        "type": "string",
                        "description": "The associated language locale."
                      },
                      "businessUnit": {
                        "type": "string",
                        "description": "This is is static Walmart BU."
                      }
                    },
                    "description": "ProgramAction feed header details"
                  },
                  "ProgramAction": {
                    "uniqueItems": true,
                    "type": "array",
                    "description": "This includes all the SKU ids and the type of shipping configuration to migrate.",
                    "items": {
                      "type": "object",
                      "required": [
                        "Programs",
                        "ItemIdentifiers"
                      ],
                      "properties": {
                        "Programs": {
                          "type": "object",
                          "required": [
                            "ShippingConfiguration"
                          ],
                          "properties": {
                            "ShippingConfiguration": {
                              "type": "object",
                              "required": [
                                "itemShippingConfiguration"
                              ],
                              "properties": {
                                "itemShippingConfiguration": {
                                  "type": "string",
                                  "description": "Type of shipping configuration to where current SKU should be migrated to. Eligible values for the field are: Simplified Shipping Settings & Manual Template"
                                }
                              }
                            }
                          },
                          "description": "The type of shipping configuration to migrate."
                        },
                        "ItemIdentifiers": {
                          "type": "object",
                          "required": [
                            "sku"
                          ],
                          "properties": {
                            "sku": {
                              "type": "string",
                              "description": "SKU of the item which seller wants to migrate."
                            }
                          },
                          "description": "Item Identifier which needs to be migrated."
                        }
                      },
                      "description": "This includes all the SKU ids and the type of shipping configuration to migrate."
                    }
                  }
                }
              },
              "examples": {
                "Sample Request": {
                  "value": {
                    "ProgramActionFeedHeader": {
                      "version": "5.0.20241002-17_27_17-api",
                      "locale": "en",
                      "businessUnit": "WALMART_US"
                    },
                    "ProgramAction": [
                      {
                        "Programs": {
                          "ShippingConfiguration": {
                            "itemShippingConfiguration": "Simplified Shipping Settings"
                          }
                        },
                        "ItemIdentifiers": {
                          "sku": "8922gfgf"
                        }
                      }
                    ]
                  }
                }
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successful Operation",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "feedId": {
                      "type": "string",
                      "description": "A unique ID, returned from the Bulk Migration API, used for tracking the Feed File."
                    }
                  }
                },
                "examples": {
                  "Sample Response": {
                    "value": {
                      "feedId": "17EF05E37122540094F294ED0F8F66B8@Af8BBgAY"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
```