Difference between revisions of "SmartMover V3:Notice"

From Melissa Data Wiki
Jump to navigation Jump to search
(Created page with "← SmartMover V3 {{CustomTOC}} ==CCOA Updated Notice== ===Effective Date: January 1st, 2016=== Users of our CCOA service must go to the [https://www.can...")
 
Line 1: Line 1:
[[SmartMover V3|← SmartMover V3]]
[[SmartMover V3|← SmartMover V3]]
{{CustomTOC}}
{{CustomTOC}}
==SmartMover 2018 Update==
''Released 01/16/2018''
The new version of SmartMover can now be consumed using the following endpoint:
:;rcsmartmover.melissadata.net
:;rcsmartmovercanada.melissadata.net
The SmartMover service has grown with two new output fields to help users keep track of whether a specific address is labeled as a residence or business by the USPS. The 2018 update includes the addition of new elements in the response structure which in effect also changes the WSDL structure. Please follow proper update procedures to prevent sudden disruption of service.
===Timeline===
The official SmartMover endpoint (smartmover.melissadata.net) will be updated to the new version on April 4th, 2018. The rcsmartmover endpoint will continue to be online until May 17th, 2018, after which it will be taken offline.
Here is the official timeline:
{|style="padding:5px;" cellspacing="0"
|-
|
|style="background-color:#0070c0; color:white; padding:5px; border-color:black; border-style:solid; border-width:0px 1px 0px 0px;"|'''01/15/2018'''
|style="background-color:#0070c0; color:white; padding:5px; border-color:black; border-style:solid; border-width:0px 1px 0px 0px;"|'''04/15/2018'''
|style="background-color:#0070c0; color:white; padding:5px;"|'''05/30/2018'''
|- style="border-right:10px solid red;"
|style="background-color:#0070c0; color:white; padding:5px; border-color:black; border-style:solid; border-width:0px 1px 0px 0px;"|'''Release Candidate Endpoint'''<br>(rcsmartmover.melissadata.net)
|style="background-color:#c4d79b; padding:5px; border-color:black; border-style:solid; border-width:1px 1px 0px 0px;"|Release: Version 4.0.4.48+
|style="background-color:#c4d79b; padding:5px; border-color:black; border-style:solid; border-width:1px 1px 0px 0px;"|Version 4.0.4.48+
|style="background-color:#da9694; padding:5px; border-color:black; border-style:solid; border-width:1px 0px 0px 0px;"|Offline
|- style="border-right:10px solid red;"
|style="background-color:#0070c0; color:white; padding:5px; border-color:black; border-style:solid; border-width:1px 1px 0px 0px;"|'''Release Candidate Endpoint'''<br>(rcsmartmovercanada.melissadata.net)
|style="background-color:#c4d79b; padding:5px; border-color:black; border-style:solid; border-width:1px 1px 0px 0px;"|Release: Version 4.0.4.48+
|style="background-color:#c4d79b; padding:5px; border-color:black; border-style:solid; border-width:1px 1px 0px 0px;"|Version 4.0.4.48+
|style="background-color:#da9694; padding:5px; border-color:black; border-style:solid; border-width:1px 0px 0px 0px;"|Offline
|-
|style="background-color:#0070c0; color:white; padding:5px; border-color:black; border-style:solid; border-width:1px 1px 0px 0px;"|'''Official Endpoint'''<br>(smartmover.melissadata.net)
|style="background-color:#da9694; padding:5px; border-color:black; border-style:solid; border-width:1px 1px 0px 0px;"|Version 4.0.4.44
|style="background-color:#c4d79b; padding:5px; border-color:black; border-style:solid; border-width:1px 1px 0px 0px;"|Update: Version 4.0.4.48+
|style="background-color:#c4d79b; padding:5px; border-color:black; border-style:solid; border-width:1px 0px 0px 0px;"|Version 4.0.4.48+
|-
|style="background-color:#0070c0; color:white; padding:5px; border-color:black; border-style:solid; border-width:1px 1px 0px 0px;"|'''Official Endpoint'''<br>(smartmovercanada.melissadata.net)
|style="background-color:#da9694; padding:5px; border-color:black; border-style:solid; border-width:1px 1px 0px 0px;"|Version 4.0.4.44
|style="background-color:#c4d79b; padding:5px; border-color:black; border-style:solid; border-width:1px 1px 0px 0px;"|Update: Version 4.0.4.48+
|style="background-color:#c4d79b; padding:5px; border-color:black; border-style:solid; border-width:1px 0px 0px 0px;"|Version 4.0.4.48+
|}
===Update Procedures===
Clients whose web service integrations do not support WSDL changes due to the addition of new elements in the request/response structure are strongly advised to follow these update procedures:
#All applications must be re-compiled to use the Release Candidate Endpoint (rcsmartmover.melissadata.net and rcsmartmovercanada.melissadata.net) before April 4th, 2018.
#Come April 4th, we will be updating the official endpoint with version 4.0.4.48+ of SmartMover. At this time, all applications must be switched back to use the official endpoint before May 17th, 2018 when the Release Candidate Endpoint goes offline.
Client whose Web Service Integrations support structure/WSDL additions are strongly encouraged to follow this update procedure, but are not required to.
===Version 4.0.4.48+ Changes===
The following element has been added as part of the default response structure:
{|class="alternate01" cellspacing="0"
!Default Output Field
|-
|DeliveryIndicator
|}
The following element has been added as part of the response structure:
{|class="alternate01" cellspacing="0"
!Additional Output Field
|-
|StandardizedDeliveryIndicator
|}
In order to retrieve this new element in the response, you may enumerate the field, or the group to which it belongs in the columns request:
<pre>
<Columns>StandardizedDeliveryIndicator</Columns>
</pre>
Or
<pre>
<Columns>GrpStandardized</Columns>
</pre>
;Please Note:
:This change will also affect the Canadian SmartMover endpoint (smartmovercanada.melissadata.net). However, no values will be returned for Canada. We have chosen to do this to keep the two endpoints as close to lockstep as possible.


==CCOA Updated Notice==
==CCOA Updated Notice==

Revision as of 20:10, 16 January 2018

← SmartMover V3


SmartMover 2018 Update

Released 01/16/2018

The new version of SmartMover can now be consumed using the following endpoint:

rcsmartmover.melissadata.net
rcsmartmovercanada.melissadata.net

The SmartMover service has grown with two new output fields to help users keep track of whether a specific address is labeled as a residence or business by the USPS. The 2018 update includes the addition of new elements in the response structure which in effect also changes the WSDL structure. Please follow proper update procedures to prevent sudden disruption of service.

Timeline

The official SmartMover endpoint (smartmover.melissadata.net) will be updated to the new version on April 4th, 2018. The rcsmartmover endpoint will continue to be online until May 17th, 2018, after which it will be taken offline. Here is the official timeline:

01/15/2018 04/15/2018 05/30/2018
Release Candidate Endpoint
(rcsmartmover.melissadata.net)
Release: Version 4.0.4.48+ Version 4.0.4.48+ Offline
Release Candidate Endpoint
(rcsmartmovercanada.melissadata.net)
Release: Version 4.0.4.48+ Version 4.0.4.48+ Offline
Official Endpoint
(smartmover.melissadata.net)
Version 4.0.4.44 Update: Version 4.0.4.48+ Version 4.0.4.48+
Official Endpoint
(smartmovercanada.melissadata.net)
Version 4.0.4.44 Update: Version 4.0.4.48+ Version 4.0.4.48+


Update Procedures

Clients whose web service integrations do not support WSDL changes due to the addition of new elements in the request/response structure are strongly advised to follow these update procedures:

  1. All applications must be re-compiled to use the Release Candidate Endpoint (rcsmartmover.melissadata.net and rcsmartmovercanada.melissadata.net) before April 4th, 2018.
  2. Come April 4th, we will be updating the official endpoint with version 4.0.4.48+ of SmartMover. At this time, all applications must be switched back to use the official endpoint before May 17th, 2018 when the Release Candidate Endpoint goes offline.

Client whose Web Service Integrations support structure/WSDL additions are strongly encouraged to follow this update procedure, but are not required to.


Version 4.0.4.48+ Changes

The following element has been added as part of the default response structure:

Default Output Field
DeliveryIndicator


The following element has been added as part of the response structure:

Additional Output Field
StandardizedDeliveryIndicator


In order to retrieve this new element in the response, you may enumerate the field, or the group to which it belongs in the columns request:

<Columns>StandardizedDeliveryIndicator</Columns>

Or

<Columns>GrpStandardized</Columns>
Please Note
This change will also affect the Canadian SmartMover endpoint (smartmovercanada.melissadata.net). However, no values will be returned for Canada. We have chosen to do this to keep the two endpoints as close to lockstep as possible.


CCOA Updated Notice

Effective Date: January 1st, 2016

Users of our CCOA service must go to the Canada Post website to obtain an End User Terms of Use ID (TOUID) and register it on our website in order to continue using CCOA in the new year.

Canada Post website link: https://www.canadapost.ca/web/en/pages/ncoa/default.page