Marketplace Guide to Shipping Profiles

• Shipping Profiles
  • Zones & Rates
    • Zone Definitions
    • Zone Definition examples
  • Rates
    • Item/SKU-specified rates example

Shipping Profiles

• Shipping profiles are Supplier configured collections of zones & rates for Rithum's Dsco platform.

Zones & Rates

Zone Definitions

• Selection of a Marketplace customer's country and regional zone must be consistent between a Retailer's and Supplier's understanding.
• To this end, a list of "well-known" zones will be defined and made available.
• Zone definitions will grow in number as future requirements dictate.
• Four zones initially available (~2023):
  • Continental US: All lower 48 US states.
  • Alaska & Hawaii
  • APO/FPO
  • US Protectorates & Territories

Zone Definition examples

[{
  "zone_id": "continental_us",
  "rate_name": "Continguous 48 States",
  "description": "All states in the continental United States",
  "countries": ["US"],
  "regions": ["AL","AR","AZ",...]
},{
  "zone_id": "alaska_hawaii_us",
  "rate_name": "Alaska & Hawaii",
  "description": "Special zone to ship to Alaska & Hawaii",
  "countries": ["US"],
  "regions": ["AK", "HI"]
},{
  "zone_id": "military_us",
  "rate_name": "Military",
  "description": "APO & FPO",
  "countries": "US",
  "regions": ["APO","FPO"]
},{
  "zone_id": "protectorates_us",
  "rate_name": "US Protectorates & Territories",
  "description": "Special zone to ship Guam, Puerto Rico, US Virgin Isles, etc.",
  "countries": ["US"],
  "regions": ["GUAM", "PR", "USVI",...]
}]

Rates

• Zone definitions (above) do not contain rates.
• Rates will be found within the zones as supplied on individual items/SKUs.
• If an item/SKU can be shipped to more than one zone, each zone will be represented, with rates, on the item/SKU.

Item/SKU-specified rates example

"item":{
"itemId": "123456789",
"sku": "MySKU_123",
"shipProfile": {
"profileId": "default",
"profileName": "Default",
"zones": [{
  "zoneId": "continental_us",
  "zoneName": "Contiguous 48 States",
  "description": "All states in the continental United States",
  "rates":[
    {
      "rateId": "standard",
      "rateName": "Standard",
      "leadTime": "1-3 business days",
      "transitTime": "4-5 business days", 
      "weights":[
         {"minValue":-1,"maxValue":-1, "cost":11.00, 
          "unit":"lbs", "currency":"USD", "default":true},
         {"minValue":0, "maxValue":10, "cost":6.00, 
          "unit":"lbs", "currency":"USD", "default":false}
      ]
    },{
      "rateId": "expedited",
      "rateName": "Expedited",
      "leadTime": "1-2 business days",
      "transitTime": "2-3 business days",
      "weights":[
         {"minValue":-1,"maxValue":-1, "cost":21.00, 
          "unit":"lbs", "currency":"USD", "default":true},
         {"minValue":0, "maxValue":10, "cost":16.00, 
          "unit":"lbs", "currency":"USD", "default":false}
      ]
    },{
      "rateId": "overnight",
      "rateName": "Overnight",
      "leadTime": "6-12 hours",
      "transitTime": "1-2 business days",
      "weights":[
         {"minValue":-1,"maxValue":-1, "cost":31.00, 
          "unit":"lbs", "currency":"USD", "default":true},
         {"minValue":0, "maxValue":10, "cost":26.00, 
          "unit":"lbs", "currency":"USD", "default":false}
      ]
    }
  },
  ... Additional zones if defined...
  ]}