docs
  1. SCAYLE Resource Center
  2. Onboarding Guide
  3. Onboarding: Backend
  4. Configure your warehouses

Configure your warehouses

Warehouses must be configured before sending stock information as variants.

Remember, product variants are the last level within SCAYLE's product structure and represent the sellable entity. See Product Structure.

In the next sections, we’ll explain how our warehouses work, how many you might need, and how to configure them based on our example scenario.

Understanding warehouses

In the world of SCAYLE, a warehouse is a logical entity that holds stock for specific variants.

Every warehouse is assigned to one or more shop countries.

A warehouse can represent a physical warehouse, but it doesn’t have to.

Furthermore, warehouses outline priority that defines which stock should be sold first per variant. You can configure priority on the shop country level. The higher the value, the higher the priority. Also, stock assigned to a specific warehouse can have different delivery times on the shop country level

Refer to Delivery Estimations for more information about this feature.

Configuring warehouses

Warehouses can be configured using the Admin API endpoint.
However, in most cases, you will only configure warehouses once without further changes, so we recommend using the SCAYLE Panel.

Identifying the correct warehouse structure

The following set of questions can help you to identify which warehouse structure you need:

  1. Do you have more than one physical warehouse?
    If yes, you can consider having multiple warehouses in SCAYLE.
  2. Do you have more than one physical warehouse, but all warehouses have the same estimated delivery times in all shop countries?
    If this is the case, you can just use one.
  3. Do you have more than one shop country and more than one physical warehouse?
    If yes, you should consider translating the warehouses to SCAYLE so you can define which warehouse should serve each shop country.

Applying the theory to practice

Now let’s see how we would set up warehouses for our Fashion Store. Our example operates two warehouses. Here are some additional details we need to configure our warehouses:

  1. The warehouse in Germany is in Frankfurt, and the warehouse in Switzerland is in Basel.
  2. The stock in the Basel warehouse is only available in Switzerland, but the stock in the Frankfurt warehouse is available in both countries.
  3. Since Switzerland can retrieve stock from both warehouses, we should consider selling the stock in Basel before the stock in Frankfurt to ensure quick deliveries.

The following diagram illustrates the scenario:

Warehouses

In this situation, we need to create two warehouses. The warehouse in Frankfurt will be assigned to all shop countries, while the warehouse in Basel will only be assigned to the 2 shop countries of Switzerland.

We identified the need to have three shop countries in this chapter: Shop Structure.

First, we have to create the warehouses via the SCAYLE Panel:

  1. Go to: Settings > Merchant management > Select default merchant > Edit.
  2. Scroll down to Create warehouses. Click Create new >`` Add Warehouse.
  3. Create two warehouses, one named “warehouse_frankfurt” and the other, “warehouse_basel”.

In the next steps, assign your warehouses to specific shop countries

  1. Go to: Shops > [Shop Name] > Shop Country > Storefront > Warehouses.
  2. Select the warehouses that have to be assigned from the dropdown menu and save the form. Perform this step for every shop country/warehouse combination required.

Storefront - Add Warehouse

Great job! Now you’ve learned the warehouse basics and assigned them to our Fashion Store.

Time to send stock information in the next section.

Further education - SCAYLE Academy