Follow CDYNE Blog on WordPress.com
Header Image -

Tag Archives

32 Articles

CDYNE PAV Now Offers Full 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.

0 views

Deliver Relevant Communications to Customers and Clients

CDYNE Phone Notify! API is an automated API phone notification system that allows IT departments to build voice applications to deliver relevant communications to customers and clients.  It has the ability to send or receive up to 5,000 tier-1 quality phone calls per minute using text to speech (TTS) in multiple languages, recorded files, or both. With over 50 programming methods, you can build powerful applications that will handle complex phone scripts, send immediate or scheduled phone calls, respond to call actions in real time, and manage call lists. Phone Notify! allows programmers to send automated phone alerts, conduct phone surveys, perform conference calls, and integrate custom business applications into their existing system.

AN OVERVIEW

There are over 50 Phone Notify! programming operations available to build and integrate voice applications into your system. They can be categorized into the list shown below. Additionally, a detailed operation list by category may be found here.

  • Send and Receive Phone Calls
  • Status Report Management
  • Script Management
  • Sound File Management
  • List Management

 

TUTORIALS & SCRIPTING SAMPLES

Tutorials 1 and 2 use C# in Visual Studio 2010. You may find additional source code examples and download code examples from the Phone Notify! developer’s wiki. The script samples show advance scripting features that are available with Phone Notify! API.

Build an appointment reminder using NotifyPhoneBasic and RecordSoundViaPhoneCall methods

Integrate conference calls using NotifyPhoneAdvanced, SetIncomingCallScript, and CancelConference methods

An advanced scripting example for automated phone reminders

Additional scripting examples for a political poll, school announcement, registration confirmation, survey, and recording sound files may be found on the CDYNE developer’s wiki.

For more information about CDYNE Phone Notify! API, 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 Phone Notify! API.

Developers find CDYNE Phone Notify! API integration details on the CDYNE developer’s wiki.

0 views

Phone Notify! Programming Methods

This is a tutorial on how to program the PAV API avoid invalid or incorrect address entries.

This simple web form that was created using Visual Studio’s C# ASP.NET Web Forms Application to verify an address before completing an entry to the database.

address-input

This is how it was programmed:

 

This section of code is simply for aesthetics and will be what the end user’s see when completing the form.

Once you have created a new project within Visual Studio, you will need to add the API WSDL (http://pav3.cdyne.com/PavService.svc?wsdl) the project as a service reference. Once it has been added you would then need to include it in the very top section of the “Default.aspx.cs” page as shown below in the highlight yellow box. In our case we have named the project “VerifyAddress” and given the service reference the name of “WSDL”.

service reference

After the service reference has been added, we then navigate to the “Default.aspx” page within the project and add the necessary text boxes and button.


Now that the textboxes and button have been created, the portion of code below is added to the “Default.aspx.cs” page.  The API request code is contained within the “Submit” button click event.  All information passed along within the request with the exception of the parameter :”Urbanization” (which is used for address within Puerto Rico only) and the API license key are passed from the textboxes to the request code once an end user presses “Submit”.

After the address has been submitted, the end user would receive an alert box notating if there was an error verifying the address and if so, the error is explained and the user is asked to re-enter the address.  If no errors occur and the address verifies successfully (CDYNE ReturnCode of 100, 101, 102, or 200) the end user receives an alert box stating their order has been successfully submitted.

Once the “OK” button is pressed on the alert box, the textboxes on the form then display the text as it was shown when the page was first loaded and another address can be verified.

0 views

Is a DID Required When Using CDYNE SMS Notify! API?

One question we often get asked is, “Is a DID required to use your SMS Notify! API?” The short answer is yes. Every SMS Notify! account comes with one dedicated DID, which is an SMS-enabled phone number that allows you to send text messages. DIDs are useful for low volume, person-to-person text messaging, but more importantly they provide two key benefits:

  1. Build your application with the SMS Notify! API while implementing a dedicated short code
  2. Use DIDs as a backup system to short codes when a carrier is not supported

SMS Notify! uses DIDs and short codes to send and receive text messages from and to your application. Dedicated short codes take time for carrier approval and launch, but companies can still build and test their application with SMS Notify! by using DIDs.

DID Text Messaging Best Practices

  1. DIDs are meant for low volume, person-to-person text messaging. The SMS Notify! API throttles outgoing text messages at a rate of 1 message every two seconds per DID.
  2. CDYNE recommends not sending more than 500 outgoing text messages per DID per day. Sending more than this may put you at risk of the carriers flagging your DID traffic. If your volume per DID is higher than 500 per day, please contact CDYNE to add more DIDs to your account to balance the message load.
  3. Marketing messages are not allowed on DIDs. CDYNE offers short code text messaging for marketing messages. Please contact CDYNE for more short code details.

DIDs for Short Code Backup

CDYNE offers DIDs for low-volume, non-marketing messaging  which makes a nice backup to short codes in the case a carrier is not supported on the short code. This is an optional feature that can be set up during the short code sign up process.

Call 1-800-984-3710 for more information or test today for free.

0 views

Part 5: CDYNE Postal Address Verification DPV Code Suggestions

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.

0 views

Part 4: CDYNE Postal Address Verification 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). 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.

0 views