Delivery options module

Article
08/12/2022

This article covers delivery options modules and explains how to configure them in Microsoft Dynamics 365 Commerce.

Delivery options modules let customers select a mode of delivery such as shipping or pickup for their online order. A shipping address is required to determine the mode of delivery. If the shipping address changes, the delivery options must be retrieved again. If an order includes only items that will be picked up in a store, this module is automatically hidden.

For information about how to configure modes of delivery, see Online channel setup and Set up modes of delivery.

Each delivery mode can have an associated charge. For more information about how to configure charges for an online store, see Omni-channel Advanced auto-charges.

In Commerce version 10.0.13, the delivery options module has been updated to support the Header charges without proration and Shipping as a line charge features. If proration is turned off, the expectation is that the e-Commerce workflow won't allow a mixed mode of delivery for the items in the cart (that is, some items are selected for shipment, but others are selected for pickup). The Header charges without proration feature requires that the Enable consistent delivery mode handling in channel flag is turned on in Commerce headquarters. When the feature flag is turned on, shipping charges will be applied at either the header level or the line level, depending on the configuration in Commerce headquarters.

The Fabrikam theme supports a mixed mode of delivery, where some items are selected for shipment but others are selected for pickup. In this mode, shipping charges will be prorated for all items that are selected for the shipping mode of delivery. For a mixed mode of delivery to work, you must first configure the Header charges with proration feature in Commerce headquarters. For more information about this configuration, see Prorate header charges to match sales lines.

If shipping charges apply to line items, they can be shown on the cart line for each item. This functionality requires that the Show shipping charges on line item property be turned on for both the cart module and the checkout module. For more information, see Cart module and Checkout module.

The following illustration shows an example of a delivery options module on a checkout page.

Example of a delivery options module on a checkout page.

Delivery options module properties

Property	Values	Description
Heading	Heading text and a heading tag (H1, H2, H3, H4, H5, or H6)	An optional heading for the delivery options module.
Custom CSS class name	Text	A custom Cascading Style Sheets (CSS) class name that will be used to render this module, if applicable.
Filter Delivery Mode Option	Do not filter or Non-shipping modes	A value that specifies whether the delivery options module should filter out all non-shipping delivery modes.
Auto select a delivery option	Do not filter, Auto select delivery option and show summary, or Auto select delivery option and don't show summary	This property automatically applies the first available delivery option to checkout without requiring the user to select it. It should be used only if there is one available delivery option. This property is supported as of the Commerce version 10.0.19 release.

Add a delivery options module to a checkout page and set the required properties

A delivery options module can be added only to a checkout module. For more information about how to configure the delivery options module and add it to a checkout page, see Checkout module.

Note

You might experience inconsistent delivery handling, or you might not see non-prorated header-level charges in your e-commerce channel. For guidance about how to fix these issues, see Enable consistent delivery mode handling in e-commerce channels.