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:
TwoDay shipping
ThreeDay shipping
Expedited delivery
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.
You can also access fulfillment and shipping choices via Walmart Seller Center. The APIs use the standard header parameters as with other APIs listed in Developer Portal: Marketplace Settings Program.
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:
Use shipping overrides to specify shipping attributes such as ShipMethod, ShipRegion, ShipPrice. Use the Update Items in Bulk API, and use the Shipping Override feed.
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.
We provide several sample shipping templates for various shipping scenarios. To view samples, see Payload Samples in Create Shipping Templates API Reference.
Note: Each template description corresponds to a template sample. See all Payload Samples in Create Shipping Templates API Reference.
General Request Template
To create a general request, see the sample shipping template in the API Reference section, Sample Request Body: SAMPLE 1.
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.
Template 3
48 States Street + PO Box => Cannot be clubbed with any other regions. will create an individual rule (configuration).
Template 4
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
Template 5
APO/FPO => Cannot be clubbed with any other regions Has MILITARY address Type.
Template 6
(Hawaii & Alaska and US Protectorates + PO Box) + US Protectorates Street => creates 2 rule
Template 7
Seller Selects subset of 48 State Street Subregions.
Template 8
When PARTNER invokes “CREATE SHIPPING TEMPLATE” API , the attribute “type” needs to be set as ” CUSTOM”
Template 9
Third-party delivers the item, and invokes “CREATE SHIPPING TEMPLATE” API , the attribute “type” needs to be set 3PL Specific (for example: “DELIVER”)
Template 10
A tiered shipping template example.
Template 11
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.
Template Type
“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:
Method
Transit Time (days)
VALUE
6,7
TWO_DAY
2
STANDARD
3,4,5
FREIGHT
8,9,10
Max Charges allowed for Ship Methods
Max Charges allowed for Ship Methods:
Method
Shipping and Handling
Charge Per Weight
Charge Per Item
Tiered Charges
VALUE
0
0
0
0
STANDARD
200
200
200
200
TWO_DAY
0
0
0
0
FREIGHT
200
200
200
200
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.
Coverage Areas
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.
Rate Model
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.
We provide several sample shipping templates for various shipping scenarios. To view samples, see Payload Samples in Update Shipping Templates API Reference.
This sample shows a payload example to 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.
After you create the Shipping Template, you can associate items that use it by mapping the product SKU to the template.
Step 1: Map the SKU to a shipping template
To map an item SKU to a shipping template, use the Bulk Item Setup (Multiple) API. Specify SKU_TEMPLATE_MAP for the feed type. For example, call POST /v3/feeds?feedType=SKU_TEMPLATE_MAP
Provide your sample file with values for required parameters in your request payload:
sku – Item SKU code
actionType – Specify “Add” to associate SKU to the template
shippingTemplateId – provide the Shipping Template ID that you want to associate the SKU to
fulfillmentCenterId – provide the Fulfillment Center ID
To view an example, see Bulk Item Setup (Multiple) API Reference. Go to the Request Samples pane, and select “SKU_TEMPLATE_MAP – Sample 1” from the Example drop-down menu.
Note: Make sure to set the content type for the payload to “application/json” There is an error in the example shown in the Reference, it suggests “multipart/form-data” but this is incorrect.
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.
Error Type
Cause
How to fix or avoid error
DATA_ERROR
Shipping Template ID is invalid
Verify the Shipping Template ID and resend request.
DATA_ERROR
Fulfillment center ID is invalid.
Provide correct FC ID and resend request.
DATA_ERROR
SKU is missing from the request. Or, SKU is invalid.
Provide SKU and resend the request. Verify SKU format is correct, and retry request.
SYSTEM_ERROR
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.
The response includes all shipping templates that a seller has configured, including Custom, Default and third-party specific (e.g. DELIVERR) templates.
Authentication Requirements for sellers and solution providers
Sellers must use seller authentication with proper external headers. To set up your API key, see Authentication.
For third-party partner access, make sure to provide delegated access permissions to the partner. To create an API key for a solution provider, see Authorization.
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:
/v3/settings/shipping/templates{templateId}
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.
Find out template activation status
To find out if a seller has Shipping Templates program activated, you can get the activation status with the Shipping Template Activation Status API.
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.