Address Matching Approval System (AMAS)

  1. What is AMAS
  2. Platform Availability
  3. Release Cycle
  4. Configuration
  5. How to Check If Installed
  6. Installation
  7. Parameters

 

  1. What is AMAS

The Address Matching Approval System (AMAS) is a certification program used to correct and match addresses against the Australia Post Postal Address File (PAF). AMAS also adds a unique Delivery Point Identifier (DPID) to each address record in order to generate a barcode for mail. Additional information about AMAS can be found on the Australian Post website here.

  1. Platform Availability

Please note, AMAS is currently only available for the following platforms:

  • Win32
  • Win64
  • Lin32
  • Lin64

 

  1. Release Cycle
Loqate Release Date Certification Expiry Date*
2018-11-29 2019-03-31
  1. Configuration

No special configuration required.

  1. How to check if Installed

There are two methods to check if AMAS is installed.

Option 1: (For Windows)

Important Note: If you’re using Windows, please ensure Loqate is installed outside of program files. Even if you enable read/write permissions while inside program files, there may still be permissions issues, we recommend installing Loqate outside of program files.

1) Click on lqtDemo.exe program (available in Loqate API folder)

2) Click on first tab” “GKR”

3) Click “Browse” to select Loqate data folder

4) Click the “Select a file” drop down menu to find “AMASInfo”

5) “Expiry Date” of AMAS is shown (refer to below sample screenshot)

Option 2: (For Linux)

1) In linux command line, navigate to your Loqate installation folder (where Loqate API file: lqtBatch is located)

2) Run below in that path (the dot at the end is mandatory) and press enter. This is to set the environment path to that folder:

export LD_LIBRARY_PATH=.

3) Use command below: (replace the directory path value with your Loqate data folder location)

./lqtbatch -d <your data folder>

4) The expiration date information for AMAS is as shown below:

i) if AMAS is still valid, below sample return

ii) If AMAS already expired, it will return below “AMAS connection status: AMAS Error (503) : PAF expired”:

6. Installation

The installation for AMAS involves installation of the API and AMAS data packs. The AMAS API and AMAS Data are platform dependent.

  • AMAS API:

The respective library files for corresponding platform must be uploaded in the same location as the Loqate API installation directory.

For Windows platforms, you would also need the VC71 redistributable libraries found in (VC71) folder.

  • AMAS data:

AMAS data are platform specific. Therefore, respective data for the corresponding platform must be uploaded.

The data files should end up inside data amas subdirectory where ‘data’ is the Loqate data installation directory.

7. Parameters

Important note: AMAS process requires the input addresses to be in one of the following format as input. The input headers must also match Loqate address fields, found on the support site here.

Format 1: Address1, Address2, Address3(optional) and Country

Address1 Address2 Country
35 Stirling Hwy Crawley WA 6009 AUS

 

Format 2: Address1, Locality, AdministrativeArea, PostalCode and Country

Address1 Locality AdministrativeArea PostalCode Country
35 Stirling Hwy Crawley WA 6009 AUS