The Settings API allows you to configure shipping delivery and fulfillment settings your items. You can create shipping templates to specify the precise delivery speed for your items. You can specify fulfillment center choices for your items.
You can create a precise delivery with new shipping speed options:
About Fulfillment Center Settings
You can use the Settings API to make changes to the fulfillment centers and the shipping program you elect for your items (e.g. TwoDay shipping).
Fulfillment centers were also known as “Ship Nodes,” so you might see some parameter names with Ship Node nomenclature.
Walmart provides an enhanced free TwoDay Shipping Program to enable US marketplace sellers to add multiple fulfillment centers along with capability to manage them and easily configure item assortment setup for TwoDay program.
You can use Shipping Templates to support a fast and precise delivery experience to bridge the gap between promise and actual delivery time. The Settings API allows you to create and manage these settings as a Shipping Template. You can create a shipping template to specify faster shipping for specific regions. First specify the regions, and the ship speed buyers in that region can get their items shipped. Next, you assign the product SKU to that shipping template.
The Shipping Rules API provide access to configure the TwoDay shipping program. For more details about Shipping Rules, see Shipping Rule Managements.
If you would like to provide more shipping options, such as ThreeDay and expedited, you can now use Shipping Templates instead of the shipping rules for TwoDay.
If you onboard to the TwoDay program and create shipping rules with the Rules API, you can migrate to the precise delivery options with Shipping Templates.
These APIs can be integrated with directly or via channel partners that have adopted these changes. These changes can also be accessed via Walmart Seller Center. The APIs use the standard header parameters as with other APIs listed in Developer Portal.
Download the Shipping Templates APIs JSON Schema from:
The program offers qualified sellers a way to offer free, two-day shipping to our customers with dynamic, location-based logic that will automatically display the “2-Day Shipping” banner on eligible items. Two-day shipping is made available through additions to the request body during Item setup.
This samples provides for the scenario with 48 States Street + 48 states PO Box + (AK andHI Street and PO Box + US Protectorates Street and PO Box) + APO/FPO .48 States Street has granular subregions -> state -> stateSubRegions.
48 States Street + PO Box => Cannot be clubbed with any other regions. will create an individual rule (configuration).
Hawaii & Alaska + US Protectorates + Street + PO Box => creates one rule with both regions and both PO Box and Street selected. Otherwise 2 rules needs be created
APO/FPO => Cannot be clubbed with any other regions Has MILITARY address Type.
(Hawaii & Alaska and US Protectorates + PO Box) + US Protectorates Street => creates 2 rule
Seller Selects subset of 48 State Street Subregions.
When PARTNER invokes “CREATE SHIPPING TEMPLATE” API , the attribute “type” needs to be set as ” CUSTOM”
Third-party delivers the item, and invokes “CREATE SHIPPING TEMPLATE” API , the attribute “type” needs to be set 3PL Specific (for example: “DELIVER”)
A tiered shipping template example.
This sample shows a payload example to create or update the Paid Standard shipping template.with the option to add a ship charge. for a “Paid Standard” shipping template.
This differs from the typical usage, where the Paid Standard Shipping template provides free shipping.
When Seller invokes “CREATE SHIPPING TEMPLATE” API , the attribute “type” in the request payload needs to be set as “CUSTOM”.
Seller can create total 15 CUSTOM templates.
Seller can update DEFAULT, CUSTOM and 3PL-specific (DELIVER) shipping templates.
Seller can have total of 15 CUSTOM templates, 4 3PL specific and 1 Default Template.
Delegate access for Solution Providers
Third-party Solution Providers must use delegated access for invoking this API with proper External Headers.
When 3PL partner invokes “CREATE SHIPPING TEMPLATE” API , the attribute “type” in the request payload needs to be set as template specific to 3PL e.g. if DELIVER invokes the API, template type should be set as “DELIVER”.
3PL can create total 4 templates per seller.
3PL cannot create Freight Shipping Templates.
3PL can only update 3PL-specific templates e.g. DELIVER can update only DELIVER template.
“type” attribute of template can be DEFAULT, CUSTOM or 3PL-specific (e.g. DELIVER) templates.
“type” attribute in the request payload of the Shipping Template cannot be updated.
A CUSTOM shipping template can have two combinations of Ship method
Only Freight Ship Method
Value and any other Ship Methods (Except Freight)
The DEFAULT shipping template cannot be created/ deleted/ disabled.
Template Naming Conventions
Only alphanumeric characters (a-z, A-Z, 0-9) and spaces are allowed in the template name. Spaces will be removed from the start and end of the name. Name having only spaces will be considered empty.
Max template length allowed is 25 chars.
Template Name must be unique for a seller, and it is case insensitive
Allowable Shipping Method per Transit Time
Allowable shipping methods and transit time combinations are:
Transit Time (days)
Max Charges allowed for Ship Methods
Max Charges allowed for Ship Methods:
Shipping and Handling
Charge Per Weight
Charge Per Item
Freight Ship Method
Only allowed for Custom templates.
No granular subregions supported.
Two Day (Expedited) Ship method
Only allowed for Sellers approved on Two Day Program.
Free shipping always for Expedited Shipping Methods (Both rate models).
Value Ship Method
Must have only one shipping rule.
Value Ship-method should have only 48 STATE region and address type should be STREET.
For VALUE ship method No granular subregions supported.
Free shipping always for Value Shipping Methods (Both rate models).
Standard Ship Method
Granular subregions must be supplied for 48 states and address type Street.
No Granular subregion support for regions : HI and AK, Street, US Protec, APO/FPO.No Granular subregion support for 48 States PO BOX.No Overlapping of areas allowed in different shipping rules for the same shipping method in a template.
If the attribute “rateModelType” is set to “PER_SHIPMENT_PRICING” then only Per Shipment charges must be supplied.If the attribute “rateModelType” is set to “TIERED_PRICING” then only a list of Tiered shipping charges must be supplied.If the attribute “rateModelType” is set to “TIERED_PRICING”, then the range of “minLimit” to “maxLimit” for the attribute “tieredShippingCharges” should be continuous. e.g. minLimit=0, maxLimit=5 ; minLimit=5.01, maxLimit=-1-1 for attribute “maxLimit” indicates highest value of charges for the ship method.
Update a shipping template
You can update or delete a shipping template with the Settings APIs.
If you prefer to opt-out of the precise delivery available with Shipping Templates, you can simply set up a TwoDay shipping rule with Create a new Rule API. To learn more about the Rules API, see Rules Management.
If you have already onboarded to the TwoDay program, before you activated the Shipping Templates, you can switch back to TwoDay shipping. For a mapping of activation status and program onboarding status, see Rules Management.
Validation Error Troubleshooting
When you send a SKU_TEMPLATE_MAP feed to Walmart, it validates according to Attribute type and acceptable format.
If you provide an incorrect Shipping Template ID, Fulfillment Center ID, or invalid SKU, you will get data or system errors. Here are some tips to fix the errors.
How to fix or avoid error
Shipping Template ID is invalid
Verify the Shipping Template ID and resend request.
Fulfillment center ID is invalid.
Provide correct FC ID and resend request.
SKU is missing from the request. Or, SKU is invalid.
Provide SKU and resend the request. Verify SKU format is correct, and retry request.
SKU provided in request is not found in the system.
Make sure that the correct item SKU was ingested in the system. To ingest the item again, call Bulk Item Setup API. Please provide a valid SKU in the payload line items and reattempt. If the issue persists, contact the support team at https://sellerhelp.walmart.com/s/.
Get Feed Status Errors
If you call Get Feed Status API it might fail if you do not include all required parameters in the request.
Make sure that you include the selling channel in the request.
Make a call to Get All Shipping Details API and specify the templateId for the Shipping Template you want to view as a path parameter, for example:
The response returns all the details about that shipping template.
Template type – this can be either DEFAULT, CUSTOM or DELIVERR.
Rate Models – Configures either tiered pricing or per-shipment pricing. For example, TIERED_PRICING means that you charge shipping rates based on item price. PER_SHIPMENT_PRICING means that you charge shipping based on item weight in pounds, or based on the number of items purchased in an order.
Shipping Methods – For each shipMethod (e.g. TWO_DAY or VALUE) it provides the region, shipping costs, address types, shipping times and regions for that method.
Note: The activation status represents whether or not the seller has onboarded to the Shipping Templates program. This is different from the active or inactive setting the seller can specify for the template.
The API call returns activationStatus, either NOT_ACTIVATED or ACTIVATED and the date of program activation. The createdDate is the date that the Shipping Template was activated in the Seller Center.
The modifiedDate is that last date the Shipping Template activation status has changed.