To create a new delivery option, click the Create Delivery Option button on the list page to begin building your logic.
Step 1: Delivery option details
Define the basic details for this delivery option, including how it is identified internally and what your customers see at checkout:
Internal name: Only visible in Scurri, to help you easily identify this option later. We recommend a name that outlines the scenario it powers.
Name at checkout: The customer-facing name displayed at checkout (e.g., "Next Day Delivery").
Description: Optional text to add extra context for the customer (e.g., "Order before 4pm for delivery tomorrow").
Shipping cost: Set the static shipping cost and currency to be displayed to the customer for this option.
Step 2: Checkout offering
Configure how orders are delivered and manage the related customer checkout experience.
Home delivery (default): When creating a delivery option, it is set to home delivery by default.
Out-of-home delivery: This allows you to set up a collection option instead. You can choose between:
Carrier locations: For carrier pick-up/drop-off (PUDO) points, such as stores or postal collection points. These locations are provided by the carrier.
Own locations: For retailers' own locations, such as stores or warehouses. These are provided by you.
If "Out-of-home delivery" is chosen, you will need to configure:
Location category: Choose one or more location types (such as locker, collection point, store, etc.). This filters the list of locations to display only the location types you want at checkout.
Max. number of locations: This allows you to limit the total number of locations returned in the API response.
Max. distance radius: Additionally, you can set a maximum distance (in kilometres) from the customer's delivery address that locations will be shown for. For example, only show locations within a 20km radius of the recipient's address.
Tip: To include the retailer's own locations, see the Own Locations API documentation.
Step 3: Display conditions
This is the logic of your delivery option. Specify the conditions that need to be met in order for this option to be allocated to.
Destination: Limit options to specific countries or postcodes.
Basket contents: Base options on weight, SKU, or total order value.
Time: Show or hide options based on your warehouse cut-off times.
NOTE: For the full list of available condition types, operators, and wildcard/grouping syntax, see Conditions & Operators.
Step 4: Allocation
Select the carrier and service that should be assigned if this delivery option is allocated to. Optionally, define enhancements for the carrier service for additional service-level features.
Ship from warehouse
To explicitly route shipments from a specific warehouse, select the warehouse name from the "Ship from" dropdown. If you leave this field unset (the default), the system will use the warehouse specified on the shipment when it is imported into Scurri.
Tip: This is useful when you have multiple warehouses and want certain delivery option to apply only to shipments from specific locations.
Allocation type
You can define how to allocate to a carrier and service in two different ways:
Single carrier service: Allocate all matching to one specific carrier and service that you select.
Find cheapest: Select multiple carrier services, and the system will automatically allocate to the cheapest option among them. This is ideal when you want cost-optimisation while maintaining a choice of carriers and services.
Testing your setup
We recommend testing your logic by configuring your sandbox account first, before deploying to production.
For full technical specifications and schema details, please refer to our API Documentation.