Simplified Shipping Settings migration

Sellers and approved Solution Providers can use this API endpoint to migrate eligible items between manual and Simplified Shipping Settings configurations. You must create account level settings before migrating eligible items to Simplified Shipping Settings configurations. With this endpoint, you can use feedType and requestType strings to manage and categorize the data and actions involved in the migration process.

Throttling

Request limits: 20 calls per minute per seller. You may receive an HTTP 429 error if you exceed this limit. You can refer to the Throttling guide to learn more about the throttling guidelines.

Request example

The request requires authentication with an API token (WM_SEC.ACCESS_TOKEN), consumer ID, and channel type. These credentials ensure that only authorized sellers and approved Solution Providers can migrate an account’s configurations.

The endpoint https://marketplace.walmartapis.com/v3/feeds specifies that you are making a request to migrate your items between manual and Simplified Shipping Settings configurations.

feedType: This string specifies the type of data feed being processed during the migration. It helps to identify the nature of the data being migrated, such as item details, shipping configurations, and pricing information. For example, PROGRAM_ACTIONS.

requestType: This string specifies the type of request made during the migration process. It helps to determine the action that needs to be performed, such as creating new shipping configurations, updating existing ones, or deleting outdated configurations. For example, SHIPPING_CONFIG.

Encoding for spaces: This request requires encoding if spaces are present in the query. The endpoint uses %20 for spaces.

Before you use the example code, replace the example access token and correlation ID (a randomly generated GUID used to track and debug issues) with your own values.

curl -X 'POST' \ 'https://marketplace.walmartapis.com/v3/feeds?feedType=PROGRAM_ACTIONS&requestType=SHIPPING_CONFIG' \ -H 'accept: application/json' \ -H ‘WM_SEC.ACCESS_TOKEN: eyABCDEFGHI123456789…’ \ -H ‘WM_QOS.CORRELATION_ID: AAAAAAAA-1111-BBBB-2222-CCCC3333DDDD’ \ -H 'WM_SVC.NAME: Walmart Service Name' \ -H 'Content-Type: application/json' \ -d '{ "ProgramActionFeedHeader": { "version": "5.0.20241002-17_27_17-api", "locale": "en", "businessUnit": "WALMART_US" }, "ProgramAction": [ { "Programs": { "ShippingConfiguration": { "itemShippingConfiguration": "Simplified Shipping Settings" } }, "ItemIdentifiers": { "sku": "8922gfgf" } } ]
}'

Response example

This API endpoint responds with a body response that contains the feedId.

feedId: A unique ID from the endpoint used to track the feed file.

{ "feedId": "1234567890ABCDEFG@123ABc"
}

Next steps

This API overview guide shows you how to migrate between manual templates and Simplified Shipping Settings configurations with only the required parameters. You can refer to the full Reference guide to learn how to use the optional parameters.