docs
  1. SCAYLE Resource Center
  2. Configure
  3. Carrier & Shipping
  4. Shipping Options

Shipping Options

Overview

At SCAYLE, Shipping Options refer to the various methods available for delivering goods to customers. Whether it's standard delivery, express shipping, scheduled delivery, or special handling for freight items, SCAYLE provides the flexibility to personalize the delivery experience based on destination, delivery speed, and order size.

Shipping options also determine the fees associated with each delivery method. Specific rates can be set for standard or express shipping, VAT on shipping charges can be customized, minimum order values for free shipping can be established, and items can be consolidated into a single delivery for added convenience.

Each Shipping Option is linked to an individual Carrier. These options are not limited to Home Delivery but can also be applied to Collection Points like in-store pickups.

Understand Shipping Options

At SCAYLE, the technical term used for defining the delivery options associated with a customer’s order during the Checkout flow is Shipping Policies.

Depending on the configuration, the customer can pick from multiple Shipping Policies for the order, such as standard or express delivery. Each Shipping Policy includes parameters that directly influence the Checkout Experience, such as carrier, fees, and distinctive configurations.

A Shipping Policy includes a Shipping Policy Key that is linked to a specific Shipping Option configured globally in the SCAYLE Panel. This setup allows each Shipping Option, such as standard_delivery to be tailored for different country shops by assigning parameters like baseShippingServiceCost, additionalExpressShippingServiceCost, and carrierGroupKey. This enables flexible, customized shipping configurations for various regions.

The carrierGroupKey organizes available Shipping Options under the assigned Carrier component in the Checkout Webcomponent. For details on carrierGroupKeys, please refer to Available Carrier Group Keys.

Below is an example of an available Shipping Policy, representing a "Standard Delivery" option associated with the carrier "Hermes".

Shipping Policy Example

 "availableShippingPolicies":[
      {
         "additionalExpressShippingServiceCost":{
            "taxAmount":0,
            "taxRate":0.19,
            "withTax":0,
            "withoutTax":0
         },
         "baseShippingServiceCost":{
            "taxAmount":0,
            "taxRate":0.19,
            "withTax":0,
            "withoutTax":0
         },
         "carrierKey":"Hermes",
         "config":{
            "logisticalPhoneNumber":"optional",
            "minBruttoOrderValue":2990,
            "typePolicyZipList":"block_list"
         },
         "deliveryDays":{
            "maximum":2,
            "minimum":1
         },
         "key":"standard_delivery",
         "minBruttoOrderValueAfterReturns":9500,
         "rank":{
            "app":2,
            "desktop":2,
            "mobile":2

Shipping Options Entity Relationship

Understand Shipping Options

Checkout defaults

Default Shipping Options

From a translation standpoint, we recommend to reuse default Shipping Options, such as:

  • express_delivery - "Express Delivery"
  • free_delivery - "Free Delivery"
  • scheduled_delivery - "Scheduled Delivery"
  • standard_delivery - "Standard Delivery"
  • least_packages - "All Items in One Delivery"

For instance, if you want to use the functionality for scheduled_delivery, the naming must match exactly. Changing it to something like dhl_scheduled_delivery would break the functionality, such as the date picker.

Webcomponent defaults

When setting up Shipping Options for the first time, both the Checkout Webcomponent and Backend configurations are automatically set by default. You can find a list of these default configurations below. All default options can be individually adjusted under the Customize section.

"shippingOptions": 
    "descriptions": 
      "short": false,
      "toolTip": false,
    "hideDeliveryEstimation": false
CustomizationDefaultDescription
hideDeliveryEstimationsfalseBy default, delivery estimates are displayed on the right side of the order summary during the Payment step
shortfalseA short description is per default not shown within the delivery option component.
toolTipfalseBy default, no tooltip is displayed in the Shipping Option component

Shipping Option Component with Short Description Enabled