getByBpNumber

Objekt: /net/dsb/avs3/Bp
Methode: getByBpNumber
Version: 2.0.0
Fuba: /DSB/ISM_E_GET_GP

Diese Methode liefert den entsprechenden Geschäftspartner aus dem AVS/3-System anhand der übergebenen Geschäftspartnernummer. Wird kein Eintrag gefunden, so wird eine leere Message zurückgeliefert.

Parameter

Name	Typ / Länge	Kann / Muss	Beschreibung
bp-number	AN / 10	m	Geschäftspartner Nummer

Rückgabe Element

Ein XML-Fragment ‚business-partner siehe unten

Beispiel Request

<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>
    <bp-number>1234567890</bp-number>
  </body>
</message>

Beispiel Response

<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>
    <!-- 0...1 ->
    <business-partner>
    ...
    </business-partner >
  </body>
</message>

Response Struktur

Aufbau <business-partner>

Hinweis: Diese Rückgabestruktur ist momentan für die Abfrage eines Geschäftspartners über die Methoden getByBpNumber, getByBpAttribute und getByTimestamp vorbehalten.

<business-partner>
    <salutation-code></salutation-code>
    <titel-code-academic></titel-code-academic>
    <titel-academic></titel-academic>
    <titel-code-royal></titel-code-royal>
    <titel-royal></titel-royal>
    <job-titel></job-titel>
    <last-name1></last-name1>
    <last-name2></last-name2>
    <first-name></first-name>
    <nick-name></nick-name>
    <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>
    <zipcode></zipcode>
    <country-code></country-code>
    <city></city>
    <district></district>
    <region-code></region-code>
    <region-text></region-text>
    <company1></company1>
    <company2></company2>
    <company3></company3>
    <company4></company4>
    <department></department>
    <po-box></po-box>
    <po-box-zipcode></po-box-zipcode>
    <po-box-city></po-box-city>
    <po-box-country-code></po-box-country-code>
    <major-customer-zipcode></major-customer-zipcode>
    <address-source></address-source>
    <advertisement></advertisement>
    <category></category>
    <bp-number></bp-number>
    <bp-number-external></bp-number-external>
    <bp-group></bp-group>
    <eu-sales-tax-number></eu-sales-tax-number>
    <date-of-birth></date-of-birth>
    <bic-master-number></bic-master-number>
    <sector></sector>
    <!-- Kommunikationsarten 0...n -->
    <communication>
        <communication-type></communication-type>
        <communication-value></communication-value>
    </communication>
    <!-- GP-Merkmale 0...n -->
    <attribute>
        <attribute-type></attribute-type>
        <attribute-value></attribute-value>
    </attribute>
</business-partner>

Elementdefinition

Feld	Länge	Typ	Bemerkung, Feldversorgung oder Umschlüsselung
salutation-code	2	C	Anrede
titel-code-academic	4	C	Akademischer Titel
titel-academic	15	C	Akademischer Titel im Klartext (z. B. Dr.)
titel-code-royal	4	C	Adels-Titel
titel-royal	15	C	Adels-Titel im Klartext
job-titel	35	C	Berufsbezeichnung im Klartext
last-name1	40	C	Nachname1
last-name2	40	C	Nachname2
first-name	40	C	Vorname(n)
nick-name	40	C	Nickame
street	50	C	Strasse
street-suffix	40	C	Strassen Zusatz
street-number	10	C	Haus-Nummer
street-number-suffix	10	C	Haus-Nummer - Zusatz
address-line-1	35	C	Adresse Zeile 1 für UK Adressen
address-line-2	35	C	Adresse Zeile 2 für UK Adressen
address-line-3	35	C	Adresse Zeile 3 für UK Adressen
zipcode	10	C	Postleitzahl
country-code	3	C	Land (KFZ Nationalitätskennzeichen)
city	40	C	Ort
district	25	C	Zusatz zum Ort (z. B. Ortsteil, Bezirk, Gebiet, …)
region-code	3	C	Regions-Code (Bundesstaat, Bundesland, Provinz, Grafschaft)
region-text	25	C	Region als Klartext (z.B. Bundesland, County…)
company1	35	C	Firma Zeile 1
company2	35	C	Firma Zeile 2
company3	40	C	Firma Zeile 3
company4	40	C	Firma Zeile 4
department	30	C	Abteilung
po-box	10	C	Postfach
po-box-zipcode	10	C	Postfach-PLZ
po-box-city	40	C	Ort zum Postfach
po-box-country-code	3	C	Land zum Postfach
major-customer-zipcode	10	C	Großkunden-PLZ
address-source	10	C	Adressquelle Codetabelle, Inhalt legt Fachbereich fest
advertisement	1	C	Kennzeichen, ob Werbung zugesendet werden soll.
category	2	C	Adressart
bp-number	10	C	Optional, bei Bestandskunde Kundennummer
bp-number-external	20	C	Geschäftspartner-Nr. eines externen Systems
bp-group	4	C	Kundengruppe Codetabelle, Inhalt legt Fachbereich fest
eu-sales-tax-number	14	C	EG-UST Identnummer
date-of-birth	10	D	Geburtstag Format: JJJJ-MM-TT
bic-master-number	10	C	Partner-ID des Masters (z.B. Firma des Ansprechpartners)
sector	10	C	Branche
communication
- communicationtype	2	C	Kommunikationsart (Wertebereich)
- communcationvalue	50	C	Wert der Kommunikationsart
attribute
- attribute-type	6	C	Funktion des Geschäftspartner Merkmals z. B. Adressart
- attribute-value	50	C	Wert des Geschäftspartner Merkmals