changeBp Diese Methode ändert die Daten eines Geschäftspartners im Zielsystem. Um eine Änderung durchzuführen müssen alle Daten des Geschäftspartners, auch diejenigen die sich nicht verändert haben übergeben werden. Nicht übergebene Daten werden als zu löschend interpretiert. Die Geschäftspartner- Nr. ist bei einer Änderung Pflichtfeld. Objekt: /net/dsb/vhs3/Bp Methode: changeBp Version: 1.0.0 Parameter Name Typ / LängeKann / MussBeschreibung business-partnerXML m XML Fragment „business-partner“ wie bei Neubestellungen entsprechend der Beschreibung im Abschnitt unten. Rückgabe Element Transaktions-Nr. der Änderung. Beispiel Request <?xml version="1.0" encoding="UTF-8"?> <message version="1.0" system="vhs/3" > <header> <client>4711</client> <service-provider>999</service-provider> </header> <body> <business-partner> <salutation-code>01</salutation-code> <last-name1>Mustermann</last-name1> <first-name>Hans</first-name> <street>Musterstr. 15</street> <zipcode>12345</zipcode> <country-code code-type="iso">DE</country-code> <city>Musterhausen</city> <bp-number>1234567890</bp-number> <communication> <communication-type>WW</communication-type> <communication-value>hans.mustermann@aol.com</communication-value> </communication> </business-partner </body> </message> Beispiel Response <?xml version="1.0" encoding="UTF-8"?> <message version="1.0" system="vhs/3"> <header> <client>4711</client> <service-provider>999</service-provider> </header> <body> <transaction-guid>F67B9A28-E640-72CD-4989-29BB44F6CFEC</transaction-guid> </body> </message> Request Struktur Aufbau <business-partner> Request <business-partner id="" role-type=""> <salutation-code></salutation-code> <prefix></prefix> <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> <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 code-type=""></country-code> <city></city> <district></district> <region-code></region-code> <region-text></region-text> <company1></company1> <company2></company2> <company3></company3> <department></department> <po-box></po-box> <po-box-zipcode></po-box-zipcode> <po-box-city></po-box-city> <po-box-country-code code-type=""></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> <postal-check></postal-check> <purge-check></purge-check> <dublicate-check></dublicate-check> <block></block> <block-reason></block-reason> <intercompany></intercompany> <bic-master-number></bic-master-number> <sector></sector> <communication> <communication-type></communication-type> <communication-value></communication-value> </communication> <attribute> <attribute-type></attribute-type> <attribute-value></attribute-value> </attribute> <debit-account> <debit-account-number></debit-account-number> <debit-bank-code></debit-bank-code> <debit-country-code code-type=""></debit-country-code> <debit-account-holder></debit-account-holder> <debit-continuous></debit-continuous> <iban></iban> <bic></bic> </debit-account> <cc-account> <cc-number></cc-number> <cc-checksum></cc-checksum> <cc-company-code></cc-company-code> <cc-holder></cc-holder> <cc-expiry></cc-expiry> <cc-startdate></cc-startdate> <cc-issuenumber></cc-issuenumber> <cc-type></cc-type> </cc-account> <avs-attributes> <sales-organization></sales-organization> <distribution-channel></distribution-channel> <division></division> </avs-attributes> <vhs-attributes> <client></client> <service-provider></service-provider> </vhs-attributes> </business-partner> Elementdefinition Wichtiger Hinweis: Längenangaben in Klammern beziehen sich auf VHS/3 Standalone. Hier sind teilweise längere Werte möglich. Feld KeyLänge ArtBeschreibung Attribute: id n. a. AN Eindeutige ID (z. B. GUID) dieses Geschäftspartner innerhalb des XML-Dokuments. Diese ID wird benötigt um eine Beziehung zwischen Auftrag und Geschäftspartner zu beschreiben. Dies ID sollte nicht mit dem Attribut role-type verwechselt werden, welche die Rolle des Geschäftspartners beschreibt. Siehe auch Element „bp-reference“ in der XML-Struktrur „purchase-order“ im Abschnitt 3.19. Attribute: role-type 2 AN Rolle die der Geschäftspartner in der Beziehung zum Auftrag einnimmt. AG = Auftraggeber WE = Warenempfänger Hierbei handelt es sich um die vereinfachte Angabe der Beziehung, falls die erweiterten Möglichkeiten von „purchaseorder-to-business-partner-relation“ nicht benötigt werden. salutation-code 2 AN Anrede 01 = Herr 02 = Frau 04 = Firma 99 = unbekannt weitere Codes sind in einer Codetabelle hinterlegt, bei Bedarf bitte anfragen titel-code-academic 4 AN Code Akademischer Titel Codewerte siehe Anhang. titel-academic 15(30)AN Akademischer Titel im Klartext (z. B. Dr.) titel-code-royal 4 AN Code Adels-Titel Codewerte siehe Anhang. titel-royal 15(30)AN Adels-Titel im Klartext job-titel 35 AN Berufsbezeichnung last-name1 40(50)AN Nachname1 last-name2 40(50)AN Nachname2 first-name 40(30)AN Vorname(n) street 50 AN Straße street-suffix 40 AN Strassen Zusatz street-number 10 AN Hausnummer street-number-suffix 10 AN Hausnummer – Zusatz address-line-1 35 AN Adresse Zeile 1 für UK Adressen address-line-2 35 AN Adresse Zeile 2 für UK Adressen address-line-3 35 AN Adresse Zeile 3 für UK Adressen zipcode 10 AN Postleitzahl country-code 2 AN Land (internationaler Länder ISO-Code) country-code →Attribute code-type 3 AN iso – Ländercode als ISO Länderkennung (default) car – Ländercode als KFZ Länderkennung city 40 AN Ort district 40(50)AN Zusatz zum Ort (z. B. Ortsteil, Bezirk, Gebiet, …) region-code 3 AN region-code Codetabelle, Inhalt legt Fachbereich fest region-text 25 AN Region als Klartext (z.B. Bundesland, County…) company1 40 AN Firma Zeile 1 company2 40 AN Firma Zeile 2 company3 40 AN Firma Zeile 3 department 30 A Abteilung po-box 10 AN Postfach po-box-zipcode 10 AN Postfach-PLZ po-box-city 40 AN Postfach Ort (nicht unterstützt in Verbindung mit VHS/3) po-box-country-code 2 AN Postfach Land (internationaler Länder ISO-Code) (nicht unterstützt in Verbindung mit VHS/3) major-customer-zipcode 10 AN Großkunden-PLZ address-source 10 AN Adressquelle Codetabelle, Inhalt legt Fachbereich fest Das Feld erwartet bestimmte Codes, die im AVS/3 Customzing hinterlegt sein müssen. advertisement 1 AN Werbung erlaubt (nur bei integriertem Betrieb verfügbar) Y = Ja N = Nein (z. B. Robinson) category 2 AN Adressart (nur VHS/3) bp-number 10 AN Optional, bei Bestandskunde Kundennummer bp-number-external 20 AN Geschäftspartner-Nr. eines externen Systems bp-group 4 AN Kundengruppe Codetabelle, Inhalt legt Fachbereich fest Das Feld erwartet bestimmte Codes, die im AVS/3 Customzing hinterlegt sein müssen. eu-sales-tax-number 14 AN EG-UST Identnummer date-of-birth 10 N Geburtstag Format: JJJJ-MM-TT postal-check 1 AN Prüfung Kundenanschrift:: postalisch Y = Prüfung, N = keine Prüfung keine Angabe = (Defaultwertvers.) purge-check 1 AN Prüfung Kundenanschrift:: Purge dublicate-chec 1 AN Prüfung Kundenanschrift:: Dublette block 1 AN Sperrkennzeichen des Geschäftspartners Y = Ja N = Nein block-reason 2 AN Sperrgrund intercompany 1 AN Y/N sector 10 AN Branche: Dieses Element steht nur für SingleSales integration zur Verfügung und kann im AVS über den Geschäftspartner abgerufen werden. communication -communication-type (M)2 AN Kommunikations-Art Wertebereich -communcation-value (M)50 AN Wert der Kommunikationsart attribute - attribute-type (M)6 AN Funktion des Geschäftspartner Merkmals (z. B. Adressart) Das Feld erwartet bestimmte Codes, die im AVS/3 Customzing hinterlegt sein müssen. - attribute-value (M)50 AN Wert des Geschäftspartner Merkmals debit-account - debit-account-number (M)18 AN Konto-Nr. - debit-bank-code (M)12 AN Bankleitzahl (BLZ) - debit-country-code (M)2 AN Ländercode der Bank (internationaler ISO Code) - debit-account-holder (M)50 AN Name des Kontoinhabers - debit-continous 1 AN Einmalabbuchung oder Einzugsermächtigung erteilt. Y = Dauerhaft N = einmalig cc-account - cc-number (M)19 AN Kreditkarten Nr. - cc-checksum 4 AN Kreditkarten Prüfziffer Wert wird nur für Prüfzwecke verwendet aber nicht gespeichert! - cc-company-code (M)4 AN Kreditkarten Institut - cc-holder (M)40 AN Kreditkarten Inhaber - cc-expiry (M)6 N Kreditkarte gültig bis (Format YYYYMM) - cc-startdate 6 N Kreditkarte gültig von (Format YYYYMM) - cc-issuenumber 3 AN Kreditkarte Ausgabe-Nummer - cc-type 2 AN Kreditkarten-Typ avs-attributes - sales-organization 4 AN Verkaufsorganisation im AVS/3 - distribution-channel 2 AN Vertriebsweg im AVS/3 - division 2 AN Sparte im AVS/3 vhs-attributes - client 4 AN Mandanten-Nr. im VHS/3 - service-provider 3 AN Dienstleister-Kennung im VHS/3 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