Simplified Shipping Settings API overview

Simplified Shipping Settings provides accurate delivery estimates using live- carrier data , and protect on-time delivery Seller Performance Standards. You can configure orders to use manually created templates or Simplified Shipping Settings configurations.

Manually created templates

Manually created templates provide the flexibility to incorporate both free and paid shipping options for all products you sell. Manually created templates require you to manually change each template to respond to carrier and fulfillment center complications. If you choose manually created templates, you can tailor them to ship domestic and international orders.

Simplified Shipping Settings

Simplified Shipping Settings allow sellers to specify their carrier and fulfillment center options or use the recommended configurations based on real-time carrier transit data. The recommended configurations protect your on-time delivery (OTD) Seller Performance Standards and provide customers with positive experiences.

You can choose Simplified Shipping Settings if your items meet the following requirements:

  • The item offers free shipping for customers.
  • The order can be shipped to the 48 contiguous states. (If an order ships to anywhere outside of the 48 contiguous states, it must use a manually created template.)

You can migrate existing manually created templates to the new Simplified Shipping Settings configurations.

Your shipping costs

Each Simplified Shipping Settings configuration gives you the flexibility to choose if you want items in a particular configuration to prioritize shipping speed or more economical options. As the Simplified Shipping Settings API requires free shipping for customers, the seller is responsible for covering the shipping costs.

Order fulfillment and carrier preferences

Simplified Shipping Settings provide you with recommended fulfillment centers and carrier options. You can use your own presets instead of the recommendations, but they may cause delays depending on carrier transit conditions. When you use the recommended configurations, you are not accountable for delays caused by your shipping carrier. You can use the GET Simplified Shipping Settings details endpoint to confirm that your ship-from-location and carrier methods are accurate.

On-time delivery Seller Performance Standards protection

Sellers and approved Solution Providers who consistently ship orders on-time, use preset carrier methods, and follow the fulfillment center recommendations can protect their on-time delivery (OTD) performance metrics. When you meet all the requirements below, carrier-caused delays will not affect your OTD Seller Performance Standards.

RequirementDefinition
On-time shipping performance metrics are at 100%.You shipped all orders on or before the estimated ship date (ESD).
The carrier method accuracy performance metrics are at 100%.You shipped all orders with your selected carrier method.
The ship-from-location accuracy performance metrics are at 100%.You shipped all orders from the recommended fulfillment center location.

Consider the following prerequisites to use Marketplace APIs

  • API Keys (clientID and clientSecret):
    • Sellers can retrieve API keys from the Developer Portal and use the keys to call Marketplace APIs.
    • Sellers must generate or refresh Authentication tokens every 24 hours.
    • If you are a solution provider, refer to the Getting Started Guide for Solution Providers.
    • OAuth 2.0 authentication is required to access the Walmart Marketplace APIs. Ensure that you have obtained the necessary credentials and tokens before making API requests. For more information, refer to the OAuth 2.0 authorization guide.

Market availability

The Walmart Simplified Shipping Settings API is available for sellers listing in the U.S. marketplace.

Refer to the links below for additional guidance

How to use Simplified Shipping Settings API endpoints

There are two types of Simplified Shipping Settings API users:

  • New sellers
  • Current sellers and Simplified Shipping Settings sellers

New and existing users can use these endpoints to access information required to make informed shipping and fulfillment decisions.

New sellers should start with:

StepRequiredAPI endpointPurpose
1.YesCreate Simplified Shipping Settings configurationsYou need to use this endpoint to configure Simplified Shipping Settings.
2.YesRetrieve account configurationsYou can use this endpoint to retrieve and review shipping and fulfillment configurations.
3.NoSimplified Shipping Settings migrationYou can use this endpoint to convert between manual and Simplified Shipping Settings configurations.

Current sellers and Simplified Shipping Settings sellers should start with:

StepRequiredAPI endpointPurpose
1.YesRetrieve account configurationsYou can use this endpoint to retrieve and review shipping and fulfillment configurations.
2.NoUpdate Simplified Shipping Settings configurationsYou can use this endpoint to retrieve and review shipping and fulfillment configurations.
3.NoChange fulfillment center configurationsYou can use this endpoint to change specific fulfillment centers.
4.NoSimplified Shipping Settings migrationYou can use this endpoint to convert between manual and Simplified Shipping Settings configurations.