Carrier

Overview

Carriers are the service providers that deliver your customers' orders. While some Carriers operate in multiple countries other Carriers may be very country-specific.

SCAYLE offers multiple ways to individualize the Checkout experience.

You may

• customize default Carriers
• configure new Carriers
• assign dedicated Shipping Options to specific Carriers
• optimize costs by setting Minimum Order Values for free shipping
• …and customize a lot along the way.

Understanding Carrier

In SCAYLE's logistics and shipping system, the Carrier concept is defined by two key elements:

1. CarrierKey (Carrier Code)
2. CarrierGroupKey

Those keys serve distinct functions within the shipping process. In combination, they streamline both the logistical and user-facing aspects of the shipping process and are configured as Carrier Type.

CarrierKey (Carrier Code)

The carrierKey defines, which shipping provider is used, when a customer places an order. Carrier keys are often country-specific (i.e. hermes_at) as shipping contracts are typically tailored to individual countries.

The logistics system uses the carrierKey, allowing warehouses to identify the actual Carrier responsible for fulfilling the shipment.

The carrierKey is created and stored in SCAYLE's system when a new Carrier Type is created in the SCAYLE Panel.

CarrierGroupKey

The carrierGroupKey controls how the Carrier is visually represented during the Checkout process.

Unlike the carrierKey, carrierGroupKeys are pre-configured by SCAYLE and cannot be modified. However, existing carrierGroupKeys can be used when setting up a new Carrier Type or configuring a Carrier for a specific shop country.

It specifies the Carrier’s logo and translation key, ensuring consistent visualization across different shop countries. Additionally, Shipping Options are visually grouped under a specific Carrier based on its distinctive carrierGroupKey.

The carrierGroupKey also plays a crucial role for Collection Points, where conditional logic is used to render fields like carrierCustomerID, which are linked to the carrierGroupKey.

Carrier Group Keys are also used by the system to verify if individual packages can be sent via the specified Carrier. The validation occurs in the background when the user enters the Checkout flow.

Data Mapping

To understand naming differences across different systems use the following data mapping table

Relation to other Service

Carriers are deeply connected to other Checkout Services like Shipping Options and Collection Points or to global configurations like Merchants.

Once set up, the selected Carrier and its Shipping Options are automatically attached to the order. After the order is confirmed, the selected parameters are forwarded to the individual warehouse or logistic system to fulfill the order.

Best Practices

To make the most out of Carriers, the following Best practices should be applied.

• Always use the same carrierGroupKey & carrierKey across Global settings and country-specific Checkout configurations, so your setup is easier to maintain.

Available Carrier Group Keys

At SCAYLE, the Checkout Webcomponent comes with pre-configured carrierGroupKeys. Those keys define the carrier logo and are related to the translation key in the Checkout Webcomponent.