The Settings API allows you to configure shipping delivery and fulfillment settings your items. This is applicable for only Seller Owned Shipping sellers and not for Walmart Provided Shipping sellers. You can create shipping templates to specify the precise delivery speed for your items. You can specify fulfillment center choices for your items.
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. Standard shipping).
Fulfillment centers were also known as “Ship Nodes,” so you might see some parameter names with Ship Node nomenclature.
You can manage your Fulfillment Centers (Ship Nodes) through the following Apis:
While creating and updating fulfillment centers, you can pass in an optional Calendar Day Configuration block. This calendar day configuration block provides the flexibility to define Working Days of Week (days on which there is active order processing) along with the cutoff time (time at which order processing stops for the day) for each day in respective timezones. In addition to that, there is a provision of defining additional non-working dates for a fulfillment center (ship node). There is no default Working Days of a Week.
Please note if cutoff time is not explicitly configured for a fulfillment center, the default is taken as 2 pm of fulfillment center’s respective time zone. The configuration is done in a 24hour format (HH:mm) and any value from 00:00 (12 am)to 23:59 (11:59 pm ) can be set.
To fetch Calendar Day Configuration for a fulfillment center, use the optional includeCalendarDayConfiguration flag in the URL. For fulfillment centers, where no calendar day configuration is set explicitly, no Calendar Day Configuration will be present while fetching.
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.
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.
These APIs can be integrated with directly. 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:
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.
Samples for Shipping Template Creation
To create a shipping template, see the sample shipping template in the API Reference section.
Sample Request Body:
When Seller invokes “CREATE SHIPPING TEMPLATE” API , the attribute “type” in the request payload needs to be set as “CUSTOM”.
Seller can create total 60 CUSTOM templates.
Seller can update DEFAULT and CUSTOM shipping templates.
Seller can have total of 60 CUSTOM templates and 1 Default Template.
Template Type
“type” attribute of template can be DEFAULT and CUSTOM templates.
“type” attribute in the request payload of the Shipping Template cannot be updated.
A CUSTOM shipping template can have 1 combinations of Ship method
Standard and any other Ship Methods
The DEFAULT shipping template cannot be created/ deleted/ disabled.
Template Naming Conventions
Only alphanumeric characters (a-z, A-Z, 0-9), accented characters (á, é, í, ó, ú, â, ê, ô, ã, õ, ç, Á, É, Í, Ó, Ú, Â, Ê, Ô, Ã, Õ, Ç, ü, ñ,Ü,Ñ) 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)
STANDARD
0-30
Max Charges allowed for Ship Methods
No limit currently, but we recommend Shipping Charges to be as low as possible.
Standard Ship Method
Granular subregions must be supplied for 8 regions along with 32 states and address type Street.
Coverage Areas
8 regions along with 32 states is supported. Overlapping of areas is not allowed in different shipping rules for the same shipping method in a template.
Rate Model
Only a single ship rate model that is applicable at a shipment level can be set. If the attribute “rateModelType” is set to “PER_SHIPMENT_PRICING” then only Per Shipment charges must be supplied.If the attribute. For Mx only “PER_SHIPMENT_PRICING” is allowed.
Available List of Regions
RegionCode
RegionName
SubregionCode
SubregionName
StateCode
StateName
StateSubRegionCode
StateSubRegionName
MX-NW
REGIÓN NOROESTE
1020
Baja California
1020
Baja California
1020
Baja California
1030
Baja California Sur
1030
Baja California Sur
1030
Baja California Sur
1050
Chihuahua
1050
Chihuahua
1050
Chihuahua
1090
Durango
1090
Durango
1090
Durango
1240
Sinaloa
1240
Sinaloa
1240
Sinaloa
1250
Sonora
1250
Sonora
1250
Sonora
MX-NE
REGIÓN NORESTE
1070
Coahuila
1070
Coahuila
1070
Coahuila
1180
Nuevo León
1180
Nuevo León
1180
Nuevo León
1270
Tamaulipas
1270
Tamaulipas
1270
Tamaulipas
MX-WT
REGIÓN OCCIDENTE
1170
Nayarit
1170
Nayarit
1170
Nayarit
1130
Jalisco
1130
Jalisco
1130
Jalisco
1080
Colima
1080
Colima
1080
Colima
1150
Michoacán
1150
Michoacán
1150
Michoacán
MX-ET
REGIÓN ORIENTE
1200
Puebla
1200
Puebla
1200
Puebla
1290
Veracruz
1290
Veracruz
1290
Veracruz
1280
Tlaxcala
1280
Tlaxcala
1280
Tlaxcala
1120
Hidalgo
1120
Hidalgo
1120
Hidalgo
MX-NC
REGIÓN CENTRONORTE
1010
Aguascalientes
1010
Aguascalientes
1010
Aguascalientes
1100
Guanajuato
1100
Guanajuato
1100
Guanajuato
1230
San Luis Potosí
1230
San Luis Potosí
1230
San Luis Potosí
1310
Zacatecas
1310
Zacatecas
1310
Zacatecas
1210
Querétaro
1210
Querétaro
1210
Querétaro
MX-SC
REGIÓN CENTROSUR
1160
Morelos
1160
Morelos
1160
Morelos
1140
Estado de México
1140
Estado de México
1140
Estado de México
1000
Ciudad de México
1000
Ciudad de México
1000
Ciudad de México
MX-SW
REGIÓN SUROESTE
1110
Guerrero
1110
Guerrero
1110
Guerrero
1190
Oaxaca
1190
Oaxaca
1190
Oaxaca
1060
Chiapas
1060
Chiapas
1060
Chiapas
MX-SE
REGIÓN SURESTE
1260
Tabasco
1260
Tabasco
1260
Tabasco
1040
Campeche
1040
Campeche
1040
Campeche
1220
Quintana Roo
1220
Quintana Roo
1220
Quintana Roo
1300
Yucatán
1300
Yucatán
1300
Yucatán
Update a shipping template
You can update or delete a shipping template with the Settings APIs.
Update a shipping template
To update a shipping template, Call the Update Shipping Template API: PUT /v3/settings/shipping/templates/{templateId}
View shipping template samples
We provide several sample shipping templates for various shipping scenarios. To view samples, see Payload Samples in Update Shipping Templates API Reference.
Template 3
This sample shows a payload example to update the Template 3 that is described above.
The response includes all shipping templates that a seller has configured, including Custom, Default 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 shipping costs, address types, shipping times and regions for that method.