Introduction

The system integrates with the Aurora Store Locator to provide a searchable (by Post Code and Name) Google Maps interface, with clickable results for ease of use when trying to find the best order collection location.

Configuring Doddle for the First Time

Aurora Back-end

Doddle Integration Settings

The Doddle integration settings can be accessed in the Aurora Backend under Store > Settings > Shipping > Doddle.

📘

By setting these up correctly and following the Doddle Template Guide, you should be able to enable the service within Aurora without any additional assistance from Aurora Commerce.

If you do however have any questions, please contact your Agency for assistance.

 Shipping rules

📘

When using the Doddle service, you will need to configure a shipping rule to be used when a Doddle collection point is selected.

An example Doddle shipping rule will automatically be created for you when the Doddle integration is set to be Enabled.

Please use the Shipping Rules support article to find out how to configure these rules and note that you will need to select Doddle Collection as the Delivery Type when configuring shipping rules for Doddle.

❗️

If you do not configure a shipping rule as described here, then your Doddle collection points will not work and may not even appear in the Store Locator.

Shipping Method

The individual shipping method might be configured as follows.

📘

Points of particular interest include:

• The Delivery Type should be set to Doddle Collection.
• The Default Courier should be configured to use the shipping service you are using to fulfil Doddle orders.

Delivery Country

In order for the Doddle Integration to utilise the correct Doddle API service, it's important to configure the Delivery Country postcode format (i.e. Postcode Regex) within:

Orders > Shipping > Countries > United Kingdom

📘

Use a Postcode Regex similar to the following in order to match United Kingdom postcodes:

[A-Z]{1,2}[0-9][0-9A-Z]?\s?[0-9][A-Z]{2}

The Front-end Checkout Store Locator

When the Doddle integration is enabled and configured, the Checkout Store Locator will include Doddle collection points i.e.

Physical Store Preference

A typical store list will include physical stores and Doddle collection points - which will be ordered by distance. The exception to this is when a physical store is within a configured radius: in that case a physical store will take precedence over any Doddle collection points, and will be added to the beginning of the stores list. The radius that determines this can be configured in Aurora Backend under Store > Settings > Shipping section. The setting is called Prefer Physical Stores instead of Collection Points when they are within (miles) and accepts a positive number.

The Front-end Checkout & Basket

Once the configuration described in the Configuring Doddle for the First Time section of this article is complete and your Front-end templates have been modified according to the Doddle Template Guide, the basket and checkout pages will allow you to select Doddle collection points.

Doddle collection points will be selectable the same way as a physical store, which can be done following these steps:

• Select the Collect in Store delivery option
• Click Search available stores, which should open up the Checkout Store Locator in a popup
• In the pop up Checkout Store Locator, select a physical store or a Doddle collection point by clicking the appropriate Choose store for delivery link.

Once you have selected a Store or Collection point, the store details will be displayed on the Basket and Checkout. For example:

📘

This article describes example behaviour supported by the Aurora, however this may vary based on each template implementation.

Please coordinate with your Agency to create your desired user journey.

This user journey is provided for illustrative purposes only.

Error Handling

📘

There are a few points at which errors can occur during the order placement process, from shipping method selection within the basket to order placement itself. Should an error occur, Aurora will do everything possible to avoid interrupting the potential customer's progression to conversion.

If the Doddle service cannot be contacted, or an error occurs during communication with the Doddle API, the Doddle collection points will not be included in the search results and an error message can be displayed to suggest that the customer should select another Branded Store or try again later:

📘

The store locator popup, accessible from the basket and checkout pages, will display errors the same way as the store locator page and all errors are customisable through the Aurora Site Text system.

Please also see the Doddle Template Guide to ensure your store locator template renders errors correctly.

Service Errors

If there are issues connecting to the Doddle service, the Aurora Integration Log can be used to observe all attempts to communicate with the Doddle API.

All request and response details are logged along with the response time of the Doddle service request.