JavaScript is deactivated. Please activate JS for viewing this website.


FAQ Software Library

Show all / Hide all

fold faq

Does AddressDoctor add the rural route information for Canadian addresses?

The AddressDoctor Software Library adds the rural route information to the address verification results. This means that the rural route is returned as part of the formatted address for rural addresses in Canada. This is available for the Batch, Interactive and Fast Completion modes. It should be noted that this functionality is not available for the Certified mode due to SERP rules and regulations.

Example:

Input:
4370 Lorimer Rd
Whistler V0N 1B4

Output:
4370 Lorimer Rd

RR 4

Whistler BC V0N 1B4

Process Status = C4
Address Type =”R”

fold faq

What is the Extended Element Result Status (EERS)?

The Extended Element Result Status (EERS) code is a twenty character output string similar to the existing Element Result Status field for all valid or corrected addresses.  The EERS informs the user that additional information may be available in the reference database for the given address. 

fold faq

Does AddressDoctor support Postal Address Code (PAK) for Serbia?

Post Serbia has introduced an additional six-digit Postal Address Code (PAK) which goes down to the street level. The PAK ensures that mail is delivered correctly and promptly to recipients in Serbia.  For items that are addressed to a P.O. Box, “poste restante” or to a military address, the PAK is not needed in the address.  AddressDoctor offers the PAK as an enrichment to Serbian addresses.

Example of an Address containing the PAK:

Mr. Petar Petrovic
Beogradska 3
BAJMOK

24210 BAJMOK

PAK 456769

SERBIA

www.posta.rs/struktura/eng/posalji/pismo-adresovanje.asp

fold faq

What is the UK UDPRN (Unique Delivery Point Reference Number)?

The Unique Delivery Point Reference Number, or UDPRN, is an eight character code that uniquely identifies each postal address of the Royal Mail PAF database.  The UDPRN allows to keep a constant reference that remains uniquely tied to the physical delivery point regardless of any changes in the address.  Wit AddressDoctor Version 5.3.1., the UDPRN is available as an enrichment in the UK Supplementary database.

fold faq

Does AddressDoctor provide the Japanese Address Code (Choumei Aza)?

AddressDoctor version 5.3.1 is providing the Japanese Address Code (Choumei Aza) as an enrichment to Japanese Addresses. The Choumei Aza code is an eleven digit code defining an unique delivery point for Japanese addresses.

fold faq

Does AddressDoctor provide CEDEX information for French addresses?

With AddressDoctor's Software Library Version 5.3.1, customers can process CEDEX (Large Volume Receiver) types of addresses for France.

Example:

Sinopia Financial Services
Immeuble Ile de France
4 Place De La Pyramide
Puteaux
92912 Paris La Defense CEDEX
France

Category: Software Library
fold faq

Does AddressDoctor support thirteen character abbreviation for Canadian localities?

With version 5.3.1 of AddressDoctor's Software Library, customers can use the thirteen character Canada Post locality abbreviations for Canadian address validation.  It should be noted that some municipalities in Canada have names which are 14 or more characters in length and the particular municipality does not see the need to abbreviate the names of these localities.  In such cases, the official name of the municipality will be output.

fold faq

Does AddressDoctor offer Multi-Language Support for Canada?

Yes, with AddressDoctor Software Library 5.3.1, AddressDoctor offers Multi-Language Support for Canada. Customers in Canada can specify the language of the output or preserve the language of the input address.  This implies that customers can output an English address in French in Québec for example.  Please note that only Street Descriptors and Provinces are available in multiple languages in version 5.3.1.

 

fold faq

Why is it important that an address validation software is certified by postal organizations?

Postal certifications serve as a standard for address data quality measurement and allow customers to benefit of postage discounts. They are an absolute necessity if you plan to post bulk mail at discounted rates within specific countries. Customers like direct marketing agencies or online shops benefit from accurate addresses which culminates in more efficient and timely mail delivery.

Main benefits:

  • Mailing discounts for mass mailings in specific countries
  • Punctual and correct mail delivery thanks to valid addresses
  • Reduced costs, caused by inaccurate addresses and non-deliverable mail
  • Improved effectiveness of direct marketing activities
  • Strengthened customer retention with timely and accurate correspondence
fold faq

Does AddressDoctor's Software Library support the British Forces Postal File (BFPO)?

Yes.

British Forces working abroad can take advantage of ordering goods online or via telephone. AddressDoctor has implemented the Royal Mail British Forces Post Office (BFPO) data into the Software Library Version 5.3.0. This information is available in the Royal Mail Postal Address File. Customers can ensure that goods ordered by Military personnel stationed abroad do not go astray.

An example of a BFPO address:

BFPO 802 -> Thoroughfare/Street
BFPO -> Post Town
BF1 1AB -> Postal Code
GBR

fold faq

What does SNA certified mean?

Since July 2nd, 2012, AddressDoctor's Software Library is officially certified by the French postal organization La Poste. The SNA certification confirms that AddressDoctor complies with the high standards set by La Poste.

French Postal Organizations require French addresses to conform to certain rules and standards. Below is a summary of the most important rules for French addresses. For more information, contact the French Postal organization "La Poste" at www.laposte.com.

A certified address consists of 6 Formatted Address Lines (FALs)

If FALs are used for input they must follow this format as well

The FAL contains the following information:

  • Line 1 – Contact
  • Line 2 – Organization / Sub Building
  • Line 3 – Building Name
  • Line 4 – Street with House Number
  • Line 5 – PO Box / BP / Locality 2
  • Line 6 - CSLLN (Locality 1, postal code)

Additional localities identified, that are not associated to Locality 1, must be eliminated from the address

All other data must remain inside the address

Unidentified input must not appear in lines 4-6. It must be moved into lines 1 - 3

Every SNA address must contain a FAL 6 and a FAL 4

CEDEX postal codes must not be changed

Non-CEDEX postal codes may be changed, but not to a CEDEX postal code

fold faq

What does HNO mean?

HNO is the abbreviation for house number, for example:

208 S Wilmington St
Raleigh NC 27601
USA

The house number (HNO) is “208”

fold faq

What does SendRight mean?

Since 2008, the New Zealand postal authority offers a certification program to decrease the number of incorrectly addressed pieces of mail through the SendRight™ Address Accuracy Program. This program requires bulk mail customers to validate their postal addresses against New Zealand Post’s Postal Address File (PAF), and obtain a Statement of Accuracy (SOA). To obtain the certification which allows for a postal discount, an SOA percentage of 85% must be achieved. The portion of mail pieces with inaccurate addresses below this will be charged at the full standard mail rate. SendRight™ certification provides a process for address validation software to be tested for accuracy and quality address standards, and recognized as suitable to issue SOAs. AddressDoctor’s Software Library Version 5.3.0 has passed the certification program and was approved by New Zealand Post.

fold faq

What is the Residential Delivery Indicator (RDI)?

The United States Postal Service (USPS) developed the Residential Delivery Indicator (RDI) product to provide shipping companies the information required to make informed shipping decisions.  AddressDoctor utilizes the RDI data during CASS certified processing to indicate if an address is classified as residential or business.

fold faq

What is an Early Warning System (EWS)?

The United States Postal Service (USPS) developed the Early Warning System (EWS) as a way to increase address quality. The system is used to identify new construction addresses that have not been added to the USPS ZIP+4 database. These addresses are valid addresses and should not be changed as the USPS is in the process of assigning ZIP+4 codes.  AddressDoctor utilizes the EWS data during the CASS certified processing of addresses to inform customers that an address that isn’t currently in the ZIP+4 database we be added in the next database release.

fold faq

Understanding SERP Status Values

  • ESE0: SERP output not available (for this address)
    • You will receive this for addresses not within the CAN databases
  • ESE1: SERP attributes provided
    • You will receive this for addresses within the CAN databases
    This does not necessarily mean that the address is a valid address, just that the address was processed using the SERP processing
fold faq

Understanding CASS Status Values

  • ECA0: CASS output not available (for this address)
    • You will receive this for addresses not within the USA databases
  • ECA1: CASS attributes only partially provided (some databases are missing)
    • You will receive this when processing and a database is missing during initialization of the AddressDoctor software library
  • ECA2..4: Reserved for future use
  • ECA5: CASS attributes provided
    • You will receive this for addresses within the USA databases
    • This does not necessarily mean that the address is a valid address, just that the address was processed using the CASS processing
fold faq

Understanding Geocoding Status Values

  • EGCU: Geocoding database not unlocked
  • EGCN: Geocoding database not found
  • EGCC: Geocoding database corrupt
  • EGC0: No Geocode available
  • EGC1..4: Reserved for future use
  • EGC5: Geocode with postal code level accuracy
  • EGC6: Geocode with locality level accuracy
  • EGC7: Geocode with street level accuracy
  • EGC8: Geocode with house number level accuracy (interpolated approximation)
  • EGC9: Reserved for future use
fold faq

Understanding Mailability Scores

  • 5: completely confident
  • 4: almost certain
  • 3: should be fine
  • 2: fair chance
  • 1: risky
  • 0: futile
Category: Software Library
fold faq

Understanding Process Status Values

  • V4 Verified – Input data correct - all (postally relevant) elements were checked and input matched perfectly
  • V3 Verified – Input data correct on input but some or all elements were standardized or input contains outdated names or exonyms
  • V2 Verified – Input data correct but some elements could not be verified because of incomplete reference data
  • V1 Verified – Input data correct but the user standardization has deteriorated deliverability (wrong element user standardization – for example, postcode length chosen is too short). Not set by validation.
  • C4 Corrected – all (postally relevant) elements have been checked
  • C3 Corrected – but some elements could not be checked
  • C2 Corrected – but delivery status unclear (lack of reference data)
  • C1 Corrected – but delivery status unclear because user standardization was wrong. Not set by validation.
  • I4 Data could not be corrected completely, but is very likely to be deliverable – single match (e.g. HNO is wrong but only 1 HNO is found in reference data)
  • I3 Data could not be corrected completely, but is very likely to be deliverable – multiple matches (e.g. HNO is wrong but more than 1 HNO is found in reference data)
  • I2 Data could not be corrected, but there is a slim chance that the address is deliverable
  • I1 Data could not be corrected and is precodey unlikely to be delivered.
  • Q3 FastCompletion Status – Suggestions are available – complete address
  • Q2 FastCompletion Status – Suggested address is complete but combined with elements from the input (added or deleted)
  • Q1 FastCompletion Status – Suggested address is not complete (enter more information)
  • Q0 FastCompletion Status – Insufficient information provided to generate suggestions
  • RA Country recognized from ForceCountryISO3 Secodeing
  • R9 Country recognized from DefaultCountryISO3 Secodeing
  • R8 Country recognized from name without errors
  • R7 Country recognized from name with errors
  • R6 Country recognized from territory
  • R5 Country recognized from province
  • R4 Country recognized from major town
  • R3 Country recognized from format
  • R2 Country recognized from script
  • R1 Country not recognized - multiple matches
  • R0 Country not recognized
  • S4 Parsed perfectly
  • S3 Parsed with multiple results
  • S2 Parsed with Errors – Elements change position
  • S1 Parse Error – Input Format Mismatch
  • N1 Validation Error: No validation performed because country was not recognized
  • N2 Validation Error: No validation performed because required reference database is not available
  • N3 Validation Error: No validation performed because country could not be unlocked
  • N4 Validation Error: No validation performed because reference database is corrupt or in wrong format
  • N5 Validation Error: No validation performed because reference database is too old – please contact AddressDoctor to obtain updated reference data

Please note that for BATCH processing it is strictly recommended to only accept records with Vx or Cx status for automated data updates. Ix records need to be reviewed manually before using these results for any data update whatsoever.

Category: Software Library
fold faq

What does CASS, SERP, SNA, SendRight or AMAS Certified mean?

Five postal organizations worldwide offer an official certification process for address validation software: USPS, Canada Post, La Poste in France, New Zealand Post and Australia Post. AddressDoctor's Software Library has achieved their stringent address data cleansing and validation criteria and received all of the five following certifications:

  1. SendRight (New Zealand Post)

  2. SNA (La Poste France)

  3. CASS (USPS - Unites States Postal Service)

  4. AMAS (Australia Post)

    5. SERP (Canada Post)

fold faq

Is the AddressDoctor Software Library USPS CASS (Coding Accuracy Support System) certified?

AddressDoctor 5 has been first certified by the United States Postal Service in March 2010.  As of July 2011, AddressDoctor v5.2.7 is CASS Cycle N certified.

Category: Software Library
fold faq

Is the AddressDoctor Software Library Canada Post SERP (Software Evaluation and Recognition Program) certified?

Yes, AddressDoctor has achieved certification by Canada Post in March 2010. AddressDoctor completed certification for the SERP 2011 standard powered by the new Point of Call Address Data (PoCAD) from Canada Post.

Category: Software Library
fold faq

What kind of information do I need to provide when contacting the AddressDoctor Support Team?

You may contact Informatica Global Customer Support at: www.informatica.com/us/services-and-training/support-services/global-support-centers/ 
When doing so, please make sure to provide the following XML files in a ZIP archive, after having run them through the ConsoleDemo application provided by AddressDoctor to check for reproducibility of your issue:

  • SetConfig.xml - may be retrieved using AD_GetConfigSecodeingsXML() (in Java: getConfigXML())
  • Parameters.xml - may be retrieved using AD_GetParametersXML() (in Java: getParametersXML())
  • InputData.xml - may be retrieved using AD_GetInputDataXML()(in Java: getInputDataXML())
  • Result.xml - may be retrieved using AD_GetResultXML()(in Java: getResultXML())
Category: Software Library
fold faq

How do I analyze error conditions?

For C, AD_GetLastError() provides you with the last error return code and AD_GetExtendedErrorMsg() allows access to extended information pertaining to the last error. Error messages often point to configuration issues that are best analyzed by referring to GetConfig.xml or Parameters.xml.

For Java you use

AddressDoctorException.getExtendedMessage() for that same purpose. Please make sure to wrap AddressDoctor and AddressObject calls with try/catch blocks for proper exception handling – for a more detailed example see the code in the documentation:

try

{   

AddressDoctor.process(m_oAO);   

iLastError = AddressDoctor.getLastError();   

System.out.println("Process returned " + iLastError);

} catch (AddressDoctorException ex)

{   

System.out.println("Exception during process: " + ex.toString());

}

The ConsoleDemo test application in C and Java provided by AddressDoctor may prove helpful in analyzing error conditions.

Category: Software Library
fold faq

How do I produce valid AddressDoctor XML?

Any XML input to the AddressDoctor Engine should always be well-formed and validated against the DTDs provided for that purpose by AddressDoctor. Please do note that the sequence of the XML elements does matter (but not that of their attributes), which can be checked through DTD validation as well.

Refer to wikipedia.org/wiki/XML for an introduction to XML. Apart from XML functionality being an integral part of most modern Integrated Development Environments (IDEs), there is a diverse choice of free validating XML editors, like WMHelp XMLPad or XML Copy Editor from SourceForge.net.

When dealing with XML files produced on different platforms, please note that end-of-line (EOL) characters differ between Windows (CR+LF) and UNIX (LF), see wikipedia.org/wiki/Linebreak.

Category: Software Library
fold faq

How can I determine when the unlock code will expire?

Calling AD_GetConfigSecodeingsXML() will return a GetConfig.xml with the engine configuration, including unlock code information.

 

Category: Software Library
fold faq

How often is the AddressDoctor Software Library updated?

A new software library is released several times a year. These libraries contain functional enhancements and bug fixes. Registered customers can download these libraries from our servers. Additional update information can be found Opens internal link in current windowhere.

Category: Software Library
fold faq

Is AddressDoctor 5 multithreaded?

AddressDoctor 5 provides optimized multi-threading support presenting you with the ability to harness the power of current multi-core hardware architectures. Using multiple threads, you can scale your address processing throughput efficiently by processing multiple addresses in parallel on multiple processor cores.

Category: Software Library
fold faq

Can one key unlock multiple countries or do I need one key per country?

One key can unlock multiple countries. More than one key is only required when the durations of the licenses differ.

Category: Software Library
fold faq

What happens when we try to validate an address that is in a country that AddressDoctor is not able to process? Is an error returned?

AddressDoctor can process and cleanse data from more than 240 countries and territories. There are only few countries for which addresses cannot be processed. Currently (as of Fall 2011), addresses from Ireland, for example, cannot be validated. AddressDoctor marks Irish addresses with N2 (N2 = No validation because there is no reference data available).

fold faq

Which platforms are supported?

The AddressDoctor software library is developed using the C++ programming language. The resulting API is available for C and Java, provided by a single combined AddressDoctor software library.

While the primary development platform is Windows and Microsoft Visual Studio 2005, the library is available for numerous hardware and software platforms. AddressDoctor 5 library packages are available for Windows, AIX, Solaris and Linux.

For more Information please click here.

Category: Software Library
fold faq

What are the system requirements?

AddressDoctor has been designed to achieve the best possible performance while being highly efficient in its memory and resource usage. In order to ensure best possible performance, a fast I/O system and sufficient memory is recommended. As with most applications, the engine will perform better if more memory and a faster processor are installed. The minimum requirements are 512 MB of memory for validation operations and 128 MB of memory if parsing-only is required. In October 2011, the entire worldwide postal reference database requires around 15 to 20 GB of disk space. To optimize performance, the most commonly used databases should reside in memory. Thus it is recommended to have at least 1GB RAM available, up to several GB are needed for loading the full reference database set into memory. As this might well exceed the maximum amount of memory a 32 Bit operating system can access, AddressDoctor strongly recommends using 64 Bit operating systems in production.

Category: Software Library
fold faq

For what countries does AddressDoctor supply Geocodes?

Please go to Country List and select "Geocoding" to get a current list of all countries supporting Geocoding of addresses.