FAQs
1. Getting Started
1.1 what is SmartMover Web Service?
SmartMover Web Service allows companies to build routines for individual or
business change of address into their custom applications using a SOAP
message and a simple HTTP post from any programming language and toolkit.
SmartMover makes NCOA™ Data available on demand without any software to
install or maintain. Develop your client using our example code once and
enjoy the benefits of the most current address data available anytime and
anywhere. SmartMover Web Service is the most cutting edge NCOA ™ technology
from the USPSİ and is only available from Melissa Data.
1.2 What is the process to get started with using SmartMover Web Service?
1. Create a SmartMover Web Service account with your Melissa Data sales
representative. You will be assigned a UserID for your account.
2. Your sales representative will send you a Postal Acknowledgement Form to
fill out and fax back to us.
3. For each mailing list you want to process, you will use our TicketService
(https://account.melissadata.net/TicketService.asmx) web
service to issue you a TicketID with at least 100 credits. Those credits are
decremented from your account and the issued ticket will expire at midnight
the next day. Please make sure to record the TicketID so it will not be
lost.
4. You can then use your UserID and TicketID to process addresses with the
SmartMover (http://smartmover.melissadata.net/v2/smartmover.asmx)
web service until you run out of credits on that ticket or the ticket
expires. After a ticket expires, all unused credits are lost. (If there are
any verifiable downtime issues with the web service during processing please
call your sales representative who can reset the number of credits)
1.3 How do I request the details of an already issued ticket?
If you would like to see the usage details of a ticket that has already
been assigned you can utilize the GetTicketDetails method of the
TicketService using the same mdRequest as you would for requesting a new
ticket. Fill in your UserID and the TicketID and call GetTicketDetails with
that mdRequest. The response will provide you with the number of records
allocated for that ticket, number of records used, as well as the expiration
data and time of the specified ticket.
2.
Security
2.1 I am worried about the security of my name & address data. Can Melissa Data provide me with more security?
HTTPS is a secure version of the HTTP Protocol using SSL
128 Bit encryption and is available for those customers
who require an extra layer of security by using the URL:
https://smartmover.melissadata.net/v2/smartmover.asmx
No personal information is ever kept or stored on the
Melissa Data web servers.
3.
SmartMover Return Codes
3.1 Question: Why am I getting code of 1 (Move) for
address.result.status.code but empty address/city/state
fields from the SmartMover Web service?
Not all declared moves will be accompanied with an
address. The USPS can sometimes confirm someone did in
fact move from a particular location but there are some
cases where they do not have the new address. In this
case the records marked with “1” are foreign moves. The
USPS contains no addresses outside the United States as
the NCOA file is strictly national. Other countries also
work differently in terms of data distribution and
postal environments compared with the USA. Here are some
examples of codes written back for flagged moves. Some
contain moves and others do not based on definition.
"A"= "COA Match - A Business, Individual or Family"
"91"= "COA Match - Secondary Number Dropped from COA"
"92"= "COA Match - Secondary Number Dropped from Input"
"01"= "COA Match - Foreign Move"
"02"= "COA Match - Moved Left No Address"
"03"= "COA Match - PO Box Closed No Forwarding Address"
"05"= "COA Match - A New Address cannot be provided"
"14"= "COA Match - New Address would not convert"
"19"= "Found COA - New Address not ZIP+4 or DPV Confirm"
|
