changeBpAddress Objekt: /net/dsb/avs3/Bp Methode: changeBpAddress Version: 2.0.0 Fuba: /DSB/ISM_H_STAPEL_EINSPIELEN Diese Methode ändert einen bestehenden Geschäftspartner im AVS/3-System ab. Parameter Name Typ / LängeKann / MussBeschreibung input-office AN / 12 m Erfassungs-Büro input-user AN / 12 m Erfassungs-User stack-name AN / 17 (m) Stapel-Name stack-descriptionAN / 50 k Optionale Stapelbeschreibung business-partner n.a. m XML-Fragment ‚business-partner‘ siehe unten Rückgabe Element XML-Fragment ‚bp-change-response‘ 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> <input-office>123456789012</input-office> <input-user>123456789012</input-user> <stack-name></stack-name> <business-partner> ... </business-partner> </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> <bp-change-response> ... </bp-change-response> </body> </message> Request Struktur 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 MussBemerkung, 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. Response Struktur Aufbau <bp-...-response> <bp-...-response> <bp-number></bp-number> <bp-number-external></bp-number-external> <stack-name></stack-name> <number-in-stack></number-in-stack> </bp-...-response> Elementdefinition Feld LängeTypBemerkung, Feldversorgung oder Umschlüsselung bp-number 10 C Nr. des Geschäftspartners im AVS/3 wenn eine direkte Verbuchung erfolgreich war. bp-number-external20 C Externe Geschäftspartners aus dem Request, wenn vorhanden. stack-name 17 C Name des Stapel, in dem der GP angelegt wurde. number-in-stack 6 N Nummer des angelegten GP im Stapel. 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. OK Weitere Information