• Docs
    • Marketplace
    • DSV
      • API
      • EDI
    • Warehouse
    • Content Providers
  • Tools
    • Sandbox
    • Try It Out
  • What's New
  • Help
  • My Account
  • US
    • MX
    • CA

Select Login Type

Marketplace
DSV and Warehouse

What's Coming

  • « Additional Scenarios for Precise Delivery
  • Item Search API »

New Features for Precise Delivery

Jul 22 2020

Introduction

As a part of the Precise Delivery program, we are bringing new features for Marketplace sellers that will enable sellers to support a fast and precise delivery experience. This program aims to bridge the gap between promise and actual delivery time by giving granular region level customisation capability to the sellers for their assortment and fulfilment options management.

Capabilities included as a part of the new features are –

  • Sellers can CREATE and MANAGE ship-settings as Shipping Template
  • Sellers can assign custom SKUs to Shipping Template via Bulk Upload/API or ItemSpec
  • Sellers can get visibility into Item to Ship-template mapping details through Reports

 

Timelines and Updates

The changes are targeted to be available in production by late-September 2020. API specification below is for early preview, so you can plan your development, prior to the actual release. If there are any API changes prior to release based on integrator's feedback, they will be updated in this page itself.


API Specification

S.No.

Features

Applicable To

API Specifications 

1

Template Creation & Management 

  • MP Sellers 
  • Channel Partners 
  • Deliverr

Get ALL ShipTemplates

Get Details of a Shipping Template

Create Shipping Template

Update Shipping Template

Delete a shipping template

2

Assign custom SKUs to Shipping Template via Bulk Upload/API

  • MP Sellers 
  • Channel Partners 

SKU to Template Association

3

Deliverr Overrides 

  • Deliverr ONLY 

Sample Deliverr Request

4

Configuration Reports 

  • MP Sellers
  • Channel Partners
  • Deliverr
Shipping Configuration Report
Shipping Program Report



Base URL - https://marketplace.walmartapis.com/v3/settings/shipping

API Headers

Accept */*
Authentication Headers <<Authentication Headers>>
Content Type application/json
Host marketplace.walmartapis.com



Request/Response JSON Parameter Details

JSON Key

Type

Sample Value

Description

id

String

4557281627891219

Shipping Template ID

name

String

West Coast template

Shipping Template Name

type

String

  • CUSTOM
  • DEFAULT

Shipping Template Type

status

String

  • ACTIVE
  • INACTIVE

Shipping Template/ Configurations active or inactive status

createdDate

String

1594630961156

Template Creation Date

modifiedDate

String

1594630961156

Template Modified Date

totalRecords

String

123

Total Number of records in the response of the API.

rateModelType

String

  • TIERED_PRICING
  • PER_SHIPMENT_PRICING

This is the shipping model type.

  • TIERED_PRICING: This model means that you charge shipping based on the price of the item
  • PER_SHIPMENT_PRICING: This model means that you charge shipping based on the weight of your items (per pound), or you charge shipping based on the number of items purchased in an order
shippingMethods

Array of Object

 

Array of different ship methods of a Shipping Template

shipMethod

String

VALUE

STANDARD

TWO_DAY

FREIGHT

VALUE: All Marketplace Sellers must offer Value shipping to Walmart.com customers for items that can't ship within expected transit times for standard shipping.

STANDARD: You are required to offer standard shipping to Walmart.com customers. 
TWO_DAY: If approved for this option, you'll provide free 2-day shipping to customers and your items will be enabled with the TwoDay delivery tag.

FREIGHT: Heavy items which takes 8,9,10 days.

configurations

Array of Object

{}

Contains an array of Regions, an array of Address Type, Transit Time and Per shipping charge or array of Tired Shipping Charge

regions

Array of Object

 

Supported Regions includes 48 State Street, 48 State – Street Po Box/Street, AK and HI – Street etc

regionCode

String

C

Supported Region Code

regionName

String

48 State

Supported Region Name

subRegions

Array of Objects

 

Supported Sub-region

subRegionCode

String

NE

Supported Sub-region Code

subRegionName

String

NE

Supported Sub-region Name

states

Array Of Objects

 

Supported States

stateCode

String

PA

Supported State Code

stateName

String

Pennsylvania

Supported State Name

stateSubregions

Array of Objects

 

Supported Subregions of a State

stateSubregionCode

String

PA3

Supported state subregion code

stateSubregionName

String

PA3

Supported state subregion name

addressType

String

·         PO_BOX

·         STREET

·         MILITARY

Supported address type

transitTime

Number

1

Time in transit

perShippingCharge

Object

 

Charge per shipping

unitOfMeasure

String

LB

Unit of Measure

shippingAndHandling

Object

 

Shipping and Handling Charge Object

amount

Number

0.05

The numerical amount for that charge. Example: 9.99

currency

String

USD

The type of currency for the charge. Example: USD for US Dollars

chargePerWeight

Object

 

Per Weight Charge

chargePerItem

Object

 

Per Item Charge

tieredShippingCharges

Object

 

Shipping Charges

minLimit

Number

 

minimum Limit

maxLimit

Number

 

Maximum Limit

shipCharge

Object

 

Details of Shipping Charge



Get All Shipping Templates

Use Case

Get all the shipping template for a Seller

Prerequisites

1.       Deliverr Partner must use delegated access for invoking this API with proper External Headers

2.       Seller must use seller authentications while using this API with proper External Headers

Conditions

1.       Deliverr will be able to see only Deliverr Templates

2.       Partner will be able to see Deliverr, Custom and Default Template

Api Uri

https://marketplace.walmartapis.com/v3/settings/shipping/templates?mediaType={mediaType}

Request Parameters

 

Request Parameter

Optional

Sample Values

Comments

mediaType

Yes

csv

Can be supplied to specify the format of response

Http Method

GET

Request Payload

NA

Response Body

{

    "shippingTemplates": [

        {

            "id": "6149582897525423",

            "name": "Custom Template 1",

            "type": "CUSTOM",

            "status": "ACTIVE",

            "rateModelType": "TIERED_PRICING",

            "createdDate": "1594378810740",

            "modifiedDate": "1594378810740"

        },

        {

            "id": "24451553786425",

            "name": "Custom template AM 1",

            "type": "CUSTOM",

            "status": "INACTIVE",

            "rateModelType": "TIERED_PRICING",

            "createdDate": "1594402467708",

            "modifiedDate": "1594819837077"

        }

    ],

    "totalRecords": "2"

}



Get Details of A Shipping Template

Use Case

Get details of the specific template

Prerequisites

  1. Deliverr Partner Must use delegated access for invoking this Apis with proper External Headers
  2. Seller Must use seller authentications while using this Api with proper External Headers

Conditions

  1. Deliverr will be able to see details for DELIVERR Templates
  2. Partner will be able to see details of DELIVERR, CUSTOM and DEFAULT Template

Api Uri

https://marketplace.walmartapis.com/v3/settings/shipping/templates/{templateId}

Request Parameters

 

Request Parameter

Optional

Sample Values

Comments

templateId

No

6403347396979011

Shipping Template Id

Http Method

GET

Request Payload

NA

Response Body

{
    "id": "5235903149749704",
    "name": "Transit Time Template",
    "type": "CUSTOM",
    "rateModelType": "TIERED_PRICING",
    "status": "ACTIVE",
    "shippingMethods": [
        {
            "shipMethod": "VALUE",
            "status": "ACTIVE",
            "configurations": [
                {
                    "regions": [
                        {
                            "regionCode": "C",
                            "regionName": "48 State"
                        }
                    ],
                    "addressType": [
                        "STREET"
                    ],
                    "transitTime": 6,
                    "tieredShippingCharges": [
                        {
                            "minLimit": 0.0,
                            "maxLimit": -1,
                            "shipCharge": {
                                "amount": 0.0,
                                "currency": "USD"
                            }
                        }
                    ]
                }
            ]
        },
        {
            "shipMethod": "STANDARD",
            "status": "ACTIVE",
            "configurations": [
                {
                    "regions": [
                        {
                            "regionCode": "C",
                            "regionName": "48 State",
                            "subRegions": [
                                {
                                    "subRegionCode": "NE",
                                    "subRegionName": "NE",
                                    "states": [
                                        {
                                            "stateCode": "PA",
                                            "stateName": "Pennsylvania",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "PA4",
                                                    "stateSubregionName": "PA4"
                                                },
                                                {
                                                    "stateSubregionCode": "PA1",
                                                    "stateSubregionName": "PA1"
                                                }
                                            ]
                                        },
                                        {
                                            "stateCode": "CT",
                                            "stateName": "Connecticut",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "CT2",
                                                    "stateSubregionName": "CT2"
                                                }
                                            ]
                                        }
                                    ]
                                },
                                {
                                    "subRegionCode": "MW",
                                    "subRegionName": "MW",
                                    "states": [
                                        {
                                            "stateCode": "SD",
                                            "stateName": "South Dakota",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "SD1",
                                                    "stateSubregionName": "SD1"
                                                }
                                            ]
                                        }
                                    ]
                                }
                            ]
                        }
                    ],
                    "addressType": [
                        "STREET"
                    ],
                    "transitTime": 4,
                    "tieredShippingCharges": [
                        {
                            "minLimit": 5.01,
                            "maxLimit": -1,
                            "shipCharge": {
                                "amount": 0.13,
                                "currency": "USD"
                            }
                        },
                        {
                            "minLimit": 0.0,
                            "maxLimit": 5,
                            "shipCharge": {
                                "amount": 0.11,
                                "currency": "USD"
                            }
                        }
                    ]
                },
                {
                    "regions": [
                        {
                            "regionCode": "C",
                            "regionName": "48 State",
                            "subRegions": [
                                {
                                    "subRegionCode": "NE",
                                    "subRegionName": "NE",
                                    "states": [
                                        {
                                            "stateCode": "PA",
                                            "stateName": "Pennsylvania",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "PA3",
                                                    "stateSubregionName": "PA3"
                                                }
                                            ]
                                        },
                                        {
                                            "stateCode": "CT",
                                            "stateName": "Connecticut",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "CT1",
                                                    "stateSubregionName": "CT1"
                                                }
                                            ]
                                        }
                                    ]
                                },
                                {
                                    "subRegionCode": "MW",
                                    "subRegionName": "MW",
                                    "states": [
                                        {
                                            "stateCode": "SD",
                                            "stateName": "South Dakota",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "SD2",
                                                    "stateSubregionName": "SD2"
                                                }
                                            ]
                                        }
                                    ]
                                }
                            ]
                        }
                    ],
                    "addressType": [
                        "STREET"
                    ],
                    "transitTime": 3,
                    "tieredShippingCharges": [
                        {
                            "minLimit": 0.0,
                            "maxLimit": 10,
                            "shipCharge": {
                                "amount": 1.0,
                                "currency": "USD"
                            }
                        },
                        {
                            "minLimit": 10.01,
                            "maxLimit": -1,
                            "shipCharge": {
                                "amount": 2.05,
                                "currency": "USD"
                            }
                        }
                    ]
                },
                {
                    "regions": [
                        {
                            "regionCode": "H",
                            "regionName": "AK and HI"
                        },
                        {
                            "regionCode": "C",
                            "regionName": "48 State"
                        },
                        {
                            "regionCode": "P",
                            "regionName": "US Protectorates"
                        }
                    ],
                    "addressType": [
                        "PO_BOX"
                    ],
                    "transitTime": 5,
                    "tieredShippingCharges": [
                        {
                            "minLimit": 5.01,
                            "maxLimit": -1,
                            "shipCharge": {
                                "amount": 0.13,
                                "currency": "USD"
                            }
                        },
                        {
                            "minLimit": 0.0,
                            "maxLimit": 5,
                            "shipCharge": {
                                "amount": 0.11,
                                "currency": "USD"
                            }
                        }
                    ]
                },
                {
                    "regions": [
                        {
                            "regionCode": "P",
                            "regionName": "US Protectorates"
                        },
                        {
                            "regionCode": "H",
                            "regionName": "AK and HI"
                        },
                        {
                            "regionCode": "C",
                            "regionName": "48 State",
                            "subRegions": [
                                {
                                    "subRegionCode": "NE",
                                    "subRegionName": "NE",
                                    "states": [
                                        {
                                            "stateCode": "CT",
                                            "stateName": "Connecticut",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "CT2",
                                                    "stateSubregionName": "CT2"
                                                }
                                            ]
                                        },
                                        {
                                            "stateCode": "PA",
                                            "stateName": "Pennsylvania",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "PA2",
                                                    "stateSubregionName": "PA2"
                                                }
                                            ]
                                        }
                                    ]
                                }
                            ]
                        }
                    ],
                    "addressType": [
                        "STREET"
                    ],
                    "transitTime": 3,
                    "tieredShippingCharges": [
                        {
                            "minLimit": 0.0,
                            "maxLimit": 10,
                            "shipCharge": {
                                "amount": 5.0,
                                "currency": "USD"
                            }
                        },
                        {
                            "minLimit": 10.01,
                            "maxLimit": -1,
                            "shipCharge": {
                                "amount": 6.05,
                                "currency": "USD"
                            }
                        }
                    ]
                }
            ]
        }
    ],
    "createdBy": "am@gmail.com",
    "modifiedBy": "gm@gmail.com",
    "createdDate": "1595309580126",
    "modifiedDate": "1595319509156"
}



Create Shipping Template

Use Case

Create a new shipping template

Prerequisites

  1. Deliverr Partner Must use delegated access for invoking this Apis with proper External Headers
  2. Seller Must use seller authentications while using this Api with proper External Headers
  3. WHEN DELIVERR invokes "CREATE SHIPPING TEMPLATE" API , the attribute "type" in the request payload needs to be set as "DELIVERR" 
  4. When PARTNER invokes "CREATE SHIPPING TEMPLATE" API , the attribute "type" in the request payload needs to be set as " CUSTOM"

Conditions

  • Partner can create total 15 CUSTOM templates.
  • Deliverr can create total 4 DELIVERR templates per partner.
  • Deliverr cannot create Freight Shipping Templates.
  • "type" attribute in the request payload of the Shipping Template cannot be updated.
  • Partner can update DEFAULT, CUSTOM and DELIVERR shipping Templates.
  • Deliverr can only update DELIVERR Templates (Type attribute of template differentiates between DEFAULT, CUSTOM and DELIVERR templates)
  • A CUSTOM shipping template can have two combinations of Ship method
    • Only Freight Ship Method
    • Value and any other Ship Methods (Except Freight)
  • The DEFAULT shipping template cannot be disabled
  • The DEFAULT shipping template cannot be deleted.
  • The DEFAULT shipping template cannot be created.
  • Only Alphanumeric characters (a-z, A-Z, 0-9) and spaces allowed in the template name.Spaces will be trimmed. Spaces will be removed from the start and end of the name. Name having only spaces will be considered empty
  • Max Template length Allowed 25 chars
  • Template Name must be unique for a seller, and it is case insensitive
  • Shipping Methods: Only below given shipping methods and transit time combinations are allowed

Method

Transit time

VALUE

6, 7

STANDARD

3,4,5

TWO_DAY

2

FREIGHT

8, 9, 10

 

  • Freight Shipping method is only allowed for Custom templates.
  • For Freight , No granular Subregions supported
  • Expedited Shipping method is only allowed for Sellers approved on Two Day Program.
  • Free shipping always for Expedited Shipping Methods(Both rate models).
  • Max Charges allowed for a shipMethods.

 

Method

Shipping and handling

Charge per weight

Charge per Item

Tiered Charges

VALUE

0

0

0

0

Standard

200

200

200

200

Expedited

0

0

0

0

Freight

200

200

200

200

 

  • Only Non Negative values are allowed are in shipping Charges.
  • Value Ship-method
    • Must have only one shipping rule.
    • Value Ship-method should have only 48 STATE region and address type should be STREET.
    • For VALUE ship method No granular subregions supported.
    • Free shipping always for Value Shipping Methods(Both rate models).
  • Standard Ship method : Granular subregions must be supplied for 48 states and address type Street.
  • No Granular subregion support for regions : HI and AK, Street, US Protec, APO/FPO.
  • No Granular subregion support for 48 States PO BOX.
  • No Overlapping of areas allowed in different shipping rules for the same shipping method in a template.
  • If the attribute "rateModelType" is set to "TIERED_PRICING" then only a list of Tiered shipping charges must be supplied.
  • 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 the range of "minLimit" to "maxLimit" for the attribute "tieredShippingCharges" should be continuous. -1 for attribute "maxLimit" indicates highest Value. Example Below :-

 

{
  "tieredShippingCharges": [
    {
      "minLimit": 0,
      "maxLimit": 5,
      "shipCharge": {
        "currencyAmount": 0.1,
        "currencyUnit": "USD"
      }
    },
    {
      "minLimit": 5.01,
      "maxLimit": -1,
      "shipCharge": {
        "currencyAmount": 0.1,
        "currencyUnit": "USD"
      }
    }
  ]
}

 

Api Uri

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

Request Parameters

 

Http Method

POST

Request Payload

{
    "name": "Transit Time Template Custom 2",
    "type": "CUSTOM",
    "rateModelType": "TIERED_PRICING",
    "status": "ACTIVE",
    "shippingMethods": [
        {
            "shipMethod": "VALUE",
            "status": "ACTIVE",
            "configurations": [
                {
                    "regions": [
                        {
                            "regionCode": "C",
                            "regionName": "48 State"
                        }
                    ],
                    "addressType": [
                        "STREET"
                    ],
                    "transitTime": 6,
                    "tieredShippingCharges": [
                        {
                            "minLimit": 0.0,
                            "maxLimit": -1,
                            "shipCharge": {
                                "amount": 0.0,
                                "currency": "USD"
                            }
                        }
                    ]
                }
            ]
        },
        {
            "shipMethod": "STANDARD",
            "status": "ACTIVE",
            "configurations": [
                {
                    "regions": [
                        {
                            "regionCode": "C",
                            "regionName": "48 State",
                            "subRegions": [
                                {
                                    "subRegionCode": "NE",
                                    "subRegionName": "NE",
                                    "states": [
                                        {
                                            "stateCode": "PA",
                                            "stateName": "Pennsylvania",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "PA4",
                                                    "stateSubregionName": "PA4"
                                                },
                                                {
                                                    "stateSubregionCode": "PA1",
                                                    "stateSubregionName": "PA1"
                                                }
                                            ]
                                        },
                                        {
                                            "stateCode": "CT",
                                            "stateName": "Connecticut",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "CT2",
                                                    "stateSubregionName": "CT2"
                                                }
                                            ]
                                        }
                                    ]
                                },
                                {
                                    "subRegionCode": "MW",
                                    "subRegionName": "MW",
                                    "states": [
                                        {
                                            "stateCode": "SD",
                                            "stateName": "South Dakota",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "SD1",
                                                    "stateSubregionName": "SD1"
                                                }
                                            ]
                                        }
                                    ]
                                }
                            ]
                        }
                    ],
                    "addressType": [
                        "STREET"
                    ],
                    "transitTime": 4,
                    "tieredShippingCharges": [
                        {
                            "minLimit": 5.01,
                            "maxLimit": -1,
                            "shipCharge": {
                                "amount": 0.13,
                                "currency": "USD"
                            }
                        },
                        {
                            "minLimit": 0.0,
                            "maxLimit": 5,
                            "shipCharge": {
                                "amount": 0.11,
                                "currency": "USD"
                            }
                        }
                    ]
                },
                {
                    "regions": [
                        {
                            "regionCode": "C",
                            "regionName": "48 State",
                            "subRegions": [
                                {
                                    "subRegionCode": "NE",
                                    "subRegionName": "NE",
                                    "states": [
                                        {
                                            "stateCode": "PA",
                                            "stateName": "Pennsylvania",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "PA3",
                                                    "stateSubregionName": "PA3"
                                                }
                                            ]
                                        },
                                        {
                                            "stateCode": "CT",
                                            "stateName": "Connecticut",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "CT1",
                                                    "stateSubregionName": "CT1"
                                                }
                                            ]
                                        }
                                    ]
                                },
                                {
                                    "subRegionCode": "MW",
                                    "subRegionName": "MW",
                                    "states": [
                                        {
                                            "stateCode": "SD",
                                            "stateName": "South Dakota",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "SD2",
                                                    "stateSubregionName": "SD2"
                                                }
                                            ]
                                        }
                                    ]
                                }
                            ]
                        }
                    ],
                    "addressType": [
                        "STREET"
                    ],
                    "transitTime": 3,
                    "tieredShippingCharges": [
                        {
                            "minLimit": 0.0,
                            "maxLimit": 10,
                            "shipCharge": {
                                "amount": 1.0,
                                "currency": "USD"
                            }
                        },
                        {
                            "minLimit": 10.01,
                            "maxLimit": -1,
                            "shipCharge": {
                                "amount": 2.05,
                                "currency": "USD"
                            }
                        }
                    ]
                },
                {
                    "regions": [
                        {
                            "regionCode": "H",
                            "regionName": "AK and HI"
                        },
                        {
                            "regionCode": "C",
                            "regionName": "48 State"
                        },
                        {
                            "regionCode": "P",
                            "regionName": "US Protectorates"
                        }
                    ],
                    "addressType": [
                        "PO_BOX"
                    ],
                    "transitTime": 5,
                    "tieredShippingCharges": [
                        {
                            "minLimit": 5.01,
                            "maxLimit": -1,
                            "shipCharge": {
                                "amount": 0.13,
                                "currency": "USD"
                            }
                        },
                        {
                            "minLimit": 0.0,
                            "maxLimit": 5,
                            "shipCharge": {
                                "amount": 0.11,
                                "currency": "USD"
                            }
                        }
                    ]
                },
                {
                    "regions": [
                        {
                            "regionCode": "P",
                            "regionName": "US Protectorates"
                        },
                        {
                            "regionCode": "H",
                            "regionName": "AK and HI"
                        },
                        {
                            "regionCode": "C",
                            "regionName": "48 State",
                            "subRegions": [
                                {
                                    "subRegionCode": "NE",
                                    "subRegionName": "NE",
                                    "states": [
                                        {
                                            "stateCode": "CT",
                                            "stateName": "Connecticut",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "CT2",
                                                    "stateSubregionName": "CT2"
                                                }
                                            ]
                                        },
                                        {
                                            "stateCode": "PA",
                                            "stateName": "Pennsylvania",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "PA2",
                                                    "stateSubregionName": "PA2"
                                                }
                                            ]
                                        }
                                    ]
                                }
                            ]
                        }
                    ],
                    "addressType": [
                        "STREET"
                    ],
                    "transitTime": 3,
                    "tieredShippingCharges": [
                        {
                            "minLimit": 0.0,
                            "maxLimit": 10,
                            "shipCharge": {
                                "amount": 5.0,
                                "currency": "USD"
                            }
                        },
                        {
                            "minLimit": 10.01,
                            "maxLimit": -1,
                            "shipCharge": {
                                "amount": 6.05,
                                "currency": "USD"
                            }
                        }
                    ]
                }
            ]
        }
    ]
}

Response Body


{
    "id": "73716811029721089",
    "name": "Transit Time Template Custom 2",
    "type": "CUSTOM",
    "rateModelType": "TIERED_PRICING",
    "status": "ACTIVE",
    "shippingMethods": [
        {
            "shipMethod": "VALUE",
            "status": "ACTIVE",
            "configurations": [
                {
                    "regions": [
                        {
                            "regionCode": "C",
                            "regionName": "48 State"
                        }
                    ],
                    "addressType": [
                        "STREET"
                    ],
                    "transitTime": 6,
                    "tieredShippingCharges": [
                        {
                            "minLimit": 0.0,
                            "maxLimit": -1,
                            "shipCharge": {
                                "amount": 0.0,
                                "currency": "USD"
                            }
                        }
                    ]
                }
            ]
        },
        {
            "shipMethod": "STANDARD",
            "status": "ACTIVE",
            "configurations": [
                {
                    "regions": [
                        {
                            "regionCode": "C",
                            "regionName": "48 State",
                            "subRegions": [
                                {
                                    "subRegionCode": "NE",
                                    "subRegionName": "NE",
                                    "states": [
                                        {
                                            "stateCode": "PA",
                                            "stateName": "Pennsylvania",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "PA4",
                                                    "stateSubregionName": "PA4"
                                                },
                                                {
                                                    "stateSubregionCode": "PA1",
                                                    "stateSubregionName": "PA1"
                                                }
                                            ]
                                        },
                                        {
                                            "stateCode": "CT",
                                            "stateName": "Connecticut",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "CT2",
                                                    "stateSubregionName": "CT2"
                                                }
                                            ]
                                        }
                                    ]
                                },
                                {
                                    "subRegionCode": "MW",
                                    "subRegionName": "MW",
                                    "states": [
                                        {
                                            "stateCode": "SD",
                                            "stateName": "South Dakota",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "SD1",
                                                    "stateSubregionName": "SD1"
                                                }
                                            ]
                                        }
                                    ]
                                }
                            ]
                        }
                    ],
                    "addressType": [
                        "STREET"
                    ],
                    "transitTime": 4,
                    "tieredShippingCharges": [
                        {
                            "minLimit": 5.01,
                            "maxLimit": -1,
                            "shipCharge": {
                                "amount": 0.13,
                                "currency": "USD"
                            }
                        },
                        {
                            "minLimit": 0.0,
                            "maxLimit": 5,
                            "shipCharge": {
                                "amount": 0.11,
                                "currency": "USD"
                            }
                        }
                    ]
                },
                {
                    "regions": [
                        {
                            "regionCode": "C",
                            "regionName": "48 State",
                            "subRegions": [
                                {
                                    "subRegionCode": "NE",
                                    "subRegionName": "NE",
                                    "states": [
                                        {
                                            "stateCode": "PA",
                                            "stateName": "Pennsylvania",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "PA3",
                                                    "stateSubregionName": "PA3"
                                                }
                                            ]
                                        },
                                        {
                                            "stateCode": "CT",
                                            "stateName": "Connecticut",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "CT1",
                                                    "stateSubregionName": "CT1"
                                                }
                                            ]
                                        }
                                    ]
                                },
                                {
                                    "subRegionCode": "MW",
                                    "subRegionName": "MW",
                                    "states": [
                                        {
                                            "stateCode": "SD",
                                            "stateName": "South Dakota",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "SD2",
                                                    "stateSubregionName": "SD2"
                                                }
                                            ]
                                        }
                                    ]
                                }
                            ]
                        }
                    ],
                    "addressType": [
                        "STREET"
                    ],
                    "transitTime": 3,
                    "tieredShippingCharges": [
                        {
                            "minLimit": 0.0,
                            "maxLimit": 10,
                            "shipCharge": {
                                "amount": 1.0,
                                "currency": "USD"
                            }
                        },
                        {
                            "minLimit": 10.01,
                            "maxLimit": -1,
                            "shipCharge": {
                                "amount": 2.05,
                                "currency": "USD"
                            }
                        }
                    ]
                },
                {
                    "regions": [
                        {
                            "regionCode": "H",
                            "regionName": "AK and HI"
                        },
                        {
                            "regionCode": "C",
                            "regionName": "48 State"
                        },
                        {
                            "regionCode": "P",
                            "regionName": "US Protectorates"
                        }
                    ],
                    "addressType": [
                        "PO_BOX"
                    ],
                    "transitTime": 5,
                    "tieredShippingCharges": [
                        {
                            "minLimit": 5.01,
                            "maxLimit": -1,
                            "shipCharge": {
                                "amount": 0.13,
                                "currency": "USD"
                            }
                        },
                        {
                            "minLimit": 0.0,
                            "maxLimit": 5,
                            "shipCharge": {
                                "amount": 0.11,
                                "currency": "USD"
                            }
                        }
                    ]
                },
                {
                    "regions": [
                        {
                            "regionCode": "P",
                            "regionName": "US Protectorates"
                        },
                        {
                            "regionCode": "H",
                            "regionName": "AK and HI"
                        },
                        {
                            "regionCode": "C",
                            "regionName": "48 State",
                            "subRegions": [
                                {
                                    "subRegionCode": "NE",
                                    "subRegionName": "NE",
                                    "states": [
                                        {
                                            "stateCode": "CT",
                                            "stateName": "Connecticut",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "CT2",
                                                    "stateSubregionName": "CT2"
                                                }
                                            ]
                                        },
                                        {
                                            "stateCode": "PA",
                                            "stateName": "Pennsylvania",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "PA2",
                                                    "stateSubregionName": "PA2"
                                                }
                                            ]
                                        }
                                    ]
                                }
                            ]
                        }
                    ],
                    "addressType": [
                        "STREET"
                    ],
                    "transitTime": 3,
                    "tieredShippingCharges": [
                        {
                            "minLimit": 0.0,
                            "maxLimit": 10,
                            "shipCharge": {
                                "amount": 5.0,
                                "currency": "USD"
                            }
                        },
                        {
                            "minLimit": 10.01,
                            "maxLimit": -1,
                            "shipCharge": {
                                "amount": 6.05,
                                "currency": "USD"
                            }
                        }
                    ]
                }
            ]
        }
    ]
}

 



Update Shipping Template

Use Case

Update Existing Shipping Template

Prerequisites

  1. Deliverr Partner Must use delegated access for invoking this Apis with proper External Headers
  2. Seller Must use seller authentications while using this Api with proper External Headers
  3. WHEN DELIVERR invokes "CREATE SHIPPING TEMPLATE" API , the attribute "type" needs to be set as "DELIVERR" 
  4. When PARTNER invokes "CREATE SHIPPING TEMPLATE" API , the attribute "type" needs to be set as " CUSTOM"

Conditions

  • "type" attribute in the request payload of the Shipping Template cannot be updated
  • Partner can update DEFAULT, CUSTOM and DELIVERR Shipping Templates
  • Deliverr can only update DELIVERR Templates (Type attribute of template differentiates between DEFAULT, CUSTOM and DELIVERR templates)
  • A CUSTOM template can have two combinations of Ship method
    • Only Freight Ship Method
    • Value and any other Ship Methods (Except Freight)
  • The DEFAULT template cannot be disabled
  • The DEFAULT template cannot be deleted.
  • Only Alphanumeric characters (a-z, A-Z, 0-9) and spaces allowed in the template name.Spaces will be trimmed. Spaces will be removed from the start and end of the name. Name having only spaces will be considered empty
  • Max Template length Allowed 25 chars
  • Template Name must be unique for a seller, and it is case insensitive
  • Shipping Methods
    Only below given shipping methods and transit time combinations are allowed

 

 

Method

Transit Time

TWO_DAY

2

FREIGHT

8, 9, 10

STANDARD

3,4,5

VALUE

6, 7

 

  • Freight Shipping method is only allowed for Custom templates
  • For Freight , No granular Subregions supported
  • TWO DAY Shipping method is only allowed for Sellers approved on Two Day Program.
  • Free shipping always for TWO DAY Shipping Methods(Both rate models).
  • Max Charges allowed for a shipMethods

 

shipMethods

Shipping and handling

Charge per weight

Charge per Item

Tiered Charges

VALUE

0

0

0

0

Standard

200

200

200

200

TWO_DAY

0

0

0

0

Freight

200

200

200

200

 

  • Only Non Negative values are allowed are in shipping Charges.
  • Value Ship-method
    • Must have only one shipping rule.
    • Value Ship-method should have only 48 STATE region and address type should be STREET.
    • For VALUE ship method No granular subregions supported.
    • Free shipping always for Value Shipping Methods(Both rate models).
  • Standard Ship method : Granular subregions must be supplied for 48 states and address type Street.
  • No Granular subregion support for regions : HI and AK, Street, US Protec, APO/FPO.
  • No Granular subregion support for 48 States PO BOX.
  • No Overlapping of areas allowed in different shipping rules for the same shipping method in a template.
  • If the attribute "rateModelType" is set to "TIERED_PRICING" then only a list of Tiered shipping charges must be supplied.
  • 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 the range of "minLimit" to "maxLimit" for the attribute "tieredShippingCharges" should be continuous. -1 for attribute "maxLimit" indicates highest Value. Example Below :-
{
  "tieredShippingCharges": [
    {
      "minLimit": 0,
      "maxLimit": 5,
      "shipCharge": {
        "currencyAmount": 0.1,
        "currencyUnit": "USD"
      }
    },
    {
      "minLimit": 5.01,
      "maxLimit": -1,
      "shipCharge": {
        "currencyAmount": 0.1,
        "currencyUnit": "USD"
      }
    }
  ]
}

Api Uri

https://marketplace.walmartapis.com/v3/settings/shipping/templates/{templateId}

Request Parameters

Request Parameter

Optional

Sample Values

Comments

templateId

No

6403347396979011

Shipping Template Id

Http Method

PUT

Request Payload

{
    "name": "Transit Time Template Custom 2 updated",
    "type": "CUSTOM",
    "rateModelType": "TIERED_PRICING",
    "status": "ACTIVE",
    "shippingMethods": [
        {
            "shipMethod": "VALUE",
            "status": "ACTIVE",
            "configurations": [
                {
                    "regions": [
                        {
                            "regionCode": "C",
                            "regionName": "48 State"
                        }
                    ],
                    "addressType": [
                        "STREET"
                    ],
                    "transitTime": 6,
                    "tieredShippingCharges": [
                        {
                            "minLimit": 0.0,
                            "maxLimit": -1,
                            "shipCharge": {
                                "amount": 0.0,
                                "currency": "USD"
                            }
                        }
                    ]
                }
            ]
        },
        {
            "shipMethod": "STANDARD",
            "status": "ACTIVE",
            "configurations": [
                {
                    "regions": [
                        {
                            "regionCode": "C",
                            "regionName": "48 State",
                            "subRegions": [
                                {
                                    "subRegionCode": "NE",
                                    "subRegionName": "NE",
                                    "states": [
                                        {
                                            "stateCode": "PA",
                                            "stateName": "Pennsylvania",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "PA4",
                                                    "stateSubregionName": "PA4"
                                                },
                                                {
                                                    "stateSubregionCode": "PA1",
                                                    "stateSubregionName": "PA1"
                                                }
                                            ]
                                        },
                                        {
                                            "stateCode": "CT",
                                            "stateName": "Connecticut",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "CT2",
                                                    "stateSubregionName": "CT2"
                                                }
                                            ]
                                        }
                                    ]
                                },
                                {
                                    "subRegionCode": "MW",
                                    "subRegionName": "MW",
                                    "states": [
                                        {
                                            "stateCode": "SD",
                                            "stateName": "South Dakota",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "SD1",
                                                    "stateSubregionName": "SD1"
                                                }
                                            ]
                                        }
                                    ]
                                }
                            ]
                        }
                    ],
                    "addressType": [
                        "STREET"
                    ],
                    "transitTime": 4,
                    "tieredShippingCharges": [
                        {
                            "minLimit": 5.01,
                            "maxLimit": -1,
                            "shipCharge": {
                                "amount": 0.13,
                                "currency": "USD"
                            }
                        },
                        {
                            "minLimit": 0.0,
                            "maxLimit": 5,
                            "shipCharge": {
                                "amount": 0.11,
                                "currency": "USD"
                            }
                        }
                    ]
                },
                {
                    "regions": [
                        {
                            "regionCode": "C",
                            "regionName": "48 State",
                            "subRegions": [
                                {
                                    "subRegionCode": "NE",
                                    "subRegionName": "NE",
                                    "states": [
                                        {
                                            "stateCode": "PA",
                                            "stateName": "Pennsylvania",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "PA3",
                                                    "stateSubregionName": "PA3"
                                                }
                                            ]
                                        },
                                        {
                                            "stateCode": "CT",
                                            "stateName": "Connecticut",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "CT1",
                                                    "stateSubregionName": "CT1"
                                                }
                                            ]
                                        }
                                    ]
                                },
                                {
                                    "subRegionCode": "MW",
                                    "subRegionName": "MW",
                                    "states": [
                                        {
                                            "stateCode": "SD",
                                            "stateName": "South Dakota",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "SD2",
                                                    "stateSubregionName": "SD2"
                                                }
                                            ]
                                        }
                                    ]
                                }
                            ]
                        }
                    ],
                    "addressType": [
                        "STREET"
                    ],
                    "transitTime": 3,
                    "tieredShippingCharges": [
                        {
                            "minLimit": 0.0,
                            "maxLimit": 10,
                            "shipCharge": {
                                "amount": 1.0,
                                "currency": "USD"
                            }
                        },
                        {
                            "minLimit": 10.01,
                            "maxLimit": -1,
                            "shipCharge": {
                                "amount": 2.05,
                                "currency": "USD"
                            }
                        }
                    ]
                },
                {
                    "regions": [
                        {
                            "regionCode": "H",
                            "regionName": "AK and HI"
                        },
                        {
                            "regionCode": "C",
                            "regionName": "48 State"
                        },
                        {
                            "regionCode": "P",
                            "regionName": "US Protectorates"
                        }
                    ],
                    "addressType": [
                        "PO_BOX"
                    ],
                    "transitTime": 5,
                    "tieredShippingCharges": [
                        {
                            "minLimit": 5.01,
                            "maxLimit": -1,
                            "shipCharge": {
                                "amount": 0.13,
                                "currency": "USD"
                            }
                        },
                        {
                            "minLimit": 0.0,
                            "maxLimit": 5,
                            "shipCharge": {
                                "amount": 0.11,
                                "currency": "USD"
                            }
                        }
                    ]
                },
                {
                    "regions": [
                        {
                            "regionCode": "P",
                            "regionName": "US Protectorates"
                        },
                        {
                            "regionCode": "H",
                            "regionName": "AK and HI"
                        },
                        {
                            "regionCode": "C",
                            "regionName": "48 State",
                            "subRegions": [
                                {
                                    "subRegionCode": "NE",
                                    "subRegionName": "NE",
                                    "states": [
                                        {
                                            "stateCode": "CT",
                                            "stateName": "Connecticut",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "CT2",
                                                    "stateSubregionName": "CT2"
                                                }
                                            ]
                                        },
                                        {
                                            "stateCode": "PA",
                                            "stateName": "Pennsylvania",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "PA2",
                                                    "stateSubregionName": "PA2"
                                                }
                                            ]
                                        }
                                    ]
                                }
                            ]
                        }
                    ],
                    "addressType": [
                        "STREET"
                    ],
                    "transitTime": 3,
                    "tieredShippingCharges": [
                        {
                            "minLimit": 0.0,
                            "maxLimit": 10,
                            "shipCharge": {
                                "amount": 5.0,
                                "currency": "USD"
                            }
                        },
                        {
                            "minLimit": 10.01,
                            "maxLimit": -1,
                            "shipCharge": {
                                "amount": 6.05,
                                "currency": "USD"
                            }
                        }
                    ]
                }
            ]
        }
    ]
}

Response Body

{
    "id": "73716811029721089",
    "name": "Transit Time Template Custom 2 updated",
    "type": "CUSTOM",
    "rateModelType": "TIERED_PRICING",
    "status": "ACTIVE",
    "shippingMethods": [
        {
            "shipMethod": "VALUE",
            "status": "ACTIVE",
            "configurations": [
                {
                    "regions": [
                        {
                            "regionCode": "C",
                            "regionName": "48 State"
                        }
                    ],
                    "addressType": [
                        "STREET"
                    ],
                    "transitTime": 6,
                    "tieredShippingCharges": [
                        {
                            "minLimit": 0.0,
                            "maxLimit": -1,
                            "shipCharge": {
                                "amount": 0.0,
                                "currency": "USD"
                            }
                        }
                    ]
                }
            ]
        },
        {
            "shipMethod": "STANDARD",
            "status": "ACTIVE",
            "configurations": [
                {
                    "regions": [
                        {
                            "regionCode": "C",
                            "regionName": "48 State",
                            "subRegions": [
                                {
                                    "subRegionCode": "NE",
                                    "subRegionName": "NE",
                                    "states": [
                                        {
                                            "stateCode": "PA",
                                            "stateName": "Pennsylvania",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "PA4",
                                                    "stateSubregionName": "PA4"
                                                },
                                                {
                                                    "stateSubregionCode": "PA1",
                                                    "stateSubregionName": "PA1"
                                                }
                                            ]
                                        },
                                        {
                                            "stateCode": "CT",
                                            "stateName": "Connecticut",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "CT2",
                                                    "stateSubregionName": "CT2"
                                                }
                                            ]
                                        }
                                    ]
                                },
                                {
                                    "subRegionCode": "MW",
                                    "subRegionName": "MW",
                                    "states": [
                                        {
                                            "stateCode": "SD",
                                            "stateName": "South Dakota",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "SD1",
                                                    "stateSubregionName": "SD1"
                                                }
                                            ]
                                        }
                                    ]
                                }
                            ]
                        }
                    ],
                    "addressType": [
                        "STREET"
                    ],
                    "transitTime": 4,
                    "tieredShippingCharges": [
                        {
                            "minLimit": 5.01,
                            "maxLimit": -1,
                            "shipCharge": {
                                "amount": 0.13,
                                "currency": "USD"
                            }
                        },
                        {
                            "minLimit": 0.0,
                            "maxLimit": 5,
                            "shipCharge": {
                                "amount": 0.11,
                                "currency": "USD"
                            }
                        }
                    ]
                },
                {
                    "regions": [
                        {
                            "regionCode": "C",
                            "regionName": "48 State",
                            "subRegions": [
                                {
                                    "subRegionCode": "NE",
                                    "subRegionName": "NE",
                                    "states": [
                                        {
                                            "stateCode": "PA",
                                            "stateName": "Pennsylvania",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "PA3",
                                                    "stateSubregionName": "PA3"
                                                }
                                            ]
                                        },
                                        {
                                            "stateCode": "CT",
                                            "stateName": "Connecticut",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "CT1",
                                                    "stateSubregionName": "CT1"
                                                }
                                            ]
                                        }
                                    ]
                                },
                                {
                                    "subRegionCode": "MW",
                                    "subRegionName": "MW",
                                    "states": [
                                        {
                                            "stateCode": "SD",
                                            "stateName": "South Dakota",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "SD2",
                                                    "stateSubregionName": "SD2"
                                                }
                                            ]
                                        }
                                    ]
                                }
                            ]
                        }
                    ],
                    "addressType": [
                        "STREET"
                    ],
                    "transitTime": 3,
                    "tieredShippingCharges": [
                        {
                            "minLimit": 0.0,
                            "maxLimit": 10,
                            "shipCharge": {
                                "amount": 1.0,
                                "currency": "USD"
                            }
                        },
                        {
                            "minLimit": 10.01,
                            "maxLimit": -1,
                            "shipCharge": {
                                "amount": 2.05,
                                "currency": "USD"
                            }
                        }
                    ]
                },
                {
                    "regions": [
                        {
                            "regionCode": "H",
                            "regionName": "AK and HI"
                        },
                        {
                            "regionCode": "C",
                            "regionName": "48 State"
                        },
                        {
                            "regionCode": "P",
                            "regionName": "US Protectorates"
                        }
                    ],
                    "addressType": [
                        "PO_BOX"
                    ],
                    "transitTime": 5,
                    "tieredShippingCharges": [
                        {
                            "minLimit": 5.01,
                            "maxLimit": -1,
                            "shipCharge": {
                                "amount": 0.13,
                                "currency": "USD"
                            }
                        },
                        {
                            "minLimit": 0.0,
                            "maxLimit": 5,
                            "shipCharge": {
                                "amount": 0.11,
                                "currency": "USD"
                            }
                        }
                    ]
                },
                {
                    "regions": [
                        {
                            "regionCode": "P",
                            "regionName": "US Protectorates"
                        },
                        {
                            "regionCode": "H",
                            "regionName": "AK and HI"
                        },
                        {
                            "regionCode": "C",
                            "regionName": "48 State",
                            "subRegions": [
                                {
                                    "subRegionCode": "NE",
                                    "subRegionName": "NE",
                                    "states": [
                                        {
                                            "stateCode": "CT",
                                            "stateName": "Connecticut",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "CT2",
                                                    "stateSubregionName": "CT2"
                                                }
                                            ]
                                        },
                                        {
                                            "stateCode": "PA",
                                            "stateName": "Pennsylvania",
                                            "stateSubregions": [
                                                {
                                                    "stateSubregionCode": "PA2",
                                                    "stateSubregionName": "PA2"
                                                }
                                            ]
                                        }
                                    ]
                                }
                            ]
                        }
                    ],
                    "addressType": [
                        "STREET"
                    ],
                    "transitTime": 3,
                    "tieredShippingCharges": [
                        {
                            "minLimit": 0.0,
                            "maxLimit": 10,
                            "shipCharge": {
                                "amount": 5.0,
                                "currency": "USD"
                            }
                        },
                        {
                            "minLimit": 10.01,
                            "maxLimit": -1,
                            "shipCharge": {
                                "amount": 6.05,
                                "currency": "USD"
                            }
                        }
                    ]
                }
            ]
        }
    ]
}



Delete Shipping Template

 

Use Case

Delete Existing Shipping Template

Prerequisites

  1. Deliverr Partner Must use delegated access for invoking this Apis with proper External Headers
  2. Seller Must use seller authentications while using this Api with proper External Headers

Conditions

  1. PARTNERS cannot delete DEFAULT template.
  2. DELIVERR cannot delete PARTNERS template.

Api Uri

https://marketplace.walmartapis.com/v3/settings/shipping/templates/{templateId}

Request Parameters

Request Parameter

Optional

Sample Values

Comments

templateId

No

6403347396979011

Shipping Template Id

Http Method

DELETE

Request Payload

NA

Response Payload

{
    "id": "180778427676118"
}



Get All Fulfilment Centres

Use Case

Download All fulfilment Centres of a Seller

Prerequisites

  1. Deliverr Partner Must use delegated access for invoking this Apis with proper External Headers
  2. Seller Must use seller authentications while using this Api with proper External Headers

Conditions

  1. PARTNERS cannot delete DEFAULT template.
  2. DELIVERR cannot delete PARTNERS template.

Api Uri

https://marketplace.walmartapis.com/v3/settings/shipping/shipnodes?mediaType={mediaType}

Request Parameters

Request Parameter

Optional

Sample Values

Comments

mediaType

Yes

csv

Can be supplied to specify

Http Method

GET

Request Payload

 

NA

 

Response Payload

 

[{
		"shipNode": "79897837271126017",
		"nodeType": "PHYSICAL",
		"shipNodeName": "Testing Central TimeZone",
		"status": "ACTIVE",
		"timeZone": "MST",
		"distributorSupportedServices": [
			"TWO_DAY_DELIVERY"
		],
		"customNodeId": "1121222332",
		"postalAddress": {
			"addressLine1": "dffdf",
			"city": "dfdfdfdf",
			"state": "FL",
			"country": "USA",
			"postalCode": "32703"
		},
		"shippingDetails": [{
			"twoDayShipping": [{
				"carrierMethodName": "USPS",
				"carrierMethodType": "GROUND"
			}]
		}]
	},
	{
		"shipNode": "83262080191954945",
		"nodeType": "PHYSICAL",
		"shipNodeName": "werer",
		"status": "ACTIVE",
		"timeZone": "PST",
		"distributorSupportedServices": [
			"TWO_DAY_DELIVERY"
		],
		"customNodeId": "11212223",
		"postalAddress": {
			"addressLine1": "A-2104, Hill Cress",
			"city": "Sunnyvelle",
			"state": "IA",
			"country": "USA",
			"postalCode": "56006"
		},
		"shippingDetails": [{
			"twoDayShipping": [{
				"carrierMethodName": "USPS",
				"carrierMethodType": "GROUND"
			}]
		}]
	}
]

 

SKU to Template Association

Use Case

Sample SKU-Node-Template Association request

Api Uri

https://marketplace.walmartapis.com/v3/feeds?feedType=SKU_TEMPLATE_MAP

Http Method

POST

Query Parameters

feedType=SKU_TEMPLATE_MAP

Request Payload

 

{
  "ItemFeedHeader": {
    "sellingChannel": "precisedelivery",
    "locale": "en",
    "version": "1.0"
  },
  "Item": [
    {
      "PreciseDelivery": {
        "sku": "sku1",
        "actionType": "Add",
        "shippingTemplateId": "8374652987346572",
        "fulfillmentCenterId": "83746529874858434"
      }
    },
    {
      "PreciseDelivery": {
        "sku": "sku2",
        "shippingTemplateId": "8374652987346572",
        "actionType": "Remove",
        "fulfillmentCenterId": "83746529874858434"
      }
    }
  ]
}

Response Payload

 

{
  "feedId": "F129C19240844B97A3C6AD8F1A2C4997@AU8BAQA",
  "additionalAttributes": null,
  "errors": null
}

 

Sample Deliverr Request

Use Case

Deliverr Feed Request API

Api Uri

https://marketplace.walmartapis.com/v3/feeds?feedType=SHIPPING_OVERRIDES

Http Method

POST

Query Parameters

feedType=SHIPPING_OVERRIDES

Request Payload

 

{
  "ItemFeedHeader": {
    "version": "1.0",
    "sellingChannel": "overrides",
    "locale": "en"
  },
  "Item": [
    {
      "Override": {
        "sku": "sku1",
        "actionType": "UPDATE",
        "fulfilmentCenterId": "83746529874858430",
        "ShippingOverrides": [
          {
            "ShippingOverride": {
              "shipMethod": "EXPEDITED",
              "actionType": "CREATE",
              "transit": 2,
              "northeastRegionStates": "NY,NJ",
              "midwestRegionStates": "IA",
              "westRegionStates": "CA",
              "southRegionStates": "FL,AL"
            }
          },
          {
            "ShippingOverride": {
              "shipMethod": "STANDARD",
              "actionType": "CREATE",
              "transit": 3,
              "shipPrice": 10.55,
              "northeastRegionStates": "NY,NJ",
              "midwestRegionStates": "IA",
              "westRegionStates": "CA",
              "southRegionStates": "FL,AL"
            }
          },
          {
            "ShippingOverride": {
              "shipMethod": "STANDARD",
              "actionType": "CREATE",
              "transit": 4,
              "shipPrice": 10.55,
              "northeastRegionStates": "NY,NJ",
              "midwestRegionStates": "IA",
              "westRegionStates": "CA",
              "southRegionStates": "FL,AL"
            }
          },
          {
            "ShippingOverride": {
              "shipMethod": "VALUE",
              "actionType": "CREATE",
              "transit": 9,
              "nationWide": "48_STATES_STREET"
            }
          }
        ]
      }
    }
  ]
}

Response Payload

 

{
  "feedId": "F129C19240844B97A3C6AD8F1A2C4997@AU8BAQA",
  "additionalAttributes": null,
  "errors": null
}



Error Responses

Error Responses will follow Standard Walmart Error Format as Mentioned in the Developer Portal here

Scenario HTTP Code Error Response
General Error While Creating Shipping Template 400 Bad Request
{
    "errors": [
        {
            "code": "INVALID_REQUEST.GMP_SHIPPING_TEMPLATE_API",
            "field": "transitTime",
            "description": "The transit time for the shipping method VALUE must be one of [6, 7].",
            "info": "Invalid transit time.",
            "severity": "ERROR",
            "category": "DATA"
        },
        {
            "code": "INVALID_REQUEST.GMP_SHIPPING_TEMPLATE_API",
            "field": "shippingMethods",
            "description": "The VALUE shipping method supports only 48 state street.",
            "info": "The VALUE shipping method supports only 48 state street.",
            "severity": "ERROR",
            "category": "DATA"
        },
        {
            "code": "INVALID_REQUEST.GMP_SHIPPING_TEMPLATE_API",
            "field": "name",
            "description": "The shipping template with the name 'Custom Template 223' already exists.",
            "info": "Invalid shipping template name.",
            "severity": "ERROR",
            "category": "DATA"
        },
        {
            "code": "INVALID_REQUEST.GMP_SHIPPING_TEMPLATE_API",
            "field": "type",
            "description": "No new shipping templates can be created. Max 20 templates are allowed.",
            "info": "No new shipping templates can be created.",
            "severity": "ERROR",
            "category": "DATA"
        }
    ]
}





Reports

Shipping Configuration Report

Sample CSV format -



Shipping Program Report

Sample CSV format -