Adding address lookup to your shop

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".

Although it was launched only 3 years ago, 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're here to help
If you have problems setting up Postcode Anywhere please send an email to PCA@mole-end.biz.

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

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. You now need to add the generated HTML into your Actinic. If you are using Actinic V4 to V7 you should use Approach A. If you are using Actinic V8 you should use Approach B.

Approach A

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">

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="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.

Save the template.

Approach B

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>

      <input type="text" name="INVOICEPOSTALCODE" size="10" maxlength="50" value="<Actinic:Variable Name="InvoicePostalCode"/>" />

Click on the Apply button.

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 XC91-Zr24-MU16-KH61 (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 bottom of the window, under the Common tasks section, you should select the Open the editor picture.

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 confirm the 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 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.

If you do not want to set-up postcode lookup on your delivery page your installation is complete.

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"/>