docs
  1. SCAYLE Resource Center
  2. Developer Guides
  3. Shops
  4. General

General

General

SCAYLE allows users to create and manage any number of shops.

Some of the core functions of SCAYLE relate to the creation and administration of shops. The system allows individual settings for each shop within the instance, for example, for category trees and country-specific assortments.

You can manage several shops in the same instance of SCAYLE. Shops can run entirely independently from any other shop or inherit certain values from a superordinate shop. Some everyday use cases for operating multiple shops are:

  • individual shops for different assortments (e.g., only fashion, only furniture)
  • individual shops for different target groups (e.g., only women, only men)
  • individual shops for different brands

Since we highly value and support your flexibility, there are no limitations on how shops can be handled in the same instance. You can operate shops with overlapping assortments and shared products. Each new shop can be created independently from any other shop that is part of the same instance. You can also check out our user manual for further reference on how shops are managed in the SCAYLE Panel.

Shop structure

The shop structure of SCAYLE consists of two levels:

  1. Shop
  2. Shop Country

All shop countries exist within a shop (see the example shop setup below). This structure is the foundation of your shop.

What is a shop in SCAYLE?

A shop in SCAYLE is a virtual entity in the SCAYLE universe that translates to an online store in the front end. You can structure different shop countries within a shop. Shops are differentiated by their purpose, for example, a B2B shop, an outlet, or a brand.

All shops within your SCAYLE instance share certain product data, such as master categories and attribute groups. Learn more about product data here.

Your SCAYLE shop setup includes a shared shop category tree. All shop countries use the same shop category structure, however, it is also possible to customize your shop countries by activating and deactivating specific shop categories.

You can also limit SCAYLE Panel users’ access to a specific shop. Find more details about SCAYLE Panel user access and roles here.

What is a shop country in SCAYLE?

You must create a new shop country for every country and language combination within a shop. For example, a Swiss shop in French is one shop country, and a Swiss shop in German is another, separate shop country.

It is not possible to define a combination of a country and language several different times within one shop, meaning, for example, your shop can only have one shop country for Germany with the language German.

A shop country has access to all shared information from the shop level. Additionally, each shop country can have a specific assortment and shop categories.

An example shop setup

The diagram below shows a setup consisting of two shops and several subsequent shop countries.

A) Shop 1 has three shop countries:

  1. German: German language
  2. Switzerland: German language
  3. Switzerland: French language

B) Shop 2 has three shop countries:

  1. Germany: German language
  2. Netherlands: Dutch language
  3. Denmark: Danish language

Example shop setup

Which shop structure suits your needs?

Use the following questions to decide which shop structure suits you best:

  • What is the purpose of the shops you want to build?
    • Do you need a separate outlet shop? If yes, you create an additional shop for the outlet in SCAYLE.
    • What about different brands that each need their own shop? If yes, configure a new shop in SCAYLE for each brand.
  • Where do you want to sell and deliver products? Each country and language combination requires a new shop country.
  • Do you want to use the same shop category tree for all shop countries? If yes, use the basic setup “shared shop category” tree.

You can use the SCAYLE Panel to set up shops and shop countries. While you can also configure a shop using the Admin API, we recommend doing this only once during setup, making the SCAYLE Panel a more convenient option. Learn more here.

Putting the principles into action

You’ve learned about configuring your shop, so now let’s look at an example. We’ve named our imaginary shop Fashion Store.

For our example Fashion Store, we need to set up shop countries in Germany and Switzerland. Switzerland serves German and French-speaking customers, so we’ll create two shop countries for Switzerland. We’ll use EUR in the German shop country, and CHF in the Swiss shop countries.

Shop Country#Country CodeLanguage CodeCurrency
1DEde_DEEUR
2CHde_CHCHF
3CHfr_CHCHF

You’ll need to consider currency later when assigning prices to variants. Don’t worry, we’ll go into more detail in the following chapters.

You must create at least one shop country in the shop creation wizard. Please have your shop countries in mind before setting up. In our case, we create the shop Fashion Store, and our first shop country will be Germany (with the language set to German).

Set up the shop for Fashion Store

  1. In the SCAYLE Panel, go to Shops > + New.

Create Shop

Set up additional shop countries

  1. In the SCAYLE Panel, click Add Another Country button on the shop creation form.

    In our case, we add two Switzerland shop countries, one with the language set to German and one in French, both with the currency CHF.

Add Another Country

Add shop countries to a pre-existing shop

  1. In the SCAYLE Panel, go to Shops > Shop Name > Internationalization > Countries > New Country.

New Country.

Update your shop’s URL

If you don’t know the final shop URL right now, don’t worry. You can update your shop’s URL after you’ve created shop countries in the SCAYLE Panel.

  1. Go to: Shops > Shop Name > Internationalization > Countries > Click on a country name.

Edit country information

You can also update language, billing, and shipping countries in the panel. But in the case of our demo shop, we don’t need to make any changes.

For legal reasons, please take careful note of how you configure billing addresses, especially for shops within the EU!

Further education - SCAYLE Academy