Rule MacroRIS-RM-2212 – MISSING TOWN & REGION FIX

Missing Town & Region Fix

Fill empty Town and Region fields in the delivery and billing addresses of your Linnworks orders automatically, so orders are ready for labels and couriers.

Overview

Missing Town and Region Fix is an automated address-cleaning solution for Linnworks. It fills any empty Town and Region fields in the delivery and billing addresses of your orders.

The macro runs through the Linnworks Rules Engine. An empty Region is filled with the region you choose in the settings. An empty Town is then filled with the Region of the same address.

Each address is checked on its own, so an incomplete billing address is fixed even when the delivery address is complete. Values that are already filled in are never changed.

Missing Town and Region Fix helps you avoid courier rejections, reduce manual address checks and keep your order addresses complete.

Video Walkthrough

Video walkthrough showing how to set up and use Missing Town and Region Fix in Linnworks
Video walkthrough showing how to set up and use Missing Town and Region Fix in Linnworks (coming soon).

Configure the Macro

Once the app is installed, please create a macro configuration. This tells Linnworks which macro to run and which default region to use.

You can change this set-up at any time to suit how you work.

Steps to Configure

Go to Apps > Macro Configuration and click + Add new configuration.

Macro Configuration screen with the Add new configuration button
Macro Configuration screen with the Add new configuration button

Who Should Use Missing Town and Region Fix

Key Features

How Missing Town and Region Fix Works

Missing Town and Region Fix follows the same steps each time it processes one or more orders. The Rules Engine starts it and sends it the matching orders automatically.

Step 1: Check the default region

The macro checks that a default region is set. If it is blank, the macro stops and no orders are changed.

Step 2: Read the orders

The macro reads the delivery and billing address of each order. An order without both addresses is skipped.

Step 3: Fill the delivery address

An empty delivery Region gets your default region. An empty delivery Town then gets the delivery Region.

Step 4: Fill the billing address

The billing address is checked and filled in the same way, separately from the delivery address.

Step 5: Save the order

If any field was filled, the macro saves the address to the order. If nothing was empty, the order is left as it is.

Key Benefits

Missing Town or Region values often stop labels printing or cause couriers to reject an order. This macro fixes them before your team has to.

Spend less time checking addresses and more time getting orders out of the door.

Usage of App

Missing Town and Region Fix runs through the Linnworks Rules Engine to fill empty address fields on the orders you choose.

Execution

Once your rule is active, the macro runs automatically on every order that matches it. You can also run it yourself on the orders you choose. This is handy for testing, or for orders that need it straight away.

Quick path: Orders > Open Orders → select your orders → Actions → Other actions → Run rules engine → Missing Town And Region Fix

Select your orders

Go to Orders > Open Orders and tick the box next to each order you want the macro to process.

Open the Actions menu

Click the Actions button at the top left of the screen. You can also right-click any of the selected orders.

Go to Other actions > Run rules engine

Point to Other actions, then Run rules engine. A list of your rules appears.

Choose your rule

Click the name of the rule you created in Step 6 of Steps to Configure, for example Missing Town And Region Fix. The macro runs on the selected orders straight away.

Good to know: The rule's conditions still apply, so the macro only changes selected orders that match them. If you choose All instead of your rule's name, every active rule runs on the selected orders.

Outcome

When the macro runs on an order, it:

Finds the empty fields

It looks for an empty Town or Region in the delivery and billing addresses. A field with only spaces counts as empty.

Fills them in

An empty Region gets your default region, for example Greater London. An empty Town gets the Region of the same address.

Saves the order

The updated address is saved to the order only. The customer record in Linnworks is not changed, and no order note is added.

Input Parameters

You enter this macro's only setting, RegionName, in Step 3 of Steps to Configure. Please make sure it has a value. If it is blank, the macro stops and no orders are changed.

The Rules Engine sends the matching orders to the macro automatically, so you do not need to enter any order numbers.

The following behaviour is built into the macro and cannot be changed on the Macro Configuration screen:

SettingDescription
Fields checkedTown and Region, in both the delivery and billing addresses.
Empty fieldA field that is blank or contains only spaces.
Existing valuesNever changed. Only empty fields are filled.
Customer recordNot changed. The address is updated on the order only.

Address Update Rules

The macro applies these rules to the delivery address and the billing address separately:

When the address…The macro…
Has an empty RegionFills the Region with your default region.
Has an empty TownFills the Town with the Region of the same address.
Has no Town and no RegionFills both with your default region.
Already has a Town and a RegionLeaves it unchanged.

For example, with Greater London as the default region:

FieldBeforeAfter
Delivery RegionEmptyGreater London
Delivery TownEmptyGreater London
Billing RegionLondonLondon
Billing TownEmptyLondon

Best Practices

Test the macro on a few orders with different missing fields before using it on all your orders.

FAQ

How is Missing Town and Region Fix triggered?

The macro runs through the Linnworks Rules Engine. When an order matches your rule, the Rules Engine sends it to the macro automatically.

Can I run the macro on an order straight away?

Yes. In Orders > Open Orders, select the orders, then go to Actions > Other actions > Run rules engine and choose your rule's name.

Does the macro need any settings?

Yes, one. Enter your default region in RegionName in Step 3 of Steps to Configure. If it is blank, the macro stops and no orders are changed.

Will the macro change a Town or Region that is already filled in?

No. Only empty fields are filled. Existing values are always kept.

What happens when both the Town and the Region are empty?

The Region is filled with your default region first. The Town is then filled with that same value.

Is the billing address fixed if the delivery address is already complete?

Yes. Each address is checked separately, so an incomplete address is fixed even when the other one is complete.

Why was my order not changed?

The macro leaves an order unchanged when both addresses already have a Town and a Region. It also skips an order that has no delivery or billing address.

Does the macro update the customer record or add an order note?

No. It only updates the address on the order itself.

What happens if I select a lot of orders at once?

Linnworks stops a macro after a set time. The macro never starts an order it cannot finish in time, so no order is left half updated. If some orders were not reached, please run the rule again. Orders already fixed are skipped.

What happens if one order cannot be updated?

The macro notes the problem in the macro log and carries on with the remaining orders.

Please review these pages to understand how data is handled and the terms that apply to this application.

Summary

Missing Town and Region Fix fills empty Town and Region fields on the Linnworks orders you choose.

Once it is set up through the Rules Engine, the macro checks both addresses, fills the empty fields and saves the order. Values you already have are never changed.

If an order does not give the expected result, please check that the macro configuration is enabled and that the order matches your rule's conditions. Please also check that RegionName has a value.