Express Capture Guides

Global Data Coverage

Country Buildings Streets Cities Postalcodes Coordinates Updated
Afghanistan greentick greentick greentick 11/10/2017
Åland greentick greentick greentick 11/10/2017
Albania greentick greentick greentick greentick 16/10/2017
Algeria greentick greentick greentick 11/10/2017
American Samoa greentick greentick greentick greentick greentick 29/11/2017
Andorra greentick greentick greentick greentick greentick 5/12/2017
Angola greentick greentick greentick greentick 17/10/2017
Anguilla greentick greentick 11/10/2017
Antigua and Barbuda greentick greentick greentick 11/10/2017
Argentina greentick greentick greentick greentick greentick 17/10/2017
Armenia greentick greentick greentick 11/10/2017
Aruba greentick greentick greentick 11/10/2017
Australia greentick greentick greentick greentick greentick 3/10/2017
Austria greentick greentick greentick greentick greentick 13/11/2017
Azerbaijan greentick greentick greentick 11/10/2017
Bahamas greentick greentick greentick 11/10/2017
Bahrain greentick greentick greentick 17/10/2017
Bangladesh greentick greentick greentick 11/10/2017
Barbados greentick greentick greentick greentick 11/10/2017
Belarus greentick greentick greentick greentick greentick 11/10/2017
Belgium greentick greentick greentick greentick greentick 16/10/2017
Belize greentick greentick 11/10/2017
Benin greentick greentick 11/10/2017
Bermuda greentick greentick greentick greentick greentick 11/10/2017
Bhutan greentick greentick greentick 11/10/2017
Bolivia greentick greentick 11/10/2017
Bonaire, Sint Eustatius and Saba greentick greentick 11/10/2017
Bosnia and Herzegovina greentick greentick greentick 11/10/2017
Botswana greentick greentick greentick greentick 17/10/2017
Brazil greentick greentick greentick greentick greentick 10/11/2017
British Indian Ocean Territory greentick greentick greentick 11/10/2017
British Virgin Islands greentick greentick greentick 12/10/2017
Brunei greentick greentick greentick greentick 24/10/2017
Bulgaria greentick greentick greentick greentick greentick 11/10/2017
Burkina Faso greentick greentick 11/10/2017
Burma greentick greentick 11/10/2017
Burundi greentick greentick 11/10/2017
Cambodia greentick greentick greentick 11/10/2017
Cameroon greentick greentick 11/10/2017
Canada greentick greentick greentick greentick greentick 7/12/2017
Cape Verde greentick greentick greentick 11/10/2017
Cayman Islands greentick greentick greentick 11/10/2017
Central African Republic greentick greentick 11/10/2017
Chad greentick greentick 12/10/2017
Chile greentick greentick greentick greentick greentick 17/10/2017
China greentick greentick greentick 11/10/2017
Christmas Island greentick greentick greentick 11/10/2017
Cocos (Keeling) Islands greentick greentick greentick 11/10/2017
Colombia greentick greentick greentick greentick greentick 17/10/2017
Comoros greentick greentick 11/10/2017
Congo greentick greentick 11/10/2017
Congo (Democratic Republic) greentick greentick 11/10/2017
Cook Islands greentick greentick greentick 11/10/2017
Costa Rica greentick greentick greentick 11/10/2017
Croatia greentick greentick greentick greentick greentick 16/10/2017
Cuba greentick greentick greentick 17/10/2017
Curaçao greentick greentick 11/10/2017
Cyprus greentick greentick greentick greentick greentick 11/10/2017
Czechia greentick greentick greentick greentick greentick 11/10/2017
Denmark greentick greentick greentick greentick greentick 16/10/2017
Djibouti greentick greentick 11/10/2017
Dominica greentick greentick 11/10/2017
Dominican Republic greentick greentick greentick 11/10/2017
East Timor greentick greentick 12/10/2017
Ecuador greentick greentick greentick 11/10/2017
Egypt greentick greentick greentick greentick greentick 17/10/2017
El Salvador greentick greentick greentick greentick 12/10/2017
Equatorial Guinea greentick greentick 11/10/2017
Eritrea greentick greentick 11/10/2017
Estonia greentick greentick greentick greentick greentick 11/10/2017
Ethiopia greentick greentick 11/10/2017
Falkland Islands greentick greentick greentick greentick 11/10/2017
Faroe Islands greentick greentick greentick 11/10/2017
Fiji greentick greentick greentick 11/10/2017
Finland greentick greentick greentick greentick greentick 16/10/2017
France greentick greentick greentick greentick greentick 16/10/2017
French Guiana greentick greentick greentick greentick greentick 11/10/2017
French Polynesia greentick greentick greentick 11/10/2017
Gabon greentick greentick 11/10/2017
Gambia greentick greentick 11/10/2017
Georgia greentick greentick greentick greentick greentick 11/10/2017
Germany greentick greentick greentick greentick greentick 14/11/2017
Ghana greentick greentick 11/10/2017
Gibraltar greentick greentick greentick greentick greentick 11/10/2017
Greece greentick greentick greentick greentick greentick 16/10/2017
Greenland greentick greentick greentick 11/10/2017
Grenada greentick greentick 11/10/2017
Guadeloupe greentick greentick greentick greentick greentick 11/10/2017
Guam greentick greentick greentick greentick greentick 29/11/2017
Guatemala greentick greentick greentick 11/10/2017
Guernsey greentick greentick greentick greentick greentick 8/12/2017
Guinea greentick greentick greentick 11/10/2017
Guinea-Bissau greentick greentick greentick 11/10/2017
Guyana greentick greentick 11/10/2017
Haiti greentick greentick greentick greentick greentick 11/10/2017
Honduras greentick greentick greentick 11/10/2017
Hong Kong greentick greentick greentick greentick 24/10/2017
Hungary greentick greentick greentick greentick greentick 16/10/2017
Iceland greentick greentick greentick greentick greentick 16/10/2017
India greentick greentick greentick greentick greentick 5/07/2017
Indonesia greentick greentick greentick greentick greentick 24/10/2017
Iran greentick greentick greentick 11/10/2017
Iraq greentick greentick greentick 11/10/2017
Ireland greentick greentick greentick greentick greentick 16/10/2017
Isle of Man greentick greentick greentick greentick greentick 8/12/2017
Israel greentick greentick greentick 11/10/2017
Italy greentick greentick greentick greentick greentick 17/10/2017
Ivory Coast greentick greentick 11/10/2017
Jamaica greentick greentick 11/10/2017
Japan greentick greentick greentick greentick 11/10/2017
Jersey greentick greentick greentick greentick greentick 8/12/2017
Jordan greentick greentick greentick 17/10/2017
Kazakhstan greentick greentick greentick 11/10/2017
Kenya greentick greentick greentick 11/10/2017
Kiribati greentick greentick 11/10/2017
Korea (North) greentick greentick 11/10/2017
Korea (South) greentick greentick greentick greentick greentick 11/10/2017
Kuwait greentick greentick greentick greentick 17/10/2017
Kyrgyzstan greentick greentick greentick greentick greentick 11/10/2017
Laos greentick greentick greentick 11/10/2017
Latvia greentick greentick greentick greentick greentick 17/10/2017
Lebanon greentick greentick greentick 11/10/2017
Lesotho greentick greentick greentick 11/10/2017
Liberia greentick greentick greentick greentick 11/10/2017
Libya greentick greentick 11/10/2017
Liechtenstein greentick greentick greentick 11/10/2017
Lithuania greentick greentick greentick greentick greentick 17/10/2017
Luxembourg greentick greentick greentick greentick greentick 17/10/2017
Macao greentick greentick greentick greentick 24/10/2017
Macedonia greentick greentick greentick 11/10/2017
Madagascar greentick greentick greentick 11/10/2017
Malawi greentick greentick greentick 17/10/2017
Malaysia greentick greentick greentick greentick 11/10/2017
Maldives greentick greentick greentick greentick greentick 11/10/2017
Mali greentick greentick 11/10/2017
Malta greentick greentick greentick greentick greentick 17/10/2017
Marshall Islands greentick greentick greentick greentick greentick 29/11/2017
Martinique greentick greentick greentick greentick greentick 11/10/2017
Mauritania greentick greentick 11/10/2017
Mauritius greentick greentick greentick 17/10/2017
Mayotte greentick greentick greentick greentick greentick 11/10/2017
Mexico greentick greentick greentick greentick greentick 17/10/2017
Micronesia greentick greentick greentick greentick greentick 29/11/2017
Moldova greentick greentick greentick greentick greentick 11/10/2017
Monaco greentick greentick greentick greentick greentick 11/10/2017
Mongolia greentick greentick greentick 11/10/2017
Montenegro greentick greentick greentick greentick greentick 17/10/2017
Montserrat greentick greentick greentick 11/10/2017
Morocco greentick greentick greentick greentick greentick 17/10/2017
Mozambique greentick greentick greentick greentick 17/10/2017
Namibia greentick greentick greentick greentick greentick 17/10/2017
Nauru greentick greentick 11/10/2017
Nepal greentick greentick greentick 11/10/2017
Netherlands greentick greentick greentick greentick greentick 17/10/2017
New Caledonia greentick greentick greentick 11/10/2017
New Zealand greentick greentick greentick greentick greentick 25/09/2017
Nicaragua greentick greentick greentick 11/10/2017
Niger greentick greentick greentick 11/10/2017
Nigeria greentick greentick greentick greentick 11/10/2017
Norfolk Island greentick greentick greentick 11/10/2017
Northern Mariana Islands greentick greentick greentick greentick greentick 29/11/2017
Norway greentick greentick greentick greentick greentick 17/10/2017
Oman greentick greentick greentick 17/10/2017
Pakistan greentick greentick greentick 11/10/2017
Palau greentick greentick greentick greentick greentick 29/11/2017
Panama greentick greentick 11/10/2017
Papua New Guinea greentick greentick greentick 11/10/2017
Paraguay greentick greentick greentick greentick greentick 11/10/2017
Peru greentick greentick greentick 11/10/2017
Philippines greentick greentick greentick greentick 11/10/2017
Pitcairn greentick greentick greentick 11/10/2017
Poland greentick greentick greentick greentick greentick 17/10/2017
Portugal greentick greentick greentick greentick greentick 17/10/2017
Puerto Rico greentick greentick greentick greentick greentick 29/11/2017
Qatar greentick greentick greentick 17/10/2017
Réunion greentick greentick greentick greentick greentick 11/10/2017
Romania greentick greentick greentick greentick greentick 17/10/2017
Russia greentick greentick greentick greentick greentick 17/10/2017
Rwanda greentick greentick greentick 12/10/2017
Saint Martin (French) greentick greentick greentick greentick greentick 11/10/2017
Samoa greentick greentick greentick 12/10/2017
San Marino greentick greentick greentick greentick greentick 17/10/2017
Sao Tome and Principe greentick greentick 12/10/2017
Saudi Arabia greentick greentick greentick greentick 17/10/2017
Senegal greentick greentick greentick greentick 12/10/2017
Serbia greentick greentick greentick greentick greentick 17/10/2017
Seychelles greentick greentick 12/10/2017
Sierra Leone greentick greentick greentick 12/10/2017
Singapore greentick greentick greentick greentick greentick 24/10/2017
Sint Maarten (Dutch) greentick greentick 12/10/2017
Slovakia greentick greentick greentick greentick greentick 17/10/2017
Slovenia greentick greentick greentick greentick greentick 17/10/2017
Solomon Islands greentick greentick greentick 12/10/2017
Somalia greentick greentick 12/10/2017
South Africa greentick greentick greentick greentick greentick 17/10/2017
South Georgia and the South Sandwich Islands greentick greentick greentick 12/10/2017
South Sudan greentick greentick greentick 12/10/2017
Spain greentick greentick greentick greentick greentick 16/10/2017
Sri Lanka greentick greentick greentick 11/10/2017
St Barthélemy greentick greentick greentick greentick 11/10/2017
St Helena, Ascension and Tristan da Cunha greentick greentick greentick 12/10/2017
St Kitts and Nevis greentick greentick 11/10/2017
St Lucia greentick greentick greentick 11/10/2017
St Pierre and Miquelon greentick greentick greentick 12/10/2017
St Vincent greentick greentick greentick 12/10/2017
Sudan greentick greentick greentick 12/10/2017
Suriname greentick greentick 12/10/2017
Svalbard and Jan Mayen greentick greentick greentick 12/10/2017
Swaziland greentick greentick greentick greentick 17/10/2017
Sweden greentick greentick greentick greentick greentick 17/10/2017
Switzerland greentick greentick greentick greentick greentick 16/10/2017
Syria greentick greentick 12/10/2017
Taiwan greentick greentick greentick greentick greentick 24/10/2017
Tajikistan greentick greentick greentick 12/10/2017
Tanzania greentick greentick greentick 12/10/2017
Thailand greentick greentick greentick greentick 24/10/2017
Togo greentick greentick 12/10/2017
Tonga greentick greentick 12/10/2017
Trinidad and Tobago greentick greentick greentick 12/10/2017
Tunisia greentick greentick greentick greentick 17/10/2017
Turkey greentick greentick greentick greentick greentick 17/10/2017
Turkmenistan greentick greentick greentick 12/10/2017
Turks and Caicos Islands greentick greentick greentick greentick 12/10/2017
Tuvalu greentick greentick 12/10/2017
Uganda greentick greentick greentick greentick 17/10/2017
Ukraine greentick greentick greentick greentick greentick 17/10/2017
United Arab Emirates greentick greentick greentick greentick greentick 17/11/2017
United Kingdom greentick greentick greentick greentick greentick 8/12/2017
United States greentick greentick greentick greentick greentick 29/11/2017
United States Virgin Islands greentick greentick greentick greentick greentick 29/11/2017
Uruguay greentick greentick greentick greentick greentick 12/10/2017
Uzbekistan greentick greentick greentick 12/10/2017
Vanuatu greentick greentick 12/10/2017
Vatican City greentick greentick greentick greentick 12/10/2017
Venezuela greentick greentick greentick 12/10/2017
Vietnam greentick greentick greentick greentick greentick 24/10/2017
Wallis and Futuna greentick greentick greentick greentick 12/10/2017
Yemen greentick greentick greentick 17/10/2017
Zambia greentick greentick greentick greentick 17/10/2017
Zimbabwe greentick greentick greentick greentick 17/10/2017

Field Types Available

Field name Description
Line1-5 The specific line number of the returned address
Town The Town of the returned address
County The County of the returned address
Postcode The Postcode of the returned address
Country The ISO 3166 Country name for the returned address
Company Returns the full company name where registered
Search Input Search bar where all the address validation magic happens
Building Name Name of the building for the returned address
Building Number Number of the building for the returned address
Sub Building The Flat or Unit number within the building. i.e. Flat 1
Street The Street Name of the returned address
District The locality within the Town or City
County Name The name of the County, Province or State, i.e. California
County Code The code of the County, Province or State, i.e. CA
2-Character ISO Code The ISO 3166 2-character Country Code for the returned address, i.e. GB
3-Character ISO Code The ISO 3166 3-character Country Code for the returned address, i.e. GBR
Formatted Address The FULL address in the correct standardised format

Mapping Fields for New Zealand Addresses

When mapping fields for New Zealand Addresses you will need type the following into the ‘Our Fields’ cell:

Addressline 1 = {{SubBuildingType} }{{SubBuilding}, }{StreetAddress}
Suburb = District (Select from the drop down)
City = Town(Select from the drop down)
Postcode = Postcode(Select from the drop down)

nz mapping

Express Capture when using Demandware

When using the ExpressCapture (EC) in a website that uses Google Tag Manager (GTM) and Demandware there are extra steps required to make sure all the fields are mapped correctly.

The issue is that the drop-down fields used by Demandware uses javascript to display/store the state value in their address forms making it impossible for the standard EC setup to work correctly.

When mapping your fields for ExpressCapture the state field should be “dwfrm_singleshipping_shippingAddress_addressFields_states_state” and it should be matched to ‘County’.

Below is the tag code required. The same code can be used for the billing section by just changing the field names used.

<script type="text/javascript" src="https://expresscapture.datatoolscloud.net.au/js/expresscapture-2.30.min.js?key=BH97-HA71-UB13-YP52"></script>
<link rel="stylesheet" type="text/css" href="https://expresscapture.datatoolscloud.net.au/css/expresscapture-2.30.min.css?key=BH97-HA71-UB13-YP52">
<script>
   $(document).ready(function () 
  {
     
	pca.expressCapture.listen('load', function(control)
	{
		control.listen("populate", function (address) 
		{
			if(control.bound("dwfrm_singleshipping_shippingAddress_addressFields_states_state"))
			{
				var changeEvent = document.createEvent("HTMLEvents");
				changeEvent.initEvent("change", true, true);
              document.getElementById("dwfrm_singleshipping_shippingAddress_addressFields_states_state").dispatchEvent(changeEvent);
	
			};
		});
	});
	});
</script>

Update My Profile Details in Express Capture

Update My Profile Details in Express Capture

  1. Click on the “My Account” button on the Kleber website.
  2. Then click onto the “My Profile” icon, if you are not login please enter your username and password.

 

balance

 

3. When you are in the “My Profile” page, update the details you wish to change.

4. Then click SAVE.

profile

How to remove a secured URL for your Express Capture Key

If you ever need to remove a URL for an Express Capture Key, please do the following.

  1. Log in to My Account using your email and password
  2. Click on Setup Express Capture
    New setup button
     
  3. Click on Security Select the key from the top drop down list you wish to remove the URL from and press LOAD. If that Key already has URLs attached to it – they will appear below. If not – the table will remain blank.
  4. Go down to the Drop down window underneath the listed URLs. Select the URL you wish to remove and click on the Remove button. Repeat for all URL’s you wish to remove.SecurityTabRemove

 

How to delete your existing Express Capture Keys

If you need to work out which Express Capture Key applies to which URL and/or Scripts, please do the following:

  1. Log in to My Account using your email and password
  2. Click on Setup Express CaptureNew setup button

     

  3. IF YOU ARE CERTAIN AS TO WHICH KEY TO DELETE – click on Delete Keys tab and select the key or keys you wish to delete by checking the little box beside it and then press the Delete Key/s button. 

    NOTE: ALL deletions are final.DeleteKeys

  4. IF YOU ARE UNCERTAIN AS TO WHICH KEY TO DELETE – Click on Existing Keys tab to view the Key, and it’s associated URL/Page and the Script/CSS. Work out which key/s you need and then go to Step 3 above to delete.

 

How to view your existing Express Capture Keys, URLs & Scripts

If you need to work out which Express Capture Key applies to which URL and/or Scripts, please do the following:

  1. Log in to My Account using your email and password
  2. Click on Setup Express Capture
    New setup button
  3. Click on Existing Keys tab. Here you can see all the Express Capture API Keys you have created, the URL/Page it is used on and the Script/CSS that applies to that.ExistingKeys

Express Capture Predict for Dynamics CRM

The first thing you need to do is import the Solution into your Dynamics Org

dynamics 1

  1. Download the ExpressCapture_Latest_manages.zip developed by PCA.
  2. Go to Settings > Solutions > Import and select the ExpressCapture_Latest_managed.zip file.
  3. Click Next, and Publish All Customizations.

Include the Javascript libraries in the relevant entity

  1. Create a new instance of the entity you wish to enable Capture+ in (e.g. for the Account entity, select Sales > Accounts > New).
  2. Click Form Form Properties.
  3. On the Events tab, under Form Libraries, click Add.
  4. Select pca_ScriptLibrary, click OK– this is the generic JavaScript library for the address lookup, and needs to be at the top of the list of libraries.
  5. Click Add a second time, this time selecting the entity-specific library e.g. for the Account entity, the library is pca_AccountAddress, for Contact the library is pca_ContactAddress, etc. These libraries contain the field mappings for the form, only one entity-specific library need be included for a given entity.
  6. Click OK, there should now be two JavaScript libraries prefixed pca_in the list.

dynamics 2

Add an event handler to the form’s OnLoad event

dynamics 3

  1. Still on the Events tab, under Event Handlers, set Control to Form and Event to OnLoad, and click Add.
  2. On the Details tab, set Library to pca_[EntityName]Address (e.g. pca_AccountAddress for the Account entity, etc.), and Function to load.
  3. Under Parameters, enter your license key in the following format, including the double quotes: “AA11-AA11-AA11-AA11”. Get your account key by clicking on Create Key at http://expresscapture.datatools.com.au/setup-express-capture/
    dynamics 4
  4. A second optional parameter can be added to set advanced options. It can be used to order and filter the countries that appear in the list, as well as the default selection by providing ISO 3-char country codes.
  5. If the options parameter is added, the format should be the following: “AA11-AA11-AA11-AA11″,{countries:{codeList:”AUS,NZL”,defaultCode:”AUS”,fillOthers: true}}
  6. The Form Properties dialogue should now contain 2 JavaScript libraries, and 1 event handler.dynamics 6 1
  7. Click OKOK > Save > Publish

Test the newly set up Express Capture control

  1. Create a new instance of the entity.
  2. Start searching for any address element in any of the address fields.
  3. The Express Capture control should register every keystroke and present you with an updating list, selecting an address from this list should populate the data back into the form.

The solution is now fully installed and ready to use within the standard Dynamics CRM entities. Remember, if you have any problems we’re here to help, support@datatools.com.au

How to reset your field mappings in Express Capture

If you have already set up Express Capture but need to remap your webform’s fields to the Express Capture fields again (For instance you have updated your form and the input fields have changed) – please do the following.

  1. Log in to My Account using your email and password
  2. Click on Setup Express Capture

  3. Click on the Reset Mappings tab
    Reset Mapping tab
  4. From the drop down box pick the key that relates to the page you want to adjust.

    NOTE: If you are unsure which key to use – please go to the Existing Key tab to see what key is on what URL. Note down the one you want to change and return to Reset Mappings.
  5. Once you’ve selected the Key – click on the Reset Field mapping You will receive a new Verification code. Note down this code.
  6. Go to the page that you want to update, the Express Capture mapping wizard should begin. Enter the new Verification code and remap the fields as required.

Express Capture country list

The countries are ISO standard 2 & 3 character codes.

 

AW ABW 553 Aruba
AF AFG 4 Afghanistan
AO AGO 24 Angola
AI AIA 660 Anguilla
AX ALA 248 Ã…land Islands
AL ALB 8 Albania
AD AND 20 Andorra
AE ARE 784 United Arab Emirates
AR ARG 32 Argentina
AM ARM 51 Armenia
AS ASM 16 American Samoa
AQ ATA 10 Antarctica
TF ATF 260 French Southern Territories
AG ATG 28 Antigua and Barbuda
AU AUS 36 Australia
AT AUT 40 Austria
AZ AZE 31 Azerbaijan
BI BDI 108 Burundi
BE BEL 56 Belgium
BJ BEN 204 Benin
BQ BES 535 Bonaire, Saint Eustatius and Saba
BF BFA 854 Burkina Faso
BD BGD 50 Bangladesh
BG BGR 100 Bulgaria
BH BHR 48 Bahrain
BS BHS 44 Bahamas
BA BIH 70 Bosnia and Herzegovina
BL BLM 652 Saint Barthélemy
BY BLR 112 Belarus
BZ BLZ 84 Belize
BM BMU 60 Bermuda
BO BOL 68 Bolivia, Plurinational State Of
BR BRA 76 Brazil
BB BRB 52 Barbados
BN BRN 96 Brunei Darussalam
BT BTN 64 Bhutan
BV BVT 74 Bouvet Island
BW BWA 72 Botswana
CF CAF 140 Central African Republic
CA CAN 124 Canada
CC CCK 166 Cocos (Keeling) Islands
CH CHE 756 Switzerland
CL CHL 152 Chile
CN CHN 156 China
CI CIV 384 Côte D’ivoire
CM CMR 120 Cameroon
CD COD 180 Congo, the Democratic Republic of the
CG COG 178 Congo
CK COK 184 Cook Islands
CO COL 170 Colombia
KM COM 174 Comoros
CV CPV 132 Cape Verde
CR CRI 188 Costa Rica
CU CUB 192 Cuba
CW CUW 531 Curaçao
CX CXR 162 Christmas Island
KY CYM 136 Cayman Islands
CY CYP 196 Cyprus
CZ CZE 203 Czech Republic
DE DEU 276 Germany
DJ DJI 262 Djibouti
DM DMA 212 Dominica
DK DNK 208 Denmark
DO DOM 214 Dominican Republic
DZ DZA 12 Algeria
EC ECU 218 Ecuador
EG EGY 818 Egypt
ER ERI 232 Eritrea
EH ESH 732 Western Sahara
ES ESP 724 Spain
EE EST 233 Estonia
ET ETH 231 Ethiopia
FI FIN 246 Finland
FJ FJI 242 Fiji
FK FLK 238 Falkland Islands (Malvinas)
FR FRA 250 France
FO FRO 234 Faroe Islands
FM FSM 583 Micronesia, Federated States of
GA GAB 266 Gabon
GB GBR 826 United Kingdom
GE GEO 268 Georgia
GG GGY 831 Guernsey
GH GHA 288 Ghana
GI GIB 292 Gibraltar
GN GIN 324 Guinea
GP GLP 312 Guadeloupe
GM GMB 270 Gambia
GW GNB 624 Guinea-Bissau
GQ GNQ 226 Equatorial Guinea
GR GRC 300 Greece
GD GRD 308 Grenada
GL GRL 304 Greenland
GT GTM 320 Guatemala
GF GUF 254 French Guiana
GU GUM 316 Guam
GY GUY 328 Guyana
HK HKG 344 Hong Kong
HM HMD 334 Heard Island and McDonald Islands
HN HND 340 Honduras
HR HRV 191 Croatia
HT HTI 332 Haiti
HU HUN 348 Hungary
ID IDN 360 Indonesia
IM IMN 833 Isle of Man
IN IND 356 India
IO IOT 86 British Indian Ocean Territory
IE IRL 372 Ireland
IR IRN 364 Iran, Islamic Republic Of
IQ IRQ 368 Iraq
IS ISL 352 Iceland
IL ISR 376 Israel
IT ITA 380 Italy
JM JAM 388 Jamaica
JE JEY 832 Jersey
JO JOR 400 Jordan
JP JPN 392 Japan
KZ KAZ 398 Kazakhstan
KE KEN 404 Kenya
KG KGZ 417 Kyrgyzstan
KH KHM 116 Cambodia
KI KIR 296 Kiribati
KN KNA 659 Saint Kitts and Nevis
KR KOR 410 Korea, Republic of
KW KWT 414 Kuwait
LA LAO 418 Lao people’s Democratic Republic
LB LBN 422 Lebanon
LR LBR 430 Liberia
LY LBY 434 Libya
LC LCA 662 Saint Lucia
LI LIE 438 Liechtenstein
LK LKA 144 Sri Lanka
LS LSO 426 Lesotho
LT LTU 440 Lithuania
LU LUX 442 Luxembourg
LV LVA 428 Latvia
MO MAC 446 Macao
MF MAF 663 Saint Martin (French part)
MA MAR 504 Morocco
MC MCO 492 Monaco
MD MDA 498 Moldova, Republic of
MG MDG 450 Madagascar
MV MDV 462 Maldives
MX MEX 484 Mexico
MH MHL 485 Marshall Islands
MK MKD 807 Macedonia, the Former Yugoslav Republic of
ML MLI 466 Mali
MT MLT 470 Malta
MM MMR 104 Myanmar
ME MNE 499 Montenegro
MN MNG 496 Mongolia
MP MNP 580 Northern Mariana Islands
MZ MOZ 508 Mozambique
MR MRT 478 Mauritania
MS MSR 500 Montserrat
MQ MTQ 474 Martinique
MU MUS 480 Mauritius
MW MWI 454 Malawi
MY MYS 458 Malaysia
YT MYT 175 Mayotte
NA NAM 516 Namibia
NC NCL 540 New Caledonia
NE NER 562 Niger
NF NFK 574 Norfolk Island
NG NGA 566 Nigeria
NI NIC 558 Nicaragua
NU NIU 570 Niue
NL NLD 528 Netherlands
NO NOR 578 Norway
NP NPL 524 Nepal
NR NRU 520 Nauru
NZ NZL 554 New Zealand
OM OMN 512 Oman
PK PAK 586 Pakistan
PA PAN 591 Panama
PN PCN 612 Pitcairn
PE PER 604 Peru
PH PHL 608 Philippines
PW PLW 585 Palau
PG PNG 598 Papua New Guinea
PL POL 616 Poland
PR PRI 630 Puerto Rico
KP PRK 408 Korea, Democratic People’s Republic of
PT PRT 620 Portugal
PY PRY 600 Paraguay
PS PSE 275 Palestine, State of
PF PYF 258 French Polynesia
QA QAT 634 Qatar
RE REU 638 Réunion
RO ROU 642 Romania
RU RUS 643 Russian Federation
RW RWA 646 Rwanda
SA SAU 682 Saudi Arabia
SD SDN 729 Sudan
SN SEN 686 Senegal
SG SGP 702 Singapore
GS SGS 239 South Georgia and the South Sandwich Islands
SH SHN 654 Saint Helena, Ascension and Tristan da Cunha
SJ SJM 744 Svalbard and Jan Mayen
SB SLB 90 Solomon Islands
SL SLE 694 Sierra Leone
SV SLV 222 El Salvador
SM SMR 674 San Marino
SO SOM 706 Somalia
PM SPM 666 Saint Pierre and Miquelon
RS SRB 688 Serbia
SS SSD 728 South Sudan
ST STP 678 Sao Tome and Principe
SR SUR 740 Suriname
SK SVK 703 Slovakia
SI SVN 705 Slovenia
SE SWE 752 Sweden
SZ SWZ 748 Swaziland
SX SXM 534 Sint Maarten (Dutch part)
SC SYC 690 Seychelles
SY SYR 760 Syrian Arab Republic
TC TCA 796 Turks and Caicos Islands
TD TCD 148 Chad
TG TGO 768 Togo
TH THA 764 Thailand
TJ TJK 762 Tajikistan
TK TKL 772 Tokelau
TM TKM 795 Turkmenistan
TL TLS 626 Timor-Leste
TO TON 776 Tonga
TT TTO 780 Trinidad and Tobago
TN TUN 788 Tunisia
TR TUR 792 Turkey
TV TUV 798 Tuvalu
TW TWN 158 Taiwan, Province Of China
TZ TZA 834 Tanzania, United Republic Of
UG UGA 800 Uganda
UA UKR 804 Ukraine
UM UMI 581 United States Minor Outlying Islands
UY URY 858 Uruguay
US USA 840 United States
UZ UZB 860 Uzbekistan
VA VAT 336 Holy See (Vatican City State)
VC VCT 670 Saint Vincent and the Grenadines
VE VEN 862 Venezuela, Bolivarian Republic Of
VG VGB 92 Virgin Islands, British
VI VIR 850 Virgin Islands, U.S.
VN VNM 704 Viet Nam
VU VUT 548 Vanuatu
WF WLF 876 Wallis and Futuna
WS WSM 882 Samoa
XK XKX 0 Kosovo
YE YEM 887 Yemen
ZA ZAF 710 South Africa
ZM ZMB 894 Zambia
ZW ZWE 716 Zimbabwe

 

How to change default country?

How to change default country?

 

The country field auto selects the country that the users IP resides in.

 

However – should you wish to always set a default country regardless of where the users IP resides – please do the following.

 

Please note: this functionality will only work for Express Capture Keys created after 11/11/2015. If you have an Express Capture page created before this you will need to go to ‘Create a new Key’ tab shown at Step 3, enter the URL or a name for the key, grab the new code snippet and verification code & place into your existing page mapping the fields again. Then you can complete the steps below to amend the list of countries Express Capture will show.

 

  1. Log into your My Account
  2. Go to Setup Express Capture
  3. Click on the tab “Add/Remove CountryAddRemoveCountry
  4. Select which Express Capture Key you would like to limit the countries of from the drop down list and then click on the Load (Note: if you are uncertain as to which key is for which page – please click on the Existing API Keys to assist you)    SelectKey
  5. At Default Country – select the country you would like to default to from the drop down list and Save.SelectDefaultCountry

Express Capture Account Balance & Usage

Account Balance & Usage

    1. On Express Capture homepage, log in your account
    2. Click on “My Account” tab.
    3. Next, click on “Balance & Usage”

accountbalanceusage1

Balance & Usage page allows you to see your Credit Balance, Usage by Day and Order History.

 

Credit Balance

This page allows you to see the credit balance available to you and when it expires.

accountbalanceusage2

Usage By Day

The transaction graph shows your Express Capture account usage for a selected time period.

accountbalanceusage3

 

Order History

 This page allows you to view details of your order.

You can view further details of your order if you click on “View”.

accountbalanceusage4

 

accountbalanceusage5

How to Secure your Express Capture Keys to certain URLs

How to Secure your Express Capture Keys to certain URLs

DataTools strongly recommends that you restrict your Express Capture service to the URLs that you plan to use the service with.

To secure your code – please do the following:

  1. Log in to My Account using your email and password
  2. Click on Setup Express Capture
    Setup
  3. Click on Security Select the key from the top drop down list you wish to secure and press LOAD. If that Key already has URLs attached to it – they will appear below. If not – the table will remain blank.(If you are uncertain as to which key to use – visit the Existing Keys tab first to view all existing keys and their details)
  4. SecurityTab1
  5. At the Allowed URL List box – type in the full URLs you would like to secure this code to (include http etc.) You can include all combinations by putting a comma in between each URL. Then click the Add button.The list of URLs will appear in the table below it.

    SecurityTab2

Your code is now restricted to only working on those URLs.

How to Add/Remove countries from the list in Express Capture.

Please note: this functionality will only work for Express Capture Keys created after 11/11/2015. If you have an Express Capture page created before this you will need to go to ‘Create a new Key’ tab shown at Step 3, enter the URL or a name for the key, grab the new code snippet and verification code & place into your existing page mapping the fields again. Then you can complete the steps below to amend the list of countries Express Capture will show.

  1. Log into your My Account
  2. Go to Setup Express Capture
  3. Click on the tab “Add/Remove CountryAddRemoveCountry
  4. Select which Express Capture Key you would like to limit the countries of from the drop down list and then click on the Load (Note: if you are uncertain as to which key is for which page – please click on the Existing API Keys to assist you)SelectKey

5. Make the changes required and click Save. Changes you can make include –

  1. Set a default country by selecting it from the list
  2. Set a default language
  3. Set whether the default country is determined by the country the IP is in or by what you set at Default country. ‘True’ means the user will automatically be set to whatever country their IP address is in. ‘False’ means it will always default to what you select here.
  4. Set which countries data you require or only want to access (for example  – if you only want to see Australia and New Zealand data you tick on only those two countries)CountryList

Field Mappings in Express Capture

When you install Express Capture into your website it will first attempt to automatically map its address fields to the fields you have on your website and then ask you to test it by entering an address.

Should you find that it is missing a field or hasn’t mapped them correctly – click on the No button and you will be able to manually map the fields.

Img1

At the next screen you will be asked to confirm the address fields that are contained on your website. Click on the Pick new fields button beside the set of address fields you want to change

Img2

You will then be asked to map (line up) your address fields listed on the left hand side to the Express Capture address fields on the right hand side. You will need to map each field.

First click on the field from your website on the left hand side and then select one from Express Capture fields on the right hand side. Click on Add new field to add the next field in and repeat.

Img3

Below are a list of the fields within Express Capture and what they would normally equate to. This will assist you in manually mapping the fields correctly.

Img4

 

How to setup Express Capture

To add Express Capture into your website – follow these steps:

1. Click on “Start Your Free Trial” or Register via My Account. You will be asked to register and fill in a few basic contact questions to create an account.

2. Once the account is created – click on the Setup Express Capture image in My Account.

New setup button

3. Go to the Create Key tab and enter the page URL you will use for the Express Capture. Then click Create Key button

CreateKey

Your Express Capture code snippet and Verification Code will then be created.

4. COPY the Express Capture code snippet in the top box by clicking on the Copy button.

5. Access the html of the website you want to add Express Capture into and PASTE it at the bottom of the page. (Click on these links to see how to add Express Capture via Google Tag Manager. Magento or WooCommerce.)

6. Refresh your web page in a web browser. Express Capture will appear at the bottom of the screen and ask you to add in your Verification Code. Enter it and click the ENTER button.

image005

7. Express Capture will then take a moment to try to auto match your address fields to the ones in Express Capture.

When it is done it will show this message highlighted below:

image007

TO TEST IF EXPRESS CAPTURE IS WORKING AS EXPECTED – Go to your search field in your web page and start typing in an address. You should see a little drop down box appear and addresses start to display as you type. Once you find the address you need, select it and watch to see if it populates your address fields.

If it DOES – Hit the YES button.

You will have then successfully installed Express Capture!
You don’t have any more steps to follow. 

If it DOESN’T – hit the NO button to manually match up the fields and continue on from Step 8.

8. If you have hit NO – this screen will appear:

image009

Express Capture will try to identify the address area in the coloured box. If you click on the image011 button it will show you what it has already auto-matched and you can make changes as required by using the drop down arrows to make selections.

However if you want to start a manual match from scratch – click on Pick New Fields button.

9. Express Capture will then ask you to match your fields to our fields as shown below.

image013

Click on the down arrows to make the selections in both Your Fields and Our Fields. Click on the ‘Add new Field’ to add another field to the list and repeat until all fields are matched.

10. Once you have matched all the fields, click on the ‘Done’ button.

See example below. (Note: Your field names etc may be different to those shown)

image015

It will again ask you to check if it is working by entering an address into the Search field (as for Step 7 above). Check it and see if the other address fields now populate as expected.

If it DOESN’T – Hit NO and repeat steps 8-10 again.

If it DOES – hit YES. It will then show you this screen to say you have been successful. Hit Close to finish.

image017

Note – If you want Express Capture on another page follow step 3 to 10 again.

CATEGORIES

Australian Address Lists

States