Product Shipping Destinations

This API allows you to set shipping prices of particular product variants (or products) to particular countries.

Defaults

By default, all your product variants that have positive stock at a warehouse ship to all countries customized for this warehouse with shipping prices set for these variants when adding them to a warehouse. This API allows you to override these defaults for particular variant-country pairs.

Using warehouses

By default, all your stocks and shipping prices are put to a default warehouse. That is, when you create and update products their variants’ inventory and shippingPrice are actually put to a default warehouse under the hood. Shipping countries for your default warehouse are determined by the settings in your Merchant Panel.

Working with default warehouse is simple: you just don’t think of it! When you use the default warehouse in this Shipping Destinations API, you skip all warehouseId and warehouseLabel fields.

You can set up custom warehouses to ship certain products to certain countries and have different stock amounts at these warehouses. For more details please refer to Products at Warehouses section.

When you work with custom (non-default) warehouse in this Shipping Destinations API you need to supply either warehouseId or warehouseLabel to identify the warehouse.

Use Cases

Setting default shipping prices of particular variants to all countries

When you create and update products their variants’ shippingPrice is set as the default shipping price to all countries to which you ship from the default warehouse.

For custom warehouses, check the Products at Warehouses section.

Overriding shipping prices to particular countries

Use Update Custom Shipping Destinations endpoint to set shipping prices for the variant-country pairs for which you’d like to override the defaults.

Disabling shipping of all products to particular countries

Just disable these countries for the warehouse in the warehouse settings. Don’t disable them for every variant.

Disabling shipping of particular products to particular countries

Use Update Per Product Custom Shipping Destinations endpoint to disable shipping for the product-country pairs. You can also use Update Custom Shipping Destinations endpoint to disable shipping for the variant-country pairs, but we encourage you to use per product version if you want to disable shipping for all product’s variants.

Checking current shipping prices and disabled countries

Use Retrieve Custom Shipping Destinations endpoint to check which shipping prices you’ve set for particular variant-country pairs. Please note that this endpoint only shows changes made by Update Custom Shipping Destinations endpoint and does not show any defaults.

Normally, you don’t have to use this endpoint, unless when testing or debugging.