docs
  1. SCAYLE Resource Center
  2. User Guide
  3. SETTINGS
  4. General
  5. Configurations

Configurations

The SCAYLE Panel offers customizable settings under the menu item Configuration. You can find this section in the Settings area: Settings > General > Configuration.

Configuration Options

Depending on your permissions, you can access the following options:

Admin-Webhooks

Please use Admin-Webhooks for new implementations, which will fully replace Checkout Webhooks in the future.

Add a webhook

  1. Go to Settings > General > Configuration > Admin Webhooks.
  2. Click Add new Webhook.
  3. Enter Authentication field.
  4. Enter the Type of webhook event you would like to subscribe to.
  5. Click SAVE.

A complete list of webhook events is provided in the Developer Guide.

Webhook Status Monitoring

Click on a created webhook to monitor the status of your webhooks in real-time, with detailed insights into status codes.

HTTP Response Codes overview

This dashboard helps you identify potential issues, track success/failure rates, and ensure optimal webhook performance.

StatuscodeDescription
0The request never reached the server, e.g. due to network issues, timeouts, or client-side failures.
200 (OK)The request was successful, and the server returned the expected response.
400 (Bad Request)The server could not understand the request due to invalid syntax or missing parameters.
500 (Internal Server Error)The server encountered an unexpected condition that prevented it from fulfilling the request.

Checkout Webhooks

Checkout Webhooks are deprecated and will be removed in future releases. Please avoid using them in new implementations. Please use Admin-Webhooks for new implementations.

Add a webhook

  1. Go to Shops > Shop > Storefront > Checkout Settings > Checkout Webhooks.
  2. Click Add Webhook.
  3. Enter Authentication field.
  4. Enter the Type of webhook event you would like to subscribe to.
  5. Click SAVE.

A complete list of webhook events is provided in the Developer Guide.

New webhook

Auto Soft Delete Obsolete Products

With soft delete, products remain in the database, but are inactive and no longer visible in shops.

Sometimes you may not want outdated products to be completely deleted from the database right away. An example would be when merchants have not updated a product for a long time. The system can automatically detect such products and perform a "soft" delete whereby products remain in the database, but are inactive and thus no longer visible in shops.

Once soft deletion has been enabled, you can specify how many days a product must be un-updated for it to be scheduled for soft deletion. The soft deletion will then take place automatically.

If activated, you can also soft delete products manually via the product detail page. However, you can still access the product via the product ID. When the item is uploaded again into the system as a merchant product, it can be reactivated with the product assignment.

It is possible that merchant products uploaded to the system are already provided with a soft delete (for example, if a product is currently not available).

Create Merchant Product Before Deletion

If a merchant product is uploaded to the system with a preexisting soft delete, the product can still be created when this setting is enabled. If the setting is disabled, no product will be created.

Old Price Calculation

Instead of simply adopting the old price of a product, the price can also be selected based on predefined logic (for example, the recommended retail price). These rules are not defined in the SCAYLE Panel, but in the database. However, the function can be enabled and disabled in the SCAYLE Panel.

Sync Style Level Attributes values Enabled

Products with the same core criteria have the same "style" (also: master ID or style ID). If one of these products has its master-level attribute values adjusted, the change will be applied to all products with the same style key.

If the synchronization on style level is active, you do not have to adjust all new variants manually. You can easily take over the attributes from existing ones.

Carriers

To add a new carrier, including name, logo, and tracking URLs:

  1. Go to Settings Settings > General > Configuration > Carriers.`
  2. Click + Add New Carrier.
  3. Upload a carrier logo (optional).
  4. Enter Carrier Name, Carrier Code, Carrier Group Name, Tracking URL (all required).
  5. Enter Tracking Email, Tracking Tool (optional).
  6. Select whether it is external tracking (Yes/No) and display track & trace (Yes/No).
  7. Click Create.

Added carriers are then available in relevant shop-level settings such as Shipping Options.

Carrier Type Details

Content Delivery Network URLs

Often data, such as images, are located on separate servers. You can provide access to this data in the SCAYLE Panel by creating Content Delivery Network (CDN) URLs. Added URLs include a Mime Type for the desired format as well as the URL accessing the server. All requested data can be retrieved from a single URL regardless of the file type. Alternatively, you can create different URLs for different file formats.

To add a CDN URL:

  1. Go to Settings > General > Configuration > CDN URLs.
  2. Click + CREATE.
  3. Enter the URL and Mime Type.
  4. Click CREATE.

To add a shop-specific CDN URLs:

  1. Go to Shops > Shop Name > General > Overview.
  2. Click Edit and change the entry in the CDN line.

Flag For New Products

You can set how long a product is flagged as New or use the default value.

New flag default value: 30 days

To set a custom Flag for New Products:

  1. Go to Settings > General > Configuration > Flag for New Products.
  2. Select Manual configuration , then click the + NEW PROPERTY button.
  3. In the dialog, select the shop and enter the number of days the flag should be active.
  4. Click CREATE.

Delete your entries by clicking the trash can icon.

Global Shop Properties

If you want shop properties to apply to the whole shop, you can define them in this area. This option is often used for general rules, but also variable properties like payment methods.

Import Demo Data

The Import Demo Data feature gives first-time users a chance to explore the various functionalities using sample data. You can to skip this import and access it later via: Settings > General > Configuration > Import Demo Data. You can import demo data for products, customers, and orders. To import orders, you must first import product and customer demo data.

The customers demo data import feature is currently in development and you will be able to access it soon.

To import demo data:

  1. Select a data type from Products, Orders, or Customers. Orders can only be selected if product and customer demo data is imported.
  2. Choose from the drop-down a list of product types such as Fashion, Home & Living, Food, Electronics, or Books.
  3. After product selection, the orders section gets enabled. Select Orders.
  4. Click Import.

Import Demo Data

You will now receive a confirmation pop-up from the system about the demo data import being initiated. The status of this import can be viewed from the imports page.

Once the import is done, you can view the products. You may add product Attribute Groups, master categories, variants, and so on. You may also see how the orders are placed. This will give you an idea of the environment.

Unlike importing orders, you can independently import product or customer demo data as well.

It is recommended to use the Import Demo Data feature on a fresh setup. In a test /live /production environment the usage of this feature may break your current configurations or override existing data.

Logo Upload

The custom logo upload replaces the SCAYLE logo in the main navigation, as well as in emails. To be rendered correctly in all the situations, the image must follow these rules:

  • Format: PNG or SVG
  • Size: Less than 1MB
  • Max resolution: 192x32 px

Regional Taxes

When dealing with different tax rates, it is essential to have a double security layer. Therefore, you can define all expected merchant tax rates in the SCAYLE Panel yourself to ensure the data always corresponds to the correct value. These rates will then be automatically compared with imported prices. If a tax rate does not match the expected one, you will be notified.

To add a new tax rate:

  1. Go to Settings > General > Configuration > Regional Taxes.
  2. Click CREATE.
  3. Select Country and Merchant (optional).
  4. Enter the Tax Rate (%).
  5. Click CREATE.

The tax rate itself depends on the country and product.

Click on the pen icon to the right of an entry to edit the data set or on the trash bin icon to remove an entry. You can create several entries for each merchant in different regions with the respective tax rate.

Adding Regional Taxes

Shipping Options

Logistics Managers are able to set and configure shipping options within the SCAYLE Panel. Here you can define a key and set whether the option requires date/time scheduling.

For example, below are four shopping options, with one (scheduled_delivery) requiring both date and time scheduling.

KeyRequires date schedulingRequires time scheduling
standard_deliveryFalseFalse
express_deliveryFalseFalse
scheduled_deliveryTrueTrue
least_packagesFalseFalse

The Shipping Options can be configured further under Checkout Settings. Here, the user can assign existing shipping options to a country and add details like cost, carrier, etc.

Sale Calculation

The sale calculation setup lets you define the conditions under which products are returned as on sale by SCAYLE's Storefront API.

There are two different methods that may be used for this:

  • Configuring Sale Minimum Percentage for Discount Eligibility
  • Minimum Discount Threshold for Automatic Price Updates

Permissions

These settings can only be viewed or updated with these permissions:

  • CONFIGURATION__SALE_CALCULATION__SHOW - See the configured values
  • CONFIGURATION__SALE_CALCULATION__UPDATE Change the configured values

Configuring Sale Minimum Percentage for Discount Eligibility

The sale_minimum_percentage field allows you to configure the minimum percentage difference between the old price and the current price required to qualify as a sale. When this condition is met, SCAYLE’s Storefront API will return a variant marked with a sale flag.

Minimum Discount Threshold for Automatic Price Updates

The min_discount_threshold field allows you to enter the threshold for copying the old price from the merchant (e.g., your SAP system) to the product-level old price. When the ratio of the merchant price to the old price meets or exceeds this threshold, the prices are automatically updated at the product level.