Shipping and Delivery Overview

Ask about this Page
Copy for AI
View as Markdown

Overview of the concepts related to shipping and delivery of Orders in your Project.

Learn more about how to implement shipping information collection as part of a custom checkout flow in our self-paced Implement a custom checkout module.

Shipping versus Delivery

We differentiate conceptually between the shipping addresses of the Cart and the delivery addresses of the Order.

  • The shipping addresses captured during checkout represent the request of the customer as to where the individual items should be shipped.
  • The delivery information captured for the Order represent how the Order is actually fulfilled.
Therefore, the delivery information is not automatically set on the Order based on which shipping addresses are set on the Cart. For how to add delivery information to an Order, see Shipping and Delivery APIs overview.

Multiple deliveries

Multiple Deliveries can be added to the same Order to represent split or partial shipments. A single Line Item or Custom Line Item quantity can be distributed across several Deliveries, and further split into multiple Parcels within a Delivery.
For how quantities across Deliveries are validated, see Shipping and Delivery APIs overview.

Typical scenarios include:

Large items shipped as one Delivery but with multiple Parcels: A single Line Item is fulfilled in one Delivery, but due to size, it is packaged into several Parcels. For example, a wardrobe that is too large to send in a single box and must be split up.
Line Items with multiple units fulfilled across multiple Deliveries: A Line Item with quantity greater than one is shipped in stages, with each Delivery sending part of the total quantity. For example, an order of 5 T-shirts where the first Delivery ships 2 T-shirts, and a later Delivery ships the remaining 3 T-shirts.
Single large or complex items fulfilled across multiple Deliveries: A single Line Item is shipped in stages, with each Delivery sending different components of that item. For example, custom furniture where the initial Delivery ships core components, and a subsequent Delivery ships remaining parts.

Shipping addresses

When the Cart is configured for a single Shipping Method (the default), the shipping address of the Cart determines the following:

  • The Shipping Methods that are available and their shipping rates
  • The Tax Rate applied to each (Custom) Line Item and the shipping rate
For how the shipping address is set and used for tax calculation, see Shipping and Delivery APIs overview.

Ship to a single address

To ship all (Custom) Line Items of the Cart to the same address using the same fulfillment method, use a single Shipping Method.
To ship all (Custom) Line Items of the Cart to the same address, using more than one fulfillment method, use multiple Shipping Methods.
For how to ship items to multiple addresses, see Shipping and Delivery APIs overview.

Shipping Methods

Shipping Methods model the fulfillment option that you assign to a Cart or, when the Cart is configured to support multiple Shipping Methods, to individual Line Items. A Shipping Method combines the delivery option, tax category, predicate-based eligibility, and Zone-based shipping rates for options such as standard delivery, express delivery, or in-store collection.
Shipping Methods can optionally be scoped to specific Stores. If no Stores are assigned, the Shipping Method is global and available to all Carts. If one or more Stores are assigned, the Shipping Method is Store-scoped and the following validation applies whenever it is used on a Cart:
  • A Cart that belongs to a Store can use Shipping Methods scoped to that Store, as well as global Shipping Methods.
  • A Cart that belongs to a Store cannot use Shipping Methods scoped to a different Store.
  • A Cart that does not belong to a Store can only use global Shipping Methods.
For the error returned when the Store scoping of a Shipping Method does not match the Cart, see Shipping and Delivery APIs overview.
For how frozen Carts affect Store scoping, see Carts and Orders APIs overview.
For how to define a default Shipping Method, see Shipping and Delivery APIs overview.
You can set the shipping rates and the geographical area(s) covered by a Shipping Method using Zones.

Predicates

Predicates allow you to define rule-based logic to determine which Shipping Methods are eligible for a Cart during checkout.

For example:

  • Shipping Method "Express" should only be offered for Carts with Line Items that are eligible for express shipping.
  • Shipping Method "Overnight" should not be offered to a certain segment of the customers.
  • Shipping Method "Ground" is the only method available for Carts with bulky items weighing more than 10 kg.
  • Shipping Method "Scandinavia" is the only method available for Carts in the Store for Sweden.
Shipping predicates take into account the entire scope of the Cart, regardless of associations to Line Items. For example, a Shipping Method with a predicate that requires a total Cart price above 100.00 USD will be applicable even if only $10 worth of goods is associated with it, so long as total Cart price satisfies the predicate. Similarly, this also applies to the Shipping Method's free-above price.
For business-rule design examples, see the Predicates self-learning page. For how predicates are set and evaluated with the API, see Shipping and Delivery APIs overview.

Shipping Rates

A shipping rate is the price configuration inside a Shipping Method for a specific Zone and currency. Shipping rates are defined in the Shipping Method's Zones, and they determine the shipping price that applies when that Shipping Method matches the Cart.

Fixed shipping rates

A fixed shipping rate is a rate assigned to a Shipping Method that never changes, even if the content or the conditions of a Cart is modified.

Tiered shipping rates

The alternative to fixed shipping rates is tiered shipping rates. This allows you to set shipping rates that increase or decrease, based on the tiers that you define. For example, you might want the shipping rate to decrease based on the Cart value, meaning the more money the customer is spending, the cheaper the shipping becomes.

For the types of shipping rate tiers, how to enable them, and examples, see Shipping and Delivery APIs overview.

Free shipping

The following free-shipping mechanisms are supported:

Free above: A free-above threshold belongs to a fixed shipping rate on a specific Shipping Method.
Cart discounts: This option applies the same free shipping threshold amount across all Shipping Methods by default. However, it is possible to restrict a Cart Discount to only certain Shipping Methods using Cart Predicates.
We strongly recommend that you choose only one of these methods and not use both at the same time.
Learn more about free-shipping strategy and discount trade-offs in our self-paced Apply discounts to shipping module.
For how free shipping, shipping rates, and shipping taxes are calculated with the API, see Shipping and Delivery APIs overview.