PDF Export

searchByAddress

Diese Methode sucht nach Geschäftspartnern anhand der übergebenen Adressbestandteile und liefert eine entsprechende Trefferliste zurück. Wird kein passender Geschäftspartner gefunden, wird eine leere Liste zurückgegeben. Die bevorzugte Nutzung dieses Services dient der Ermittlung einer Geschäftspartner Nummer, über die dann nachfolgende Requests(Bp.getByBpNumber oder Subscription.getByBpNumber) für einen umfänglichen Datenabruf angestoßen werden.

  • Objekt: /net/dsb/avs3/BpSearch
  • Methode: searchByAddress
  • Version: 2.0.0
  • Fuba: /DSB/ISM_E_QUICKFIND_SUCHE

Parameter

Name Typ / LängeKann / MussBeschreibung
company AN / 30 K Firmenname (min. 3 Stellen)
first-name AN / 30 K Vorname (min. 3 Stellen)
last-name AN / 30 K Nachname (min. 3 Stellen)
street AN / 50 K Straße (min. 4 Stellen)
zipcode AN / 11 K Postleitzahl (min. 3 Stellen)
city AN / 50 K Ort (min. 3 Stellen)
country-code AN / 2 K Int. ISO Länderkennzeichen.
communication n.a. K 0 … n XML-Fragment ‚ communication‘ siehe unten. Codewerte: T = Telefon, TB = Tel. geschäftlich, TM = Tel. mobil, TP = Tel. privat, WW = Mail
search-contact-personsB K Sollen auch Ansprechpartner gesucht werden. Default ist „false“. Achtung: Dieser Parameter wird derzeit im AVS/3 nicht unterstützt und ist für zukünftige Erweiterungen gedacht.
max-hit-count N / 4 K Anzahl der max. zurückgelieferten Treffer. Default ist 20. . (max. Limit ist 500)
fallback-search AN / 1 K Wenn das Element nicht angegeben wird ist es gleichbedeutend mit Element leer oder bestückt mit N. Dies ist der Standard-Fall und es wird dadurch keine erweiterte(2-stufige) Suche ausgeführt. Wird explizit ein Y angegeben hat es zur Folge, dass intern eine erweiterte Suche mit z.B. Wildcards gemacht wird und es daher zu einer erweiterten Ergebnismenge kommen kann. Diese Sucherweiterung wird nur ausgeführt, wenn über die 1. Suchstufe kein Ergebnis ermittelt werden konnte. Kommt durch die 2-stufige Suche ein „unsauberes“ Ergebnis zurück, sollte client-seitig in der Ergebnis Selection direkt auf das entsprechende Kriterium gefiltert werden.

Rückgabe Element

Liste mit business-partner-address-extract Fragmenten siehe unten.

Beispiel Request

<?xml version="1.0" encoding="UTF-8"?>
<message version="1.0" system="avs/3">
  <header>
    <client>999</client>
    <avs3-sales-organization>9999</avs3-sales-organization>
    <avs3-service-provider>123</avs3-service-provider>
  </header>
  <body>
    <company></company>
    <first-name></first-name>
    <last-name></last-name>
    <street></street>
    <zipcode></zipcode>
    <city></city>
    <country-code></country-code>
    <communication>
      <communication-type></communication-type>
      <communication-value></communication-value>
    </communication>
    <search-contact-persons></search-contact-persons>
    <max-hit-count></max-hit-count>
    <fallback-search></fallback-search>
  </body>
</message>

Beispiel Response

<?xml version="1.0" encoding="UTF-8"?>
<message version="1.0" system="avs/3">
  <header>
    <client>999</client>
    <avs3-sales-organization>9999</avs3-sales-organization>
    <avs3-service-provider>123</avs3-service-provider>
  </header>
  <body>
    <!—-up to 20 bp-addresses -->
    <business-partner-address-extract>
    ...
    </business-partner-address-extract>
  </body>
</message>

Response Struktur


Cookies helfen bei der Bereitstellung von Inhalten. Durch die Nutzung dieser Seiten erklären Sie sich damit einverstanden, dass Cookies auf Ihrem Rechner gespeichert werden. Weitere Information