Create shipping templates

Market availability: US | CA | MX

Overview

The Create shipping templates API allows sellers to create custom shipping templates that define shipping methods, transit times, pricing logic, and geographic coverage.

Endpoint

POST https://marketplace.walmartapis.com/v3/settings/shipping/templates

Function

With this API, you can configure:

Shipping methods (for example, VALUE, STANDARD, TWO_DAY, and ONE_DAY, FREIGHT)
Regions (for example, C, H, P, or A)
Sub-regions and state-level granularity
Address types (for example, STREET, PO_BOX, MILITARY)
Transit times
Tiered shipping charges
Per-shipment pricing
International shipping configurations
Fulfillment center associations

This API is used to define new shipping rules before assigning or activating a new rule.

Shipping Template Requirements

Market availability: Canada

The seller must use seller authentication to use the POST Create Shipping Template API with proper External Headers.

When the Seller invokes the “CREATE SHIPPING TEMPLATE” API, the attribute “type” in the request payload must be set to “CUSTOM.”
The seller can create a total of 60 CUSTOM templates.
Seller can update DEFAULT and CUSTOM shipping templates.
The seller can have a total of 60 CUSTOM templates and 1 Default Template.

Template Type

The “type” attribute of the template can be DEFAULT and CUSTOM templates.
The “type” attribute in the request payload of the Shipping Template cannot be updated.
A CUSTOM shipping template can have one combination of Ship method
Standard and any other shipping methods
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.
The maximum 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

Standard Shipping:
- For domestic sellers (all warehouses within Canada), the maximum transit time is 7 days.
- For cross-border sellers (at least one warehouse outside Canada), the maximum transit time is 13 days.
Express Shipping:
- Maximum transit time is 3 days, regardless of warehouse location.

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 10 regions and address type Street and PO_BOX

Express Ship Method

Granular subregions must be supplied for 10 regions and address type Street and PO_BOX

Coverage Areas

10 regions, along with the PO box, are supported. Overlapping of areas is not 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.

For example, minLimit=0, maxLimit=5, minLimit=5.01, maxLimit=-1-1 for attribute “maxLimit” indicates the highest value of charges for the shipping method.

Available List of Regions

RegionCode	RegionName	SubregionCode	SubregionName	StateCode	StateName	StateSubRegionCode	StateSubRegionName
2001	Greater Toronto	2001	Greater Toronto	GT	Greater Toronto	GT	Greater Toronto
2003	Greater Montreal	2003	Greater Montreal	GM	Greater Montreal	GM	Greater Montreal
2009	Rest of Canada	2009	Rest of Canada	RC	Rest of Canada	RC	Rest of Canada
3017	Urban Ontario	3017	Urban Ontario	UO	Urban Ontario	UO	Urban Ontario
3019	Rural Ontario	3019	Rural Ontario	RO	Rural Ontario	RO	Rural Ontario
3025	Eastern Canada	3025	Eastern Canada	EC	Eastern Canada	EC	Eastern Canada
3023	Rural Quebec	3023	Rural Quebec	RQ	Rural Quebec	RQ	Rural Quebec
2005	Urban British Columbia	2005	Urban British Columbia	UC	Urban British Columbia	UC	Urban British Columbia
3005	Rural British Columbia	3005	Rural British Columbia	RB	Rural British Columbia	RB	Rural British Columbia
3007	Urban Prairies (MB, SK, AB)	3007	Urban Prairies (MB, SK, AB)	UP	Urban Prairies (MB, SK, AB)	UP	Urban Prairies (MB, SK, AB)
2002	Greater Toronto – PO Box	2002	Greater Toronto – PO Box	GT-PO	Greater Toronto – PO Box	GT-PO	Greater Toronto – PO Box
2004	Greater Montreal – PO Box	2004	Greater Montreal – PO Box	GM-PO	Greater Montreal – PO Box	GM-PO	Greater Montreal – PO Box
2010	Rest of Canada – PO Box	2010	Rest of Canada – PO Box	RC-PO	Rest of Canada – PO Box	RC-PO	Rest of Canada – PO Box
3018	Urban Ontario – PO Box	3018	Urban Ontario – PO Box	UO-PO	Urban Ontario – PO Box	UO-PO	Urban Ontario – PO Box
3020	Rural Ontario – PO Box	3020	Rural Ontario – PO Box	RO-PO	Rural Ontario – PO Box	RO-PO	Rural Ontario – PO Box
3026	Eastern Canada – PO Box	3026	Eastern Canada – PO Box	EC-PO	Eastern Canada – PO Box	EC-PO	Eastern Canada – PO Box
3024	Rural Quebec – PO Box	3024	Rural Quebec – PO Box	RQ-PO	Rural Quebec – PO Box	RQ-PO	Rural Quebec – PO Box
2006	Urban British Columbia – PO Box	2006	Urban British Columbia – PO Box	UC-PO	Urban British Columbia – PO Box	UC-PO	Urban British Columbia – PO Box
3006	Rural British Columbia – PO Box	3006	Rural British Columbia – PO Box	RB-PO	Rural British Columbia – PO Box	RB-PO	Rural British Columbia – PO Box
3008	Urban Prairies (MB, SK, AB) – PO Box	3008	Urban Prairies (MB, SK, AB) – PO Box	UP-PO	Urban Prairies (MB, SK, AB) – PO Box	UP-PO	Urban Prairies (MB, SK, AB) – PO Box

Sample requests

Sample Full domestic per-shipment

curl --request PUT \ --url https://marketplace.walmartapis.com/v3/settings/shipping/templates/templateId \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "type": "CUSTOM", "rateModelType": "PER_SHIPMENT_PRICING", "status": "ACTIVE", "shippingMethods": [ { "shipMethod": "VALUE", "status": "ACTIVE", "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "perShippingCharge": { "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" }, "unitOfMeasure": "LB" }, "transitTime": 6 } ] }, { "shipMethod": "STANDARD", "status": "ACTIVE", "configurations": [ { "regions": [ { "subRegions": [ { "states": [ { "stateSubregions": [ { "stateSubregionCode": "CT2", "stateSubregionName": "CT_SOUTH_WEST" }, { "stateSubregionCode": "CT1", "stateSubregionName": "CT_REST_ALL" } ], "stateCode": "CT", "stateName": "Connecticut" }, { "stateSubregions": [ { "stateSubregionCode": "PA3", "stateSubregionName": "PA_NORTH_EAST" }, { "stateSubregionCode": "PA2", "stateSubregionName": "PA_CENTRAL_NORTH" }, { "stateSubregionCode": "PA5", "stateSubregionName": "PA_WEST" }, { "stateSubregionCode": "PA4", "stateSubregionName": "PA_SOUTH" }, { "stateSubregionCode": "PA1", "stateSubregionName": "PA_CENTRAL" } ], "stateCode": "PA", "stateName": "Pennsylvania" }, { "stateSubregions": [ { "stateSubregionCode": "MA2", "stateSubregionName": "MA_WEST" }, { "stateSubregionCode": "MA1", "stateSubregionName": "MA_EAST" } ], "stateCode": "MA", "stateName": "Massachusetts" }, { "stateSubregions": [ { "stateSubregionCode": "RI", "stateSubregionName": "RI" } ], "stateCode": "RI", "stateName": "Rhode Island" }, { "stateSubregions": [ { "stateSubregionCode": "ME2", "stateSubregionName": "ME_WEST" }, { "stateSubregionCode": "ME1", "stateSubregionName": "ME_EAST" } ], "stateCode": "ME", "stateName": "Maine" }, { "stateSubregions": [ { "stateSubregionCode": "NH", "stateSubregionName": "NH" } ], "stateCode": "NH", "stateName": "New Hampshire" }, { "stateSubregions": [ { "stateSubregionCode": "NY1", "stateSubregionName": "NY_BROOKLYN" }, { "stateSubregionCode": "NY3", "stateSubregionName": "NY_NORTH_CENTRAL" }, { "stateSubregionCode": "NY2", "stateSubregionName": "NY_CENTRAL" }, { "stateSubregionCode": "NY5", "stateSubregionName": "NY_SOUTH" }, { "stateSubregionCode": "NY4", "stateSubregionName": "NY_NORTH_WEST" } ], "stateCode": "NY", "stateName": "New York" }, { "stateSubregions": [ { "stateSubregionCode": "NJ2", "stateSubregionName": "NJ_NORTH" }, { "stateSubregionCode": "NJ1", "stateSubregionName": "NJ_CENTRAL" }, { "stateSubregionCode": "NJ4", "stateSubregionName": "NJ_KEARNY" }, { "stateSubregionCode": "NJ3", "stateSubregionName": "NJ_SOUTH" } ], "stateCode": "NJ", "stateName": "New Jersey" }, { "stateSubregions": [ { "stateSubregionCode": "VT", "stateSubregionName": "VT" } ], "stateCode": "VT", "stateName": "Vermont" } ], "subRegionCode": "NE", "subRegionName": "NE" }, { "states": [ { "stateSubregions": [ { "stateSubregionCode": "SD2", "stateSubregionName": "SD_WEST" }, { "stateSubregionCode": "SD1", "stateSubregionName": "SD_EAST" } ], "stateCode": "SD", "stateName": "South Dakota" }, { "stateSubregions": [ { "stateSubregionCode": "MN2", "stateSubregionName": "MN_REST_ALL" }, { "stateSubregionCode": "MN1", "stateSubregionName": "MN_CENTRAL_EAST" } ], "stateCode": "MN", "stateName": "Minnesota" }, { "stateSubregions": [ { "stateSubregionCode": "MO3", "stateSubregionName": "MO_WEST" }, { "stateSubregionCode": "MO2", "stateSubregionName": "MO_SOUTH" }, { "stateSubregionCode": "MO1", "stateSubregionName": "MO_EAST" } ], "stateCode": "MO", "stateName": "Missouri" }, { "stateSubregions": [ { "stateSubregionCode": "WI2", "stateSubregionName": "WI_WEST" }, { "stateSubregionCode": "WI1", "stateSubregionName": "WI_EAST" } ], "stateCode": "WI", "stateName": "Wisconsin" }, { "stateSubregions": [ { "stateSubregionCode": "IL5", "stateSubregionName": "IL_SOUTHWEST" }, { "stateSubregionCode": "IL4", "stateSubregionName": "IL_SOUTHEAST" }, { "stateSubregionCode": "IL1", "stateSubregionName": "IL_CHICAGO" }, { "stateSubregionCode": "IL3", "stateSubregionName": "IL_NORTH_WEST" }, { "stateSubregionCode": "IL2", "stateSubregionName": "IL_NORTH_EAST" } ], "stateCode": "IL", "stateName": "Illinois" }, { "stateSubregions": [ { "stateSubregionCode": "IN1", "stateSubregionName": "IN_CENTRAL_AND_EAST" }, { "stateSubregionCode": "IN3", "stateSubregionName": "IN_SOUTH" }, { "stateSubregionCode": "IN2", "stateSubregionName": "IN_NORTH" }, { "stateSubregionCode": "IN4", "stateSubregionName": "IN_WEST" } ], "stateCode": "IN", "stateName": "Indiana" }, { "stateSubregions": [ { "stateSubregionCode": "ND", "stateSubregionName": "ND" } ], "stateCode": "ND", "stateName": "North Dakota" }, { "stateSubregions": [ { "stateSubregionCode": "NE", "stateSubregionName": "NE" } ], "stateCode": "NE", "stateName": "Nebraska" }, { "stateSubregions": [ { "stateSubregionCode": "KS2", "stateSubregionName": "KS_WEST" }, { "stateSubregionCode": "KS1", "stateSubregionName": "KS_EAST" } ], "stateCode": "KS", "stateName": "Kansas" }, { "stateSubregions": [ { "stateSubregionCode": "IA2", "stateSubregionName": "IA_REST" }, { "stateSubregionCode": "IA1", "stateSubregionName": "IA_CENTRAL" } ], "stateCode": "IA", "stateName": "Iowa" }, { "stateSubregions": [ { "stateSubregionCode": "OH1", "stateSubregionName": "OH_CENTRAL" }, { "stateSubregionCode": "OH3", "stateSubregionName": "OH_SOUTH_EAST" }, { "stateSubregionCode": "OH2", "stateSubregionName": "OH_NORTH" }, { "stateSubregionCode": "OH4", "stateSubregionName": "OH_WEST" } ], "stateCode": "OH", "stateName": "Ohio" }, { "stateSubregions": [ { "stateSubregionCode": "MI2", "stateSubregionName": "MI_NORTH" }, { "stateSubregionCode": "MI1", "stateSubregionName": "MI_CENTRAL" }, { "stateSubregionCode": "MI3", "stateSubregionName": "MI_SOUTH_EAST" } ], "stateCode": "MI", "stateName": "Michigan" } ], "subRegionCode": "MW", "subRegionName": "MW" }, { "states": [ { "stateSubregions": [ { "stateSubregionCode": "DE", "stateSubregionName": "DE" } ], "stateCode": "DE", "stateName": "Delaware" }, { "stateSubregions": [ { "stateSubregionCode": "TX6", "stateSubregionName": "TX_NORTH_EAST" }, { "stateSubregionCode": "TX5", "stateSubregionName": "TX_HOUSTON" }, { "stateSubregionCode": "TX8", "stateSubregionName": "TX_SOUTH" }, { "stateSubregionCode": "TX7", "stateSubregionName": "TX_NORTH_WEST" }, { "stateSubregionCode": "TX9", "stateSubregionName": "TX_SOUTH_EAST" }, { "stateSubregionCode": "TX10", "stateSubregionName": "TX_SOUTH_WEST" }, { "stateSubregionCode": "TX2", "stateSubregionName": "TX_CENTRAL_NORTH" }, { "stateSubregionCode": "TX1", "stateSubregionName": "TX_CENTRAL" }, { "stateSubregionCode": "TX4", "stateSubregionName": "TX_DALLAS" }, { "stateSubregionCode": "TX3", "stateSubregionName": "TX_CENTRAL_WEST" } ], "stateCode": "TX", "stateName": "Texas" }, { "stateSubregions": [ { "stateSubregionCode": "FL2", "stateSubregionName": "FL_CENTRAL_WEST" }, { "stateSubregionCode": "FL1", "stateSubregionName": "FL_CENTRAL_EAST" }, { "stateSubregionCode": "FL4", "stateSubregionName": "FL_NORTH" }, { "stateSubregionCode": "FL3", "stateSubregionName": "FL_MIAMI" }, { "stateSubregionCode": "FL6", "stateSubregionName": "FL_SOUTH_WEST" }, { "stateSubregionCode": "FL5", "stateSubregionName": "FL_SOUTH_EAST" } ], "stateCode": "FL", "stateName": "Florida" }, { "stateSubregions": [ { "stateSubregionCode": "MS2", "stateSubregionName": "MS_SOUTH" }, { "stateSubregionCode": "MS1", "stateSubregionName": "MS_NORTH" } ], "stateCode": "MS", "stateName": "Mississippi" }, { "stateSubregions": [ { "stateSubregionCode": "AL1", "stateSubregionName": "AL_NORTH" }, { "stateSubregionCode": "AL2", "stateSubregionName": "AL_SOUTH" } ], "stateCode": "AL", "stateName": "Alabama" }, { "stateSubregions": [ { "stateSubregionCode": "VA1", "stateSubregionName": "VA_CENTRAL" }, { "stateSubregionCode": "VA3", "stateSubregionName": "VA_SOUTH_EAST" }, { "stateSubregionCode": "VA2", "stateSubregionName": "VA_NORTH" }, { "stateSubregionCode": "VA4", "stateSubregionName": "VA_SOUTH_WEST" } ], "stateCode": "VA", "stateName": "Virginia" }, { "stateSubregions": [ { "stateSubregionCode": "KY2", "stateSubregionName": "KY_WEST" }, { "stateSubregionCode": "KY1", "stateSubregionName": "KY_EAST" } ], "stateCode": "KY", "stateName": "Kentucky" }, { "stateSubregions": [ { "stateSubregionCode": "SC2", "stateSubregionName": "SC_NORTH" }, { "stateSubregionCode": "SC1", "stateSubregionName": "SC_CENTRAL" }, { "stateSubregionCode": "SC3", "stateSubregionName": "SC_SOUTH" } ], "stateCode": "SC", "stateName": "South Carolina" }, { "stateSubregions": [ { "stateSubregionCode": "AR2", "stateSubregionName": "AR_WEST" } ], "stateCode": "AR", "stateName": "Arkansas" }, { "stateSubregions": [ { "stateSubregionCode": "LA1", "stateSubregionName": "LA_NORTH" }, { "stateSubregionCode": "LA2", "stateSubregionName": "LA_SOUTH" } ], "stateCode": "LA", "stateName": "Louisiana" }, { "stateSubregions": [ { "stateSubregionCode": "NC1", "stateSubregionName": "NC_EAST" }, { "stateSubregionCode": "NC3", "stateSubregionName": "NC_SOUTH" }, { "stateSubregionCode": "NC2", "stateSubregionName": "NC_NORTH" }, { "stateSubregionCode": "NC4", "stateSubregionName": "NC_WEST" } ], "stateCode": "NC", "stateName": "North Carolina" }, { "stateSubregions": [ { "stateSubregionCode": "MD1", "stateSubregionName": "MD_CENTRAL" }, { "stateSubregionCode": "MD2", "stateSubregionName": "MD_REST_ALL" } ], "stateCode": "MD", "stateName": "Maryland" }, { "stateSubregions": [ { "stateSubregionCode": "GA2", "stateSubregionName": "GA_CENTRAL" }, { "stateSubregionCode": "GA1", "stateSubregionName": "GA_ATLANTA" }, { "stateSubregionCode": "GA4", "stateSubregionName": "GA_NORTH_WEST" }, { "stateSubregionCode": "GA3", "stateSubregionName": "GA_NORTH_EAST" }, { "stateSubregionCode": "GA5", "stateSubregionName": "GA_SOUTH" } ], "stateCode": "GA", "stateName": "Georgia" }, { "stateSubregions": [ { "stateSubregionCode": "TN2", "stateSubregionName": "TN_EAST" }, { "stateSubregionCode": "TN1", "stateSubregionName": "TN_CENTRAL" }, { "stateSubregionCode": "TN3", "stateSubregionName": "TN_WEST" } ], "stateCode": "TN", "stateName": "Tennessee" }, { "stateSubregions": [ { "stateSubregionCode": "OK2", "stateSubregionName": "OK_REST_ALL" }, { "stateSubregionCode": "OK1", "stateSubregionName": "OK_NORTH_EAST" } ], "stateCode": "OK", "stateName": "Oklahoma" }, { "stateSubregions": [ { "stateSubregionCode": "WV1", "stateSubregionName": "WV_EAST" }, { "stateSubregionCode": "WV2", "stateSubregionName": "WV_WEST" } ], "stateCode": "WV", "stateName": "West Virginia" }, { "stateSubregions": [ { "stateSubregionCode": "DC", "stateSubregionName": "DC" } ], "stateCode": "DC", "stateName": "District of Columbia" } ], "subRegionCode": "SO", "subRegionName": "SO" }, { "states": [ { "stateSubregions": [ { "stateSubregionCode": "WY", "stateSubregionName": "WY" } ], "stateCode": "WY", "stateName": "Wyoming" }, { "stateSubregions": [ { "stateSubregionCode": "OR1", "stateSubregionName": "OR_CENTRAL" }, { "stateSubregionCode": "OR2", "stateSubregionName": "OR_NORTH_WEST" } ], "stateCode": "OR", "stateName": "Oregon" }, { "stateSubregions": [ { "stateSubregionCode": "MT", "stateSubregionName": "MT" } ], "stateCode": "MT", "stateName": "Montana" }, { "stateSubregions": [ { "stateSubregionCode": "NV2", "stateSubregionName": "NV_NORTH" }, { "stateSubregionCode": "NV1", "stateSubregionName": "NV_LAS_VEGAS" }, { "stateSubregionCode": "NV3", "stateSubregionName": "NV_SOUTH" } ], "stateCode": "NV", "stateName": "Nevada" }, { "stateSubregions": [ { "stateSubregionCode": "AZ1", "stateSubregionName": "AZ_NORTH" }, { "stateSubregionCode": "AZ2", "stateSubregionName": "AZ_PHOENIX" }, { "stateSubregionCode": "AZ3", "stateSubregionName": "AZ_SOUTH" } ], "stateCode": "AZ", "stateName": "Arizona" }, { "stateSubregions": [ { "stateSubregionCode": "WA", "stateSubregionName": "WA" } ], "stateCode": "WA", "stateName": "Washington" }, { "stateSubregions": [ { "stateSubregionCode": "ID1", "stateSubregionName": "ID_BOISE_AND_NAMPA" }, { "stateSubregionCode": "ID2", "stateSubregionName": "ID_NORTH_AND_EAST" } ], "stateCode": "ID", "stateName": "Idaho" }, { "stateSubregions": [ { "stateSubregionCode": "CO2", "stateSubregionName": "CO_REST_ALL" }, { "stateSubregionCode": "CO1", "stateSubregionName": "CO_CENTRAL" } ], "stateCode": "CO", "stateName": "Colorado" }, { "stateSubregions": [ { "stateSubregionCode": "CA13", "stateSubregionName": "CA_SAN_DIEGO_COUNTY" }, { "stateSubregionCode": "CA12", "stateSubregionName": "CA_SAN_DIEGO" }, { "stateSubregionCode": "CA11", "stateSubregionName": "CA_SAN_BERNARDINO" }, { "stateSubregionCode": "CA10", "stateSubregionName": "CA_RIVERSIDE_IMPERIAL\t" }, { "stateSubregionCode": "CA2", "stateSubregionName": "CA_CENTRAL_NORTH" }, { "stateSubregionCode": "CA1", "stateSubregionName": "CA_CENTRAL" }, { "stateSubregionCode": "CA4", "stateSubregionName": "CA_CENTRAL_WEST" }, { "stateSubregionCode": "CA3", "stateSubregionName": "CA_CENTRAL_SOUTH" }, { "stateSubregionCode": "CA6", "stateSubregionName": "CA_LOS_ANGELES" }, { "stateSubregionCode": "CA5", "stateSubregionName": "CA_LONG_BEACH" }, { "stateSubregionCode": "CA8", "stateSubregionName": "CA_NORTH" }, { "stateSubregionCode": "CA7", "stateSubregionName": "CA_LOS_ANGELES_VENTURA_COUNTY" }, { "stateSubregionCode": "CA9", "stateSubregionName": "CA_ONTARIO" }, { "stateSubregionCode": "CA15", "stateSubregionName": "CA_SANTA_ANA" }, { "stateSubregionCode": "CA14", "stateSubregionName": "CA_SAN_FRANCISCO" } ], "stateCode": "CA", "stateName": "California" }, { "stateSubregions": [ { "stateSubregionCode": "UT1", "stateSubregionName": "UT_NORTH" }, { "stateSubregionCode": "UT2", "stateSubregionName": "UT_SOUTH" } ], "stateCode": "UT", "stateName": "Utah" }, { "stateSubregions": [ { "stateSubregionCode": "NM1", "stateSubregionName": "NM_CENTRAL" }, { "stateSubregionCode": "NM2", "stateSubregionName": "NM_REST_ALL" } ], "stateCode": "NM", "stateName": "New Mexico" } ], "subRegionCode": "WE", "subRegionName": "WE" } ], "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "tieredShippingCharges": [ { "shipCharge": { "amount": 2, "currency": "USD" }, "minLimit": 10.06, "maxLimit": -1 }, { "shipCharge": { "amount": 1, "currency": "USD" }, "minLimit": 0, "maxLimit": 10.05 } ], "transitTime": 3 } ] } ], "name": "Next Day servc test"
}
'

import requests template_id = "templateId" # replace with your real template ID
access_token = "<ACCESS_TOKEN>" # replace with a valid OAuth token url = f"https://marketplace.walmartapis.com/v3/settings/shipping/templates/{template_id}" headers = { "Accept": "application/json", "Content-Type": "application/json", "Authorization": f"Bearer {access_token}",
} payload = { "type": "CUSTOM", "rateModelType": "TIERED_PRICING", "status": "ACTIVE", "shippingMethods": [ { "shipMethod": "VALUE", "status": "ACTIVE", "configurations": [ { "regions": [{"regionCode": "C", "regionName": "48 State"}], "addressTypes": ["STREET"], "tieredShippingCharges": [ { "shipCharge": {"amount": 0, "currency": "USD"}, "minLimit": 0, "maxLimit": -1, } ], "transitTime": 6, } ], }, { "shipMethod": "STANDARD", "status": "ACTIVE", "configurations": [ { "regions": [ { "subRegions": [ { "states": [ { "stateSubregions": [ { "stateSubregionCode": "SD2", "stateSubregionName": "SD_WEST", }, { "stateSubregionCode": "SD1", "stateSubregionName": "SD_EAST", }, ], "stateCode": "SD", "stateName": "South Dakota", } ], "subRegionCode": "MW", "subRegionName": "MW", } ], "regionCode": "C", "regionName": "48 State", } ], "addressTypes": ["STREET"], "tieredShippingCharges": [ { "shipCharge": {"amount": 2, "currency": "USD"}, "minLimit": 10.06, "maxLimit": -1, }, { "shipCharge": {"amount": 1, "currency": "USD"}, "minLimit": 0, "maxLimit": 10.05, }, ], "transitTime": 3, } ], }, ], "name": "Next Day servc test",
} resp = requests.put(url, headers=headers, json=payload, timeout=30) print("Status:", resp.status_code)
print(resp.text)
resp.raise_for_status()

Sample `DELIVERR` type

curl --request PUT \ --url https://marketplace.walmartapis.com/v3/settings/shipping/templates/templateId \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "name": "Next Day", "type": "DELIVERR", "rateModelType": "TIERED_PRICING", "status": "ACTIVE", "shippingMethods": [ { "shipMethod": "VALUE", "status": "ACTIVE", "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "transitTime": 6, "tieredShippingCharges": [ { "minLimit": 0, "maxLimit": -1, "shipCharge": { "amount": 0, "currency": "USD" } } ] } ] }, { "shipMethod": "STANDARD", "status": "ACTIVE", "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "MW", "subRegionName": "MW", "states": [ { "stateCode": "SD", "stateName": "South Dakota", "stateSubregions": [ { "stateSubregionCode": "SD2", "stateSubregionName": "SD_WEST" }, { "stateSubregionCode": "SD1", "stateSubregionName": "SD_EAST" } ] } ] } ] } ], "addressTypes": [ "STREET" ], "transitTime": 3, "tieredShippingCharges": [ { "minLimit": 10.06, "maxLimit": -1, "shipCharge": { "amount": 2, "currency": "USD" } }, { "minLimit": 0, "maxLimit": 10.05, "shipCharge": { "amount": 1, "currency": "USD" } } ] } ] } ]
}
'

import requests template_id = "templateId" # replace with your real template ID
access_token = "<ACCESS_TOKEN>" # replace with a valid OAuth token url = f"https://marketplace.walmartapis.com/v3/settings/shipping/templates/{template_id}" headers = { "Accept": "application/json", "Content-Type": "application/json", "Authorization": f"Bearer {access_token}",
} payload = { "type": "CUSTOM", "rateModelType": "PER_SHIPMENT_PRICING", "status": "ACTIVE", "shippingMethods": [ { "shipMethod": "VALUE", "status": "ACTIVE", "configurations": [ { "regions": [{"regionCode": "C", "regionName": "48 State"}], "addressTypes": ["STREET"], "perShippingCharge": { "shippingAndHandling": {"amount": 0, "currency": "USD"}, "chargePerWeight": {"amount": 0, "currency": "USD"}, "unitOfMeasure": "LB", }, "transitTime": 6, } ], }, { "shipMethod": "STANDARD", "status": "ACTIVE", "configurations": [ { "regions": [ { "subRegions": [ { "states": [ { "stateSubregions": [ { "stateSubregionCode": "CT2", "stateSubregionName": "CT_SOUTH_WEST", }, { "stateSubregionCode": "CT1", "stateSubregionName": "CT_REST_ALL", }, ], "stateCode": "CT", "stateName": "Connecticut", }, { "stateSubregions": [ { "stateSubregionCode": "PA3", "stateSubregionName": "PA_NORTH_EAST", }, { "stateSubregionCode": "PA2", "stateSubregionName": "PA_CENTRAL_NORTH", }, { "stateSubregionCode": "PA5", "stateSubregionName": "PA_WEST", }, { "stateSubregionCode": "PA4", "stateSubregionName": "PA_SOUTH", }, { "stateSubregionCode": "PA1", "stateSubregionName": "PA_CENTRAL", }, ], "stateCode": "PA", "stateName": "Pennsylvania", }, { "stateSubregions": [ { "stateSubregionCode": "MA2", "stateSubregionName": "MA_WEST", }, { "stateSubregionCode": "MA1", "stateSubregionName": "MA_EAST", }, ], "stateCode": "MA", "stateName": "Massachusetts", }, { "stateSubregions": [ {"stateSubregionCode": "RI", "stateSubregionName": "RI"} ], "stateCode": "RI", "stateName": "Rhode Island", }, { "stateSubregions": [ { "stateSubregionCode": "ME2", "stateSubregionName": "ME_WEST", }, { "stateSubregionCode": "ME1", "stateSubregionName": "ME_EAST", }, ], "stateCode": "ME", "stateName": "Maine", }, { "stateSubregions": [ {"stateSubregionCode": "NH", "stateSubregionName": "NH"} ], "stateCode": "NH", "stateName": "New Hampshire", }, { "stateSubregions": [ { "stateSubregionCode": "NY1", "stateSubregionName": "NY_BROOKLYN", }, { "stateSubregionCode": "NY3", "stateSubregionName": "NY_NORTH_CENTRAL", }, { "stateSubregionCode": "NY2", "stateSubregionName": "NY_CENTRAL", }, { "stateSubregionCode": "NY5", "stateSubregionName": "NY_SOUTH", }, { "stateSubregionCode": "NY4", "stateSubregionName": "NY_NORTH_WEST", }, ], "stateCode": "NY", "stateName": "New York", }, { "stateSubregions": [ { "stateSubregionCode": "NJ2", "stateSubregionName": "NJ_NORTH", }, { "stateSubregionCode": "NJ1", "stateSubregionName": "NJ_CENTRAL", }, { "stateSubregionCode": "NJ4", "stateSubregionName": "NJ_KEARNY", }, { "stateSubregionCode": "NJ3", "stateSubregionName": "NJ_SOUTH", }, ], "stateCode": "NJ", "stateName": "New Jersey", }, { "stateSubregions": [ {"stateSubregionCode": "VT", "stateSubregionName": "VT"} ], "stateCode": "VT", "stateName": "Vermont", }, ], "subRegionCode": "NE", "subRegionName": "NE", } ], "regionCode": "C", "regionName": "48 State", } ], "addressTypes": ["STREET"], "tieredShippingCharges": [ { "shipCharge": {"amount": 2, "currency": "USD"}, "minLimit": 10.06, "maxLimit": -1, }, { "shipCharge": {"amount": 1, "currency": "USD"}, "minLimit": 0, "maxLimit": 10.05, }, ], "transitTime": 3, } ], }, ], "name": "Next Day servc test",
} resp = requests.put(url, headers=headers, json=payload, timeout=30) print("Status:", resp.status_code)
print(resp.text)
resp.raise_for_status()

Sample Full domestic tiered

curl --request PUT \ --url https://marketplace.walmartapis.com/v3/settings/shipping/templates/templateId \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "name": "Template 3", "type": "CUSTOM", "rateModelType": "TIERED_PRICING", "status": "ACTIVE", "shippingMethods": [ { "shipMethod": "VALUE", "status": "ACTIVE", "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "transitTime": 6, "tieredShippingCharges": [ { "minLimit": 0, "maxLimit": -1, "shipCharge": { "amount": 0, "currency": "USD" } } ] } ] }, { "shipMethod": "STANDARD", "status": "ACTIVE", "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "NE", "subRegionName": "NE", "states": [ { "stateCode": "CT", "stateName": "Connecticut", "stateSubregions": [ { "stateSubregionCode": "CT2", "stateSubregionName": "CT_SOUTH_WEST" }, { "stateSubregionCode": "CT1", "stateSubregionName": "CT_REST_ALL" } ] }, { "stateCode": "PA", "stateName": "Pennsylvania", "stateSubregions": [ { "stateSubregionCode": "PA3", "stateSubregionName": "PA_NORTH_EAST" }, { "stateSubregionCode": "PA2", "stateSubregionName": "PA_CENTRAL_NORTH" }, { "stateSubregionCode": "PA5", "stateSubregionName": "PA_WEST" }, { "stateSubregionCode": "PA4", "stateSubregionName": "PA_SOUTH" }, { "stateSubregionCode": "PA1", "stateSubregionName": "PA_CENTRAL" } ] }, { "stateCode": "MA", "stateName": "Massachusetts", "stateSubregions": [ { "stateSubregionCode": "MA2", "stateSubregionName": "MA_WEST" }, { "stateSubregionCode": "MA1", "stateSubregionName": "MA_EAST" } ] }, { "stateCode": "RI", "stateName": "Rhode Island", "stateSubregions": [ { "stateSubregionCode": "RI", "stateSubregionName": "RI" } ] }, { "stateCode": "ME", "stateName": "Maine", "stateSubregions": [ { "stateSubregionCode": "ME2", "stateSubregionName": "ME_WEST" }, { "stateSubregionCode": "ME1", "stateSubregionName": "ME_EAST" } ] }, { "stateCode": "NH", "stateName": "New Hampshire", "stateSubregions": [ { "stateSubregionCode": "NH", "stateSubregionName": "NH" } ] }, { "stateCode": "NY", "stateName": "New York", "stateSubregions": [ { "stateSubregionCode": "NY1", "stateSubregionName": "NY_BROOKLYN" }, { "stateSubregionCode": "NY3", "stateSubregionName": "NY_NORTH_CENTRAL" }, { "stateSubregionCode": "NY2", "stateSubregionName": "NY_CENTRAL" }, { "stateSubregionCode": "NY5", "stateSubregionName": "NY_SOUTH" }, { "stateSubregionCode": "NY4", "stateSubregionName": "NY_NORTH_WEST" } ] }, { "stateCode": "NJ", "stateName": "New Jersey", "stateSubregions": [ { "stateSubregionCode": "NJ2", "stateSubregionName": "NJ_NORTH" }, { "stateSubregionCode": "NJ1", "stateSubregionName": "NJ_CENTRAL" }, { "stateSubregionCode": "NJ4", "stateSubregionName": "NJ_KEARNY" }, { "stateSubregionCode": "NJ3", "stateSubregionName": "NJ_SOUTH" } ] }, { "stateCode": "VT", "stateName": "Vermont", "stateSubregions": [ { "stateSubregionCode": "VT", "stateSubregionName": "VT" } ] } ] }, { "subRegionCode": "MW", "subRegionName": "MW", "states": [ { "stateCode": "SD", "stateName": "South Dakota", "stateSubregions": [ { "stateSubregionCode": "SD2", "stateSubregionName": "SD_WEST" }, { "stateSubregionCode": "SD1", "stateSubregionName": "SD_EAST" } ] }, { "stateCode": "MN", "stateName": "Minnesota", "stateSubregions": [ { "stateSubregionCode": "MN2", "stateSubregionName": "MN_REST_ALL" }, { "stateSubregionCode": "MN1", "stateSubregionName": "MN_CENTRAL_EAST" } ] }, { "stateCode": "MO", "stateName": "Missouri", "stateSubregions": [ { "stateSubregionCode": "MO3", "stateSubregionName": "MO_WEST" }, { "stateSubregionCode": "MO2", "stateSubregionName": "MO_SOUTH" }, { "stateSubregionCode": "MO1", "stateSubregionName": "MO_EAST" } ] }, { "stateCode": "WI", "stateName": "Wisconsin", "stateSubregions": [ { "stateSubregionCode": "WI2", "stateSubregionName": "WI_WEST" }, { "stateSubregionCode": "WI1", "stateSubregionName": "WI_EAST" } ] }, { "stateCode": "IL", "stateName": "Illinois", "stateSubregions": [ { "stateSubregionCode": "IL5", "stateSubregionName": "IL_SOUTHWEST" }, { "stateSubregionCode": "IL4", "stateSubregionName": "IL_SOUTHEAST" }, { "stateSubregionCode": "IL1", "stateSubregionName": "IL_CHICAGO" }, { "stateSubregionCode": "IL3", "stateSubregionName": "IL_NORTH_WEST" }, { "stateSubregionCode": "IL2", "stateSubregionName": "IL_NORTH_EAST" } ] }, { "stateCode": "IN", "stateName": "Indiana", "stateSubregions": [ { "stateSubregionCode": "IN1", "stateSubregionName": "IN_CENTRAL_AND_EAST" }, { "stateSubregionCode": "IN3", "stateSubregionName": "IN_SOUTH" }, { "stateSubregionCode": "IN2", "stateSubregionName": "IN_NORTH" }, { "stateSubregionCode": "IN4", "stateSubregionName": "IN_WEST" } ] }, { "stateCode": "ND", "stateName": "North Dakota", "stateSubregions": [ { "stateSubregionCode": "ND", "stateSubregionName": "ND" } ] }, { "stateCode": "NE", "stateName": "Nebraska", "stateSubregions": [ { "stateSubregionCode": "NE", "stateSubregionName": "NE" } ] }, { "stateCode": "KS", "stateName": "Kansas", "stateSubregions": [ { "stateSubregionCode": "KS2", "stateSubregionName": "KS_WEST" }, { "stateSubregionCode": "KS1", "stateSubregionName": "KS_EAST" } ] }, { "stateCode": "IA", "stateName": "Iowa", "stateSubregions": [ { "stateSubregionCode": "IA2", "stateSubregionName": "IA_REST" }, { "stateSubregionCode": "IA1", "stateSubregionName": "IA_CENTRAL" } ] }, { "stateCode": "OH", "stateName": "Ohio", "stateSubregions": [ { "stateSubregionCode": "OH1", "stateSubregionName": "OH_CENTRAL" }, { "stateSubregionCode": "OH3", "stateSubregionName": "OH_SOUTH_EAST" }, { "stateSubregionCode": "OH2", "stateSubregionName": "OH_NORTH" }, { "stateSubregionCode": "OH4", "stateSubregionName": "OH_WEST" } ] }, { "stateCode": "MI", "stateName": "Michigan", "stateSubregions": [ { "stateSubregionCode": "MI2", "stateSubregionName": "MI_NORTH" }, { "stateSubregionCode": "MI1", "stateSubregionName": "MI_CENTRAL" }, { "stateSubregionCode": "MI3", "stateSubregionName": "MI_SOUTH_EAST" } ] } ] }, { "subRegionCode": "SO", "subRegionName": "SO", "states": [ { "stateCode": "DE", "stateName": "Delaware", "stateSubregions": [ { "stateSubregionCode": "DE", "stateSubregionName": "DE" } ] }, { "stateCode": "TX", "stateName": "Texas", "stateSubregions": [ { "stateSubregionCode": "TX6", "stateSubregionName": "TX_NORTH_EAST" }, { "stateSubregionCode": "TX5", "stateSubregionName": "TX_HOUSTON" }, { "stateSubregionCode": "TX8", "stateSubregionName": "TX_SOUTH" }, { "stateSubregionCode": "TX7", "stateSubregionName": "TX_NORTH_WEST" }, { "stateSubregionCode": "TX9", "stateSubregionName": "TX_SOUTH_EAST" }, { "stateSubregionCode": "TX10", "stateSubregionName": "TX_SOUTH_WEST" }, { "stateSubregionCode": "TX2", "stateSubregionName": "TX_CENTRAL_NORTH" }, { "stateSubregionCode": "TX1", "stateSubregionName": "TX_CENTRAL" }, { "stateSubregionCode": "TX4", "stateSubregionName": "TX_DALLAS" }, { "stateSubregionCode": "TX3", "stateSubregionName": "TX_CENTRAL_WEST" } ] }, { "stateCode": "FL", "stateName": "Florida", "stateSubregions": [ { "stateSubregionCode": "FL2", "stateSubregionName": "FL_CENTRAL_WEST" }, { "stateSubregionCode": "FL1", "stateSubregionName": "FL_CENTRAL_EAST" }, { "stateSubregionCode": "FL4", "stateSubregionName": "FL_NORTH" }, { "stateSubregionCode": "FL3", "stateSubregionName": "FL_MIAMI" }, { "stateSubregionCode": "FL6", "stateSubregionName": "FL_SOUTH_WEST" }, { "stateSubregionCode": "FL5", "stateSubregionName": "FL_SOUTH_EAST" } ] }, { "stateCode": "MS", "stateName": "Mississippi", "stateSubregions": [ { "stateSubregionCode": "MS2", "stateSubregionName": "MS_SOUTH" }, { "stateSubregionCode": "MS1", "stateSubregionName": "MS_NORTH" } ] }, { "stateCode": "AL", "stateName": "Alabama", "stateSubregions": [ { "stateSubregionCode": "AL1", "stateSubregionName": "AL_NORTH" }, { "stateSubregionCode": "AL2", "stateSubregionName": "AL_SOUTH" } ] }, { "stateCode": "VA", "stateName": "Virginia", "stateSubregions": [ { "stateSubregionCode": "VA1", "stateSubregionName": "VA_CENTRAL" }, { "stateSubregionCode": "VA3", "stateSubregionName": "VA_SOUTH_EAST" }, { "stateSubregionCode": "VA2", "stateSubregionName": "VA_NORTH" }, { "stateSubregionCode": "VA4", "stateSubregionName": "VA_SOUTH_WEST" } ] }, { "stateCode": "KY", "stateName": "Kentucky", "stateSubregions": [ { "stateSubregionCode": "KY2", "stateSubregionName": "KY_WEST" }, { "stateSubregionCode": "KY1", "stateSubregionName": "KY_EAST" } ] }, { "stateCode": "SC", "stateName": "South Carolina", "stateSubregions": [ { "stateSubregionCode": "SC2", "stateSubregionName": "SC_NORTH" }, { "stateSubregionCode": "SC1", "stateSubregionName": "SC_CENTRAL" }, { "stateSubregionCode": "SC3", "stateSubregionName": "SC_SOUTH" } ] }, { "stateCode": "AR", "stateName": "Arkansas", "stateSubregions": [ { "stateSubregionCode": "AR2", "stateSubregionName": "AR_WEST" }, { "stateSubregionCode": "AR1", "stateSubregionName": "AR_EAST" } ] }, { "stateCode": "LA", "stateName": "Louisiana", "stateSubregions": [ { "stateSubregionCode": "LA1", "stateSubregionName": "LA_NORTH" }, { "stateSubregionCode": "LA2", "stateSubregionName": "LA_SOUTH" } ] }, { "stateCode": "NC", "stateName": "North Carolina", "stateSubregions": [ { "stateSubregionCode": "NC1", "stateSubregionName": "NC_EAST" }, { "stateSubregionCode": "NC3", "stateSubregionName": "NC_SOUTH" }, { "stateSubregionCode": "NC2", "stateSubregionName": "NC_NORTH" }, { "stateSubregionCode": "NC4", "stateSubregionName": "NC_WEST" } ] }, { "stateCode": "MD", "stateName": "Maryland", "stateSubregions": [ { "stateSubregionCode": "MD1", "stateSubregionName": "MD_CENTRAL" }, { "stateSubregionCode": "MD2", "stateSubregionName": "MD_REST_ALL" } ] }, { "stateCode": "GA", "stateName": "Georgia", "stateSubregions": [ { "stateSubregionCode": "GA2", "stateSubregionName": "GA_CENTRAL" }, { "stateSubregionCode": "GA1", "stateSubregionName": "GA_ATLANTA" }, { "stateSubregionCode": "GA4", "stateSubregionName": "GA_NORTH_WEST" }, { "stateSubregionCode": "GA3", "stateSubregionName": "GA_NORTH_EAST" }, { "stateSubregionCode": "GA5", "stateSubregionName": "GA_SOUTH" } ] }, { "stateCode": "TN", "stateName": "Tennessee", "stateSubregions": [ { "stateSubregionCode": "TN2", "stateSubregionName": "TN_EAST" }, { "stateSubregionCode": "TN1", "stateSubregionName": "TN_CENTRAL" }, { "stateSubregionCode": "TN3", "stateSubregionName": "TN_WEST" } ] }, { "stateCode": "OK", "stateName": "Oklahoma", "stateSubregions": [ { "stateSubregionCode": "OK2", "stateSubregionName": "OK_REST_ALL" }, { "stateSubregionCode": "OK1", "stateSubregionName": "OK_NORTH_EAST" } ] }, { "stateCode": "WV", "stateName": "West Virginia", "stateSubregions": [ { "stateSubregionCode": "WV1", "stateSubregionName": "WV_EAST" }, { "stateSubregionCode": "WV2", "stateSubregionName": "WV_WEST" } ] }, { "stateCode": "DC", "stateName": "District of Columbia", "stateSubregions": [ { "stateSubregionCode": "DC", "stateSubregionName": "DC" } ] } ] }, { "subRegionCode": "WE", "subRegionName": "WE", "states": [ { "stateCode": "WY", "stateName": "Wyoming", "stateSubregions": [ { "stateSubregionCode": "WY", "stateSubregionName": "WY" } ] }, { "stateCode": "OR", "stateName": "Oregon", "stateSubregions": [ { "stateSubregionCode": "OR1", "stateSubregionName": "OR_CENTRAL" }, { "stateSubregionCode": "OR2", "stateSubregionName": "OR_NORTH_WEST" } ] }, { "stateCode": "MT", "stateName": "Montana", "stateSubregions": [ { "stateSubregionCode": "MT", "stateSubregionName": "MT" } ] }, { "stateCode": "NV", "stateName": "Nevada", "stateSubregions": [ { "stateSubregionCode": "NV2", "stateSubregionName": "NV_NORTH" }, { "stateSubregionCode": "NV1", "stateSubregionName": "NV_LAS_VEGAS" }, { "stateSubregionCode": "NV3", "stateSubregionName": "NV_SOUTH" } ] }, { "stateCode": "AZ", "stateName": "Arizona", "stateSubregions": [ { "stateSubregionCode": "AZ1", "stateSubregionName": "AZ_NORTH" }, { "stateSubregionCode": "AZ2", "stateSubregionName": "AZ_PHOENIX" }, { "stateSubregionCode": "AZ3", "stateSubregionName": "AZ_SOUTH" } ] }, { "stateCode": "WA", "stateName": "Washington", "stateSubregions": [ { "stateSubregionCode": "WA", "stateSubregionName": "WA" } ] }, { "stateCode": "ID", "stateName": "Idaho", "stateSubregions": [ { "stateSubregionCode": "ID1", "stateSubregionName": "ID_BOISE_AND_NAMPA" }, { "stateSubregionCode": "ID2", "stateSubregionName": "ID_NORTH_AND_EAST" } ] }, { "stateCode": "CO", "stateName": "Colorado", "stateSubregions": [ { "stateSubregionCode": "CO2", "stateSubregionName": "CO_REST_ALL" }, { "stateSubregionCode": "CO1", "stateSubregionName": "CO_CENTRAL" } ] }, { "stateCode": "CA", "stateName": "California", "stateSubregions": [ { "stateSubregionCode": "CA13", "stateSubregionName": "CA_SAN_DIEGO_COUNTY" }, { "stateSubregionCode": "CA12", "stateSubregionName": "CA_SAN_DIEGO" }, { "stateSubregionCode": "CA11", "stateSubregionName": "CA_SAN_BERNARDINO" }, { "stateSubregionCode": "CA10", "stateSubregionName": "CA_RIVERSIDE_IMPERIAL\t" }, { "stateSubregionCode": "CA2", "stateSubregionName": "CA_CENTRAL_NORTH" }, { "stateSubregionCode": "CA1", "stateSubregionName": "CA_CENTRAL" }, { "stateSubregionCode": "CA4", "stateSubregionName": "CA_CENTRAL_WEST" }, { "stateSubregionCode": "CA3", "stateSubregionName": "CA_CENTRAL_SOUTH" }, { "stateSubregionCode": "CA6", "stateSubregionName": "CA_LOS_ANGELES" }, { "stateSubregionCode": "CA5", "stateSubregionName": "CA_LONG_BEACH" }, { "stateSubregionCode": "CA8", "stateSubregionName": "CA_NORTH" }, { "stateSubregionCode": "CA7", "stateSubregionName": "CA_LOS_ANGELES_VENTURA_COUNTY" }, { "stateSubregionCode": "CA9", "stateSubregionName": "CA_ONTARIO" }, { "stateSubregionCode": "CA15", "stateSubregionName": "CA_SANTA_ANA" }, { "stateSubregionCode": "CA14", "stateSubregionName": "CA_SAN_FRANCISCO" } ] }, { "stateCode": "UT", "stateName": "Utah", "stateSubregions": [ { "stateSubregionCode": "UT1", "stateSubregionName": "UT_NORTH" }, { "stateSubregionCode": "UT2", "stateSubregionName": "UT_SOUTH" } ] }, { "stateCode": "NM", "stateName": "New Mexico", "stateSubregions": [ { "stateSubregionCode": "NM1", "stateSubregionName": "NM_CENTRAL" }, { "stateSubregionCode": "NM2", "stateSubregionName": "NM_REST_ALL" } ] } ] } ] } ], "addressTypes": [ "STREET" ], "transitTime": 3, "tieredShippingCharges": [ { "minLimit": 0, "maxLimit": -1, "shipCharge": { "amount": 0, "currency": "USD" } } ] }, { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "PO_BOX" ], "transitTime": 3, "tieredShippingCharges": [ { "minLimit": 0, "maxLimit": -1, "shipCharge": { "amount": 0, "currency": "USD" } } ] }, { "regions": [ { "regionCode": "H", "regionName": "AK and HI" }, { "regionCode": "P", "regionName": "US Protectorates" } ], "addressTypes": [ "PO_BOX", "STREET" ], "transitTime": 3, "tieredShippingCharges": [ { "minLimit": 0, "maxLimit": -1, "shipCharge": { "amount": 0, "currency": "USD" } } ] }, { "regions": [ { "regionCode": "A", "regionName": "APO/FPO" } ], "addressTypes": [ "MILITARY" ], "transitTime": 3, "tieredShippingCharges": [ { "minLimit": 0, "maxLimit": -1, "shipCharge": { "amount": 0, "currency": "USD" } } ] } ] } ]
}
'

curl --request PUT \ --url https://marketplace.walmartapis.com/v3/settings/shipping/templates/templateId \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "name": "Template 3", "type": "CUSTOM", "rateModelType": "TIERED_PRICING", "status": "ACTIVE", "shippingMethods": [ { "shipMethod": "VALUE", "status": "ACTIVE", "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "transitTime": 6, "tieredShippingCharges": [ { "minLimit": 0, "maxLimit": -1, "shipCharge": { "amount": 0, "currency": "USD" } } ] } ] }, { "shipMethod": "STANDARD", "status": "ACTIVE", "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "NE", "subRegionName": "NE", "states": [ { "stateCode": "CT", "stateName": "Connecticut", "stateSubregions": [ { "stateSubregionCode": "CT2", "stateSubregionName": "CT_SOUTH_WEST" }, { "stateSubregionCode": "CT1", "stateSubregionName": "CT_REST_ALL" } ] }, { "stateCode": "PA", "stateName": "Pennsylvania", "stateSubregions": [ { "stateSubregionCode": "PA3", "stateSubregionName": "PA_NORTH_EAST" }, { "stateSubregionCode": "PA2", "stateSubregionName": "PA_CENTRAL_NORTH" }, { "stateSubregionCode": "PA5", "stateSubregionName": "PA_WEST" }, { "stateSubregionCode": "PA4", "stateSubregionName": "PA_SOUTH" }, { "stateSubregionCode": "PA1", "stateSubregionName": "PA_CENTRAL" } ] }, { "stateCode": "MA", "stateName": "Massachusetts", "stateSubregions": [ { "stateSubregionCode": "MA2", "stateSubregionName": "MA_WEST" }, { "stateSubregionCode": "MA1", "stateSubregionName": "MA_EAST" } ] }, { "stateCode": "RI", "stateName": "Rhode Island", "stateSubregions": [ { "stateSubregionCode": "RI", "stateSubregionName": "RI" } ] }, { "stateCode": "ME", "stateName": "Maine", "stateSubregions": [ { "stateSubregionCode": "ME2", "stateSubregionName": "ME_WEST" }, { "stateSubregionCode": "ME1", "stateSubregionName": "ME_EAST" } ] }, { "stateCode": "NH", "stateName": "New Hampshire", "stateSubregions": [ { "stateSubregionCode": "NH", "stateSubregionName": "NH" } ] }, { "stateCode": "NY", "stateName": "New York", "stateSubregions": [ { "stateSubregionCode": "NY1", "stateSubregionName": "NY_BROOKLYN" }, { "stateSubregionCode": "NY3", "stateSubregionName": "NY_NORTH_CENTRAL" }, { "stateSubregionCode": "NY2", "stateSubregionName": "NY_CENTRAL" }, { "stateSubregionCode": "NY5", "stateSubregionName": "NY_SOUTH" }, { "stateSubregionCode": "NY4", "stateSubregionName": "NY_NORTH_WEST" } ] }, { "stateCode": "NJ", "stateName": "New Jersey", "stateSubregions": [ { "stateSubregionCode": "NJ2", "stateSubregionName": "NJ_NORTH" }, { "stateSubregionCode": "NJ1", "stateSubregionName": "NJ_CENTRAL" }, { "stateSubregionCode": "NJ4", "stateSubregionName": "NJ_KEARNY" }, { "stateSubregionCode": "NJ3", "stateSubregionName": "NJ_SOUTH" } ] }, { "stateCode": "VT", "stateName": "Vermont", "stateSubregions": [ { "stateSubregionCode": "VT", "stateSubregionName": "VT" } ] } ] }, { "subRegionCode": "MW", "subRegionName": "MW", "states": [ { "stateCode": "SD", "stateName": "South Dakota", "stateSubregions": [ { "stateSubregionCode": "SD2", "stateSubregionName": "SD_WEST" }, { "stateSubregionCode": "SD1", "stateSubregionName": "SD_EAST" } ] }, { "stateCode": "MN", "stateName": "Minnesota", "stateSubregions": [ { "stateSubregionCode": "MN2", "stateSubregionName": "MN_REST_ALL" }, { "stateSubregionCode": "MN1", "stateSubregionName": "MN_CENTRAL_EAST" } ] }, { "stateCode": "MO", "stateName": "Missouri", "stateSubregions": [ { "stateSubregionCode": "MO3", "stateSubregionName": "MO_WEST" }, { "stateSubregionCode": "MO2", "stateSubregionName": "MO_SOUTH" }, { "stateSubregionCode": "MO1", "stateSubregionName": "MO_EAST" } ] }, { "stateCode": "WI", "stateName": "Wisconsin", "stateSubregions": [ { "stateSubregionCode": "WI2", "stateSubregionName": "WI_WEST" }, { "stateSubregionCode": "WI1", "stateSubregionName": "WI_EAST" } ] }, { "stateCode": "IL", "stateName": "Illinois", "stateSubregions": [ { "stateSubregionCode": "IL5", "stateSubregionName": "IL_SOUTHWEST" }, { "stateSubregionCode": "IL4", "stateSubregionName": "IL_SOUTHEAST" }, { "stateSubregionCode": "IL1", "stateSubregionName": "IL_CHICAGO" }, { "stateSubregionCode": "IL3", "stateSubregionName": "IL_NORTH_WEST" }, { "stateSubregionCode": "IL2", "stateSubregionName": "IL_NORTH_EAST" } ] }, { "stateCode": "IN", "stateName": "Indiana", "stateSubregions": [ { "stateSubregionCode": "IN1", "stateSubregionName": "IN_CENTRAL_AND_EAST" }, { "stateSubregionCode": "IN3", "stateSubregionName": "IN_SOUTH" }, { "stateSubregionCode": "IN2", "stateSubregionName": "IN_NORTH" }, { "stateSubregionCode": "IN4", "stateSubregionName": "IN_WEST" } ] }, { "stateCode": "ND", "stateName": "North Dakota", "stateSubregions": [ { "stateSubregionCode": "ND", "stateSubregionName": "ND" } ] }, { "stateCode": "NE", "stateName": "Nebraska", "stateSubregions": [ { "stateSubregionCode": "NE", "stateSubregionName": "NE" } ] }, { "stateCode": "KS", "stateName": "Kansas", "stateSubregions": [ { "stateSubregionCode": "KS2", "stateSubregionName": "KS_WEST" }, { "stateSubregionCode": "KS1", "stateSubregionName": "KS_EAST" } ] }, { "stateCode": "IA", "stateName": "Iowa", "stateSubregions": [ { "stateSubregionCode": "IA2", "stateSubregionName": "IA_REST" }, { "stateSubregionCode": "IA1", "stateSubregionName": "IA_CENTRAL" } ] }, { "stateCode": "OH", "stateName": "Ohio", "stateSubregions": [ { "stateSubregionCode": "OH1", "stateSubregionName": "OH_CENTRAL" }, { "stateSubregionCode": "OH3", "stateSubregionName": "OH_SOUTH_EAST" }, { "stateSubregionCode": "OH2", "stateSubregionName": "OH_NORTH" }, { "stateSubregionCode": "OH4", "stateSubregionName": "OH_WEST" } ] }, { "stateCode": "MI", "stateName": "Michigan", "stateSubregions": [ { "stateSubregionCode": "MI2", "stateSubregionName": "MI_NORTH" }, { "stateSubregionCode": "MI1", "stateSubregionName": "MI_CENTRAL" }, { "stateSubregionCode": "MI3", "stateSubregionName": "MI_SOUTH_EAST" } ] } ] }, { "subRegionCode": "SO", "subRegionName": "SO", "states": [ { "stateCode": "DE", "stateName": "Delaware", "stateSubregions": [ { "stateSubregionCode": "DE", "stateSubregionName": "DE" } ] }, { "stateCode": "TX", "stateName": "Texas", "stateSubregions": [ { "stateSubregionCode": "TX6", "stateSubregionName": "TX_NORTH_EAST" }, { "stateSubregionCode": "TX5", "stateSubregionName": "TX_HOUSTON" }, { "stateSubregionCode": "TX8", "stateSubregionName": "TX_SOUTH" }, { "stateSubregionCode": "TX7", "stateSubregionName": "TX_NORTH_WEST" }, { "stateSubregionCode": "TX9", "stateSubregionName": "TX_SOUTH_EAST" }, { "stateSubregionCode": "TX10", "stateSubregionName": "TX_SOUTH_WEST" }, { "stateSubregionCode": "TX2", "stateSubregionName": "TX_CENTRAL_NORTH" }, { "stateSubregionCode": "TX1", "stateSubregionName": "TX_CENTRAL" }, { "stateSubregionCode": "TX4", "stateSubregionName": "TX_DALLAS" }, { "stateSubregionCode": "TX3", "stateSubregionName": "TX_CENTRAL_WEST" } ] }, { "stateCode": "FL", "stateName": "Florida", "stateSubregions": [ { "stateSubregionCode": "FL2", "stateSubregionName": "FL_CENTRAL_WEST" }, { "stateSubregionCode": "FL1", "stateSubregionName": "FL_CENTRAL_EAST" }, { "stateSubregionCode": "FL4", "stateSubregionName": "FL_NORTH" }, { "stateSubregionCode": "FL3", "stateSubregionName": "FL_MIAMI" }, { "stateSubregionCode": "FL6", "stateSubregionName": "FL_SOUTH_WEST" }, { "stateSubregionCode": "FL5", "stateSubregionName": "FL_SOUTH_EAST" } ] }, { "stateCode": "MS", "stateName": "Mississippi", "stateSubregions": [ { "stateSubregionCode": "MS2", "stateSubregionName": "MS_SOUTH" }, { "stateSubregionCode": "MS1", "stateSubregionName": "MS_NORTH" } ] }, { "stateCode": "AL", "stateName": "Alabama", "stateSubregions": [ { "stateSubregionCode": "AL1", "stateSubregionName": "AL_NORTH" }, { "stateSubregionCode": "AL2", "stateSubregionName": "AL_SOUTH" } ] }, { "stateCode": "VA", "stateName": "Virginia", "stateSubregions": [ { "stateSubregionCode": "VA1", "stateSubregionName": "VA_CENTRAL" }, { "stateSubregionCode": "VA3", "stateSubregionName": "VA_SOUTH_EAST" }, { "stateSubregionCode": "VA2", "stateSubregionName": "VA_NORTH" }, { "stateSubregionCode": "VA4", "stateSubregionName": "VA_SOUTH_WEST" } ] }, { "stateCode": "KY", "stateName": "Kentucky", "stateSubregions": [ { "stateSubregionCode": "KY2", "stateSubregionName": "KY_WEST" }, { "stateSubregionCode": "KY1", "stateSubregionName": "KY_EAST" } ] }, { "stateCode": "SC", "stateName": "South Carolina", "stateSubregions": [ { "stateSubregionCode": "SC2", "stateSubregionName": "SC_NORTH" }, { "stateSubregionCode": "SC1", "stateSubregionName": "SC_CENTRAL" }, { "stateSubregionCode": "SC3", "stateSubregionName": "SC_SOUTH" } ] }, { "stateCode": "AR", "stateName": "Arkansas", "stateSubregions": [ { "stateSubregionCode": "AR2", "stateSubregionName": "AR_WEST" }, { "stateSubregionCode": "AR1", "stateSubregionName": "AR_EAST" } ] }, { "stateCode": "LA", "stateName": "Louisiana", "stateSubregions": [ { "stateSubregionCode": "LA1", "stateSubregionName": "LA_NORTH" }, { "stateSubregionCode": "LA2", "stateSubregionName": "LA_SOUTH" } ] }, { "stateCode": "NC", "stateName": "North Carolina", "stateSubregions": [ { "stateSubregionCode": "NC1", "stateSubregionName": "NC_EAST" }, { "stateSubregionCode": "NC3", "stateSubregionName": "NC_SOUTH" }, { "stateSubregionCode": "NC2", "stateSubregionName": "NC_NORTH" }, { "stateSubregionCode": "NC4", "stateSubregionName": "NC_WEST" } ] }, { "stateCode": "MD", "stateName": "Maryland", "stateSubregions": [ { "stateSubregionCode": "MD1", "stateSubregionName": "MD_CENTRAL" }, { "stateSubregionCode": "MD2", "stateSubregionName": "MD_REST_ALL" } ] }, { "stateCode": "GA", "stateName": "Georgia", "stateSubregions": [ { "stateSubregionCode": "GA2", "stateSubregionName": "GA_CENTRAL" }, { "stateSubregionCode": "GA1", "stateSubregionName": "GA_ATLANTA" }, { "stateSubregionCode": "GA4", "stateSubregionName": "GA_NORTH_WEST" }, { "stateSubregionCode": "GA3", "stateSubregionName": "GA_NORTH_EAST" }, { "stateSubregionCode": "GA5", "stateSubregionName": "GA_SOUTH" } ] }, { "stateCode": "TN", "stateName": "Tennessee", "stateSubregions": [ { "stateSubregionCode": "TN2", "stateSubregionName": "TN_EAST" }, { "stateSubregionCode": "TN1", "stateSubregionName": "TN_CENTRAL" }, { "stateSubregionCode": "TN3", "stateSubregionName": "TN_WEST" } ] }, { "stateCode": "OK", "stateName": "Oklahoma", "stateSubregions": [ { "stateSubregionCode": "OK2", "stateSubregionName": "OK_REST_ALL" }, { "stateSubregionCode": "OK1", "stateSubregionName": "OK_NORTH_EAST" } ] }, { "stateCode": "WV", "stateName": "West Virginia", "stateSubregions": [ { "stateSubregionCode": "WV1", "stateSubregionName": "WV_EAST" }, { "stateSubregionCode": "WV2", "stateSubregionName": "WV_WEST" } ] }, { "stateCode": "DC", "stateName": "District of Columbia", "stateSubregions": [ { "stateSubregionCode": "DC", "stateSubregionName": "DC" } ] } ] }, { "subRegionCode": "WE", "subRegionName": "WE", "states": [ { "stateCode": "WY", "stateName": "Wyoming", "stateSubregions": [ { "stateSubregionCode": "WY", "stateSubregionName": "WY" } ] }, { "stateCode": "OR", "stateName": "Oregon", "stateSubregions": [ { "stateSubregionCode": "OR1", "stateSubregionName": "OR_CENTRAL" }, { "stateSubregionCode": "OR2", "stateSubregionName": "OR_NORTH_WEST" } ] }, { "stateCode": "MT", "stateName": "Montana", "stateSubregions": [ { "stateSubregionCode": "MT", "stateSubregionName": "MT" } ] }, { "stateCode": "NV", "stateName": "Nevada", "stateSubregions": [ { "stateSubregionCode": "NV2", "stateSubregionName": "NV_NORTH" }, { "stateSubregionCode": "NV1", "stateSubregionName": "NV_LAS_VEGAS" }, { "stateSubregionCode": "NV3", "stateSubregionName": "NV_SOUTH" } ] }, { "stateCode": "AZ", "stateName": "Arizona", "stateSubregions": [ { "stateSubregionCode": "AZ1", "stateSubregionName": "AZ_NORTH" }, { "stateSubregionCode": "AZ2", "stateSubregionName": "AZ_PHOENIX" }, { "stateSubregionCode": "AZ3", "stateSubregionName": "AZ_SOUTH" } ] }, { "stateCode": "WA", "stateName": "Washington", "stateSubregions": [ { "stateSubregionCode": "WA", "stateSubregionName": "WA" } ] }, { "stateCode": "ID", "stateName": "Idaho", "stateSubregions": [ { "stateSubregionCode": "ID1", "stateSubregionName": "ID_BOISE_AND_NAMPA" }, { "stateSubregionCode": "ID2", "stateSubregionName": "ID_NORTH_AND_EAST" } ] }, { "stateCode": "CO", "stateName": "Colorado", "stateSubregions": [ { "stateSubregionCode": "CO2", "stateSubregionName": "CO_REST_ALL" }, { "stateSubregionCode": "CO1", "stateSubregionName": "CO_CENTRAL" } ] }, { "stateCode": "CA", "stateName": "California", "stateSubregions": [ { "stateSubregionCode": "CA13", "stateSubregionName": "CA_SAN_DIEGO_COUNTY" }, { "stateSubregionCode": "CA12", "stateSubregionName": "CA_SAN_DIEGO" }, { "stateSubregionCode": "CA11", "stateSubregionName": "CA_SAN_BERNARDINO" }, { "stateSubregionCode": "CA10", "stateSubregionName": "CA_RIVERSIDE_IMPERIAL\t" }, { "stateSubregionCode": "CA2", "stateSubregionName": "CA_CENTRAL_NORTH" }, { "stateSubregionCode": "CA1", "stateSubregionName": "CA_CENTRAL" }, { "stateSubregionCode": "CA4", "stateSubregionName": "CA_CENTRAL_WEST" }, { "stateSubregionCode": "CA3", "stateSubregionName": "CA_CENTRAL_SOUTH" }, { "stateSubregionCode": "CA6", "stateSubregionName": "CA_LOS_ANGELES" }, { "stateSubregionCode": "CA5", "stateSubregionName": "CA_LONG_BEACH" }, { "stateSubregionCode": "CA8", "stateSubregionName": "CA_NORTH" }, { "stateSubregionCode": "CA7", "stateSubregionName": "CA_LOS_ANGELES_VENTURA_COUNTY" }, { "stateSubregionCode": "CA9", "stateSubregionName": "CA_ONTARIO" }, { "stateSubregionCode": "CA15", "stateSubregionName": "CA_SANTA_ANA" }, { "stateSubregionCode": "CA14", "stateSubregionName": "CA_SAN_FRANCISCO" } ] }, { "stateCode": "UT", "stateName": "Utah", "stateSubregions": [ { "stateSubregionCode": "UT1", "stateSubregionName": "UT_NORTH" }, { "stateSubregionCode": "UT2", "stateSubregionName": "UT_SOUTH" } ] }, { "stateCode": "NM", "stateName": "New Mexico", "stateSubregions": [ { "stateSubregionCode": "NM1", "stateSubregionName": "NM_CENTRAL" }, { "stateSubregionCode": "NM2", "stateSubregionName": "NM_REST_ALL" } ] } ] } ] } ], "addressTypes": [ "STREET" ], "transitTime": 3, "tieredShippingCharges": [ { "minLimit": 0, "maxLimit": -1, "shipCharge": { "amount": 0, "currency": "USD" } } ] }, { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "PO_BOX" ], "transitTime": 3, "tieredShippingCharges": [ { "minLimit": 0, "maxLimit": -1, "shipCharge": { "amount": 0, "currency": "USD" } } ] }, { "regions": [ { "regionCode": "H", "regionName": "AK and HI" }, { "regionCode": "P", "regionName": "US Protectorates" } ], "addressTypes": [ "PO_BOX", "STREET" ], "transitTime": 3, "tieredShippingCharges": [ { "minLimit": 0, "maxLimit": -1, "shipCharge": { "amount": 0, "currency": "USD" } } ] }, { "regions": [ { "regionCode": "A", "regionName": "APO/FPO" } ], "addressTypes": [ "MILITARY" ], "transitTime": 3, "tieredShippingCharges": [ { "minLimit": 0, "maxLimit": -1, "shipCharge": { "amount": 0, "currency": "USD" } } ] } ] } ]
}
'

Sample Inactive template

curl --request PUT \ --url https://marketplace.walmartapis.com/v3/settings/shipping/templates/templateId \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "name": "Paid Standard Template 2", "type": "CUSTOM", "rateModelType": "TIERED_PRICING", "status": "INACTIVE", "shippingMethods": [ { "shipMethod": "STANDARD", "status": "ACTIVE", "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "SO", "subRegionName": "SO", "states": [ { "stateCode": "AR", "stateName": "Arkansas", "stateSubregions": [ { "stateSubregionCode": "AR2", "stateSubregionName": "AR_WEST" } ] } ] } ] } ], "addressTypes": [ "STREET" ], "transitTime": 3, "tieredShippingCharges": [ { "minLimit": 0, "maxLimit": -1, "shipCharge": { "amount": 19, "currency": "USD" } } ] }, { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "NE", "subRegionName": "NE", "states": [ { "stateCode": "CT", "stateName": "Connecticut", "stateSubregions": [ { "stateSubregionCode": "CT2", "stateSubregionName": "CT_SOUTH_WEST" }, { "stateSubregionCode": "CT1", "stateSubregionName": "CT_REST_ALL" } ] }, { "stateCode": "PA", "stateName": "Pennsylvania", "stateSubregions": [ { "stateSubregionCode": "PA3", "stateSubregionName": "PA_NORTH_EAST" }, { "stateSubregionCode": "PA2", "stateSubregionName": "PA_CENTRAL_NORTH" }, { "stateSubregionCode": "PA5", "stateSubregionName": "PA_WEST" }, { "stateSubregionCode": "PA4", "stateSubregionName": "PA_SOUTH" }, { "stateSubregionCode": "PA1", "stateSubregionName": "PA_CENTRAL" } ] }, { "stateCode": "MA", "stateName": "Massachusetts", "stateSubregions": [ { "stateSubregionCode": "MA2", "stateSubregionName": "MA_WEST" }, { "stateSubregionCode": "MA1", "stateSubregionName": "MA_EAST" } ] }, { "stateCode": "RI", "stateName": "Rhode Island", "stateSubregions": [ { "stateSubregionCode": "RI", "stateSubregionName": "RI" } ] }, { "stateCode": "ME", "stateName": "Maine", "stateSubregions": [ { "stateSubregionCode": "ME2", "stateSubregionName": "ME_WEST" }, { "stateSubregionCode": "ME1", "stateSubregionName": "ME_EAST" } ] }, { "stateCode": "NH", "stateName": "New Hampshire", "stateSubregions": [ { "stateSubregionCode": "NH", "stateSubregionName": "NH" } ] }, { "stateCode": "NY", "stateName": "New York", "stateSubregions": [ { "stateSubregionCode": "NY1", "stateSubregionName": "NY_BROOKLYN" }, { "stateSubregionCode": "NY3", "stateSubregionName": "NY_NORTH_CENTRAL" }, { "stateSubregionCode": "NY2", "stateSubregionName": "NY_CENTRAL" }, { "stateSubregionCode": "NY5", "stateSubregionName": "NY_SOUTH" }, { "stateSubregionCode": "NY4", "stateSubregionName": "NY_NORTH_WEST" } ] }, { "stateCode": "NJ", "stateName": "New Jersey", "stateSubregions": [ { "stateSubregionCode": "NJ2", "stateSubregionName": "NJ_NORTH" }, { "stateSubregionCode": "NJ1", "stateSubregionName": "NJ_CENTRAL" }, { "stateSubregionCode": "NJ4", "stateSubregionName": "NJ_KEARNY" }, { "stateSubregionCode": "NJ3", "stateSubregionName": "NJ_SOUTH" } ] }, { "stateCode": "VT", "stateName": "Vermont", "stateSubregions": [ { "stateSubregionCode": "VT", "stateSubregionName": "VT" } ] } ] }, { "subRegionCode": "MW", "subRegionName": "MW", "states": [ { "stateCode": "SD", "stateName": "South Dakota", "stateSubregions": [ { "stateSubregionCode": "SD2", "stateSubregionName": "SD_WEST" }, { "stateSubregionCode": "SD1", "stateSubregionName": "SD_EAST" } ] }, { "stateCode": "MN", "stateName": "Minnesota", "stateSubregions": [ { "stateSubregionCode": "MN2", "stateSubregionName": "MN_REST_ALL" }, { "stateSubregionCode": "MN1", "stateSubregionName": "MN_CENTRAL_EAST" } ] }, { "stateCode": "MO", "stateName": "Missouri", "stateSubregions": [ { "stateSubregionCode": "MO3", "stateSubregionName": "MO_WEST" }, { "stateSubregionCode": "MO2", "stateSubregionName": "MO_SOUTH" }, { "stateSubregionCode": "MO1", "stateSubregionName": "MO_EAST" } ] }, { "stateCode": "WI", "stateName": "Wisconsin", "stateSubregions": [ { "stateSubregionCode": "WI2", "stateSubregionName": "WI_WEST" }, { "stateSubregionCode": "WI1", "stateSubregionName": "WI_EAST" } ] }, { "stateCode": "IL", "stateName": "Illinois", "stateSubregions": [ { "stateSubregionCode": "IL5", "stateSubregionName": "IL_SOUTHWEST" }, { "stateSubregionCode": "IL4", "stateSubregionName": "IL_SOUTHEAST" }, { "stateSubregionCode": "IL1", "stateSubregionName": "IL_CHICAGO" }, { "stateSubregionCode": "IL3", "stateSubregionName": "IL_NORTH_WEST" }, { "stateSubregionCode": "IL2", "stateSubregionName": "IL_NORTH_EAST" } ] }, { "stateCode": "IN", "stateName": "Indiana", "stateSubregions": [ { "stateSubregionCode": "IN1", "stateSubregionName": "IN_CENTRAL_AND_EAST" }, { "stateSubregionCode": "IN3", "stateSubregionName": "IN_SOUTH" }, { "stateSubregionCode": "IN2", "stateSubregionName": "IN_NORTH" }, { "stateSubregionCode": "IN4", "stateSubregionName": "IN_WEST" } ] }, { "stateCode": "ND", "stateName": "North Dakota", "stateSubregions": [ { "stateSubregionCode": "ND", "stateSubregionName": "ND" } ] }, { "stateCode": "NE", "stateName": "Nebraska", "stateSubregions": [ { "stateSubregionCode": "NE", "stateSubregionName": "NE" } ] }, { "stateCode": "KS", "stateName": "Kansas", "stateSubregions": [ { "stateSubregionCode": "KS2", "stateSubregionName": "KS_WEST" }, { "stateSubregionCode": "KS1", "stateSubregionName": "KS_EAST" } ] }, { "stateCode": "IA", "stateName": "Iowa", "stateSubregions": [ { "stateSubregionCode": "IA2", "stateSubregionName": "IA_REST" }, { "stateSubregionCode": "IA1", "stateSubregionName": "IA_CENTRAL" } ] }, { "stateCode": "OH", "stateName": "Ohio", "stateSubregions": [ { "stateSubregionCode": "OH1", "stateSubregionName": "OH_CENTRAL" }, { "stateSubregionCode": "OH3", "stateSubregionName": "OH_SOUTH_EAST" }, { "stateSubregionCode": "OH2", "stateSubregionName": "OH_NORTH" }, { "stateSubregionCode": "OH4", "stateSubregionName": "OH_WEST" } ] }, { "stateCode": "MI", "stateName": "Michigan", "stateSubregions": [ { "stateSubregionCode": "MI2", "stateSubregionName": "MI_NORTH" }, { "stateSubregionCode": "MI1", "stateSubregionName": "MI_CENTRAL" }, { "stateSubregionCode": "MI3", "stateSubregionName": "MI_SOUTH_EAST" } ] } ] }, { "subRegionCode": "SO", "subRegionName": "SO", "states": [ { "stateCode": "DE", "stateName": "Delaware", "stateSubregions": [ { "stateSubregionCode": "DE", "stateSubregionName": "DE" } ] }, { "stateCode": "TX", "stateName": "Texas", "stateSubregions": [ { "stateSubregionCode": "TX6", "stateSubregionName": "TX_NORTH_EAST" }, { "stateSubregionCode": "TX5", "stateSubregionName": "TX_HOUSTON" }, { "stateSubregionCode": "TX8", "stateSubregionName": "TX_SOUTH" }, { "stateSubregionCode": "TX7", "stateSubregionName": "TX_NORTH_WEST" }, { "stateSubregionCode": "TX9", "stateSubregionName": "TX_SOUTH_EAST" }, { "stateSubregionCode": "TX10", "stateSubregionName": "TX_SOUTH_WEST" }, { "stateSubregionCode": "TX2", "stateSubregionName": "TX_CENTRAL_NORTH" }, { "stateSubregionCode": "TX1", "stateSubregionName": "TX_CENTRAL" }, { "stateSubregionCode": "TX4", "stateSubregionName": "TX_DALLAS" }, { "stateSubregionCode": "TX3", "stateSubregionName": "TX_CENTRAL_WEST" } ] }, { "stateCode": "FL", "stateName": "Florida", "stateSubregions": [ { "stateSubregionCode": "FL2", "stateSubregionName": "FL_CENTRAL_WEST" }, { "stateSubregionCode": "FL1", "stateSubregionName": "FL_CENTRAL_EAST" }, { "stateSubregionCode": "FL4", "stateSubregionName": "FL_NORTH" }, { "stateSubregionCode": "FL3", "stateSubregionName": "FL_MIAMI" }, { "stateSubregionCode": "FL6", "stateSubregionName": "FL_SOUTH_WEST" }, { "stateSubregionCode": "FL5", "stateSubregionName": "FL_SOUTH_EAST" } ] }, { "stateCode": "MS", "stateName": "Mississippi", "stateSubregions": [ { "stateSubregionCode": "MS2", "stateSubregionName": "MS_SOUTH" }, { "stateSubregionCode": "MS1", "stateSubregionName": "MS_NORTH" } ] }, { "stateCode": "AL", "stateName": "Alabama", "stateSubregions": [ { "stateSubregionCode": "AL1", "stateSubregionName": "AL_NORTH" }, { "stateSubregionCode": "AL2", "stateSubregionName": "AL_SOUTH" } ] }, { "stateCode": "VA", "stateName": "Virginia", "stateSubregions": [ { "stateSubregionCode": "VA1", "stateSubregionName": "VA_CENTRAL" }, { "stateSubregionCode": "VA3", "stateSubregionName": "VA_SOUTH_EAST" }, { "stateSubregionCode": "VA2", "stateSubregionName": "VA_NORTH" }, { "stateSubregionCode": "VA4", "stateSubregionName": "VA_SOUTH_WEST" } ] }, { "stateCode": "KY", "stateName": "Kentucky", "stateSubregions": [ { "stateSubregionCode": "KY2", "stateSubregionName": "KY_WEST" }, { "stateSubregionCode": "KY1", "stateSubregionName": "KY_EAST" } ] }, { "stateCode": "SC", "stateName": "South Carolina", "stateSubregions": [ { "stateSubregionCode": "SC2", "stateSubregionName": "SC_NORTH" }, { "stateSubregionCode": "SC1", "stateSubregionName": "SC_CENTRAL" }, { "stateSubregionCode": "SC3", "stateSubregionName": "SC_SOUTH" } ] }, { "stateCode": "AR", "stateName": "Arkansas", "stateSubregions": [ { "stateSubregionCode": "AR1", "stateSubregionName": "AR_EAST" } ] }, { "stateCode": "LA", "stateName": "Louisiana", "stateSubregions": [ { "stateSubregionCode": "LA1", "stateSubregionName": "LA_NORTH" }, { "stateSubregionCode": "LA2", "stateSubregionName": "LA_SOUTH" } ] }, { "stateCode": "NC", "stateName": "North Carolina", "stateSubregions": [ { "stateSubregionCode": "NC1", "stateSubregionName": "NC_EAST" }, { "stateSubregionCode": "NC3", "stateSubregionName": "NC_SOUTH" }, { "stateSubregionCode": "NC2", "stateSubregionName": "NC_NORTH" }, { "stateSubregionCode": "NC4", "stateSubregionName": "NC_WEST" } ] }, { "stateCode": "MD", "stateName": "Maryland", "stateSubregions": [ { "stateSubregionCode": "MD1", "stateSubregionName": "MD_CENTRAL" }, { "stateSubregionCode": "MD2", "stateSubregionName": "MD_REST_ALL" } ] }, { "stateCode": "GA", "stateName": "Georgia", "stateSubregions": [ { "stateSubregionCode": "GA2", "stateSubregionName": "GA_CENTRAL" }, { "stateSubregionCode": "GA1", "stateSubregionName": "GA_ATLANTA" }, { "stateSubregionCode": "GA4", "stateSubregionName": "GA_NORTH_WEST" }, { "stateSubregionCode": "GA3", "stateSubregionName": "GA_NORTH_EAST" }, { "stateSubregionCode": "GA5", "stateSubregionName": "GA_SOUTH" } ] }, { "stateCode": "TN", "stateName": "Tennessee", "stateSubregions": [ { "stateSubregionCode": "TN2", "stateSubregionName": "TN_EAST" }, { "stateSubregionCode": "TN1", "stateSubregionName": "TN_CENTRAL" }, { "stateSubregionCode": "TN3", "stateSubregionName": "TN_WEST" } ] }, { "stateCode": "OK", "stateName": "Oklahoma", "stateSubregions": [ { "stateSubregionCode": "OK2", "stateSubregionName": "OK_REST_ALL" }, { "stateSubregionCode": "OK1", "stateSubregionName": "OK_NORTH_EAST" } ] }, { "stateCode": "WV", "stateName": "West Virginia", "stateSubregions": [ { "stateSubregionCode": "WV1", "stateSubregionName": "WV_EAST" }, { "stateSubregionCode": "WV2", "stateSubregionName": "WV_WEST" } ] }, { "stateCode": "DC", "stateName": "District of Columbia", "stateSubregions": [ { "stateSubregionCode": "DC", "stateSubregionName": "DC" } ] } ] }, { "subRegionCode": "WE", "subRegionName": "WE", "states": [ { "stateCode": "WY", "stateName": "Wyoming", "stateSubregions": [ { "stateSubregionCode": "WY", "stateSubregionName": "WY" } ] }, { "stateCode": "OR", "stateName": "Oregon", "stateSubregions": [ { "stateSubregionCode": "OR1", "stateSubregionName": "OR_CENTRAL" }, { "stateSubregionCode": "OR2", "stateSubregionName": "OR_NORTH_WEST" } ] }, { "stateCode": "MT", "stateName": "Montana", "stateSubregions": [ { "stateSubregionCode": "MT", "stateSubregionName": "MT" } ] }, { "stateCode": "NV", "stateName": "Nevada", "stateSubregions": [ { "stateSubregionCode": "NV2", "stateSubregionName": "NV_NORTH" }, { "stateSubregionCode": "NV1", "stateSubregionName": "NV_LAS_VEGAS" }, { "stateSubregionCode": "NV3", "stateSubregionName": "NV_SOUTH" } ] }, { "stateCode": "AZ", "stateName": "Arizona", "stateSubregions": [ { "stateSubregionCode": "AZ1", "stateSubregionName": "AZ_NORTH" }, { "stateSubregionCode": "AZ2", "stateSubregionName": "AZ_PHOENIX" }, { "stateSubregionCode": "AZ3", "stateSubregionName": "AZ_SOUTH" } ] }, { "stateCode": "WA", "stateName": "Washington", "stateSubregions": [ { "stateSubregionCode": "WA", "stateSubregionName": "WA" } ] }, { "stateCode": "ID", "stateName": "Idaho", "stateSubregions": [ { "stateSubregionCode": "ID1", "stateSubregionName": "ID_BOISE_AND_NAMPA" }, { "stateSubregionCode": "ID2", "stateSubregionName": "ID_NORTH_AND_EAST" } ] }, { "stateCode": "CO", "stateName": "Colorado", "stateSubregions": [ { "stateSubregionCode": "CO2", "stateSubregionName": "CO_REST_ALL" }, { "stateSubregionCode": "CO1", "stateSubregionName": "CO_CENTRAL" } ] }, { "stateCode": "CA", "stateName": "California", "stateSubregions": [ { "stateSubregionCode": "CA13", "stateSubregionName": "CA_SAN_DIEGO_COUNTY" }, { "stateSubregionCode": "CA12", "stateSubregionName": "CA_SAN_DIEGO" }, { "stateSubregionCode": "CA11", "stateSubregionName": "CA_SAN_BERNARDINO" }, { "stateSubregionCode": "CA10", "stateSubregionName": "CA_RIVERSIDE_IMPERIAL\t" }, { "stateSubregionCode": "CA2", "stateSubregionName": "CA_CENTRAL_NORTH" }, { "stateSubregionCode": "CA1", "stateSubregionName": "CA_CENTRAL" }, { "stateSubregionCode": "CA4", "stateSubregionName": "CA_CENTRAL_WEST" }, { "stateSubregionCode": "CA3", "stateSubregionName": "CA_CENTRAL_SOUTH" }, { "stateSubregionCode": "CA6", "stateSubregionName": "CA_LOS_ANGELES" }, { "stateSubregionCode": "CA5", "stateSubregionName": "CA_LONG_BEACH" }, { "stateSubregionCode": "CA8", "stateSubregionName": "CA_NORTH" }, { "stateSubregionCode": "CA7", "stateSubregionName": "CA_LOS_ANGELES_VENTURA_COUNTY" }, { "stateSubregionCode": "CA9", "stateSubregionName": "CA_ONTARIO" }, { "stateSubregionCode": "CA15", "stateSubregionName": "CA_SANTA_ANA" }, { "stateSubregionCode": "CA14", "stateSubregionName": "CA_SAN_FRANCISCO" } ] }, { "stateCode": "UT", "stateName": "Utah", "stateSubregions": [ { "stateSubregionCode": "UT1", "stateSubregionName": "UT_NORTH" }, { "stateSubregionCode": "UT2", "stateSubregionName": "UT_SOUTH" } ] }, { "stateCode": "NM", "stateName": "New Mexico", "stateSubregions": [ { "stateSubregionCode": "NM1", "stateSubregionName": "NM_CENTRAL" }, { "stateSubregionCode": "NM2", "stateSubregionName": "NM_REST_ALL" } ] } ] } ] } ], "addressTypes": [ "STREET" ], "transitTime": 3, "tieredShippingCharges": [ { "minLimit": 0, "maxLimit": 0.01, "shipCharge": { "amount": 2, "currency": "USD" } }, { "minLimit": 0.02, "maxLimit": -1, "shipCharge": { "amount": 10, "currency": "USD" } } ] } ] } ]
}
'

Sample Region-split `VALUE` tiered

curl --request PUT \ --url https://marketplace.walmartapis.com/v3/settings/shipping/templates/templateId \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "name": "Next Day servc test", "type": "CUSTOM", "rateModelType": "TIERED_PRICING", "status": "ACTIVE", "shippingMethods": [ { "shipMethod": "VALUE", "status": "ACTIVE", "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "transitTime": 6, "tieredShippingCharges": [ { "minLimit": 0, "maxLimit": -1, "shipCharge": { "amount": 0, "currency": "USD" } } ] }, { "regions": [ { "regionCode": "H", "regionName": "AK and HI" } ], "addressTypes": [ "STREET" ], "transitTime": 6, "tieredShippingCharges": [ { "minLimit": 0, "maxLimit": -1, "shipCharge": { "amount": 0, "currency": "USD" } } ] } ] }, { "shipMethod": "STANDARD", "status": "ACTIVE", "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "MW", "subRegionName": "MW", "states": [ { "stateCode": "SD", "stateName": "South Dakota", "stateSubregions": [ { "stateSubregionCode": "SD2", "stateSubregionName": "SD_WEST" }, { "stateSubregionCode": "SD1", "stateSubregionName": "SD_EAST" } ] } ] } ] } ], "addressTypes": [ "STREET" ], "transitTime": 3, "tieredShippingCharges": [ { "minLimit": 10.06, "maxLimit": -1, "shipCharge": { "amount": 2, "currency": "USD" } }, { "minLimit": 0, "maxLimit": 10.05, "shipCharge": { "amount": 1, "currency": "USD" } } ] } ] } ]
}
'

Sample International fulfillment center

curl --request PUT \ --url https://marketplace.walmartapis.com/v3/settings/shipping/templates/templateId \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "name": "Next Day servc", "type": "CUSTOM", "rateModelType": "TIERED_PRICING", "status": "ACTIVE", "shippingType": "INTERNATIONAL", "fulfillmentCenterIds": [ "677435283530285057" ], "shippingMethods": [ { "shipMethod": "STANDARD", "status": "ACTIVE", "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "MW", "subRegionName": "MW", "states": [ { "stateCode": "SD", "stateName": "South Dakota", "stateSubregions": [ { "stateSubregionCode": "SD2", "stateSubregionName": "SD_WEST" }, { "stateSubregionCode": "SD1", "stateSubregionName": "SD_EAST" } ] } ] } ] } ], "addressTypes": [ "STREET" ], "transitTime": 10, "tieredShippingCharges": [ { "minLimit": 10.06, "maxLimit": -1, "shipCharge": { "amount": 2, "currency": "USD" } }, { "minLimit": 0, "maxLimit": 10.05, "shipCharge": { "amount": 1, "currency": "USD" } } ] } ] } ]
}
'

Sample Freight

curl --request PUT \ --url https://marketplace.walmartapis.com/v3/settings/shipping/templates/templateId \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "name": "Freight Template 1", "type": "CUSTOM", "rateModelType": "PER_SHIPMENT_PRICING", "status": "ACTIVE", "shippingMethods": [ { "shipMethod": "FREIGHT", "status": "ACTIVE", "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "transitTime": 7, "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 1, "currency": "USD" }, "chargePerWeight": { "amount": 2, "currency": "USD" } } } ] } ]
}
'

Sample OneDay

curl --request PUT \ --url https://marketplace.walmartapis.com/v3/settings/shipping/templates/templateId \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data '
{ "id": "2023101999000001748", "name": "Paid One Day S3", "type": "CUSTOM", "rateModelType": "PER_SHIPMENT_PRICING", "status": "ACTIVE", "shippingMethods": [ { "shipMethod": "VALUE", "status": "ACTIVE", "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State" } ], "addressTypes": [ "STREET" ], "transitTime": 7, "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } }, { "regions": [ { "regionCode": "H", "regionName": "AK and HI" } ], "addressTypes": [ "STREET" ], "transitTime": 7, "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } ] }, { "shipMethod": "STANDARD", "status": "ACTIVE", "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "MW", "subRegionName": "Midwest", "states": [ { "stateCode": "SD", "stateName": "South Dakota", "stateSubregions": [ { "stateSubregionCode": "SD2", "stateSubregionName": "SD_WEST" } ] }, { "stateCode": "KS", "stateName": "Kansas", "stateSubregions": [ { "stateSubregionCode": "KS2", "stateSubregionName": "KS_WEST" } ] }, { "stateCode": "MO", "stateName": "Missouri", "stateSubregions": [ { "stateSubregionCode": "MO1", "stateSubregionName": "MO_EAST" } ] }, { "stateCode": "MI", "stateName": "Michigan", "stateSubregions": [ { "stateSubregionCode": "MI1", "stateSubregionName": "MI_CENTRAL" } ] }, { "stateCode": "WI", "stateName": "Wisconsin", "stateSubregions": [ { "stateSubregionCode": "WI1", "stateSubregionName": "WI_EAST" } ] }, { "stateCode": "IN", "stateName": "Indiana", "stateSubregions": [ { "stateSubregionCode": "IN2", "stateSubregionName": "IN_NORTH" } ] }, { "stateCode": "IL", "stateName": "Illinois", "stateSubregions": [ { "stateSubregionCode": "IL2", "stateSubregionName": "IL_NORTH_EAST" }, { "stateSubregionCode": "IL1", "stateSubregionName": "IL_CHICAGO" }, { "stateSubregionCode": "IL3", "stateSubregionName": "IL_NORTH_WEST" } ] }, { "stateCode": "ND", "stateName": "North Dakota", "stateSubregions": [ { "stateSubregionCode": "ND", "stateSubregionName": "ND" } ] }, { "stateCode": "NE", "stateName": "Nebraska", "stateSubregions": [ { "stateSubregionCode": "NE", "stateSubregionName": "NE" } ] } ] }, { "subRegionCode": "SO", "subRegionName": "South", "states": [ { "stateCode": "TX", "stateName": "Texas", "stateSubregions": [ { "stateSubregionCode": "TX10", "stateSubregionName": "TX_SOUTH_WEST" }, { "stateSubregionCode": "TX1", "stateSubregionName": "TX_CENTRAL" }, { "stateSubregionCode": "TX3", "stateSubregionName": "TX_CENTRAL_WEST" }, { "stateSubregionCode": "TX2", "stateSubregionName": "TX_CENTRAL_NORTH" }, { "stateSubregionCode": "TX5", "stateSubregionName": "TX_HOUSTON" }, { "stateSubregionCode": "TX4", "stateSubregionName": "TX_DALLAS" }, { "stateSubregionCode": "TX7", "stateSubregionName": "TX_NORTH_WEST" }, { "stateSubregionCode": "TX6", "stateSubregionName": "TX_NORTH_EAST" }, { "stateSubregionCode": "TX9", "stateSubregionName": "TX_SOUTH_EAST" } ] }, { "stateCode": "OK", "stateName": "Oklahoma", "stateSubregions": [ { "stateSubregionCode": "OK1", "stateSubregionName": "OK_NORTH_EAST" }, { "stateSubregionCode": "OK2", "stateSubregionName": "OK_REST_ALL" } ] }, { "stateCode": "GA", "stateName": "Georgia", "stateSubregions": [ { "stateSubregionCode": "GA1", "stateSubregionName": "GA_ATLANTA" }, { "stateSubregionCode": "GA3", "stateSubregionName": "GA_NORTH_EAST" }, { "stateSubregionCode": "GA2", "stateSubregionName": "GA_CENTRAL" } ] }, { "stateCode": "NC", "stateName": "North Carolina", "stateSubregions": [ { "stateSubregionCode": "NC3", "stateSubregionName": "NC_SOUTH" } ] }, { "stateCode": "SC", "stateName": "South Carolina", "stateSubregions": [ { "stateSubregionCode": "SC1", "stateSubregionName": "SC_CENTRAL" }, { "stateSubregionCode": "SC2", "stateSubregionName": "SC_NORTH" } ] }, { "stateCode": "AR", "stateName": "Arkansas", "stateSubregions": [ { "stateSubregionCode": "AR2", "stateSubregionName": "AR_WEST" } ] }, { "stateCode": "AL", "stateName": "Alabama", "stateSubregions": [ { "stateSubregionCode": "AL2", "stateSubregionName": "AL_SOUTH" } ] }, { "stateCode": "FL", "stateName": "Florida", "stateSubregions": [ { "stateSubregionCode": "FL1", "stateSubregionName": "FL_CENTRAL_EAST" }, { "stateSubregionCode": "FL3", "stateSubregionName": "FL_MIAMI" }, { "stateSubregionCode": "FL2", "stateSubregionName": "FL_CENTRAL_WEST" }, { "stateSubregionCode": "FL5", "stateSubregionName": "FL_SOUTH_EAST" }, { "stateSubregionCode": "FL4", "stateSubregionName": "FL_NORTH" }, { "stateSubregionCode": "FL6", "stateSubregionName": "FL_SOUTH_WEST" } ] }, { "stateCode": "TN", "stateName": "Tennessee", "stateSubregions": [ { "stateSubregionCode": "TN3", "stateSubregionName": "TN_WEST" } ] } ] }, { "subRegionCode": "NE", "subRegionName": "Northeast", "states": [ { "stateCode": "NY", "stateName": "New York", "stateSubregions": [ { "stateSubregionCode": "NY1", "stateSubregionName": "NY_BROOKLYN" }, { "stateSubregionCode": "NY3", "stateSubregionName": "NY_NORTH_CENTRAL" }, { "stateSubregionCode": "NY5", "stateSubregionName": "NY_SOUTH" } ] } ] }, { "subRegionCode": "WE", "subRegionName": "West", "states": [ { "stateCode": "NM", "stateName": "New Mexico", "stateSubregions": [ { "stateSubregionCode": "NM2", "stateSubregionName": "NM_REST_ALL" }, { "stateSubregionCode": "NM1", "stateSubregionName": "NM_CENTRAL" } ] }, { "stateCode": "AZ", "stateName": "Arizona", "stateSubregions": [ { "stateSubregionCode": "AZ1", "stateSubregionName": "AZ_NORTH" }, { "stateSubregionCode": "AZ2", "stateSubregionName": "AZ_PHOENIX" }, { "stateSubregionCode": "AZ3", "stateSubregionName": "AZ_SOUTH" } ] }, { "stateCode": "MT", "stateName": "Montana", "stateSubregions": [ { "stateSubregionCode": "MT", "stateSubregionName": "MT" } ] } ] } ] } ], "addressTypes": [ "STREET" ], "transitTime": 3, "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } }, { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "WE", "subRegionName": "West", "states": [ { "stateCode": "UT", "stateName": "Utah", "stateSubregions": [ { "stateSubregionCode": "UT2", "stateSubregionName": "UT_SOUTH" } ] }, { "stateCode": "WY", "stateName": "Wyoming", "stateSubregions": [ { "stateSubregionCode": "WY", "stateSubregionName": "WY" } ] }, { "stateCode": "CO", "stateName": "Colorado", "stateSubregions": [ { "stateSubregionCode": "CO1", "stateSubregionName": "CO_CENTRAL" }, { "stateSubregionCode": "CO2", "stateSubregionName": "CO_REST_ALL" } ] }, { "stateCode": "CA", "stateName": "California", "stateSubregions": [ { "stateSubregionCode": "CA2", "stateSubregionName": "CA_CENTRAL_NORTH" }, { "stateSubregionCode": "CA5", "stateSubregionName": "CA_LONG_BEACH" }, { "stateSubregionCode": "CA8", "stateSubregionName": "CA_NORTH" } ] }, { "stateCode": "NV", "stateName": "Nevada", "stateSubregions": [ { "stateSubregionCode": "NV1", "stateSubregionName": "NV_LAS_VEGAS" }, { "stateSubregionCode": "NV3", "stateSubregionName": "NV_SOUTH" } ] } ] }, { "subRegionCode": "SO", "subRegionName": "South", "states": [ { "stateCode": "TX", "stateName": "Texas", "stateSubregions": [ { "stateSubregionCode": "TX8", "stateSubregionName": "TX_SOUTH" } ] } ] } ] } ], "addressTypes": [ "STREET" ], "transitTime": 4, "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } }, { "regions": [ { "regionCode": "H", "regionName": "AK and HI" } ], "addressTypes": [ "STREET" ], "transitTime": 5, "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } }, { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "WE", "subRegionName": "West", "states": [ { "stateCode": "CA", "stateName": "California", "stateSubregions": [ { "stateSubregionCode": "CA12", "stateSubregionName": "CA_SAN_DIEGO" }, { "stateSubregionCode": "CA11", "stateSubregionName": "CA_SAN_BERNARDINO" }, { "stateSubregionCode": "CA10", "stateSubregionName": "CA_RIVERSIDE_IMPERIAL\t" }, { "stateSubregionCode": "CA1", "stateSubregionName": "CA_CENTRAL" }, { "stateSubregionCode": "CA3", "stateSubregionName": "CA_CENTRAL_SOUTH" }, { "stateSubregionCode": "CA4", "stateSubregionName": "CA_CENTRAL_WEST" }, { "stateSubregionCode": "CA7", "stateSubregionName": "CA_LOS_ANGELES_VENTURA_COUNTY" }, { "stateSubregionCode": "CA6", "stateSubregionName": "CA_LOS_ANGELES" }, { "stateSubregionCode": "CA9", "stateSubregionName": "CA_ONTARIO" }, { "stateSubregionCode": "CA15", "stateSubregionName": "CA_SANTA_ANA" }, { "stateSubregionCode": "CA14", "stateSubregionName": "CA_SAN_FRANCISCO" }, { "stateSubregionCode": "CA13", "stateSubregionName": "CA_SAN_DIEGO_COUNTY" } ] }, { "stateCode": "NV", "stateName": "Nevada", "stateSubregions": [ { "stateSubregionCode": "NV2", "stateSubregionName": "NV_NORTH" } ] }, { "stateCode": "OR", "stateName": "Oregon", "stateSubregions": [ { "stateSubregionCode": "OR1", "stateSubregionName": "OR_CENTRAL" } ] }, { "stateCode": "UT", "stateName": "Utah", "stateSubregions": [ { "stateSubregionCode": "UT1", "stateSubregionName": "UT_NORTH" } ] }, { "stateCode": "ID", "stateName": "Idaho", "stateSubregions": [ { "stateSubregionCode": "ID2", "stateSubregionName": "ID_NORTH_AND_EAST" }, { "stateSubregionCode": "ID1", "stateSubregionName": "ID_BOISE_AND_NAMPA" } ] } ] } ] } ], "addressTypes": [ "STREET" ], "transitTime": 5, "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } ] }, { "shipMethod": "TWO_DAY", "status": "INACTIVE", "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "MW", "subRegionName": "Midwest", "states": [ { "stateCode": "SD", "stateName": "South Dakota", "stateSubregions": [ { "stateSubregionCode": "SD1", "stateSubregionName": "SD_EAST" } ] }, { "stateCode": "MI", "stateName": "Michigan", "stateSubregions": [ { "stateSubregionCode": "MI3", "stateSubregionName": "MI_SOUTH_EAST" }, { "stateSubregionCode": "MI2", "stateSubregionName": "MI_NORTH" } ] }, { "stateCode": "IA", "stateName": "Iowa", "stateSubregions": [ { "stateSubregionCode": "IA1", "stateSubregionName": "IA_CENTRAL" }, { "stateSubregionCode": "IA2", "stateSubregionName": "IA_REST" } ] }, { "stateCode": "WI", "stateName": "Wisconsin", "stateSubregions": [ { "stateSubregionCode": "WI2", "stateSubregionName": "WI_WEST" } ] }, { "stateCode": "IN", "stateName": "Indiana", "stateSubregions": [ { "stateSubregionCode": "IN1", "stateSubregionName": "IN_CENTRAL_AND_EAST" }, { "stateSubregionCode": "IN4", "stateSubregionName": "IN_WEST" }, { "stateSubregionCode": "IN3", "stateSubregionName": "IN_SOUTH" } ] }, { "stateCode": "MN", "stateName": "Minnesota", "stateSubregions": [ { "stateSubregionCode": "MN2", "stateSubregionName": "MN_REST_ALL" }, { "stateSubregionCode": "MN1", "stateSubregionName": "MN_CENTRAL_EAST" } ] }, { "stateCode": "KS", "stateName": "Kansas", "stateSubregions": [ { "stateSubregionCode": "KS1", "stateSubregionName": "KS_EAST" } ] }, { "stateCode": "MO", "stateName": "Missouri", "stateSubregions": [ { "stateSubregionCode": "MO3", "stateSubregionName": "MO_WEST" }, { "stateSubregionCode": "MO2", "stateSubregionName": "MO_SOUTH" } ] }, { "stateCode": "IL", "stateName": "Illinois", "stateSubregions": [ { "stateSubregionCode": "IL4", "stateSubregionName": "IL_SOUTHEAST" }, { "stateSubregionCode": "IL5", "stateSubregionName": "IL_SOUTHWEST" } ] }, { "stateCode": "OH", "stateName": "Ohio", "stateSubregions": [ { "stateSubregionCode": "OH2", "stateSubregionName": "OH_NORTH" }, { "stateSubregionCode": "OH1", "stateSubregionName": "OH_CENTRAL" }, { "stateSubregionCode": "OH4", "stateSubregionName": "OH_WEST" }, { "stateSubregionCode": "OH3", "stateSubregionName": "OH_SOUTH_EAST" } ] } ] }, { "subRegionCode": "SO", "subRegionName": "South", "states": [ { "stateCode": "DE", "stateName": "Delaware", "stateSubregions": [ { "stateSubregionCode": "DE", "stateSubregionName": "DE" } ] }, { "stateCode": "KY", "stateName": "Kentucky", "stateSubregions": [ { "stateSubregionCode": "KY1", "stateSubregionName": "KY_EAST" }, { "stateSubregionCode": "KY2", "stateSubregionName": "KY_WEST" } ] }, { "stateCode": "GA", "stateName": "Georgia", "stateSubregions": [ { "stateSubregionCode": "GA5", "stateSubregionName": "GA_SOUTH" }, { "stateSubregionCode": "GA4", "stateSubregionName": "GA_NORTH_WEST" } ] }, { "stateCode": "NC", "stateName": "North Carolina", "stateSubregions": [ { "stateSubregionCode": "NC2", "stateSubregionName": "NC_NORTH" }, { "stateSubregionCode": "NC1", "stateSubregionName": "NC_EAST" }, { "stateSubregionCode": "NC4", "stateSubregionName": "NC_WEST" } ] }, { "stateCode": "AR", "stateName": "Arkansas", "stateSubregions": [ { "stateSubregionCode": "AR1", "stateSubregionName": "AR_EAST" } ] }, { "stateCode": "WV", "stateName": "West Virginia", "stateSubregions": [ { "stateSubregionCode": "WV2", "stateSubregionName": "WV_WEST" }, { "stateSubregionCode": "WV1", "stateSubregionName": "WV_EAST" } ] }, { "stateCode": "MS", "stateName": "Mississippi", "stateSubregions": [ { "stateSubregionCode": "MS1", "stateSubregionName": "MS_NORTH" }, { "stateSubregionCode": "MS2", "stateSubregionName": "MS_SOUTH" } ] }, { "stateCode": "LA", "stateName": "Louisiana", "stateSubregions": [ { "stateSubregionCode": "LA2", "stateSubregionName": "LA_SOUTH" }, { "stateSubregionCode": "LA1", "stateSubregionName": "LA_NORTH" } ] }, { "stateCode": "SC", "stateName": "South Carolina", "stateSubregions": [ { "stateSubregionCode": "SC3", "stateSubregionName": "SC_SOUTH" } ] }, { "stateCode": "AL", "stateName": "Alabama", "stateSubregions": [ { "stateSubregionCode": "AL1", "stateSubregionName": "AL_NORTH" } ] }, { "stateCode": "VA", "stateName": "Virginia", "stateSubregions": [ { "stateSubregionCode": "VA2", "stateSubregionName": "VA_NORTH" }, { "stateSubregionCode": "VA1", "stateSubregionName": "VA_CENTRAL" }, { "stateSubregionCode": "VA4", "stateSubregionName": "VA_SOUTH_WEST" }, { "stateSubregionCode": "VA3", "stateSubregionName": "VA_SOUTH_EAST" } ] }, { "stateCode": "TN", "stateName": "Tennessee", "stateSubregions": [ { "stateSubregionCode": "TN1", "stateSubregionName": "TN_CENTRAL" }, { "stateSubregionCode": "TN2", "stateSubregionName": "TN_EAST" } ] }, { "stateCode": "MD", "stateName": "Maryland", "stateSubregions": [ { "stateSubregionCode": "MD2", "stateSubregionName": "MD_REST_ALL" }, { "stateSubregionCode": "MD1", "stateSubregionName": "MD_CENTRAL" } ] }, { "stateCode": "DC", "stateName": "District of Columbia", "stateSubregions": [ { "stateSubregionCode": "DC", "stateSubregionName": "DC" } ] } ] }, { "subRegionCode": "NE", "subRegionName": "Northeast", "states": [ { "stateCode": "NY", "stateName": "New York", "stateSubregions": [ { "stateSubregionCode": "NY2", "stateSubregionName": "NY_CENTRAL" }, { "stateSubregionCode": "NY4", "stateSubregionName": "NY_NORTH_WEST" } ] }, { "stateCode": "PA", "stateName": "Pennsylvania", "stateSubregions": [ { "stateSubregionCode": "PA2", "stateSubregionName": "PA_CENTRAL_NORTH" }, { "stateSubregionCode": "PA1", "stateSubregionName": "PA_CENTRAL" }, { "stateSubregionCode": "PA4", "stateSubregionName": "PA_SOUTH" }, { "stateSubregionCode": "PA3", "stateSubregionName": "PA_NORTH_EAST" }, { "stateSubregionCode": "PA5", "stateSubregionName": "PA_WEST" } ] } ] } ] } ], "addressTypes": [ "STREET" ], "transitTime": 2, "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 0, "currency": "USD" }, "chargePerWeight": { "amount": 0, "currency": "USD" } } } ] }, { "shipMethod": "ONE_DAY", "status": "INACTIVE", "configurations": [ { "regions": [ { "regionName": "48 State", "regionCode": "C", "subRegions": [ { "subRegionCode": "SO", "states": [ { "stateCode": "DE", "stateSubregions": [ { "stateSubregionCode": "DE" } ] }, { "stateCode": "TX", "stateSubregions": [ { "stateSubregionCode": "TX1" }, { "stateSubregionCode": "TX5" }, { "stateSubregionCode": "TX7" }, { "stateSubregionCode": "TX3" }, { "stateSubregionCode": "TX8" }, { "stateSubregionCode": "TX4" }, { "stateSubregionCode": "TX2" }, { "stateSubregionCode": "TX9" }, { "stateSubregionCode": "TX6" }, { "stateSubregionCode": "TX10" } ] }, { "stateCode": "MS", "stateSubregions": [ { "stateSubregionCode": "MS1" }, { "stateSubregionCode": "MS2" } ] }, { "stateCode": "FL", "stateSubregions": [ { "stateSubregionCode": "FL2" }, { "stateSubregionCode": "FL1" }, { "stateSubregionCode": "FL4" }, { "stateSubregionCode": "FL6" }, { "stateSubregionCode": "FL5" }, { "stateSubregionCode": "FL3" } ] }, { "stateCode": "AL", "stateSubregions": [ { "stateSubregionCode": "AL1" }, { "stateSubregionCode": "AL2" } ] }, { "stateCode": "VA", "stateSubregions": [ { "stateSubregionCode": "VA3" }, { "stateSubregionCode": "VA2" }, { "stateSubregionCode": "VA1" }, { "stateSubregionCode": "VA4" } ] }, { "stateCode": "KY", "stateSubregions": [ { "stateSubregionCode": "KY2" }, { "stateSubregionCode": "KY1" } ] }, { "stateCode": "SC", "stateSubregions": [ { "stateSubregionCode": "SC2" }, { "stateSubregionCode": "SC3" }, { "stateSubregionCode": "SC1" } ] }, { "stateCode": "AR", "stateSubregions": [ { "stateSubregionCode": "AR1" }, { "stateSubregionCode": "AR2" } ] }, { "stateCode": "LA", "stateSubregions": [ { "stateSubregionCode": "LA1" }, { "stateSubregionCode": "LA2" } ] }, { "stateCode": "NC", "stateSubregions": [ { "stateSubregionCode": "NC2" }, { "stateSubregionCode": "NC3" }, { "stateSubregionCode": "NC4" }, { "stateSubregionCode": "NC1" } ] }, { "stateCode": "MD", "stateSubregions": [ { "stateSubregionCode": "MD1" }, { "stateSubregionCode": "MD2" } ] }, { "stateCode": "GA", "stateSubregions": [ { "stateSubregionCode": "GA4" }, { "stateSubregionCode": "GA5" }, { "stateSubregionCode": "GA1" }, { "stateSubregionCode": "GA2" }, { "stateSubregionCode": "GA3" } ] }, { "stateCode": "TN", "stateSubregions": [ { "stateSubregionCode": "TN2" }, { "stateSubregionCode": "TN1" }, { "stateSubregionCode": "TN3" } ] }, { "stateCode": "OK", "stateSubregions": [ { "stateSubregionCode": "OK1" }, { "stateSubregionCode": "OK2" } ] }, { "stateCode": "WV", "stateSubregions": [ { "stateSubregionCode": "WV2" }, { "stateSubregionCode": "WV1" } ] }, { "stateCode": "DC", "stateSubregions": [ { "stateSubregionCode": "DC" } ] } ] } ] } ], "addressTypes": [ "STREET" ], "transitTime": 1, "perShippingCharge": { "unitOfMeasure": "LB", "shippingAndHandling": { "amount": 101, "currency": "USD" }, "chargePerItem": { "amount": 101, "currency": "USD" } } } ] } ]
}

Modify your code

Below are practical changes you can make to sample cURL requests so they execute against an environment and return a result. Do not change the JSON body content, only change the runtime headers and path parameter values.

Replace the templateId in the URL with the template ID you want to update.

Example
```
.../templates/91233632243720193
```
```
../templates/91233632243720193
```
Add an Authorization header with a valid token (most Marketplace APIs require OAuth/Bearer tokens).

Example (insert your real token)
```
--header 'Authorization: Bearer <ACCESS_TOKEN>'
```
(Optional) Add any environment or developer headers your integration requires (for example developer or consumer ID headers). If you have custom headers for your environment, include them as needed.
Enable verbose output to see status, headers and response (helpful in debugging):
1. Add -i to show response headers and status.
2. Add -v for verbose curl output.
If you need to debug the server response only (no body changes), use a lightweight test body (or the same body) and inspect the HTTP status codes:
1. 200 OK indicates success (see the Response sample).
2. 4xx indicates client error: Check JSON validity, required fields, or authentication.
3. 5xx indicates server error: Retry later or contact API support.
When testing in a sandbox environment, ensure you switch the base URL to the sandbox endpoint if one exists for Marketplace (your internal docs / platform team will have the exact sandbox URL).

Sample response

The following example shows a representative 200 OK response for a successful international template creation request.

{ "id": "91233632243720193", "name": "Next Day servc", "type": "CUSTOM", "rateModelType": "TIERED_PRICING", "status": "ACTIVE", "shippingType": "INTERNATIONAL", "fcDetails": { "countryName": "India", "isoCountryCode": "IN", "fulfillmentCenterIds": [ "677435283530285057" ] }, "shippingMethods": [ { "shipMethod": "STANDARD", "status": "ACTIVE", "configurations": [ { "regions": [ { "regionCode": "C", "regionName": "48 State", "subRegions": [ { "subRegionCode": "MW", "subRegionName": "MW", "states": [ { "stateCode": "SD", "stateName": "South Dakota", "stateSubregions": [ { "stateSubregionCode": "SD2", "stateSubregionName": "SD_WEST" }, { "stateSubregionCode": "SD1", "stateSubregionName": "SD_EAST" } ] } ] } ] } ], "addressTypes": [ "STREET" ], "transitTime": 10, "tieredShippingCharges": [ { "minLimit": 10.06, "maxLimit": -1, "shipCharge": { "amount": 2, "currency": "USD" } }, { "minLimit": 0, "maxLimit": 10.05, "shipCharge": { "amount": 1, "currency": "USD" } } ] } ] } ]
}

Result

After a successful request:

A unique template ID is generated.
The template is stored in the seller account.
The template can be activated if it was created as inactive.
The template can be assigned to fulfillment centers or used in shipping strategy configurations.
International templates include fcDetails.

Next steps

The Get shipping template details API gives you specific shipping configurations for a single shipping template.

The Update shipping templates API lets you modify configurations on an existing shipping template, such as shipping methods, regions, transit times, and pricing rules.

The Delete shipping templates API lets you permanently remove existing shipping templates from Walmart Marketplace settings.

The Get all fulfillment centers API retrieves fulfillment centers (also known as ship nodes) information on your account.

The Update fulfillment center API helps you update your existing fulfillment centers (also known as a ship nodes) configuration in Marketplace Settings.

The Create fulfillment center API sets up new fulfillment centers (also known as ship nodes) in Walmart Marketplace Settings.

The Get account level settings API retrieves account-level shipping settings such as calendar day configurations, weekends, and additional days off.

The Update account level settings API allows you to configure account-level calendar settings that impact shipping calculations and delivery promise logic.

The Create account level settings API lets you establish account level calendar configuration for your shipping operations.

The Get all shipping templates API retrieves a list of all shipping templates configured on your account.

The Third-party fulfillment center association API allows sellers to activate or update the status of 3PL (third-party logistics) ship nodes associated with your Marketplace account.

The Get shipping configurations API retrieves account-level shipping profile settings associated on your account.

The Get shipping template activation status API allows sellers to retrieve the current activation state of shipping templates at the account level.

The Get coverage for fulfillment centers API retrieves the geographic coverage areas associated with each fulfillment center (ship node) configured under a seller account.

The Get carrier methods API retrieves the list of carrier methods available for use in Marketplace shipping configurations

The Get all third-party fulfillment providers API retrieves all third-party fulfillment providers (3PLs) available on the Walmart marketplace.

The Get partner configurations API retrieves seller-level profile information and system configuration settings associated with a Marketplace partner account.

The Entity match API gives Payout Service Providers (PSPs) access to seller entity data.

Updated 22 days ago

Did this page help you?