docs

🔗 Warehouses

What are Warehouses?

Warehouses in SCAYLE are logical entities that hold stock for your products. They help you manage inventory across different locations and optimize shipping to your customers. Think of them as the "where" in your fulfillment strategy.

Key Benefits

  • Multi-location inventory management: Track stock across different physical locations
  • Optimized shipping: Automatically select the best warehouse for each order
  • Flexible fulfillment: Serve different regions from different warehouses
  • Priority-based fulfillment: Control which warehouse ships first when multiple options exist

Basic Concepts

Shop Country Warehouse

A shop country warehouse represents a warehouse assigned to a specific shop country. When you assign a warehouse to a shop country, you can define:

  • Priority: Which warehouse should be used first for orders
  • Package Group: How items from this warehouse should be packaged

Priority

Warehouses can have a priority that determines which warehouse should fulfill orders first. The higher the value, the higher the priority. This is useful when:

  • You have multiple warehouses serving the same region
  • You want to prioritize local inventory over remote stock
  • You need to manage stock rotation (FIFO/LIFO)

Package Groups

Package groups help organize how items are packaged and shipped from different warehouses. This is particularly useful for:

  • Different packaging requirements per location
  • Special handling instructions
  • Compliance with regional shipping regulations

Managing Warehouses in SCAYLE Panel

Accessing Warehouses

You can access warehouses through Shops ➜ [Shop] ➜ Storefront ➜ Warehouses. The warehouses page is only available at the local shop level, so first select a local shop. On the overview page, warehouses are listed with warehouse name, priority, package group, as well as icons for edit and delete.

List of warehouses for a given shop

Adding a Warehouse

Warehouses are predefined in Settings ➜ Merchant management ➜ Merchant ➜ Edit. Add a predefined warehouse to a specific shop as follows:

  1. Go to Shops ➜ [Shop] ➜ Storefront ➜ Warehouses and select Add Warehouse.
  2. Select a warehouse from the Warehouses dropdown.
  3. Optionally, assign a Priority and Package Group.
  4. Click Add Warehouse button. The new warehouse appears on the list.

Adding a warehouse to a shop

Editing a Warehouse

  1. Click the edit icon on the right side of the list.
  2. Change the Warehouses selection, Priority, or Package group.
  3. Click Save. A success confirmation appears once the information is updated.

Edit a warehouse

Deleting a Warehouse

Delete a warehouse as follows:

  1. Click the delete icon on the right side of the list.
  2. Confirm the action. A confirmation appears once the warehouse is deleted and it is removed from the list.

Delete a warehouse

Delivery Times

Logistics managers can define delivery times between warehouses. This helps customers get correct information from the shop front end when multiple order items are collected from different warehouses and are then shipped together from one warehouse.

Add delivery times

Add delivery times between warehouses as follows:

  1. Select the tab Delivery Times and click Add Warehouse.
  2. Choose a pickup warehouse from the list.
  3. In the From warehouse section, select Add Destination.
  4. Choose a destination warehouse.
  5. Add the range of days for delivery times (e.g., 1-2 Days).
  6. Click Save Warehouse.

Deleting a warehouse removes it from all "from"/"to" warehouses.

Warehouse delivery times

Further education - SCAYLE Academy

Admin API

Configure warehouses

Warehouses must be configured before sending stock information as variants.

Remember, 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.

Need a refresher on shop countries? Check: What is a “Shop Country” in SCAYLE?

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 (please refer to Delivery Estimations for more information about this feature.)

Warehouses can be configured using the Admin API. 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 2 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 until you see the Warehouses like this:

Add Warehouse.

  1. Click on Create new.

Assign your warehouses to specific shop countries

  1. Go to ** Shops ➜ [Shop] ➜ 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.