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.
Requirement | Definition |
---|---|
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
- Review the Simplified Shipping Settings guidelines to learn how you are protected against shipping carrier disruptions.
- Review the Fulfillment methods: Overview to learn about the fulfillment options available to sellers.
- Review the Shipping carrier guidelines to understand which carrier you could choose for your items.
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:
Step | Required | API endpoint | Purpose |
---|---|---|---|
1. | Yes | Create Simplified Shipping Settings configurations | You need to use this endpoint to configure Simplified Shipping Settings. |
2. | Yes | Retrieve account configurations | You can use this endpoint to retrieve and review shipping and fulfillment configurations. |
3. | No | Simplified Shipping Settings migration | You can use this endpoint to convert between manual and Simplified Shipping Settings configurations. |
Current sellers and Simplified Shipping Settings sellers should start with:
Step | Required | API endpoint | Purpose |
---|---|---|---|
1. | Yes | Retrieve account configurations | You can use this endpoint to retrieve and review shipping and fulfillment configurations. |
2. | No | Update Simplified Shipping Settings configurations | You can use this endpoint to retrieve and review shipping and fulfillment configurations. |
3. | No | Change fulfillment center configurations | You can use this endpoint to change specific fulfillment centers. |
4. | No | Simplified Shipping Settings migration | You can use this endpoint to convert between manual and Simplified Shipping Settings configurations. |
Updated 4 days ago