Adding postcode address lookup to your Actinic site

You can improve your shop's checkout facilities by adding address look up. An example checkout page is shown below:

NOTE: Previous users of Postcode Anywhere who want to use this new inline address format should go to section 13.

Adding address lookup, based upon a postcode, provides many benefits to your shop including:

	Reduction of the number of abandoned shopping baskets because it makes it easier to enter address information.
	Usually an address is provided in under 1 second
	Gives you access to 27 million UK addresses
	Addresses are automatically updated monthly
	Customer address information is more accurate

About Postcode Anywhere

Postcode Anywhere is the SMART Awards' "Best Address Management Software - 2004".

Postcode Anywhere is used by over 1500 organisations including HM Customs & Excise, Cosmos Holidays, Countrywide PLC, Oxfam and Citibank.

The Postcode Anywhere Web service enables organisations to capture and verify customer details quickly and easily, with no need to manage databases in house. Information is updated regularly via secure connection, making in-house database updates a thing of the past.

We have been working with Fernhill Solutions since 2003 to integrate their Postcode Anywhere product with Actinic since . To see how effective this service can be you can sign-up for a free trial. There is no charge for this and you will get 60 free postcode lookups. After this time you can purchase units of lookups from £50 for 750 lookups, which last 12 months (the more lookups you buy the cheaper each lookup is).

We're here to help
If you have problems setting up Postcode Anywhere please send an email to support@mole-end.biz. Fernhill can also help and can be contacted on 0800 047 0493.

To add a Lookup Address button to your checkout pages use the following steps:

1. Go to the registration page by using the following link:
Postcode Anywhere Registration

The following webpage is shown:

2. Enter your details and press the Register button. You will then be automatically logged into the Postcode Anywhere account management page and you will be sent your account ID and web license key by email. The Postcode Anywhere account management page is shown below.

3. Click on the Setup your account picture

4. You will now be shown the account set-up wizard. On the initial page select the top (default) option, "I want my customers to be able to fill their addresses in quickly on my web site" and press the Next button. This is shown below:

5. When asked "What's your preferred option?" select Popups (recommended). and press the Next button. This is shown below:

6. Select the maximum number of postcode lookups that you want to use in 1 day and press the Next button. This is shown below:

7. You will now be shown your webkey to use on your website. An example is shown below:

8. If you are using Actinic V9 use Approach A, Actinic V8 use Approach B and Actinic V4 to V7 you should use Approach C.

Approach A - Actinic V9 onwards

You will need the keys that you have you have created during the initial setup. If you are going to also use postcode lookup on the delivery page and offline ordering then you will also need to create additional keys. To do this go to step 14 and click on Add a new license key to add a new key. You will only need the type in the key value into Actinic , for example, xc91-zr24-mu16-kh61.

Display the Business Settings, using the Settings->Business Settings menu option.

Select the Address Lookup options form the left hand (the last one in the list)

Enter your Account code from the email sent to you by Postcode Anywhere and your License Keys (created by you on their website). An example of this is shown below:

Now go to step 9.

Approach B - Actinic V8

In the Design view (click on the Design tab) Select Page Type Checkout Page 1. Scroll down until you can see the Post Code/Zip Code field and click on the field (where you would enter your postcode). This is shown below:

Copy the code from the Postcode Anywhere Setting up an address finder popup window OR copy the text below and replace the <Account code> and <Web License Key> with those assigned to you. When you have finished click on the Finish button.

<SCRIPT LANGUAGE=JAVASCRIPT SRC="http://services.postcodeanywhere.co.uk/popups/javascript.aspx?account_code=<Account Code>&license_key=<Web License Key>"></SCRIPT>

Paste the code immediately after value="InvoicePostalCode"/> and then replace <Web License Key> with your license key and both occurances of <Account Code> with your account code.

For example, the layout code in red shows the lines added.

<Actinic:LOCATION TYPE='INVOICEPOSTALCODE'>

<td>

Click on the Apply button.

Now go to step 9.

Approach C V4 to V7

Open Actinic's Template Manager (Main menu option Advanced then Template Manager). If the window doesn't look like the one below you are probably in Template Navigator mode, click on the change view button at the top of the screen to return to Template Manager mode.

Go to the Ordering tab. For Invoice Address select the Order Phase 1 button. This will display the Act_Order01.html template.

Search for value="NETQUOTEVAR:INVOICEPOSTALCODE">

<SCRIPT LANGUAGE=JAVASCRIPT SRC="http://services.postcodeanywhere.co.uk/popups/javascript.aspx?account_code=<Account Code>&license_key=<Web License Key>"></SCRIPT>

Paste the code immediately after value="NETQUOTEVAR:INVOICEPOSTALCODE"> and then replace <Web License Key> with your license key and both occurances of <Account Code> with your account code.

For example, the HTML in red shows the lines added.

<td bgcolor="NETQUOTEVAR:CHECKOUTBG">NETQUOTEVAR:INVOICEPROMPT008</td>

<Actinic:LOCATION TYPE='INVOICEPOSTALCODE'>

</td></Actinic:LOCATION>

NETQUOTEDEL:INVOICEPROMPT008 NETQUOTEDEL:INVOICEPROMPT009
<tr>

Save the template.

9. You now need to configure your checkout page. Upload your Catalog and create a test order and go to the checkout.

10. Click on the Setup Postcode Anywhere button. You will be asked to confirm your Postcode Anywhere password (for security purposes).

11. You will be shown the following dialog. You should use the Express Setup option.

12. Setup is now complete. Press the Finish button.

13. If you are upgrading from a previous setup start from here (this is also for new installations)

You now need to configure your account. From the Account Home, click on the Popups and licenses picture:

14. Under the Popups and store locaters section select your website key. An example, is shown below. In this example you should click on the FM98-JG75-JF93-AW29 (named Order Limit).

15. A window titled Managing "Managing Order Limit", or similar name is displayed. A page similar to the one below is displayed:

At the right hand side of the window, click on the Edit this key button.

16. This will display a dialog titled General settings. You should confirm the license key name and daily limit options and press Next.

17. You are now shown a screen titled Popup security. To make sure no one else can use your Postcode Anywhere credits you should enter the website addresses of your website that you are setting up (or that intend to use it under). You can also restrict individual computers using your website for postcode lookup by setting a IP limiter (if you only expect an individual computer/person to make a few orders a day). You should add your own website ip address into the Limiter exclusions box. Press the Next button. An example is shown below:

18. On the Look and feel dialog change the Popuop Style to Inline address finder and press the Next key. This is shown below:

19. On the Button options confirm the Default button Button type (or add your own button style and text) and press the Next key.

20. On the Scripts page you can simply click Finish, as you have already setup this option.

21. Setting up the delivery address lookup.

Advanced steps for Actinic V4 to V8 (not required for Actinic V9)

22. Go back to My Account home page. If you do not have this available use the following link and login using the username that was sent to you (with the password that you entered).

http://www.postcodeanywhere.co.uk/

You will need to add a secondary license for the delivery address page. To do this click on Popups and licenses picture:

23. To add a new web license key click on the Setup your account picture.

26. Follow the instructions show in step 3 (to 20) , if you are using Actinic V4 to V7 you should edit Order Phase 2 (this will edit Act_Order02.html template) and entering the details immediately after the "NETQUOTEVAR:DELIVERPOSTALCODE"> rather than "NETQUOTEVAR:INVOICEPOSTALCODE">. If you are using Actinic V8 you should select a page type of Check Page 2 and paste the postcode look up text immediately after value="DeliverPostalCode"/>