Skip to main content

Exceptions in Delivery Services

Delivery service exceptions allow you to apply different shipping conditions within the same delivery services, based on country, region, or postcode ranges. This is typically used for areas where delivery is more expensive or requires special handling.

When to use delivery service exceptions

Use delivery service exceptions when:

  • most customers share the same delivery conditions, and

  • specific regions or postcode ranges require different shipping costs.

Exceptions are configured using Delivery service lines within a delivery service. CloudSuite evaluates delivery service lines per ** ** delivery options group:

  • If a customer’s delivery address matches a specific exception rule, that line is applied.
  • If no exception matches, the line marked as Catch all for group is used as the fallback.

Configuration

  1. In the CloudSuite App, go to Order Management > Configuration > Delivery Services.
  2. Open the delivery service you want to configure.
  3. In the General tab of the delivery service details, open an existing Line or create a new Line.

Configure the fields:

Delivery options Group

This field groups delivery service lines that share the same rule set.

  1. Use a clear, recognizable name (for example: NL or BE).
  2. All delivery service lines that belong together must use the exact same group name.
  3. A delivery service can contain multiple groups.Use the same name for all related delivery service lines in this group.

Examples:

  • NL – rules that apply to the Netherlands
  • BE – rules that apply to Belgium

Catch all for Group

This option marks the default delivery service line for a delivery options group

  1. Enable this on the line that should apply when no exception rule matches
  2. Each Delivery Options Group must have one Catch all line
  3. Check this box to mark the default delivery service line that applies when none of the other options in the delivery options group match the customer’s shipping address.
  4. Repeat this for all required delivery option groups and exception lines.
  5. Click Save.

Example: Higher shipping costs for specific postcode ranges

In this example, shipping is free for most addresses in the Netherlands, except for a specific region where higher shipping costs apply.

Configuration

  1. Create a delivery options group named NL.

  2. Add default delivery service lines for the Netherlands

    (for example, per carrier if applicable).

    1. Enable Catch all for group on these lines.
  3. Add separate delivery service lines for the exception region.

    1. Configure postcode ranges for these lines.
    2. Set the required shipping costs.

Multiple exception lines can be used if the region consists of multiple postcode ranges.

Working with multiple shops

If you manage multiple shops or sales types, it is often easier to work with one Delivery Service per shop. This gives more flexibility and avoids overlapping rules.

To set this up quickly:

  • duplicate an existing Delivery Service
  • link it to the correct shop or sales type
  • remove delivery service lines that do not apply

Result during checkout

  • When a customer enters a delivery address within one of the configured postcode ranges, the corresponding shipping cost applies.
  • For all other addresses in the Netherlands, the Free Shipping option applies.
Why this works

CloudSuite always evaluates delivery service lines within the same delivery options group.

Specific postcode-based exceptions are applied first. If no exception matches, the Catch all line is used as the fallback.