Configuring shipping carriers

In Kentico, shipping options are provided by carriers and services of these carriers. Imagine a carrier as a package which carries some shipping functionality; for example, a typical carrier is a FedEx carrier which returns shipping availability and price from FedEx. However, FedEx offers more than one type of shipping. That’s why carriers provide services. In the example with the FedEx carrier, its services can be the International Priority service for a quick international delivery and the International Economy service for a slower but cheaper international delivery. If your on-line store has this carrier, then you are able to create shipping options in the Kentico administration interface that offer customers the FedEx International Priority shipping and the FedEx International Economy shipping.

By default, the Kentico E-commerce Solution offers the Default carrier. The Default carrier provides the Weight based shipping service on which you can base shipping options with costs in levels according to weight of products in customers’ shopping carts. Developers can also implement custom carriers and add them to your Kentico. For example, you can add either carriers that provide services offering shipping based on the day of the week, based on customer’s address, etc., or more complex carriers, i.e., when you want to work with shipping providers (e.g., FedEx, USPS, Australia Post) and communicate with their systems to be able to calculate the actual shipping cost real-time.

After a developer implemented and installed a custom carrier provider to your Kentico instance, create and configure a carrier in the Kentico administration interface. Then you can create shipping options based on services of the carrier. You can manage carriers on the Shipping -> Carriers tab in the Store configuration application.

Creating and editing carriers

  1. Open the Store configuration application.

  2. Navigate to the Shipping -> Carriers tab.

  3. To create a new carrier, click New carrier. To edit an already existing carrier, click Edit () in the Actions column.

  4. Enter properties of the carrier:

    • Name – specifies the name of the carrier displayed in the administration interface.
    • Code name – specifies the name of the carrier used by developers in the code.
    • Carrier provider – specifies the assembly and its class that provides functionality of the carrier. The carrier provider can be set only when creating a carrier, it cannot be changed later.
  5. If editing a carrier, there can be another configuration tab with additional properties of the carrier. However, it can vary because it depends on the carrier. If possible, switch to the tab and enter the additional properties. See the example in the picture with the Configuration tab.
    Possible another configuration tab

    Always check if the carrier has a configuration tab and set all fields on the tab!

    If you leave fields on the configuration tab empty or you enter incorrect values to them, the system will allow you to create shipping options based on the carrier anyway. However, if they are required for correct functionality of the carrier, the carrier may work incorrectly and possibly cause errors.

  6. Click Save.

The system saves the carrier. From now on, you can create shipping options based on services of this carrier.

Removing carriers

To remove a carrier, click Delete () in the Actions column on the line of the carrier you want to remove.

You cannot remove a carrier on which an existing shipping option is based. To remove such a carrier, you need to remove those shipping options first.