findAddresses

Searches for addresses.

Object: /net/dsb/commons/AddressManagement
Method: findAddresses
Version: 1.0.0

Parameter

Name	Type / Length	Mandatory / Optional	Description
postal-address	XML	M	address
minimum-score	N	-	minimal score (100 = exact match)

Exemple Request

<message version="1.0" system="AVS/3">
  <header>
     <client>9999</client>
     <avs3-sales-organization>9999</avs3-sales-organization>
     <avs3-service-provider>AVS</avs3-service-provider>
  </header>
  <body>
    <postal-address>
      <zipcode>TR26 2JD</zipcode>
      <address-line-1 />
    </postal-address>
    <minimum-score>100</minimum-score>
 </body> 
</message>

Example Response

<message version="1.0" system=" AVS/3">
  <header>
     <client>9999</client>
     <avs3-sales-organization>9999</avs3-sales-organization>
     <avs3-service-provider>AVS</avs3-service-provider>
  </header>
  <body>
    <postal-address>
      <zipcode>TR26 2JD</zipcode>
      <city>ST. IVES</city>
      <region-text>Cornwall</region-text>
      <address-line-1>1 Porthia Close</address-line-1>
      <address-line-2 />
    </postal-address>
    <postal-address>
      <zipcode>TR26 2JD</zipcode>
      <city>ST. IVES</city>
      <region-text>Cornwall</region-text>
      <address-line-1>2 Porthia Close</address-line-1>
      <address-line-2 />
    </postal-address>
  </body> 
</message>

Request

Structure <postal-address>

<postal-address>
   <country-code></country-code>
   <zipcode></zipcode>
   <city></city>
   <region-code></region-code>
   <region-text></region-text>
   <district></district>
   <street></street>
   <street-suffix></street-suffix>
   <street-number></street-number>
   <street-number-suffix></street-number-suffix>
   <address-line-1></address-line-1>
   <address-line-2></address-line-2>
   <address-line-3></address-line-3>
   <po-box></po-box>
   <po-box-zipcode></po-box-zipcode>
   <po-box-city></po-box-city>
   <major-customer-zipcode></major-customer-zipcode>
</postal-address>

Element Definitions

Field	Length	Type	Description
country-code	3	AN	Country code
zipcode	10	AN	Zipcode
city	50	AN	City
region-code	3	AN	Region code
region-text	25	AN	Region as cleartext (e.g. County…)
district	50	AN	Additional to city (for example, districts, areas)
street	50	AN	Street
street-suffix	50	AN	Street addition
street-number	10	AN	House-number
street-number-suffix	15	AN	House-number - addition
address-line-1	35	AN	Adresse Line 1 for UK Addresses
address-line-2	35	AN	Adresse Line 2 for UK Addresses
address-line-3	35	AN	Adresse Line 3 for UK Addresses
po-box	10	AN	Po-box
po-box-zipcode	10	AN	Po-box-zipcode
po-box-city	40	AN	Po-box-city
major-customer-zipcode	10	AN	Major customer zipcode