Difference between revisions of "Unison:Global Address Verification"

From Melissa Data Wiki
Jump to navigation Jump to search
(Created page with "{{UnisonNav |ServicesCollapse= }} {{CustomTOC}} The Unison by Melissa Global Address Cleansing Task cleanses global contact data. link= ==Input Fields== link= This section displays the possible inputs for the Address Service. An address and ZIP code are required. <h3 class="productfield">Organization</h3> :The company or organization. <h3 class="productfield">Address Line 1<...")
 
 
(8 intermediate revisions by the same user not shown)
Line 8: Line 8:
The Unison by Melissa Global Address Cleansing Task cleanses global contact data.
The Unison by Melissa Global Address Cleansing Task cleanses global contact data.


[[File:Unison_Address-Global_Task.png|link=]]
[[File:Unison_Address-Global_Task.png|900px|link=]]




==Input Fields==
==Input Fields==
[[File:Unison_Address-Global_InputFields.png|link=]]
[[File:Unison_Address-Global_InputFields.png|900px|link=]]


This section displays the possible inputs for the Address Service. An address and ZIP code are required.
This section displays the possible inputs for the Global Address Cleansing Task. An address and Country are required.




<h3 class="productfield">Organization</h3>
<h3 class="productfield">Organization/Company</h3>
:The company or organization.
:The company or organization.




<h3 class="productfield">Address Line 1</h3>
<h3 class="productfield">Address Line 1</h3>
:The first address line.
:The first address line. This should contain the delivery address information (house number, thoroughfare, building, suite, etc.) but should not contain locality information (locality, administrative area, postal code, etc.) which have their own inputs.
 
 
<h3 class="productfield">Address Line 2 - Address Line 4</h3>
:This is optional. This should contain the delivery address information (house number, thoroughfare, building, suite, etc.) but should not contain locality information (locality, administrative area, postal code, etc.) which have their own inputs.
 
 
<h3 class="productfield">Sub-Premises/Suite</h3>
:The sub-premises or suite number.
 
 
<h3 class="productfield">Locality/City</h3>
:The locality name.
 
:'''US Term:''' City
:'''Canada Term:''' Municipality
 
 
<h3 class="productfield">Administrative Area/State</h3>
:The administrative area, state or province name.




<h3 class="productfield">Address Line 2</h3>
<h3 class="productfield">Postal Code/Zip</h3>
:The second address line. This is optional and can contain a suite or a different secondary address, like a P.O. Box.
:The Zip Code or Postal Code, depending on the country.




<h3 class="productfield">Sub-Premises</h3>
<h3 class="productfield">Country</h3>
:'''Suite'''. The suite number.
:The country code. If this is not input, the country will default to the United States.




<h3 class="productfield">Locality</h3>
===More Input Fields===
:'''City'''. The city name.
[[File:Unison_Address-Global_InputFields-More.png|900px|link=]]
 
 
<h3 class="productfield">Address Line 5 - Address Line 8</h3>
:This is optional. This should contain the delivery address information (house number, thoroughfare, building, suite, etc.) but should not contain locality information (locality, administrative area, postal code, etc.) which have their own inputs.
 
 
<h3 class="productfield">Country of Origin</h3>
:This is used to determine whether or not to include the country name as the last line in Formatted Address.


:*The destination country will be appended to the end of the formatted address when:
::*Valid '''and''' different from the destination country.


<h3 class="productfield">Administrative Area</h3>
:*The destination country will '''not''' be appended to the end of the formatted address when:
:'''State'''. The state or province name.
::*Blank '''or'''
::*Invalid '''or'''
::*Same as the destination country




<h3 class="productfield">Postal Code</h3>
<h3 class="productfield">Double Dependent Locality</h3>
:The five-digit ZIP Code, the first five digits of a ZIP+4, or a full nine-digit ZIP+4.
:The smallest population center data element. This depends on the Locality and Dependent Locality fields.




<h3 class="productfield">Plus 4</h3>
<h3 class="productfield">Dependent Locality/Urbanization</h3>
:The last four digits of a ZIP+4.
:The smaller population center data element. This depends on the Locality element.


:'''US Term:''' Urbanization: In terms of US Addresses, this element applies only to Puerto Rican addresses. It is used to break ties when a ZIP Code™ is linked to multiple instances of the same address.


<h3 class="productfield">Country</h3>
:The country code.


<h3 class="productfield">Sub Administrative Area/County</h3>
:The smallest geographic data element.


<h3 class="productfield">Urbanization (Puerto Rico)</h3>
:'''US Term:''' County.
:Only used for addresses in Puerto Rico. This is used to break ties between similar addresses in the same Postal Code.




===More Input Fields===
<h3 class="productfield">Sub National Area</h3>
[[File:Unison_Address-Global_InputFields-More.png|link=]]
:The administrative region within a country on an arbitrary level below that of the sovereign state.




==Output Fields==
==Output Fields==
[[File:Unison_Address-Global_OutputFields.png|link=]]
[[File:Unison_Address-Global_OutputFields.png|900px|link=]]


This section displays the possible outputs for the Address Service. Select the on/off toggle to enable/disable the output of a field.
This section displays the possible outputs for the Address Service. Select the on/off toggle to enable/disable the output of a field.
Line 71: Line 102:




<h3 class="productfield">Address Line 1</h3>
<h3 class="productfield">Address Line 1 - Address Line 8</h3>
:The first address line.
:These will be the standardized or corrected contents of the input address. These lines will include the entire address including the locality, administrative area, and postal code.
 
 
<h3 class="productfield">Zip/Postal Code</h3>
:The postal code.
 
:'''US Term:''' ZIP Code.
 
 
<h3 class="productfield">Country</h3>
:The country name.
 
 
<h3 class="productfield">Latitude</h3>
:The latitude of the address.
 
 
<h3 class="productfield">Longitude</h3>
:The longitude of the address.
 


<h3 class="productfield">Dependent Locality</h3>
:A dependent locality is a logical area unit that is smaller than a locality but larger than a double dependent locality or thoroughfare. It can often be associated with a neighborhood or sector. Great Britain is an example of a country that uses double dependent locality. In the United States, this would correspond to Urbanization, which is used only in Puerto Rico.


<h3 class="productfield">Address Line 2</h3>
:'''US Term:''' Urbanization.
:The second address line. This can contain a suite or a different secondary address, like a P.O. Box.




<h3 class="productfield">Locality</h3>
<h3 class="productfield">Locality</h3>
:'''City'''. The city name.
:The most common geographic area and used by virtually all countries. This is usually the value that is written on a mailing label and referred to by terms like City, Town, Postal Town, etc.


:'''US Term:''' City


<h3 class="productfield">Administrative Area</h3>
:'''State'''. The state/province name.


<h3 class="productfield">Administrative Area/State</h3>
:A common geographic area unit for larger countries.


<h3 class="productfield">Postal Code</h3>
:'''US Term:''' State
:The Zip or postal code.




<h3 class="productfield">Country</h3>
<h3 class="productfield">Delivery Line</h3>
:The standard code of the country.
:The delivery portion of the full address, from the sub-premise and house number to the street information. This does not include area information like doubledependent locality, dependent locality, locality, administrative area, and postal code if those values are available for the country.




<h3 class="productfield">Address Key</h3>
<h3 class="productfield">Locality Line</h3>
:Returns a unique key for the current address.
:The locality information of the full address. This includes information such as doubledependent locality, dependent locality, locality, administrative area, and postal code if those values are available for the country. This does not include sub-premise and house number to the thoroughfare information.




<h3 class="productfield">Melissa Address Key</h3>
<h3 class="productfield">Melissa Address Key (MAK)</h3>
:(MAK) A unique key assigned to an address record.
:(MAK) A unique key assigned to an address record.


Line 107: Line 158:




<h3 class="productfield">Address Result Codes</h3>
<h3 class="productfield">Address Type Code</h3>
:Returned result codes for the address.
:Returns a one-character code for the type of address coded. This element works only for US, Canadian, and Great Britain addresses.


:See [[Result Code Details#Unison by Melissa|Unison by Melissa Result Codes]] for a full list of result codes.


==Parsed Address Fields==
[[File:MDQ_Address_OutputOptional.png|link=]]


Adds additional parsed fields regarding the address.
<h3 class="productfield">Formatted Address</h3>
:Returns the address in the correct format for mailing from the country specified in the Country Of Origin input. This includes the Organization as the first line, one or more lines in the origin country’s format, and the destination country (if required).


:The default separate line delimiter is a comma (<code>,</code>), but can be changed under the Address Task Settings.


<h3 class="productfield">Address Range</h3>
:The street number.


<h3 class="productfield">UPRN</h3>
:'''Great Britain Only'''. Returns the Unique Property Reference Number created and maintained by Ordnance Survey.


<h3 class="productfield">Thoroughfare Pre-Directional</h3>
:'''Street Pre-Directional'''. This is any directional indicators that precede the street name. The directionals are returned as one- or two-character abbreviations. If the input data contained "Southwest", it would be shortened to "SW".


<h3 class="productfield">Result Codes</h3>
:Returned result codes for the address.


<h3 class="productfield">Thoroughfare Name</h3>
:For a list of result codes returned by Unison, see [[Result Code Details#Unison by Melissa|Unison Result Codes]].
:'''Street Name'''. Only the street name, minus the suffixes or directionals. For "SW Main Street", this would return "Main".




<h3 class="productfield">Trailing Type</h3>
==Additional Address Fields==
:'''Suffix'''. The standard abbreviations for the street types: "RD", "ST", "AVE", "BLVD", etc.
[[File:Unison_Address-Global_OutputFields-Additional.png|900px|link=]]


Adds fields for parsed data from the address.


<h3 class="productfield">Post-Directional</h3>
:This is any directional indicators that follow the street name. The directionals are returned as one- or two-character abbreviations. If the input data contained "Southwest", it would be shortened to "SW".


<h3 class="productfield">ISO 2 Country Code</h3>
:The 2 letter ISO 3166 country code value.


<h3 class="productfield">Sub-Premises Name</h3>
:For example:
:'''Suite Name'''. The descriptive portion of the secondary address: "SUITE", "APT", "UNIT", etc.


:{| class="alternate01"
!Country !! Code
|-
|United States||US
|-
|Canada||CA
|-
|Philippines||PH
|}


<h3 class="productfield">Sub-Premises Range</h3>
:'''Suite Range'''. The numeric portion of the secondary address.


<h3 class="productfield">ISO 3 Country Code</h3>
:The 3 letter ISO 3166 country code value.


<h3 class="productfield">Private Mailbox Name</h3>
:For example:
:The descriptive portion of the private mailbox number. A private mailbox, or PMB, is a secondary address associated with a Commercial Mail Receiving Agency (CMRA).


:Because the CMRA may itself be located in a suite, such an address may have both a suite number and a PMB number.
:{| class="alternate01"
!Country !! Code
|-
|United States||USA
|-
|Canada||CAN
|-
|Philippines||PHL
|}


:The name portion of the PMB will normally be either "#" or "PMB".


<h3 class="productfield">ISO Country Number</h3>
:The ISO 3166 country number value.


<h3 class="productfield">Private Mailbox Range</h3>
:For example:
:The numeric portion of the private mailbox number.


:{| class="alternate01"
!Country !! Code
|-
|United States||840
|-
|Canada||124
|-
|Philippines||608
|}


<h3 class="productfield">Route Service</h3>
:The route service number for a Canadian address. Route Service is typically used to designate an address in a rural area.




<h3 class="productfield">Lock Box</h3>
<h3 class="productfield">Formal Country Name</h3>
:The lock box number for a Canadian address. Lock boxes are similar to PO Boxes and the terms are often used interchangeably.
:Official Name for the country.




<h3 class="productfield">Delivery Installation</h3>
==Parsed Dependent Thoroughfare Fields==
:The delivery installation information for a Canadian address. The delivery installation is the Canada Post facility that services the address.
[[File:Unison_Address-Global_OutputFields-ParsedDT.png|900px|link=]]


Adds fields relating to the Dependent Thoroughfare from the address.


<h3 class="productfield">Extra Information</h3>
:This is any text from the street address column that does not fit into one of the above categories.


<h3 class="productfield">Dependent Thoroughfare</h3>
:The dependent thoroughfare is a second thoroughfare that is required to narrow down the final address. This is rarely used.


==Additional Address Fields==
[[File:MDQ_Address_OutputAdditional.png|link=]]


Adds fields for parsed data from the address.
<h3 class="productfield">Dependent Thoroughfare Pre Direction</h3>
:Pre Directions are directionals at the beginning of the dependent thoroughfare (i.e., N, S, E, W, NE, SW, etc.). This is a part of the Dependent Thoroughfare field.




<h3 class="productfield">Sub-Premises</h3>
<h3 class="productfield">Dependent Thoroughfare Post Direction</h3>
:'''Suite'''. This is the formatted suite information.
:Post Directions are directionals at the end of the dependent thoroughfare (i.e., N, S, E, W, NE, SW, etc.). This value is a part of the Dependent Thoroughfare field.




<h3 class="productfield">Locality Abbreviation</h3>
<h3 class="productfield">Dependent Thoroughfare Leading Type</h3>
:'''City Abbreviation'''. The official city abbreviation the Post Office™ has associated with the city or municipality name, if any is available.
:Leading Types are types at the beginning of the dependent thoroughfare (i.e., "Rue", etc.). This value is a part of the Dependent Thoroughfare field.




<h3 class="productfield">Private Mailbox</h3>
<h3 class="productfield">Dependent Thoroughfare Name</h3>
:The private mailbox. This will be populated if the primary address was identified as a Commercial Mail Receiving Agency (CMRA) and the secondary address information is present. This would also be populated if the secondary address information contains the string "PMB", thus identifying the address as a private mailbox.
:The parsed Dependent Thoroughfare Name. This value is a part of the Dependent Thoroughfare field.




<h3 class="productfield">Dependent Locality</h3>
<h3 class="productfield">Dependent Thoroughfare Trailing Type</h3>
:'''Urbanization'''. This is used to break ties between similar addresses in Puerto Rico. The urbanization name tells the address checking logic which "neighborhood" to look in if more than one likely address candidate is found.
:Trailing Types are types at the end of the dependent thoroughfare (i.e., "St.", "Rd.", "Ave.", etc.). This value is a part of the Dependent Thoroughfare field.


:If just one address is found, the address checking logic can correct the address and return the urbanization name.


<h3 class="productfield">Dependent Thoroughfare Type Attached</h3>
:The dependent thoroughfare type connected to the dependent thoroughfare name without a space. This is common in Germany. For example, "Berlinerstr." "str." stands for strasse and is the dependent thoroughfare type attached, while "Berliner" is the dependent thoroughfare name.


<h3 class="productfield">Plus 4</h3>
:The four-digit extension from the ZIP + 4®. If this column is not mapped the Plus4 will be appended to the ZIP column.


==Parsed Regional Fields==
[[File:Unison_Address-Global_OutputFields-ParsedRF.png|900px|link=]]


<h3 class="productfield">Delivery Indication</h3>
Adds additional fields relating to the region from the address.
:This is a one-character code indicating whether the submitted address is "R", a residence; "B", a business; or "U", the status is unknown.




<h3 class="productfield">Delivery Point Check Digit</h3>
<h3 class="productfield">Double Dependent Locality</h3>
:The delivery point, when combined with the check digit, is a three-digit number that combined with the ZIP + 4, generates a unique number for each address in that ZIP + 4. This number is used to generate barcodes, so if you plan you use this address data for commercial mailing, it would be necessary to map an output column for this information.
:A logical area unit that is smaller than a dependent locality but bigger than a thoroughfare. This field is very rarely used. Great Britain is an example of a country that uses double dependent locality.




<h3 class="productfield">Carrier Route</h3>
<h3 class="productfield">Sub Administrative Area</h3>
:This is a four-character code that indicates which mail carrier delivers to the input address.
:A logical area that that is smaller than the administrative area but larger than a locality. While many countries can have a sub-administrative area value, it is very rarely used as part of an official address.


:The first character of this Carrier Route is always alphabetic and the last three characters are numeric. For example, "R001" or "C027" would be typical carrier routes. The alphabetic letter indicates the type of delivery associated with this address.


<h3 class="productfield">Sub National Area</h3>
:A logical area unit that is larger than an administrative area but smaller than the country itself. It is extremely rarely used.


<h3 class="productfield">Postal Code Type</h3>
:The type of ZIP Code can indicate a specialized address, such as military or PO Box complexes.


==Parsed Postal Facility Fields==
[[File:Unison_Address-Global_OutputFields-ParsedPFF.png|900px|link=]]


<h3 class="productfield">Address Type Code</h3>
Adds additional fields relating to the postal facility.
:This is a one-character code indicating the type of address that was processed.




<h3 class="productfield">Address Type Description</h3>
<h3 class="productfield">Post Box</h3>
:This is a text description of the address type code.
:The parsed Post Box.




<h3 class="productfield">CMRA</h3>
<h3 class="productfield">Post Office Location</h3>
:This indicates if the primary input address is a Commercial Mail Receiving Agency (CMRA), such as the UPS Store® or similar private mailbox business location.
:If available, this is the value that is associated to the location of the post office in relation to the address. This value may or may not be used in the official mailing address for the country in question. Currently, these are the countries we will return the data for: Serbia and Slovakia.


:{| class="alternate01"
!Country !! Description
|-
|Serbia||The Post Office Location field contains the old 5 digit postal number and name. The postal code field will contain the new 6 digit PAK number.
|-
|Slovakia||The Post Office Location field returns the name of the post office location if it is not the same as the delivery address locality.
|}


<h3 class="productfield">eLot Number</h3>
:This number indicates where the current address falls in the delivery order within the ZIP + 4®.


:The eLot columns may be required if you are sending the data on to be presorted for mailing using USPS® Standard Mail® rates.
==Parsed Thoroughfare Fields==
[[File:Unison_Address-Global_OutputFields-ParsedTF.png|900px|link=]]


Adds fields relating to the Thoroughfare from the address.


<h3 class="productfield">eLot Order</h3>
:The eLot Order returns the letters "A" or "D" to indicate whether the Post Office™ delivers mail within the ZIP + 4® in ascending eLot Number order or descending.


:Therefore, if the eLot Number is 1 and the eLot Order is "D", then the address is typically the last delivery of the day.
<h3 class="productfield">Premises/Street Name</h3>
:The parsed premises name.


:'''US Term:''' Street Name


==Geographic Information==
[[File:MDQ_Address_OutputGeographic.png|link=]]


Adds fields for geographic information regarding the address.
<h3 class="productfield">Premises Number/Street Number</h3>
:The parsed premises number.


:'''US Term:''' House Number


<h3 class="productfield">Latitude</h3>
:Returns the geocoded latitude for the address.


<h3 class="productfield">Premises Type</h3>
:The parsed premises type.


<h3 class="productfield">Longitude</h3>
:Returns the geocoded longitude for the address.


<h3 class="productfield">Thoroughfare</h3>
:A part of the address lines containing all the sub-elements of the thoroughfare like trailing type, thoroughfare name, pre direction, post direction, etc.


<h3 class="productfield">GeoCoder Result Codes</h3>
:'''US Term:''' Street
:Returned result codes for the geocoding portion of the address.




<h3 class="productfield">GeoCoder Place Name</h3>
<h3 class="productfield">Thoroughfare Name</h3>
:The official Census Bureau name for the location indicated by the Place Code.
:The parsed thoroughfare name. This is part of the thoroughfare field.
 


<h3 class="productfield">GeoCoder Place Code</h3>
:The Census Bureau Place Code for the physical location of the input address. This information is useful when the boundaries of the ZIP + 4 overlap city limits.


<h3 class="productfield">Thoroughfare Pre Direction</h3>
:Pre Directions are directionals at the beginning of the thoroughfare (i.e., N, S, E, W, NE, SW, etc.). This is part of the thoroughfare field.


<h3 class="productfield">Sub Administrative Area</h3>
:'''County'''. The county name.


<h3 class="productfield">Thoroughfare Post Direction</h3>
:Post Directions are directionals at the end of the thoroughfare (i.e., N, S, E, W, NE, SW, etc.). This is part of the thoroughfare field.


<h3 class="productfield">Sub Administrative Area FIPS Code</h3>
:'''County FIPS'''. The 5-digit County FIPS code. The first two digits indicate the state while the last three digits indicate the county within the state.


<h3 class="productfield">Thoroughfare Leading Type</h3>
:Leading Types are thoroughfare types at the beginning of the thoroughfare (i.e., "Rue", etc.). This is part of the thoroughfare field.


<h3 class="productfield">Congressional District</h3>
:This term is not used in the US.
:The 2-digit code indicating the address's congressional district.




<h3 class="productfield">Time Zone</h3>
<h3 class="productfield">Thoroughfare Trailing Type</h3>
:The name of the time zone where the address is located.
:Trailing Types are thoroughfare types at the end of the thoroughfare (i.e., "St.", "Rd.", "Ave.", etc.). This is part of the thoroughfare field.




<h3 class="productfield">Time Zone Code</h3>
<h3 class="productfield">Thoroughfare Type Attached</h3>
:The one- or two-digit number code for the time zone where the verified input address is located. The number also indicates the number of hours that the time zone is behind UTC/GMT. In other words, Eastern Standard Time has a time zone code of 5, indicating that the Eastern time zone is five hours behind UTC/GMT.
:The thoroughfare type connected to the thoroughfare name without a space. This is common in Germany. For example, "Berlinerstr." "str." stands for strasse and is the thoroughfare type attached, while "Berliner" is the thoroughfare name.


:This number does not indicate differences due to daylight savings time.


==Parsed Subpremises Fields==
[[File:Unison_Address-Global_OutputFields-ParsedSF.png|900px|link=]]


==Census Details==
Adds fields relating to the sub premises from the address.
[[File:MDQ_Address_OutputCensus.png|link=]]


Adds fields for census information regarding the address.


<h3 class="productfield">Building</h3>
:Descriptive name identifying an individual location. This is a string value that is the parsed Building element from the output.


<h3 class="productfield">CBSA Code</h3>
:A five-digit code for the specific Census Bureau CBSA (Core-Based Statistical Area).


<h3 class="productfield">Sub Building</h3>
:A smaller division of the building. For example, if an address has a building name that is a part of a larger set of buildings, then the sub building may be populated.


<h3 class="productfield">CBSA Level</h3>
:'''Sub Building Number''' and '''Sub Building Type''' make up the parts of the '''Sub Building''' field.
:The CBSA code level. If present, the CBSA Level will be Metropolitan or Micropolitan.




<h3 class="productfield">CBSA Title</h3>
<h3 class="productfield">Sub Building Number</h3>
:The CBSA Title describing the CBSA code.
:The parsed sub building number. This is part of the '''Sub Building''' field.




<h3 class="productfield">CBSA Division Code</h3>
<h3 class="productfield">Sub Building Type</h3>
:A code representing the CBSA division associated with the address.
:The parsed sub building type. This is part of the '''Sub Building''' field.




<h3 class="productfield">CBSA Division Level</h3>
<h3 class="productfield">Sub Premises/Suite</h3>
:The CBSA Division code level. If present, the CBSA Division Level will be Metropolitan or Micropolitan.
:Individual units with their own addresses inside a building. This is parsed from the '''Address Line 1 - Address Line 8''' fields.


:'''Sub Premises Number''' and '''Sub Premises Type''' make up the parts of the '''Sub Premises/Suite''' field.


<h3 class="productfield">CBSA Division Title</h3>
:'''US Term:''' Suite or Apartment
:The CBSA Division Title describing the CBSA Division code.


:For example:
:'''Sub Premises:''' Apt 25A


<h3 class="productfield">Census Block</h3>
:This is a 4-digit string indicating the Census Block number associated with the address. Census Blocks are the smallest geographic area for which the Bureau of the Census collects information.


<h3 class="productfield">Sub Premises Type</h3>
:The parsed sub premises type from the '''Sub Premises/Suite''' field. This is part of the '''Sub Premises/Suite''' field.


<h3 class="productfield">Census Tract</h3>
:For example:
:This is a 4 to 6-digit string containing the Census Tract number associated with the address. Census Tracts are small subdivisions of the county.
:'''Sub Premises:''' Apt 25A
:'''Sub Premises Type:''' Apt




==Service Settings==
<h3 class="productfield">Sub Premises Level</h3>
[[File:MDQ_Address_ServiceSettings.png|link=]]
:A secondary piece of sub premise information used to describe a more generic division of the subpremise. For example, if you have an address like “1123 Market Way, Floor 12 Apt 25A” then the sub premises will be “Apt 25A” and the sub premise level will be “Floor 12”. This value is not widely used in official address data.


Use the Service Settings to enable or disable specific Address Object settings.
:'''Sub Premise Level Type''' and '''Sub Premise Level Number''' make up the parts of the '''Sub Premise Level''' field. In our example, the '''Sub Premise Level Type''' is “Floor” and the '''Sub Premise Level Number''' is “12”.




<h3 class="productfield">Perform Delivery Point Verification (DPV®)</h3>
<h3 class="productfield">Sub Premises Level Number</h3>
:DPV processing verifies that a record contains a deliverable address, down to the secondary address (suite) level.
:The parsed number from the sub premises level field. '''Sub Premise Level Type''' and '''Sub Premise Level Number''' make up the parts of the '''Sub Premise Level''' field.


:Not using DPV processing will speed up processing, but the Component will only be able to validate that the address falls within a valid street range of addresses and assign the ZIP + 4 code accordingly.
:For example:
:'''Sub Premise Level:''' Floor 12
:'''Sub Premise Level Number:''' 12


:DPV processing is required to generate a CASS Form 3553.


<h3 class="productfield">Sub Premises Level Type</h3>
:The parsed type from the sub premises level field. '''Sub Premise Level Type''' and '''Sub Premise Level Number''' make up the parts of the '''Sub Premise Level''' field.


<h3 class="productfield">Perform LACSLink® Lookups</h3>
:For example:
:Some rural route addresses are converted to city-style addresses to allow emergency services (ambulance, police, fire, and so on) to find these addresses faster.
:'''Sub Premise Level:''' Floor 12
:'''Sub Premise Level Type:''' Floor


:The LACSLink service matches the old address with the updated address and corrects it as part of the address verification process.


:Not using LACSLink processing will speed up processing, but the Component will not update addresses that have changed.
<h3 class="productfield">Sub Premises Number</h3>
:The parsed number from the '''Sub Premises/Suite''' field. This is part of the '''Sub Premises/Suite''' field.


:LACSLink processing is required to generate a CASS Form 3553.
:For example:
:'''Sub Premises:''' Apt 25A
:'''Sub Premises Number:''' 25A




<h3 class="productfield">Perofrm Delivery Indicator Lookups</h3>
==Extra Information Fields==
:Delivery Indicator indicates whether a given address is residential or business. Since some shipping rates are different for residential or business addresses, this information can potentially save a great deal of money.
[[File:Unison_Address-Global_OutputFields-Extra.png|900px|link=]]


Adds miscellaneous fields to the output record.


<h3 class="productfield">Use USPS Preferred City Names</h3>
:For every city, there is an official name that is preferred by the U.S. Postal Service. There may be one or more unofficial or "vanity" names in use. Normally, the Component allows you to verify addresses using known vanity names. If this box is checked, the Component will substitute the preferred city name for any vanity name when it verifies an address.


<h3 class="productfield">Remnants</h3>
:Any elements parsed from the input address data which could not be processed or were not relevant to the address processing are returned in the remnant parameter.


<h3 class="productfield">Countries</h3>
:Select the desirect country. If you only need to verify Canadian or U.S. addresses, selecting the option for just that country prevents the data files for the other country from being loaded, reducing memory requirements and increasing the processing speed.


<h3 class="productfield">Timezone</h3>
:Name of the timezone of the address.


<h3 class="productfield">Diacritic Mode</h3>
:This controls how the Component will handle diacritic characters in French words for addresses located in Quebec. The default setting is for the Component to return data with diacritic characters if they were already present, otherwise not. The other settings are to always return data from Quebec addresses with diacritic characters, even if they were not present in the input data, or to always replace the diacritic characters if they were present in the input data.


<h3 class="productfield">UTC</h3>
:The Coordinated Universal Time number in format of UTC+#. Note that there are timezones that are not whole hours only, like UTC+9:30.


<h3 class="productfield">Enable CASS Processing (US 3553)</h3>
:US Only.


:Enable this to generate a CASS Form 3553 after processing all records.
<h3 class="productfield">DST</h3>
:Returns a Y or a N based on if the country or area of the input observes daylight savings time. Note that the value returned by the UTC output does not change based on whether the country/area is currently in daylight savings time for not. We will only return the standard timezone and this flag to indicate is daylight savings is observed.


:This requires the address information boxes be filled out with the contact information for the company that owns the data being processed.


<h3 class="productfield">Address Key</h3>
:This is a country dependent field. The AddressKey can be used by other Melissa Data services, such as Geocoder or RBDI.


<h3 class="productfield">Enable SOA Processing</h3>
:{| class="alternate01"
:Canada Only.
!Country !! Description
 
|-
:Enable this to generate a Summary of Addresses (SOA) form.
|US||This returns a 11 digit code representing the combination of the zip code, the plus4, and the delivery point. This is a fairly good representation of a unique US address and often used as the core of postal barcode. However, this code is not guaranteed to be unique to an individual address, please use the '''Melissa Address Key''' field instead for that purpose. It is possible that this field is empty or not 11 digits if the address is a Non-USPS address (link to something about non-usps addresses).
|-
|GB||This field returns the UDPRN, which stands for Unique Delivery Point Reference Number. It is an 8 character code that is assigned and maintained by Royal Mail to each delivery point address.
|-
|AU||This returns the DPID (Delivery Point ID). This is a 8 digit number that identifies a mailbox according to Australia Post.
|}




<h3 class="productfield">Perform Suite Link Lookups</h3>
<h3 class="productfield">Delivery Indicator</h3>
:SuiteLink is a service from the U.S. Postal Service® that links a high rise business address to a suite number and updates address records with missing suite information.
:Returns a one character code that indicates if the address type. It is not available for all countries. Currently, this field is available for the US, GB, NL and IE with more countries planned in the future.


:Not using SuiteLink processing will speed up processing, but the Component will not update business addresses that are missing suite information.
:{| class="alternate01"
!Code !! Address Type
|-
|R||Residence
|-
|B||Business
|-
|U||Unknown
|}


:This requires the '''Company''' input field.


:SuiteLink processing is required to generate a CASS Form 3553.
<h3 class="productfield">Census Key</h3>
:This is a country dependent field. It is designed to return a code that correspond to the census division information for a country. Currently, this field is only returned for the US.


:'''US:''' The CensusKey for the US is a 15 or 16 digit code that is made up of the following components: FIPS Code, Census Tract, Census Block, and CensusBlockGroup if it exists.


<h3 class="productfield">Perform AddressPlus Lookups</h3>
:AddressPlus appends secondary address information, such as apartment numbers, to residential addresses and some business addresses not covered by the SuiteLink database.


:AddressPlus requires a last name. This can either be a last name column from the input data, or one of the last name output columns.
<h3 class="productfield">Delivery Point Suffix</h3>
:This is a country dependent field. This field returns an identifier that represents a suffix code usually tied to a delivery point.


:{| class="alternate01"
!Country !! Description
|-
|GB||This is a 2 character (first is numerical, 2nd character is alphabetic) that is assigned by Royal Mail. When added to the postal code, this allows each live delivery point to be uniquely identified.
|}




[[File:Unison_Address-Global_OutputFields-Additional.png|link=]]
<h3 class="productfield">Delivery Line 1 - Delivery Line 8</h3>
[[File:Unison_Address-Global_OutputFields-ParsedDT.png|link=]]
:These return the '''Address Line 1 - Address Line 8''' fields containing just the street address and dependent locality. They will not contain locality, administrative area, postal code etc.
[[File:Unison_Address-Global_OutputFields-ParsedRF.png|link=]]
[[File:Unison_Address-Global_OutputFields-ParsedPFF.png|link=]]
[[File:Unison_Address-Global_OutputFields-ParsedTF.png|link=]]
[[File:Unison_Address-Global_OutputFields-ParsedSF.png|link=]]
[[File:Unison_Address-Global_OutputFields-Extra.png|link=]]




[[Category:Unison by Melissa]]
[[Category:Unison by Melissa]]

Latest revision as of 01:42, 19 November 2022

← Unison by Melissa

Unison by Melissa Navigation
Introduction
Installation Instructions
Software Update Instructions
Address Object Tutorial
Software Rollback Tutorial
LDAP Settings
Platform
Admin Vs Users
Dashboard
Projects
Jobs
Files
Logs
Administration
Services
US Address Verification
Global Address Verification
Email Verification
Matching
Name Parsing
Phone Verification
Profiler
Result Codes
Result Code Use
Unison by Melissa Result Codes



The Unison by Melissa Global Address Cleansing Task cleanses global contact data.

Unison Address-Global Task.png


Input Fields

Unison Address-Global InputFields.png

This section displays the possible inputs for the Global Address Cleansing Task. An address and Country are required.


Organization/Company

The company or organization.


Address Line 1

The first address line. This should contain the delivery address information (house number, thoroughfare, building, suite, etc.) but should not contain locality information (locality, administrative area, postal code, etc.) which have their own inputs.


Address Line 2 - Address Line 4

This is optional. This should contain the delivery address information (house number, thoroughfare, building, suite, etc.) but should not contain locality information (locality, administrative area, postal code, etc.) which have their own inputs.


Sub-Premises/Suite

The sub-premises or suite number.


Locality/City

The locality name.
US Term: City
Canada Term: Municipality


Administrative Area/State

The administrative area, state or province name.


Postal Code/Zip

The Zip Code or Postal Code, depending on the country.


Country

The country code. If this is not input, the country will default to the United States.


More Input Fields

Unison Address-Global InputFields-More.png


Address Line 5 - Address Line 8

This is optional. This should contain the delivery address information (house number, thoroughfare, building, suite, etc.) but should not contain locality information (locality, administrative area, postal code, etc.) which have their own inputs.


Country of Origin

This is used to determine whether or not to include the country name as the last line in Formatted Address.
  • The destination country will be appended to the end of the formatted address when:
  • Valid and different from the destination country.
  • The destination country will not be appended to the end of the formatted address when:
  • Blank or
  • Invalid or
  • Same as the destination country


Double Dependent Locality

The smallest population center data element. This depends on the Locality and Dependent Locality fields.


Dependent Locality/Urbanization

The smaller population center data element. This depends on the Locality element.
US Term: Urbanization: In terms of US Addresses, this element applies only to Puerto Rican addresses. It is used to break ties when a ZIP Code™ is linked to multiple instances of the same address.


Sub Administrative Area/County

The smallest geographic data element.
US Term: County.


Sub National Area

The administrative region within a country on an arbitrary level below that of the sovereign state.


Output Fields

Unison Address-Global OutputFields.png

This section displays the possible outputs for the Address Service. Select the on/off toggle to enable/disable the output of a field.


Organization

The company or organization.


Address Line 1 - Address Line 8

These will be the standardized or corrected contents of the input address. These lines will include the entire address including the locality, administrative area, and postal code.


Zip/Postal Code

The postal code.
US Term: ZIP Code.


Country

The country name.


Latitude

The latitude of the address.


Longitude

The longitude of the address.


Dependent Locality

A dependent locality is a logical area unit that is smaller than a locality but larger than a double dependent locality or thoroughfare. It can often be associated with a neighborhood or sector. Great Britain is an example of a country that uses double dependent locality. In the United States, this would correspond to Urbanization, which is used only in Puerto Rico.
US Term: Urbanization.


Locality

The most common geographic area and used by virtually all countries. This is usually the value that is written on a mailing label and referred to by terms like City, Town, Postal Town, etc.
US Term: City


Administrative Area/State

A common geographic area unit for larger countries.
US Term: State


Delivery Line

The delivery portion of the full address, from the sub-premise and house number to the street information. This does not include area information like doubledependent locality, dependent locality, locality, administrative area, and postal code if those values are available for the country.


Locality Line

The locality information of the full address. This includes information such as doubledependent locality, dependent locality, locality, administrative area, and postal code if those values are available for the country. This does not include sub-premise and house number to the thoroughfare information.


Melissa Address Key (MAK)

(MAK) A unique key assigned to an address record.


Melissa Address Key Base

A unique key assigned to the base address of a complex with apartments or suites.


Address Type Code

Returns a one-character code for the type of address coded. This element works only for US, Canadian, and Great Britain addresses.
See Unison by Melissa Result Codes for a full list of result codes.


Formatted Address

Returns the address in the correct format for mailing from the country specified in the Country Of Origin input. This includes the Organization as the first line, one or more lines in the origin country’s format, and the destination country (if required).
The default separate line delimiter is a comma (,), but can be changed under the Address Task Settings.


UPRN

Great Britain Only. Returns the Unique Property Reference Number created and maintained by Ordnance Survey.


Result Codes

Returned result codes for the address.
For a list of result codes returned by Unison, see Unison Result Codes.


Additional Address Fields

Unison Address-Global OutputFields-Additional.png

Adds fields for parsed data from the address.


ISO 2 Country Code

The 2 letter ISO 3166 country code value.
For example:
Country Code
United States US
Canada CA
Philippines PH


ISO 3 Country Code

The 3 letter ISO 3166 country code value.
For example:
Country Code
United States USA
Canada CAN
Philippines PHL


ISO Country Number

The ISO 3166 country number value.
For example:
Country Code
United States 840
Canada 124
Philippines 608


Formal Country Name

Official Name for the country.


Parsed Dependent Thoroughfare Fields

Unison Address-Global OutputFields-ParsedDT.png

Adds fields relating to the Dependent Thoroughfare from the address.


Dependent Thoroughfare

The dependent thoroughfare is a second thoroughfare that is required to narrow down the final address. This is rarely used.


Dependent Thoroughfare Pre Direction

Pre Directions are directionals at the beginning of the dependent thoroughfare (i.e., N, S, E, W, NE, SW, etc.). This is a part of the Dependent Thoroughfare field.


Dependent Thoroughfare Post Direction

Post Directions are directionals at the end of the dependent thoroughfare (i.e., N, S, E, W, NE, SW, etc.). This value is a part of the Dependent Thoroughfare field.


Dependent Thoroughfare Leading Type

Leading Types are types at the beginning of the dependent thoroughfare (i.e., "Rue", etc.). This value is a part of the Dependent Thoroughfare field.


Dependent Thoroughfare Name

The parsed Dependent Thoroughfare Name. This value is a part of the Dependent Thoroughfare field.


Dependent Thoroughfare Trailing Type

Trailing Types are types at the end of the dependent thoroughfare (i.e., "St.", "Rd.", "Ave.", etc.). This value is a part of the Dependent Thoroughfare field.


Dependent Thoroughfare Type Attached

The dependent thoroughfare type connected to the dependent thoroughfare name without a space. This is common in Germany. For example, "Berlinerstr." "str." stands for strasse and is the dependent thoroughfare type attached, while "Berliner" is the dependent thoroughfare name.


Parsed Regional Fields

Unison Address-Global OutputFields-ParsedRF.png

Adds additional fields relating to the region from the address.


Double Dependent Locality

A logical area unit that is smaller than a dependent locality but bigger than a thoroughfare. This field is very rarely used. Great Britain is an example of a country that uses double dependent locality.


Sub Administrative Area

A logical area that that is smaller than the administrative area but larger than a locality. While many countries can have a sub-administrative area value, it is very rarely used as part of an official address.


Sub National Area

A logical area unit that is larger than an administrative area but smaller than the country itself. It is extremely rarely used.


Parsed Postal Facility Fields

Unison Address-Global OutputFields-ParsedPFF.png

Adds additional fields relating to the postal facility.


Post Box

The parsed Post Box.


Post Office Location

If available, this is the value that is associated to the location of the post office in relation to the address. This value may or may not be used in the official mailing address for the country in question. Currently, these are the countries we will return the data for: Serbia and Slovakia.
Country Description
Serbia The Post Office Location field contains the old 5 digit postal number and name. The postal code field will contain the new 6 digit PAK number.
Slovakia The Post Office Location field returns the name of the post office location if it is not the same as the delivery address locality.


Parsed Thoroughfare Fields

Unison Address-Global OutputFields-ParsedTF.png

Adds fields relating to the Thoroughfare from the address.


Premises/Street Name

The parsed premises name.
US Term: Street Name


Premises Number/Street Number

The parsed premises number.
US Term: House Number


Premises Type

The parsed premises type.


Thoroughfare

A part of the address lines containing all the sub-elements of the thoroughfare like trailing type, thoroughfare name, pre direction, post direction, etc.
US Term: Street


Thoroughfare Name

The parsed thoroughfare name. This is part of the thoroughfare field.


Thoroughfare Pre Direction

Pre Directions are directionals at the beginning of the thoroughfare (i.e., N, S, E, W, NE, SW, etc.). This is part of the thoroughfare field.


Thoroughfare Post Direction

Post Directions are directionals at the end of the thoroughfare (i.e., N, S, E, W, NE, SW, etc.). This is part of the thoroughfare field.


Thoroughfare Leading Type

Leading Types are thoroughfare types at the beginning of the thoroughfare (i.e., "Rue", etc.). This is part of the thoroughfare field.
This term is not used in the US.


Thoroughfare Trailing Type

Trailing Types are thoroughfare types at the end of the thoroughfare (i.e., "St.", "Rd.", "Ave.", etc.). This is part of the thoroughfare field.


Thoroughfare Type Attached

The thoroughfare type connected to the thoroughfare name without a space. This is common in Germany. For example, "Berlinerstr." "str." stands for strasse and is the thoroughfare type attached, while "Berliner" is the thoroughfare name.


Parsed Subpremises Fields

Unison Address-Global OutputFields-ParsedSF.png

Adds fields relating to the sub premises from the address.


Building

Descriptive name identifying an individual location. This is a string value that is the parsed Building element from the output.


Sub Building

A smaller division of the building. For example, if an address has a building name that is a part of a larger set of buildings, then the sub building may be populated.
Sub Building Number and Sub Building Type make up the parts of the Sub Building field.


Sub Building Number

The parsed sub building number. This is part of the Sub Building field.


Sub Building Type

The parsed sub building type. This is part of the Sub Building field.


Sub Premises/Suite

Individual units with their own addresses inside a building. This is parsed from the Address Line 1 - Address Line 8 fields.
Sub Premises Number and Sub Premises Type make up the parts of the Sub Premises/Suite field.
US Term: Suite or Apartment
For example:
Sub Premises: Apt 25A


Sub Premises Type

The parsed sub premises type from the Sub Premises/Suite field. This is part of the Sub Premises/Suite field.
For example:
Sub Premises: Apt 25A
Sub Premises Type: Apt


Sub Premises Level

A secondary piece of sub premise information used to describe a more generic division of the subpremise. For example, if you have an address like “1123 Market Way, Floor 12 Apt 25A” then the sub premises will be “Apt 25A” and the sub premise level will be “Floor 12”. This value is not widely used in official address data.
Sub Premise Level Type and Sub Premise Level Number make up the parts of the Sub Premise Level field. In our example, the Sub Premise Level Type is “Floor” and the Sub Premise Level Number is “12”.


Sub Premises Level Number

The parsed number from the sub premises level field. Sub Premise Level Type and Sub Premise Level Number make up the parts of the Sub Premise Level field.
For example:
Sub Premise Level: Floor 12
Sub Premise Level Number: 12


Sub Premises Level Type

The parsed type from the sub premises level field. Sub Premise Level Type and Sub Premise Level Number make up the parts of the Sub Premise Level field.
For example:
Sub Premise Level: Floor 12
Sub Premise Level Type: Floor


Sub Premises Number

The parsed number from the Sub Premises/Suite field. This is part of the Sub Premises/Suite field.
For example:
Sub Premises: Apt 25A
Sub Premises Number: 25A


Extra Information Fields

Unison Address-Global OutputFields-Extra.png

Adds miscellaneous fields to the output record.


Remnants

Any elements parsed from the input address data which could not be processed or were not relevant to the address processing are returned in the remnant parameter.


Timezone

Name of the timezone of the address.


UTC

The Coordinated Universal Time number in format of UTC+#. Note that there are timezones that are not whole hours only, like UTC+9:30.


DST

Returns a Y or a N based on if the country or area of the input observes daylight savings time. Note that the value returned by the UTC output does not change based on whether the country/area is currently in daylight savings time for not. We will only return the standard timezone and this flag to indicate is daylight savings is observed.


Address Key

This is a country dependent field. The AddressKey can be used by other Melissa Data services, such as Geocoder or RBDI.
Country Description
US This returns a 11 digit code representing the combination of the zip code, the plus4, and the delivery point. This is a fairly good representation of a unique US address and often used as the core of postal barcode. However, this code is not guaranteed to be unique to an individual address, please use the Melissa Address Key field instead for that purpose. It is possible that this field is empty or not 11 digits if the address is a Non-USPS address (link to something about non-usps addresses).
GB This field returns the UDPRN, which stands for Unique Delivery Point Reference Number. It is an 8 character code that is assigned and maintained by Royal Mail to each delivery point address.
AU This returns the DPID (Delivery Point ID). This is a 8 digit number that identifies a mailbox according to Australia Post.


Delivery Indicator

Returns a one character code that indicates if the address type. It is not available for all countries. Currently, this field is available for the US, GB, NL and IE with more countries planned in the future.
Code Address Type
R Residence
B Business
U Unknown


Census Key

This is a country dependent field. It is designed to return a code that correspond to the census division information for a country. Currently, this field is only returned for the US.
US: The CensusKey for the US is a 15 or 16 digit code that is made up of the following components: FIPS Code, Census Tract, Census Block, and CensusBlockGroup if it exists.


Delivery Point Suffix

This is a country dependent field. This field returns an identifier that represents a suffix code usually tied to a delivery point.
Country Description
GB This is a 2 character (first is numerical, 2nd character is alphabetic) that is assigned by Royal Mail. When added to the postal code, this allows each live delivery point to be uniquely identified.


Delivery Line 1 - Delivery Line 8

These return the Address Line 1 - Address Line 8 fields containing just the street address and dependent locality. They will not contain locality, administrative area, postal code etc.