API Blog

Communication and Data Quality APIs for real-time business solutions.

Posts Tagged ‘CASS Certification’


Addresses are Complicated…

Posted by:  /  Tags: , , , , , , , , , , , , , , ,

2cdyne_blog_pav

Verification vs. Correction

A common misunderstanding about what CDYNE Postal Address Verification service does has to do with the difference between verification and correction. Verification simply says something is correct or it isn’t. We can easily verify 2 + 2 = 4, likewise 3 + 3 = 4 fails verification. Verification makes no attempt to fix what is false. It is a simple statement that something is correct or it isn’t.

Correction on the other hand takes a statement and tries to make it true and that is a much more complicated process. Take the above example: 3 + 3 = 4; we can correct that to 3 + 1 = 4 OR 3 + 3 = 6. Both corrections are true but which statement was originally intended is unclear. To properly correct we need more information.

CDYNE PAV is certified by the United States Postal Service under a program called CASS (Coding Accuracy Support System). CASS rules require that our software take an input address and verify it exists in the USPS databases. Of course there is more to it than that. There is standardization, limited spelling correction, and certain inexact matches are allowed, but ultimately following CASS rules is about verification not correction.

This is best summed up by an excerpt from the USPS Address Matching Guidelines documentation:

“…the main goal of all address-matching software
should be to make THE MATCH — not just any match”

When an attempt is made to match an input to the database, if a match cannot be found, or it is unclear which address the input should match, the input fails verification. It is also important to point out that failing verification does not mean an address cannot be delivered, but mailing out something without a verified address may take longer, it might go to the wrong location, it might be returned undeliverable, or it might be lost in the system.

Addresses are Complicated…

Addresses are a mess. One of the greatest contributing factors to this is that the USPS has no control over city, street names, or street numbering. City borders move, streets are renamed, and numberings can change based on local and state government decisions.

Furthermore each municipality may create its own way of making addresses. For instance in Wisconsin the following addresses is common:

S90 W13970 Boxhorn
DrMuskego, WI 53150

In this case S90 W13970 are actually latitude and longitude coordinates.

To counter this USPS has developed its own collection of identifiers that it uses to expedite the movement of mail:

Finance numbers are typically assigned to a single post office and contain multiple zip codes.  For the most part it isn’t necessary for anyone outside the USPS to know about finance numbers, but they are convenient for creating a collection of addresses to verify a single address against.

Zip codes are usually a collection of routes used to deliver mail, but may also be a collection of PO boxes, a unique number for a single business, etc. It is important to recognize that while zip codes are often thought about as regions they really are a group of places mail can be delivered. As such they can overlap or even be discontinuous.

Plus 4 values further subdivide a zip code into areas like a city block.

Delivery point number, which is only added after an address has been fully verified, signifies a particular location that receives mail.

The USPS has created and assigned these numbers for one reason only: to make delivering a piece of mail as easy as possible.

Address verification is the process of taking the input address, finding the best match in the USPS database, and returning the address found in the database.

Street Information Broken Down

Typical street information can be broken down into parts. While most addresses follow this format there are many that don’t and have to be handled separately. Consider the following prototype:

1234 N Main Street S Apt 101

Primary number (1234)Typically the primary number is the first element and contains sequential alphanumeric information. Most often the input is checked to be in a range of values for verification. This value is present in almost all addresses and cannot be corrected, it’s either wrong or its right.

Pre-Directional (N) – The pre-directional can be one of the 4 cardinal directions or one of the 4 ordinals. This value isn’t always present and correction for it follows a very narrow set of rules.

Street Name (Main) – The street name is present in almost all addresses. It often contains more than one word and can be the most loosely matched too.

Suffix (Street) – The suffix is the “type” of street: Avenue, Road, Parkway, etc. Like the pre and post directionals it can only be corrected in a limited fashion, must match a set of values, and is abbreviated. While you will usually see a suffix it is sometimes missing.

Post-Directional (S) –The post-directional can be one of the 4 cardinal directions or one of the 4 ordinals. This value isn’t always present and correction for it follows a very narrow set of rules.

Secondary Abbreviation (Apt) – The secondary abbreviation is typically one of a collection of possible values: Apt (Apartment), Ofc (Office), Flr (Floor), Ste (Suite), etc. If all other address information matches this will be corrected to the database value if possible.

Secondary Number (101) – The secondary like the primary number contains alphanumeric information that is typically part of a sequence. It also cannot be corrected.

The Process

All address verification starts with the City, State, and Zip Code data; commonly referred to as the last line. From this information a list of finance numbers is built, and the finance numbers are separated into 8 categories:

The table above shows the priority of address matches in each finance number. For instance a match found in a Finance number that matches the City, State and ZIP in the input address would have higher priority than a match that is in a finance number that only matches the City and State of the input address. It’s important to note that a street address must match at least two pieces of the last line data, the only exception is when a zip 5 is the only piece of last line data provided.

Next a list of street names is pulled for all of the relevant finance numbers. There can be tens of thousands of street names and all of these must be compared to the input street name which can be ambiguous itself. A list of all possible addresses is generated from possible matching street names.

An attempt is then made to match the input address to one of the addresses in the list. If a single match is found it is returned, if multiple matches are found some tie breaking is attempted but if no single match can be determined the address fails verification.

Just because an address fails verification does not mean it is undeliverable. The post office may still attempt to deliver the piece of mail but it will most likely take longer to deliver, if it is delivered at all.

Click here for more information about PAV, or get a free trial key to test the API for free.

CDYNE PAV Infographic

Posted by:  /  Tags: , , , , , , , , , , , ,

cdyne_blog_usps_infographic

Companies can save money on lost production and postage fees simply by running their addresses through a CASS certified program like CDYNE PAV, which verifies the deliverability of addresses. The API compares your addresses against the USPS database and will let you know if they are deliverable. Click here (opens a PDF) to see the importance of address data quality, some reasons for bad addresses, and the return on investment when validating the accuracy of your address lists.

Click here for more information about PAV, or get a free trial key to test the API for free.

PAV Delivery Point Data Returns

Posted by:  /  Tags: , , , , , , , , , , , ,

CDYNE PAV DPV

A valuable benefit of using PAV is to check whether or not an address is deliverable in order to receive barcode discounts. PAV includes DPV (Delivery Point Validation), which is the USPS process for verifying deliverability. A delivery point is a single point at which mail is delivered (e.g., a mail slot, PO Box, or mailbox). It is not the same as a street address. In fact,  an address can contain multiple delivery points such as an apartment building or business office with numerous suites. The USPS defines DPV as a specific set of digits between 00 and 99. Combined with the ZIP+4 code, a delivery point gives each deliverable address a unique identifier. Delivery points are encoded in barcodes, which allows automated sorting for the USPS.

Developers can utilize PAV to return detailed mailing industry information including DPV data returns. This data is accessed when using the “VerifyAddressAdvanced” method and setting the “MailingIndustryInfo” parameter to True. The following are example address input and outputs.

Input: 505 independence parkway, suite 300, chesapeake, va, 23320

Output: 505 INDEPENDENCE PKWY STE 300, CHESAPEAKE, VA, 23320-5178

  • DeliveryPoint = 75
  • DpvConfirmationIndicator = Y
  • DpvCrmaIndicator = N
  • DpvFootnote1 = AA
  • DpvFootnote2 = BB
  • DpvFootnote3 = Null

In this example, the unique identifier and delivery point is 23320517875 (ZIP+4+delivery point). PAV confirms this address does have a delivery point and mail can be delivered there (DpvConfirmationIndicator = Y). The DpvCrmaIndicator = N means that the address is not associated with a valid CRMA, which stands for Commercial Mail Receiving Agency, and is also known as a Private Mailbox (PMB) operator. The DPV footnotes indicate the address has been matched to the ZIP+4 file (AA) and all components of the address were matched to DPV (BB).

The keys below show all available PAV data results.

DPV Confirmation Indicator Key

  1. Y – Address was DPV confirmed for both primary and, if present, secondary numbers
  2. D – Address was DPV confirmed for the primary number only, and secondary number information was missing
  3. S – Address was DPV confirmed for the primary number only, and secondary number information was present but unconfirmed
  4. N – Both primary and, if present, secondary number information failed to DPV confirm

DPV CMRA Indicator Key (CMRA = commercial mail receiving agent)

  1. Y – Address was found in the CMRA table
  2. N – Address was not found in CMRA table

DPV Footnotes Key

  1. AA – Input address matched to the ZIP+4 file
  2. A1 – Input address not matched to the ZIP+4 file
  3. BB – Input address matched to DPV (all components)
  4. CC – Input address primary number matched to DPV but secondary number not matched (present but invalid)
  5. F1 – Input address matched to a Military address
  6. G1 – Input address matched to a General Delivery address
  7. N1 – Input address primary number matched to DPV, but address is missing secondary number
  8. M1 – Input address primary number missing
  9. M3 – Input address primary number invalid
  10. P1 – Input address missing PO, RR, or HC box number
  11. P3 – Input address PO, RR, or HC box number invalid
  12. RR – Input address matched to CMRA and PMB (postal mailbox) designator present (PMB 123 or # 123)
  13. R1 – Input address matched to CMRA but PMB (postal mailbox) designator not present (PMB 123 or # 123)
  14. U1 – Input address matched to a unique ZIP code

Manage Residential and Business Addresses with RDI

Posted by:  /  Tags: , , , , , , , , ,

Residential Indicator API

More than 90% of the 140 million Postal Service’s delivery points are classified as residential. RDI, or Residential Delivery Indicator is a USPS delivery type status that flags an address as residential or business. Because some delivery companies charge more for residential deliveries, the biggest advantage of knowing the RDI for an address is the ability to shop for the most cost-effective delivery option. Some of the benefits of identifying an address as residential or business include:

  • Reduce residential delivery surcharges
  • Lower shipping charges by price-shopping for a service that meets your needs
  • Enhance Customer Relationship Management (CRM) by demonstrating efficient and accurate shipping practices
  • Identify shipping patterns to improve operational efficiency
  • Providing online rate-shopping services on websites

CDYNE PAV API includes an optional RDI flag free of charge. It can be returned with VerifyAddressAdvanced method by setting the parameter “ReturnResidentialIndicator” to “True.” If the address is a residence, PAV will return “N,” and if it is a business, PAV will return “Y.” The following is an example showing an address classified as a business.

Input:

505 independence pkwy, chesapeake, va 23320
Return Residential Indicator: True

Output:

505 INDEPENDENCE PKWY, CHESAPEAKE, VA 23320-5178
Residential Delivery Indicator: N

For more information about CDYNE PAV, please contact an account representative at 1-800-984-3710, inquire by email, or initiate a chat for more details.

Or sign up for a free trial license key to test CDYNE PAV.

Developers find CDYNE PAV API integration details on the CDYNE developer’s wiki.

CDYNE PAV Now Offers Full Canadian Address Verification

Posted by:  /  Tags: , , , , , , , , , , , , ,

Canadian Address Verification

CDYNE’s Postal Address Verification API now fully validates Canadian addresses. You can standardize, correct, and verify US and Canadian addresses in one step. The API has been renamed PAV, and is the perfect complement to the PAV-I API, which standardizes and validates international addresses.

There are two supported operations for Canadian address verification: VerifyAddress and VerifyAddressAdvanced. Only two return codes apply to Canadian addresses. A return code of 200 means that the address was verified. A return code of 202 means that the input address is confirmed for all components except for the secondary number. A return code of 10 means that the address could not be found or verified.

If you have Canadian addresses with missing zip codes, PAV can append the zip code of the address as long as the Canadian province name has been abbreviated at input. Please see image below for an example.

We will use the address 75 University Ave West, Waterloo, ON to emphasize PAV’s ability to append a missing zip code.

Address input with missing zip code:

Address output with appended zip code:

As you can see, the correct zip code has been added and the address yields a return code of 200, meaning that the address is verified.  The address is now prepared for optimum delivery as suggested by the Canada Post with the output address properly parsed in upper case fonts and the zip code separated after the first three characters.

For more information about CDYNE PAV, please contact an account representative at 1-800-984-3710, inquire by email, or initiate a chat for more details.

Or sign up for a free trial license key to test CDYNE PAV.

Developers find CDYNE PAV API integration details on the CDYNE developer’s wiki.

Part 5: CDYNE Postal Address Verification DPV Code Suggestions

Posted by:  /  Tags: , , , , , , , , , , , , , , ,

pav-5
CDYNE Postal Address Verification API returns USPS mailing industry information that can be useful for interacting with address verification at point of entry. In the chart below, the first two columns outline the values returned when using the VerifyAddressAdvanced method.
For example, inputting the address “2125 smith ave, chesapeake, va” will return the following mailing industry values:
  • DpvConfirmationIndicator: D
  • DpvFootnote1: AA
  • DpvFootnote2: N1
Comparing D AA N1 to the chart below may prompt a suggested interaction of, “Verify secondary information, it is not present.” In other words, the suite number is missing. Depending on the data entry scenario, you can generate an error pop-up to ask for the secondary address information, or flag the address for future processing or validation.

DPV Return Code

Footnote

Suggested Interaction


N

AA

Verify the address
. The address validated on the CASS certified software engine but cannot be validated in the DPV process.

N

AA M1

Verify the Primary Number, it is not present. The address validated on the CASS certified software engine, but cannot be validated in the DPV process

N

AA M3

Verify the Primary Number
, It is present but not valid. The address validated on the CASS certified software engine, but cannot be validated in the DPV process.

N

AA P1

Verify the box number
, it is not present for this RR or HC address but needed to confirm in the DPV process.

N

AA P3

Verify the box number
, it is present for this PO Box, RR or HC address but cannot be confirmed in the DPV process.

Y

AA BB

No action needed
, the address validated to all components.

Y

AA RR

No action needed
, the address validated. It has been found in the CMRA table with PMB information present.

Y

AA R1

The address validated
. It has been found in the CMRA table without PMB information.

Y

AA F1

No action needed.

Y

AA G1

No action needed.

Y

AA U1

No action needed.

S

AA CC

Verify secondary information
, it is present but cannot be confirmed in the DPV process.

S

AA P3

Verify the box number
, it is present for this PO Box, RR or HC address but cannot be confirmed in the DPV process.

S

AA CC RR

Verify secondary information
, it is present but cannot be confirmed in the DPV process. It has been found in the CMRA table with PMB info present.

S

AA CC R1

Verify secondary information
, it is present but cannot be confirmed in the DPV process. It has been found in the CMRA table without PMB information and is not required for USPS delivery.

D

AA P1

Verify the box number
, it is not present for this RR or HC address but needed to confirm in the DPV process.

D

AA N1

Verify secondary information
, it is not present.

D

AA N1 RR

Verify secondary information
, it is not present. It has been found in the CMRA table with PMB information present.

D

AA N1 R1

Verify secondary information
, it has been found in the CMRA table without PMB information and is not required for USPS delivery.

Blank

A1 M1

Get correct address
, this address cannot be found in CASS certified software engine so it is not presented to the DPV process.

Blank

A1 M3

Get correct address
, this address cannot be found in CASS certified software engine so it is not presented to the DPV process.

Blank

A1

Get correct address
, this address cannot be found in CASS certified software engine so it is not presented to the DPV process.
You can read the rest of the blog series by accessing the links below:

For more information about CDYNE Postal Address Verification, please contact an account representative at 1-800-984-3710, inquire by email, or initiate a chat for more details.

Or sign up for a free trial license key to test CDYNE Postal Address Verification.

Part 4: CDYNE Postal Address Verification VerifyAddressAdvanced Operation

Posted by:  /  Tags: , , , , , , , , , , , , ,

pav-4

In addition to validating whether an address is deliverable, this programming operation returns a host of optional information at no extra charge including geolocation, legislative, census, and mailing industry information. These options can be turned on with a true value within the web service call (the default value is set to false). The advantage of the VerifyAddressAdvanced Operation is the ability to customize the data return according to your business needs.

The following examples break down the complete data returns available with the VerifyAddressAdvanced method. The first section shows the default information returned. You will find detailed information about parameter definitions in the Postal Address Verification Spec Sheet.


VerifyAddress Input


VerifyAddress Output


Firm: Cdyne

Primary Address Line: 2125 smith ave

Secondary Address Line: 200

City: chesapeake

State: va

Zip: 23320


Firm: CDYNE

Primary Address Line: 2125 Smith Ave Ste 200

Secondary Address Line: 200

City: Chesapeake

State: VA

Zip: 23320-2518

Country: USA

County: CHESAPEAKE CITY

County Number: 550

Finance Number: 511750

Intelligent Mail Barcode Key: ZTVQibvZk2Jrcsi387W33A==

Multiple Matches: (null)

PMB Designator:

PMB Number:

Post Directional:

Postnet Barcode: f233202518509f

Pre Directional:

Preferred City Name: Chesapeake

Primary: 2125

Primary Delivery Line: 2125 Smith Ave Ste 200

Primary EO: O

Primary High: 2125

Primary Low: 2125

Return Code: 100

Secondary: 200

Secondary Abbreviation: STE

Secondary Delivery Line: 200

Secondary EO: E

Secondary High: 202

Secondary Low: 100

State Abbreviation: VA

Street Name: SMITH

City: Chesapeake

Suffix: AVE

Urbanization:

Zip Code: 23320-2518

Within the VerifyAddressAdvanced method is the option to set certain requests to a “True” value to obtain additional information. They include:

  • Return Case Sensitive – a value set to “True” will return proper case formatting instead of the USPS standardized all caps formatting.
  • Return Census Info – a value set to “True” will return census information including CMSA, Census Block Number, Census Tract Number, FIPS, MA, MSA, and PMSA.
  • Return City Abbreviation -
  • Return Geo Location – a value set to “True” will return area code, latitude/longitude, daylight savings status, and time zone.
  • Return Legislative Info – a value set to “True” will return congressional district number and state legislative lower and upper numbers.
  • Return Mailing Industry Info – a value set to “True” will return carrier route, delivery point, DPV, eLOT, LACS Link, and Suite Link values and return codes.
  • Return Residential Indicator – a value set to “True” will identify whether an address is classified as residential or business. A return value of “Y” means the address is residential, and “N” designates a commercial address.
  • Return Street Abbreviated -

 

The chart below shows the associated data returns when any of these requests is set to “True.” Otherwise, no data is returned.


Optional Data Returns When Set to True


Return Case Sensitive: True


City Name: Chesapeake

Preferred City Name: Chesapeake

Primary Delivery Line: 2125 Smith Ave Ste 200


Return Census Info: True


CMSA: 5720

Census Block Number: 4001

Census Tract Number: 0208.01

FIPS: 51550

MA: 572

MSA: 5720

PMSA:


Return City Abbreviation: True


Return Geolocation: True


Area Code: 757

Avg Latitude: 36.796768

Avg Longitude: -76.228590

From Latitude: 36.794937

From Longitude: -76.228590

Has Daylight Savings: True

Time Zone: EST

To Latitude: 36.798599

To Longitude: -76.228590


Return Legislative Info: True


Congressional District Number: 04

State Legislative Lower: 090

State Legislative Upper: 014


Return Mailing Industry Info: True


CS Key: X26324

Carrier Route: C006

Check Digit: 9

Default Flag: False

Delivery Point: 50

Dpv Confirmation Indicator: Y

Dpv Crma Indicator: N

Dpv Footnote 1: AA

Dpv Footnote 2: BB

Dpv Footnote 3:

Dpv No Stat Indicator: N

Dpv Vacant Indicator: N

ELOT Asc Desc: A

ELOT Sequence Number: 0122

Ews Flag: False

LACS Flag:

LACS Indicator:

LACS Return Code:

Record Type Code: H

SuiteLink Return Code: A


Return Residential Indicator: True


Residential Delivery Indicator: N


Return Street Abbreviated: True

You can read the rest of the blog series by accessing the links below:

Part 1: CDYNE Postal Address Verification API Overview

Part 2: CDYNE Postal Address Verification API Operations Overview

Part 3: CDYNE Postal Address Verification VerifyAddress Operation

Part 5: CDYNE Postal Address Verification DPV Code Suggestions

For more information about CDYNE Postal Address Verification, please contact an account representative at 1-800-984-3710, inquire by email, or initiate a chat for more details.

Or sign up for a free trial license key to test CDYNE Postal Address Verification.

Part 3: CDYNE Postal Address Verification VerifyAddress Operation

Posted by:  /  Tags: , , , , , , , , , , , , , , ,

pav-3-header

CDYNE Postal Address Verification VerifyAddress programming method is the barebones Web Service call for users who only need to validate whether or not an address is deliverable. The address deliverability status is returned through the DPV Return Code system, which indicates the parts of the address that are incorrect, and will return corrected information on file with the USPS. This article will take you through three address input and output examples to display some of the important features that the VerifyAddress operation offers.

Example 1: A Correct Address is Confirmed Deliverable

Let’s begin with a correct address and run it through the VerifyAddress Operation. The left hand column shows the input address and the license key. The right hand column displays the corrected address and return code that is sent back by CDYNE Postal Address Verification. There are several differences that immediately jump out between the input and output columns:

  • Lowercase letters were changed to all caps
  • The secondary address line input value of 200 was appended to the primary address line in the output as “STE 200″
  • The zip + 4 value of “23320-2518″ was appended
  • A code of “100″ was returned

 


VerifyAddress Input


VerifyAddress Output


Firm: Cdyne

Primary Address Line: 2125 smith ave

Secondary Address Line: 200

City: chesapeake

State: va

Zip: 23320


Firm: CDYNE

Primary Address Line: 2125 SMITH AVE STE 200

Secondary Address Line: 200

City: CHESAPEAKE

State: VA

Zip: 23320-2518


Additional Input


Additional Output


License Key: F01d55fd-5155-5455-5585-e84ab8de5555


Return Code: 100

Although the USPS does not require all capital letters the USPS prefers all caps or uppercase for ease of automatic scanning and application of bar codes. With the VerifyAddress method, address data is returned in all caps. You can use VerifyAddressAdvanced operation to return addresses in proper case.

The USPS preferred location of the secondary address unit designators (i.e. APT, STE, BLDG) is at the end of the delivery address line. In the example above, CDYNE Postal Address Verification correctly moved “200″ to the end of the primary address line, and appended the correct designator of “STE.”

The zip + 4 determines a more precise location than the five-digit zip code alone. The zip + 4 includes the five-digit zip code, a hyphen, and four-digits at the end (i.e. 23320-2518).

The return code of 100 means all parts of the address are confirmed as deliverable. DPV is a USPS validation process that confirms the existence of a specific address (down to the apartment or suite number) and whether or not it is a valid destination for a mailing or package.

CDYNE Postal Address Verification DPV Return Codes:

  • 10 – Input address is not found
  • 100 – Input address is DPV confirmed for all components
  • 101 – Input address is found, but not DPV confirmed
  • 102 – Input address primary number is DPV confirmed – Secondary number is present but not DPV confirmed
  • 103 – Input address primary number is DPV confirmed – Secondary number is missing
  • 200 – Canadian address on input. Verified on city level only

 

Example 2: Providing Minimal Input Field Information

The minimum address field requirements for CDYNE Postal Address verification to validate an address are one of two combinations:

  • Primary address line/city/state
  • Primary address line/zip code

In the example below, entering the primary address line, city, and state returns a standardized and corrected address, but the return code in this instance is 103. This means the input address primary number is DPV confirmed, and the secondary number is missing. In other words, there is supposed to be a suite or apartment number, but that information cannot be determined with the input data. This is an opportunity to interact with the data entry in real time, or flag the address in the database for further evaluation.


VerifyAddress Input


VerifyAddress Output


Firm:

Primary Address Line: 2125 smith ave

Secondary Address Line:

City: chesapeake

State: va

Zip:


Firm:

Primary Address Line: 2125 SMITH AVE

Secondary Address Line:

City: CHESAPEAKE

State: VA

Zip: 23320-2518


Additional Input


Additional Output


License Key: F01d55fd-5155-5455-5585-e84ab8de5555


Return Code: 103

In the second example, entering the primary address line and zip code also returns a standardized and corrected address with a return code of 103.


VerifyAddress Input


VerifyAddress Output


Firm:

Primary Address Line: 2125 smith ave

Secondary Address Line:

City:

State:

Zip: 23320


Firm:

Primary Address Line: 2125 SMITH AVE

Secondary Address Line:

City: CHESAPEAKE

State: VA

Zip: 23320-2518


Additional Input


Additional Output


License Key: F01d55fd-5155-5455-5585-e84ab8de5555


Return Code: 103

Example 3: Utilizing the Firm Name or Recipient Input Field

CDYNE Postal Address Verification utilizes the USPS SuiteLink database to provide improved business addressing information by appending known secondary (suite) information to business addresses. In the example below, CDYNE Postal Address Verification appended “STE 200″ to the original address because it matched the firm name, “CDYNE” to “STE 200″ in the USPS database. Notice that the input address does not contain a secondary or suite number, but the corrected address does.


VerifyAddress Input


VerifyAddress Output


Firm: CDYNE

Primary Address Line: 2125 smith ave

Secondary Address Line:

City: Chesapeake

State: VA

Zip:


Firm: CDYNE

Primary Address Line: 2125 SMITH AVE STE 200

Secondary Address Line:

City: CHESAPEAKE

State: VA

Zip: 23320-2518


Additional Input


Additional Output


License Key: F01d55fd-5155-5455-5585-e84ab8de5555


Return Code: 100

You can read the rest of the blog series by accessing the links below:

Part 1: CDYNE Postal Address Verification API Overview

Part 2: CDYNE Postal Address Verification API Operations Overview

Part 4: CDYNE Postal Address Verification VerifyAddressAdvanced Operation

Part 5: CDYNE Postal Address Verification DPV Code Suggestions

For more information about CDYNE Postal Address Verification, please contact an account representative at 1-800-984-3710, inquire by email, or initiate a chat for more details.

Or sign up for a free trial license key to test CDYNE Postal Address Verification.

Part 2: CDYNE Postal Address Verification API Operations Overview

Posted by:  /  Tags: , , , , , , , , , , , , , ,

pav-blog-2

CDYNE Postal Address Verification API offers nine programming operations that deliver address data verification and data returns in a variety of ways. Each operation specializes in a specific set of data returns so businesses can select only the address information they need from a wider range of options. The following is a summary of each operation with an example of how each one can be used.

VerifyAddress Operation

This programming operation is the barebones Web Service call for users who only need to validate whether or not an address is deliverable.  Address deliverability status is returned through the DPV Return Code system, which indicates the parts of the address that are incorrect, and will return corrected information on file with the USPS. In the example below, the left column shows the address sent to CDYNE Postal Address Verification (along with the required license key). The right column shows the corrected address. It has been standardized in all caps, the suite designator has been corrected to “STE,” and the zip+4 number “2518″ has been appended to the five-digit zip code. Most importantly, CDYNE Postal Address Verification returns the code 100. This means all parts of the address are confirmed as deliverable (see DPV Return Codes below the example).  DPV is a USPS validation process that confirms the existence of a specific address (down to the apartment or suite number) and whether or not it is a valid destination for a mailing or package.

Additionally, CDYNE Postal Address Verification will return the county, country, and return code data. The return code designates the status of the Delivery Point Validation (DPV) information on file with the USPS.

CDYNE Postal Address Verification DPV Return Codes:

  • 10 – Input address is not found
  • 100 – Input address is DPV confirmed for all components
  • 101 – Input address is found, but not DPV confirmed
  • 102 – Input address primary number is DPV confirmed – Secondary number is present but not DPV confirmed
  • 103 – Input address primary number is DPV confirmed – Secondary number is missing
  • 200 – Canadian address on input. Verified on city level only

To see examples of addresses with return codes, see Part 3: CDYNE Postal Address Verification VerifyAddress Operation.

VerifyAddressAdvanced Operation

In addition to validating whether an address is deliverable, this programming operation returns a host of optional information at no extra charge including geolocation, legislative, census, and mailing industry information. These options can be turned on with a true value within the web service call (the default value is set to false). In the example below, census, geo location, legislative, mailing industry, and residential delivery indicators were set to true. The advantage of the VerifyAddressAdvanced Operation is the ability to customize the data return according to your business needs.

The example above does not show all of the data available for return. Please see Part 4: CDYNE Postal Address Verification VerifyAddressAdvanced Operation which details the complete features and capabilities of this programming method.

GetIntelligentMailBarcode

CDYNE Postal Address Verification API can be used to obtain an Intelligent Mail Barcode string to generate a barcode for mail discounts. The first step is to run an address through the VerifyAddressAdvanced operation, which will return the Intelligent Mail Barcode Key as shown in the example below.

Once the Intelligent Mail Barcode Key is obtained, the second step is to run the GetIntelligentMailBarcode operation. There are six required input values, and they are defined as the following:

  • Barcode Identifier — a two-digit number assigned by the USPS to encode the presort identification
  • Service Type Identifier — a three-digit number assigned by the USPS for any combination of services requested on the mailpiece
  • Mailer Identifier — a unique six or nine-digit number assigned by the USPS that identifies a business entity
  • Serial Number — a six or nine-digit number assigned by the mailer for uniquely identifying and tracking mailpieces
  • Intelligent Mail Barcode Key — the data string returned by CDYNE Postal Address Verification VerifyAddressAdvanced operation
  • License Key — a unique data string assigned by CDYNE Corporation to run Postal Address Verification transactions

The string data in the Intelligent Mail Barcode return can be used to generate barcodes for postal mailing discounts.

CDYNE Postal Address Verification GetIntelligentMailBarcode Return Codes:

  • 0 – Success
  • 1 – Invalid input

 

GetZipCodesWithinDistance

This operation returns all zip codes within the radius of a designated latitude and longitude. In the example below, the latitude/longitude and a radius of 1 mile returns five zip codes for that geolocation. The GetZipCodesWithinDistance operation also includes a return code of “0″ which means “success.” The return codes for the GetZipCodesWithinDistance operation are listed below.

CDYNE Postal Address Verification GetZipCodesWithinDistance Return Codes:

  • 0 – Success
  • 1 – Invalid input
  • 2 – Invalid license key
  • 3 – Returned zero zip codes
  • 4 – Outside of the latitude and longitude range

 

GetZipCodesForCityAndState

The GetZipCodesForCityAndState programming operation returns all zip codes associated with the city name and state provided at input. The example below returns nine zip codes for Chesapeake, VA, with a return code of “0″ or successful. The return codes for the GetZipCodesForCityAndState operation are listed below.

CDYNE Postal Address Verification GetZipCodesForCityAndState Return Codes:

  • 0 – Success
  • 1 – Invalid input
  • 2 – Invalid license key
  • 3 – No match

 

GetZipCodesForFips

Federal Information Processing Standard or FIPS are standards developed by the U.S. government for use in computer systems by all non-military government agencies and government contractors. The U.S. Census Bureau uses FIPS codes to identify legal and statistical entities including states and counties. By inputting the FIPS code value, you can obtain the associated zip codes as shown in the example below.

If you do not have the FIPS value, one way to obtain is through the VerifyAddressAdvanced method. Here is an example:

CDYNE Postal Address Verification GetZipCodesForFips Return Codes:

  • 0 – Success
  • 1 – Invalid input
  • 2 – Invalid license key
  • 3 – Returned zero zip codes

 

GetCongressionalDistrictByZip

This operation returns the congressional district associated with the zip code provided at input.

CDYNE Postal Address Verification GetCongressionalDistrictByZip Return Codes:

  • 0 – Success
  • 1 – Invalid input
  • 2 – Invalid license key
  • 3 – No match
  • 4 – Multiple match

 

GetCityNamesForZipCode

Cities in a zip code may be referred to by more than one name or spelling. The GetCityNamesForZipCode operation returns the actual city name as well as acceptable alternatives. In the example below, the default city name is “Boynton Beach” and an alternate name is “Village of Golf.” Both city names are acceptable city names on file with the USPS.

CDYNE Postal Address Verification GetCityNamesForZipCode Return Codes:

  • 0 – Success
  • 1 – Invalid input
  • 2 – Invalid license key
  • 3 – No match

 

GetUrbanizationListForZipCode

Urbanizations are commonly used in Puerto Rico urban areas and they denote an area, sector, or residential development within a geographic area. They are important designators because identical street names and address number ranges can be found within the same zip code. In the following example, the urbanization name is the only element that identifies the location of a particular address.

MR OSIRIS GONZÁLEZ
URB ROYAL OAKS
123 CALLE 1
BAYAMÓN PR 00961-0123

MR PEDRO RIVERA
URB HERMOSILLO
123 CALLE 1
BAYAMÓN PR 00961-1212

CDYNE’s GetUrbanizationListForZipCode programming method will return the urbanization list for the zip code input. In the following example, the zip code, “00965″ returns five urbanization names. Urbanizations typically use the abbreviation URB, but there are exceptions as shown in the example below. BDA (Barriada), BO (Barrio), and VILLA (Villa) are the correct abbreviations to use. The USPS published a detailed addressing standards document for Puerto Rico and US Virgin Islands, which can be found here.

CDYNE Postal Address Verification GetUrbanizationListForZipCode Return Codes:

  • 0 – Success
  • 1 – Invalid input
  • 2 – Invalid license key
  • 3 – No match

 

You can read the rest of the blog series by accessing the links below:

Part 1: CDYNE Postal Address Verification API Overview

Part 3: CDYNE Postal Address Verification VerifyAddress Operation

Part 4: CDYNE Postal Address Verification VerifyAddressAdvanced Operation

Part 5: CDYNE Postal Address Verification DPV Code Suggestions

For more information about CDYNE Postal Address Verification, please contact an account representative at 1-800-984-3710, inquire by email, or initiate a chat for more details.

Or sign up for a free trial license key to test CDYNE Postal Address Verification.

Part 1: CDYNE Postal Address Verification API Overview

Posted by:  /  Tags: , , , , , , , , , , , , , , , ,

CDYNE Postal Address Verification API

CDYNE Postal Address Verification is a CASS Certified API that checks U.S. addresses against a continuously updated USPS® database to standardize, correct, and validate addresses in one step. It will reduce non-deliverable addresses, ensure the fastest delivery possible, and qualify your mailings for USPS discounts.

An API, or Application Programming Interface, acts as the interface between business web applications, programs, or databases and the CDYNE Postal Address Verification process. The advantage of using a Web Service API is the ability to add advanced features into your business applications without maintaining the software or hardware required to run that feature. CDYNE Postal Address Verification API enables a business IT department to implement address verification capabilities within their existing systems with a minimal time and money investment.

CDYNE Postal Address Verification API is CASS Certified for the most recent Cycle N by the USPS®, which means our software passed the stringent evaluation and testing process the USPS requires for correction accuracy in the areas listed below. As part of the CDYNE Postal Address Verification offering, the following data is included in the pricing.

DPV® (Delivery Point Validation)

DPV is a USPS address validation process that confirms the existence of a specific address (down to the apartment or suite number) and whether or not it is a valid destination for a mailing or package. With CDYNE Postal Address Verification API, DPV is indicated by the return code. The example below shows a return code of 100, which means all parts of the address have been DPV confirmed. In other words, the address is verified as deliverable.

The example below also shows other features included with CDYNE Postal Address Verification. Notice how the input address is standardized in all caps (per USPS formatting guidelines), corrected (“Suite” is changed to “STE” and the 4-digit zip “2518″ is appended to the original zip code provided), and validated for deliverability with a return code of 100.

CDYNE Postal Address Verification returns the following result codes for DPV with the VerifyAddress operation. This is the barebones operation for users who only need to validate whether or not an address is deliverable. For more detailed DPV return codes and suggested interactions, use the VerifyAddressAdvanced Operation, which is discussed in detail in Part 4: CDYNE Postal Address Verification VerifyAddressAdvanced Operation.

  • 10 – Input address is not found
  • 100 – Input address is DPV confirmed for all components
  • 101 – Input address is found, but not DPV confirmed
  • 102 – Input address primary number is DPV confirmed – Secondary number is present but not DPV confirmed
  • 103 – Input address primary number is DPV confirmed – Secondary number is missing
  • 200 – Canadian address on input. Verified on city level only

 

LACSLink®

LACSLink® is a system that matches addresses against a list of rural route, highway route, and box number addresses that have been renumbered or renamed due to 911 address conversions. These conversions involve changing rural-style addresses to city-style addresses for 911 emergency system implementations. LACS stands for Locatable Address Conversion Service. The greatest advantage of LACSLink processing is that it reduces undeliverable mail and ensures that your lists have the most current address information on file, which lowers costs and provides faster delivery. The example below is a made-up address to illustrate how CDYNE Postal Address Verification handles LACSLink return data.

There are three LACSLink code fields that include the LACS Flag, LACS Indicator, and LACS Return Code. CDYNE Postal Address Verification returns the following result codes.

LACS Flag – this indicates whether or not there is an address match with the LACSLink database.

  • Y – LACS record match – the input address matched to a record in the master file, and a new address could be provided.
  • S – LACS record/secondary number dropped – the input address matched to a record in the master file, but the input address had a secondary number and the master record file did not.
  • N – No match – the input address could not be matched to a record in the master file, and a new address could not be provided.
  • F – False positive – a false positive record was detected

 

LACS Indicator – this indicates whether or not the input address has a conversion in the USPS LACSLink database.

  • L – There is a conversion address in the LACSLink database
  • Blank – No conversion address was found

LACS Return Code – this indicates the reason for the LACS Indicator returned (“L” or “blank”).

  • A – Match – Address Provided – there is a LACSLink record match and a converted address is provided
  • 00 – No Match – there is no match and no converted address
  • 14 – Match – No Conversion – found LACSLink record, but could not convert the data to a deliverable address
  • 92 – Match – Dropped Secondary Number – LACSLink record matched after dropping the secondary number from input address

 

RDI™ (Residential Delivery Indicator)

RDI or Residential Delivery Indicator identifies whether an address is classified as residential or business. Most shipping companies charge a higher price for residential deliveries. Businesses can use RDI data to maximize savings by flagging residential addresses and then shopping for the most cost-effective delivery option. In the following example, the Residential Delivery Indicator is “N,” which indicates that the address is classified as a business (rather than residential) by the USPS.

CDYNE Postal Address Verification returns the following result codes for Residential Delivery Indicator:

  • Y – Address is residential
  • N – Address is commercial

 

SuiteLink™

USPS SuiteLink data provides improved business addressing information by appending known secondary (suite) information to business addresses. In the example below, CDYNE Postal Address Verification appended “STE 200″ to the original address because it matched the firm name, “CDYNE” to “STE 200″ in the USPS database. Notice that the input address does not contain a secondary or suite number, but the corrected address does.

CDYNE Postal Address Verification returns the following Suite Link Return Codes:

  • A – SuiteLink Match
  • 00 – No Match – SuiteLink look up was attempted, but a match was not made
  • Blank – SuiteLink lookup was not performed

eLOT®

Enhanced Line of Travel or eLOT was developed by the USPS to give mailers the ability to sort their mailings in approximate carrier-casing sequence. eLOT codes organize the delivery points within a zip+4 code in the order that the carrier travels as they deliver mail. Mailers may use eLOT processing to qualify for enhanced carrier route presort discounts.

The eLOT Sequence Number aids in mail sorting, and the USPS defines it as the first occurrence of delivery made to the add-on range within the carrier route. The eLOT Ascending/Descending Code indicates the approximate delivery order within the sequence number.

Barcoding Processing

POSTNET™ – or Postal Numeric Encoding Technique was developed by the USPS to encode zip code information to improve speed, accuracy, and delivery of mail. It allows for rapid and reliable sorting by barcode sorters and provides additional automation discounts for bulk mailings. CDYNE Postal Address Verification returns a POSTNET Barcode string that can be used to generate a barcode image.

The string data in the POSTNET Barcode return consists of the following data, which can be used to generate a barcode for postal mailing discounts.

  • Start character (“f”)
  • Nine digit zip code data (“23320 2518″)
  • Delivery point data (“50″)
  • Check digit (“9″)
  • Stop character (“f”)

 

IM™ Barcode – The Intelligent Mail barcode is the next generation of USPS barcode technology used to sort and track letters and flats. It combines the capabilities of the POSTNET™ barcode and the PLANET Code® barcode into one unique barcode. Bulk mail that is barcoded is eligible for additional USPS discounts. To qualify for these discounts, the USPS requires an accurate Zip + 4 code, which can be matched with CASS Certified software.

CDYNE Postal Address Verification returns a key that can be used to obtain the Intelligent Mail Barcode string to generate a barcode image. Read more details about this in the GetIntelligentMailBarcode section of Part 2: CDYNE Postal Address Verification API Operations Overview .

In this five-part blog series, we will take a more in-depth look at the programming operations that CDYNE Postal Address Verification API will perform as well as how to use the operations and understand the data returns. Click on the links below to read each article.

Part 2: CDYNE Postal Address Verification API Operations Overview

Part 3: CDYNE Postal Address Verification VerifyAddress Operation

Part 4: CDYNE Postal Address Verification VerifyAddressAdvanced Operation

Part 5: CDYNE Postal Address Verification DPV Code Suggestions

For more information about CDYNE Postal Address Verification, please contact an account representative at 1-800-984-3710, inquire by email, or initiate a chat for more details.

Or sign up for a free trial license key to test CDYNE Postal Address Verification.

Page 1 of 2 12