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
- Auto Soft Delete Obsolete Products
- Create Merchant Product Before Deletion
- Old Price Calculation
- Sync Style Level Attributes Enabled
- Carriers
- Content Delivery Network URLs
- Collection Point Types
- Flag For New Products
- Global Shop Properties
- Import Demo Data
- Logo Upload
- Regional Taxes
- Shipping Options
- Sale Calculation
Admin-Webhooks
Please use Admin-Webhooks for new implementations, which will fully replace Checkout Webhooks in the future.
Add a webhook
- Go to
Settings > General > Configuration > Admin Webhooks.
- Click Add new Webhook.
- Enter Authentication field.
- Enter the Type of webhook event you would like to subscribe to.
- 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.
This dashboard helps you identify potential issues, track success/failure rates, and ensure optimal webhook performance.
Statuscode | Description |
---|---|
0 | The 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
- Go to
Shops > Shop > Storefront > Checkout Settings > Checkout Webhooks.
- Click Add Webhook.
- Enter Authentication field.
- Enter the Type of webhook event you would like to subscribe to.
- Click SAVE.
A complete list of webhook events is provided in the Developer Guide.
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:
- Go to
Settings Settings > General > Configuration > Carriers
.` - Click + Add New Carrier.
- Upload a carrier logo (optional).
- Enter Carrier Name, Carrier Code, Carrier Group Name, Tracking URL (all required).
- Enter Tracking Email, Tracking Tool (optional).
- Select whether it is external tracking (Yes/No) and display track & trace (Yes/No).
- Click Create.
Added carriers are then available in relevant shop-level settings such as Shipping Options.
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:
- Go to
Settings > General > Configuration > CDN URLs
. - Click + CREATE.
- Enter the URL and Mime Type.
- Click CREATE.
To add a shop-specific CDN URLs:
- Go to
Shops > Shop Name > General > Overview
. - 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:
- Go to
Settings > General > Configuration > Flag for New Products
. - Select Manual configuration , then click the + NEW PROPERTY button.
- In the dialog, select the shop and enter the number of days the flag should be active.
- 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:
- Select a data type from Products, Orders, or Customers. Orders can only be selected if product and customer demo data is imported.
- Choose from the drop-down a list of product types such as Fashion, Home & Living, Food, Electronics, or Books.
- After product selection, the orders section gets enabled. Select Orders.
- Click Import.
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:
- Go to
Settings > General > Configuration > Regional Taxes
. - Click CREATE.
- Select Country and Merchant (optional).
- Enter the Tax Rate (%).
- 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.
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.
Key | Requires date scheduling | Requires time scheduling |
---|---|---|
standard_delivery | False | False |
express_delivery | False | False |
scheduled_delivery | True | True |
least_packages | False | False |
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 valuesCONFIGURATION__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.