PDF Export

Aufbau <business-partner> changeBpAddress Request

<business-partner>
    <salutation-code action="DELETE"></salutation-code>
    <prefix action="DELETE"></prefix>
    <titel-code-academic action="DELETE"></titel-code-academic>
    <titel-academic action="DELETE"></titel-academic>
    <titel-code-royal action="DELETE"></titel-code-royal>
    <titel-royal action="DELETE"></titel-royal>
    <job-titel action="DELETE"></job-titel>
    <last-name1 action="DELETE"></last-name1>
    <last-name2 action="DELETE"></last-name2>
    <first-name action="DELETE"></first-name>
    <nick-name action="DELETE"></nick-name>
    <street action="DELETE"></street>
    <street-suffix action="DELETE"></street-suffix>
    <street-number action="DELETE"></street-number>
    <street-number-suffix action="DELETE"></street-number-suffix>
    <address-line-1 action="DELETE"></address-line-1>
    <address-line-2 action="DELETE"></address-line-2>
    <address-line-3 action="DELETE"></address-line-3>
    <zipcode action="DELETE"></zipcode>
    <country-code code-type="ISO" action="DELETE"></country-code>
    <city action="DELETE"></city>
    <district action="DELETE"></district>
    <region-code action="DELETE"></region-code>
    <region-text action="DELETE"></region-text>
    <company1 action="DELETE"></company1>
    <company2 action="DELETE"></company2>
    <company3 action="DELETE"></company3>
    <company4 action="DELETE"></company4>
    <department action="DELETE"></department>
    <po-box action="DELETE"></po-box>
    <po-box-zipcode action="DELETE"></po-box-zipcode>
    <po-box-city action="DELETE"></po-box-city>
    <po-box-country-code code-type="ISO" action="DELETE"></po-box-country-code>
    <major-customer-zipcode action="DELETE"></major-customer-zipcode>
    <address-source action="DELETE"></address-source>
    <bp-number></bp-number>
    <eu-sales-tax-number action="DELETE"></eu-sales-tax-number>
    <date-of-birth action="DELETE"></date-of-birth>
    <transaction-type>Z2</transaction-type>
    <valid-from></valid-from>
    <communication>
        <communication-type action="DELETE"></communication-type>
        <communication-value action="DELETE"></communication-value>
    </communication>
    <avs-attributes>
        <sales-organization></sales-organization>
        <distribution-channel></distribution-channel>
        <division></division>
    </avs-attributes>
</business-partner>

Elementdefinition

Erläuterung:

Zu allen mit „kann(k)“ gekennzeichneten Elementen besteht ein attribute action, das entweder mit „DELETE“ oder mit „UPDATE“ gefüllt werden kann.

Bei DELETE wird der bestehende Inhalt des Feldes im AVS/3 System gelöscht. Bei UPDATE wird der bestehende Inhalt des Feldes im AVS/3 System mit dem neu gelieferten Wert überschrieben.

Bei der reinen Neuanlage eines Wertes kann das UPDATE Attribut angegeben oder weggelassen werden. Bsp.:

...
<street action='UPDATE'>Bahnhofstraße</street>
...
oder
...
<street>Bahnhofstraße</street>
...

Bei der Löschung eines Kommunikationseintrags muss der zu löschende Wert im XML-Tag direkt angegeben werden. Bsp.:

...
<communication>
    <communication-type action='DELETE'>WW</communication-type>
    <communication-value action='DELETE'>test1@tst.de</communicationvalue>
</communication>

Bei der Änderung eines Kommunikationseintrags muss der alte Wert in 'old-value' und der neue Wert im XML-Tag direkt angegeben werden.

...
<communication>
    <communication-type action='UPDATE'>WW</communication-type>
    <communication-value action='UPDATE' old-value='test1@tst.de'>test2@tst.de</communicationvalue>
</communication>

Ändern oder Hinzufügen eines Kommunikationseintrags mit communication-default Flag.

Bsp.:

<communication>
    <communication-type>WW</communication-type>
    <communication-value>test2@tst.de</communication-value>
    <communication-default>Y</communication-default>
</communication>
Feld LängeTypTextm = Muss/
k = Kann /
(m) = bedingtes Muss
Bemerkung, Feldversorgung oder Umschlüsselung
salutation-code 2 C Anredek01 = Herr
02 = Frau
99 = unbekannt weitere Codes sind in einer Codetabelle hinterlegt, bei Bedarf bitte anfragen. Falls eine Firmenadresse übergeben wird, so handelt es sich hierbei um die Anrede des Ansprechpartners (falls vorhanden).
prefix 4 C Vorsatzwort zum Namen (Schlüssel) k
titel-code-academic 4 C Akademischer Titel k Codierung siehe Tabelle im Anhang. Achtung diese Tabelle entspricht der Grundeinstellung eines Mandanten. Evtl. ist noch abzustimmen, inwieweit von dieser Grundeinstellung vom Kunden abgewichen worden ist.
titel-academic 15 C Akademischer Titel im Klartext (z. B. Dr.) k
titel-code-royal 4 C Adels-Titel k Codierung siehe Tabelle im Anhang Achtung diese Tabelle entspricht der Grundeinstellung eines Mandanten. Evtl. ist noch abzustimmen, inwieweit von dieser Grundeinstellung vom Kunden abgewichen worden ist.
titel-royal 15 C Adels-Titel im Klartext k
job-titel 35 C Berufsbezeichnung k Berufsbezeichnung
last-name1 40 C Nachname1 k Falls eine Firmenadresse übergeben wird, ist dies der Ansprechpartner
last-name2 40 C Nachname2 k Falls eine Firmenadresse übergeben wird,ist dies der Ansprechpartner
first-name 40 C Vorname(n) k Falls eine Firmenadresse übergeben wird, ist dies der Ansprechpartner
nick-name 40 C Rufname(n) k Falls eine Firmenadresse übergeben wird, ist dies der Ansprechpartner
street 50 C Strasse k Pflicht, falls eine Straßenadresse übergeben werden soll.
street-suffix 40 C Strassen Zusatz k
street-number 10 C Haus-Nummer k Pflicht, falls eine Straßenadresse übergeben werden soll.
street-number-suffix 10 C Haus-Nummer - Zusatz k
address-line-1 35 C Adresse Zeile 1 für UK Adressen k
address-line-2 35 C Adresse Zeile 2 für UK Adressen k
address-line-3 35 C Adresse Zeile 3 für UK Adressen k
zipcode 10 C Postleitzahl kPflicht, falls eine Straßenadresse übergeben werden soll.
country-code 3 C Land (KFZ Nationalitätskennzeichen) k Codierung siehe Tabelle im Anhang
city 40 C Ort k Pflicht, falls eine Straßenadresse übergeben werden soll.
district 25 C Zusatz zum Ort (z. B. Ortsteil, Bezirk, Gebiet, …) k
region-code 3 C Regions-Code (Bundesstaat, Bundesland, Provinz, Grafschaft) k
region-text 25 C Region als Klartext (z.B. Bundesland, County…) k
company1 35 C Firma Zeile 1 k
company2 35 C Firma Zeile 2 k
company3 40 C Firma Zeile 3 k
company4 40 C Firma Zeile 4 k
department 30 C Abteilung k
po-box 10 C Postfach k Pflicht, falls eine Postfachadresse übergeben werden soll
po-box-zipcode 10 C Postfach-PLZ k Pflicht, falls eine Postfachadresse übergeben werden soll
po-box-city 40 C Ort zum Postfach k Pflicht, falls eine Postfachadresse übergeben werden soll
po-box-country-code 3 C Land zum Postfach k Pflicht, falls eine Postfachadresse übergeben werden soll
major-customer-zipcode 10 C Großkunden-PLZ k
address-source 10 C Adressquelle Codetabelle, Inhalt legt Fachbereich festk
bp-number 10 C Kundennummer m
eu-sales-tax-number 14 C EG-UST Identnummer k
date-of-birth 10 D Geburtstag Format: JJJJ-MM-TT k
transaction-type 2 C Aktivitäts-Typ m Z2 Adressänderungen (Normalfall)
ZU Termingesteuerte Addressänderung BETA
valid-from 10 DDatum, ab wann die Adressänderung gültig sein soll (YYYY-MM-DD) (m) Wenn im transaction-type 'ZU' angegeben ist, dann muss hier ein gültiges Datum drinstehen (hierbei ist zu beachten, das alle Geschäftspartner Daten mitgeliefert werden müssen)
communication
- communicationtype 2 C Kommunications Typ mWertebereich
Achtung : es ist jeweils nur 1 Telefonnummer, 1 Emailadresse und 1 Faxnummer zulässig !
→action C attribut (k) DELETE oder UPDATE
→old-value 4 C alter Wert k muss angegeben werden, wenn action atttribute „UPDATE“ ist
- communicationvalue 50 C Wert mAchtung : es ist jeweils nur 1 Telefonnummer,1 Emailadresseund 1 Faxnummer zulässig !
→action C attribut (k) DELETE oder UPDATE
→old-value 4 C alter Wert kmuss angegeben werden, wenn action atttribute „UPDATE“ ist
- communication-default 1 C Default Flag kY / N Standard Kommunikations Eintrag innerhalb dieses Typs
→action C attribut (k) UPDATE
avs-attributes
- sales-organization 4 C Verkaufsorganisation im AVS/3 k Wenn nicht vorhanden, wird es Anhand der bp-number im Backend nachgelesen.
- distributionchannel 2 C Vertriebsweg im AVS/3 kWenn nicht vorhanden, wird es Anhand der bp-number im Backend nachgelesen.
- division 2 C Sparte im AVS/3 k Wenn nicht vorhanden, wird es Anhand der bp-number im Backend nachgelesen.
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