Local Delivery & AutoAddress Version 3

By integrating with Auto Address (version 3), the following functionality allows you to provide a much easier way for customers to enter their address and to automatically display the correct Local Delivery options available to them.

Once configured, you can provide the following additional features:

• Faster address entry at checkout – instead of entering their full address, customers can enter their Eircode or part of their address, select their address from the results, and the remaining address details will be automatically filled in.
• Find the nearest store – the same functionality is also added to the Select Store pop-up. Customers can enter their Eircode or part of their address and the list of stores will automatically be reordered with the nearest store at the top.
• Local Delivery Rates – you can apply a GeoJSON delivery area to a shipping rate, turning it into a Local Delivery Rate. The rate will then only be displayed on the View Basket page when the customer enters their Eircode/address and their location is within the defined GeoJSON delivery area.
• Cheapest Local Delivery Rate – if the customer's address qualifies for more than one Local Delivery Rate, only the cheapest available rate will be displayed.

AutoAddress Version 3 Required

AutoAddress Version 3 is required for the above and to use GeoJSON Local Delivery Areas.

AutoAddress Version 3 allows a customer to enter their Eircode or part of their address and returns the longitude and latitude of the selected address to the website. AB Commerce uses these coordinates to determine whether the customer is within a GeoJSON Local Delivery Area.

The upgrade to AutoAddress Version 3 within AB Commerce is free, but you will need an account with AutoAddress and their own charges will apply. Contact the AB Commerce Help Desk and we can introduce you to our AutoAddress Account Manager, who can take you through the options and costs.

Additional Features with AutoAddress Version 3

With AutoAddress Version 3 enabled, you can also provide the following functionality:

• On the Select Store pop-up, customers can enter their Eircode or part of their address and the stores will automatically be reordered with the nearest store first.
• The Select Store pop-up can display the distance in kilometres between the customer and each store.
• It can also indicate whether Local Delivery is available to the customer's address from each store.
• On the View Basket page, customers can enter their Eircode or part of their address to check whether Local Delivery is available to them.
• If the customer qualifies for more than one Local Delivery Rate, only the lowest-priced Local Delivery Rate will be displayed.

How Local Delivery Works

A Local Delivery Rate is a normal shipping rate that has a GeoJSON delivery area applied to it.

By default, the Local Delivery Rate is not displayed on the View Basket page.

When the customer enters their Eircode or part of their address:

1. AutoAddress identifies the address and returns its longitude and latitude.
2. AB Commerce checks these coordinates against the GeoJSON delivery areas.
3. If the customer's location is inside a delivery area, the relevant Local Delivery Rate is displayed.
4. If the customer is outside the delivery area, the Local Delivery Rate remains hidden.
5. If more than one Local Delivery Rate is available for the customer's location, only the cheapest rate is displayed.

This means customers only see Local Delivery when it is actually available for their address.

For a shipping rate, you can define the local delivery area an outlet using a GeoJSON file. The GeoJSON file contains the outlet's location together with one or more delivery zones, which are used during checkout to determine whether a customer's address is eligible for local delivery.

Note that you may need an integration with AutoAddress so that your customer can enter their Eircode or first line of address so that we can get their Longitude and Latitude coordinates.  Contact the Help Desk for more information.

How to Create a GeoJSON File for an Outlet

GeoJSON files are used by AB Commerce to define the local delivery areas for an outlet. When a customer enters their address during checkout, the system determines whether their location falls within one of the outlet's delivery zones.

Each outlet has one GeoJSON file containing:

• The outlet's location.
• One or more delivery areas (polygons).

Step 1 - Open geojson.io

Open the free online editor:

https://geojson.io

No installation or account is required.

Step 2 - Locate the Outlet

Use the search box to find the outlet.

For example:

Your store address

Zoom in until the outlet is clearly visible.

Step 3 - Add the Outlet Location

Click the Point tool.

Click once on the exact location of the outlet.

In the Properties panel enter:

Example:

{
    "StoreCode": "STORE01",
    "StoreName": "Your Store Name",
    "FeatureType": "StoreLocation"
}

Step 4 - Draw a Delivery Area

Click the Polygon tool.

Click around the outside of the delivery area.

When finished, click the first point again to close the polygon.

Do not leave the polygon open.

Example:

      ●────────────●
     /              \
    ●                ●
     \              /
      ●────────────●

Step 5 - Name the Delivery Area

Select the polygon.

In the Properties panel enter:

Example

{
    "StoreCode": "STORE01",
    "FeatureType": "DeliveryArea",
    "AreaCode": "STORE01-01",
    "AreaName": "Store 1 - Area 1",
    "Enabled": true,
    "Priority": 1
}

Step 6 - Create Additional Areas

If the outlet delivers to multiple separate areas, simply draw another polygon.

Example:

Area 1

███████

            Area 2

            ██████

                     Area 3

                     ███████

Each polygon should have its own:

• AreaCode
• AreaName
• Priority

Step 7 - Export the GeoJSON File

Select

Save → GeoJSON

or

File → Save

(depending on the version of geojson.io)

Save the file as:

STORE01.geojson

Guidelines

Keep polygons simple

Use enough points to follow the delivery boundary, but avoid unnecessary detail.

Good

●──────●
│      │
│      │
●──────●

Not recommended

●─●─●─●─●─●─●─●─●

Do not draw self-intersecting polygons

Incorrect

\      /
 \    /
  \  /
  /  \
 /    \
/      \

Correct

██████████
█        █
█        █
██████████

Include roads that should receive deliveries

If a road should be included, make sure it is inside the polygon.

Use one file per outlet

For example:

STORE01.geojson

STORE02.geojson

STORE01.geojson

Do not combine multiple outlets into a single file.

Before Uploading

Confirm that:

• ✓ The outlet location has been added.
• ✓ Every delivery area is a Polygon.
• ✓ Every polygon has a StoreCode.
• ✓ Every polygon has an AreaCode.
• ✓ Every polygon has an AreaName.
• ✓ Every polygon has Enabled = true.
• ✓ Every polygon has a Priority.
• ✓ The GeoJSON file has been exported successfully.

Uploading to AB Commerce

Once the GeoJSON file has been created:

1. Log into the AB Commerce Administration System.
2. Click on Settings - Shipping
3. For each local delivery rate, copy the GEOJSON into the textbox called GeoJSON Delivery Area
4. And click SAVE at the bottom of the screen

The delivery zones will then be used automatically during checkout to determine whether a customer's address qualifies for local delivery.