Curosa
Supplier Portal API Reference New

Settings

Delivery Cost Profiles

Set up delivery cost zones and profiles to charge customers different delivery amounts based on their location and distribution centre

Overview

Delivery Cost Zones and Profiles allow you to charge customers different delivery amounts based on their location. This is especially useful when delivery costs vary significantly by geographic area (e.g., remote locations, different countries, or areas requiring special handling).

How it works:

  • Delivery Cost Zones define geographic areas (e.g., England, Wales, London, Scotland) by grouping postcode prefixes. Each zone is linked to a site and contains delivery areas.
  • Delivery Cost Profiles are named sets of zone-based delivery costs for a specific distribution centre (e.g., "Standard UK Delivery", "Express Delivery"). Each profile lists the delivery cost for one or more zones.

Typical workflow: Create zones first and assign postcode areas to them, then create profiles and add delivery costs for each zone you want to support.

Accessing Delivery Cost Settings

Both sections are located under Settings in the supplier dashboard:

  1. Navigate to Settings in the sidebar navigation
  2. Click on:
    • Delivery Cost Zones – to manage zones and their postcode areas
    • Delivery Cost Profiles – to manage profiles and zone costs per distribution centre

Tip: Create zones before creating profiles, as profiles require zones to be set up first. This ensures zones are available when you're configuring delivery costs.

Delivery Cost Zones

Viewing Zones

The Delivery Cost Zones list shows:

  • Zone Name – Name of the zone (e.g. England, Scotland).
  • Site – Site the zone belongs to (zones are filtered by the site’s country).
  • Areas – Number of postcode prefixes (delivery areas) in the zone.
  • Used in profiles – Number of delivery cost profiles that use this zone.
  • Active – Whether the zone is active.

You can filter by Site, Active (Active/Inactive), and Trashed (deleted zones).

Creating a Zone

  1. On the Delivery Cost Zones page, click Create.
  2. In the modal, complete:
    • Site (required): Choose the site. Delivery areas will be limited to that site’s country. This cannot be changed after creation.
    • Zone Name (required): e.g. "England", "Wales", "London", "Scotland".
    • Active: Leave on to use the zone in profiles.
    • Delivery Areas (required): Click to open the selection modal, then choose the postcode prefixes that belong to this zone. You must select at least one area. The list is filtered by the site’s country; pick a site first if the field is disabled.
  3. Click Create to save.

Editing a Zone

  1. Open the Actions menu (three dots) on the zone row.
  2. Click Edit.
  3. Change Zone Name or Active as needed. Site and Delivery Areas can be adjusted (site drives which delivery areas are available).
  4. Click Save.

You can also Delete or Restore (if trashed) from the same menu.

Delivery Cost Profiles

Viewing Profiles

The Delivery Cost Profiles list displays:

  • Distribution Centre: The distribution centre this profile applies to
  • Profile Name: The name of the profile (e.g., "Standard UK Delivery", "Express Delivery")
  • Zone Costs: Number of zone costs in the profile (hover to see zone names)
  • Default: Whether this is the default profile for that distribution centre
  • Active: Whether the profile is active (only active profiles can be used)

Filtering Profiles

You can filter profiles to find specific entries:

  • Distribution Centre: Filter profiles by distribution centre
  • Active: Filter by Active/Inactive status
  • Default: Filter to show only default profiles
  • Trashed: View deleted profiles (soft-deleted profiles can be restored)

Viewing a Profile in Detail

To view complete information for a profile:

  1. Find the profile in the list
  2. Click the Actions menu (three dots) on the profile row
  3. Select View
  4. The view page shows:
    • Profile details (name, distribution centre, default status, active status)
    • A table of all delivery costs per zone showing:
      • Zone name
      • Display name (customer-facing)
      • Price (including tax)
      • Tax rate
      • Additional leadtime (days)
      • Active status

Use the Edit button in the header to modify the profile.

Creating a Profile

  1. On the Delivery Cost Profiles page, click Create.
  2. In the modal, complete the main fields:
    • Distribution Centre (required): Choose the distribution centre this profile applies to. This cannot be changed after creation.
    • Profile Name (required): e.g. "Standard UK Delivery", "Express Delivery".
    • Default Profile: Turn on to use this profile as the default for new products at this distribution centre. Only one profile per distribution centre can be default; turning this on will clear the default from any other profile for the same centre.
    • Active: Leave on to use the profile.
  3. In Delivery Costs per Zone:
    • Click Add Zone Cost for each zone you want to charge for.
    • For each row, fill in:
      • Zone (required): Choose a zone. The list only shows zones for your supplier that match the distribution centre’s site. Each zone can only be added once per profile.
      • Display Name (required): Customer-facing name, e.g. "Free Standard Delivery", "Standard UK Delivery".
      • Price (inc. tax) (required): Amount in £ (minimum 0).
      • Tax Rate (required): Select the applicable tax rate.
      • Additional Leadtime (days): Extra days on top of standard dispatch (0–365). Optional; default 0.
      • Active: Leave on to include this option.
  4. Click Create to save.

Tips:

  • Create and activate the zones you need first so they appear in the Zone dropdown.
  • Zones are filtered by the distribution centre’s site; if the list is empty, check that you have zones for that site.

Editing a Profile

  1. Open the Actions menu on the profile row and click Edit (or View then Edit).
  2. Change Profile Name, Default Profile, or Active as needed. Distribution Centre cannot be changed.
  3. In Delivery Costs per Zone you can:
    • Add more zone costs with Add Zone Cost (each zone only once per profile).
    • Edit existing rows (zone, display name, price, tax rate, leadtime, active).
    • Remove rows you no longer need.
  4. Click Save.

You can Delete or Restore (if trashed) from the Actions menu.

How Profiles Are Used on Products

  • When you manage a product’s distribution centres (e.g. on the product’s delivery/pricing area), you can assign a Delivery Cost Profile per distribution centre.
  • If you don’t choose a profile, the system uses the default profile for that distribution centre (if one is set and active).
  • At checkout, the customer’s delivery cost is determined by their postcode (which zone they’re in) and the zone costs defined in the profile assigned to the product for the relevant distribution centre.

Validation and Rules

  • Zones: At least one delivery area (postcode prefix) is required per zone. Choose a site first so the delivery areas list is available.
  • Profiles: Each zone can only appear once in a profile’s delivery costs. Price must be ≥ 0; additional leadtime must be between 0 and 365 days.
  • Default profile: Only one profile per distribution centre can be marked as default. Setting a profile as default automatically clears the default from the others for that centre.
  • Deleting: Deleted zones and profiles are soft-deleted; use the Trashed filter to see them and Restore if needed.

Empty States

  • No delivery cost zones: The message suggests creating zones first, then creating profiles and assigning zone costs.
  • No delivery cost profiles: The message suggests creating zones under Delivery Cost Zones first, then adding a profile and assigning zone costs.

If you need zones or profiles for a new site or distribution centre, create the zones for that site first, then create the profile for the chosen distribution centre and add the zone costs.