Products at Warehouses

If you don’t use International Warehouses feature, you can skip this section and corresponding endpoints.

This API allows you to set stocks of product variants at international warehouses and set default shipping prices of these variants from these warehouses.

Default warehouse

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.

You may use endpoints in this section to work with the default warehouse, but you don’t have to do that. Endpoints described here are more complicated than normal product creation and updates, they should be used only by merchants that have multiple warehouses.

Use Cases

Adding stocks to custom warehouses

Use Update Product’s Availability at Warehouses endpoint to update stocks for particular variants at particular warehouses.

Setting default shipping prices of particular variants to all countries

Use Update Product’s Availability at Warehouses endpoint to set default shipping prices for particular variants from particular warehouses.

Default shipping prices are valid for all countries enabled for the warehouse, unless you override them for particular variant-country pairs.

Overriding shipping prices of particular variants to particular countries

See Shipping Destinations section.

Disabling shipping of all products to particular countries

Just disable these countries for the warehouse in the warehouse settings.

Checking current stocks and/or default shipping prices

Use Retrieve Product’s Availability at Warehouses endpoint to check which stocks and default shipping prices you’ve set for particular variants at particular warehouses.

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