createBp Objekt: /net/dsb/avs3/Bp Methode: createBp Version: 2.0.0 Fuba: /DSB/ISM_H_STAPEL_EINSPIELEN Diese Methode legt einen Geschäftspartner im AVS/3-System an. 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 business-partnern.a. m XML-Fragment ‚business-partner‘ siehe Abschnitt 7.1.1 Rückgabe Element XML-Fragment ‚ bp-create-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></input-office> <input-user></input-user> <stack-name></stack-name> <business-partner> <salutation-code>01</salutation-code> <last-name1>Lustig</last-name1> <first-name>Peter</first-name> <street>Buchenstr.</street> <street-number>12</street-number> <street-number-suffix/> <zipcode>74196</zipcode> <country-code>DE</country-code> <city>Neuenstadt</city> </business-partner> </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> <bp-create-response> ... </bp-create-response> </body> </message> Request Struktur Aufbau <business-partner> Request <business-partner 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> <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> <language>DE</language> <advertisement></advertisement> <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> <transaction-type></transaction-type> <block></block> <block-reason></block-reason> <bic-master-number></bic-master-number> <sector></sector> <email-bp></email-bp> <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></debit-country-code> <debit-account-holder></debit-account-holder> <debit-continuous></debit-continuous> </debit-account> <cc-account> <cc-number></cc-number> <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 Feld LängeTypText m = Muss / k = Kann / (m) = bedingtes MussBemerkung, Feldversorgung oder Umschlüsselung salutation-code 2 C Anrede m 01 = 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.) 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 job-titel 35 C Berufsbezeichnung k Berufsbezeichnung last-name1 35 C Nachname1 (m) Falls eine Firmenadresse übergeben wird, ist dies der Ansprechpartner last-name2 35 C Nachname2 k Falls eine Firmenadresse übergeben wird, ist dies der Ansprechpartner first-name 35 C Vorname(n) (m) Falls eine Firmenadresse übergeben wird, ist dies der Ansprechpartner nick-name 35 C Rufname(n) k street 50 C Strasse (m) Pflicht, falls eine Straßenadresse übergeben werden soll. street-suffix 40 C Strassen Zusatz k street-number 10 C Haus-Nummer (m) Pflicht, falls eine Straßenadresse übergeben werden soll. street-number-suffix 8 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 (m) Pflicht, falls eine Straßenadresse übergeben werden soll. country-code 3 C Land (KFZ Nationalitätskennzeichen) m Codierung siehe Tabelle im Anhang city 40 C Ort (m) 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 (m) 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 (m) Pflicht, falls eine Postfachadresse übergeben werden soll po-box-zipcode 10 C Postfach-PLZ (m) Pflicht, falls eine Postfachadresse übergeben werden soll po-box-city 40 C Ort zum Postfach (m) Pflicht, falls eine Postfachadresse übergeben werden soll po-box-country-code 3 C Land zum Postfach (m) Pflicht, falls eine Postfachadresse übergeben werden soll major-customer-zipcode10 C Großkunden-PLZ (m) address-source 10 C Adressquelle Codetabelle, Inhalt legt Fachbereich fest k language 2 C Sprache des Geschäftspartners k ISO-Code der Sprache advertisement 1 C Kennzeichen, ob Werbung zugesendet werden soll. k 'N' → Keine Werbung zusenden 'Y' → Werbung zusenden category 2 C Adressart bp-number 10 C Optional, bei Bestandskunde Kundennummer k bp-number-external 20 C Geschäftspartner-Nr. eines externen Systems k bp-group 4 C Kundengruppe Codetabelle, Inhalt legt Fachbereich fest k 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 k 01 = Neuanlage 02 = Änderung Wenn keine Wert gesetzt ist, wird bei einer vorhandenen GP-Nr. (bp-number) eine Änderung, beim Fehlen einer GP-Nr. eine Neuanlage vorgenommen. block 1 C k block-reason 2 C k bic-master-number 10 C Partner-ID des Masters (z.B. Firma des Ansprechpartners) k sector 10 C Branche k email-bp1 C Email Geschäftspartnerk Y = Ja, N = Nein(Default) keine Angabe (Defaulteinstellung wird benutzt) communication - communication-type 2 C Kommunikationsart (m) Wertebereich Achtung : es ist jeweils nur 1 Telefonnummer, 1 Emailadresse und 1 Faxnummer zulässig ! - communcationvalue 50 C Wert der Kommunikationsart (m) Achtung : es ist jeweils nur 1 Telefonnummer, 1 Emailadresse und 1 Faxnummer zulässig ! attribute - attribute-type 6 C Funktion des Geschäftspartner Merkmals z. B. Adressart (m) - attribute-value 50 C Wert des Geschäftspartner Merkmals (m) debit-account - debit-account-number18 C Konto-Nr. k Die Bankdaten sind nur anzugeben, falls diese zum Geschäftspartner gespeichert werden sollen. Normalerweise werden die Bankdaten im Auftrag übergeben. - debit-bank-code 12 C Bankleitzahl (BLZ) k - debit-country-code 2 C Ländercode der Bank k - debit-account-holder50 C Name des Kontoinhabers - debit-continous 1 C Einmalabbuchung oder Einzugsermächtigung erteilt. k Y = Dauerhaft N = einmalig cc-account - cc-number 19 C Kreditkarten Nr. k Die Kreditkartendaten sind nur anzugeben, falls diese zum Geschäftspartner gespeichert werden sollen. Normalerweise werden die Kartendaten im Auftrag übergeben. - cc-company-code 4 C Kredikarten Institut k - cc-holder 40 C Kreditkarten Inhaber k - cc-expiry 6 C Kreditkarte gültig bis (Format YYYYMM) k - cc-start-date 6 C Kredikarte gültig von (Format YYYYMM) k - cc-issuenumber 3 C Kreditkarte Ausgabe-Nummer k - cc-type 2 C Kreditkarten-Typ k avs-attributes - sales-organization 4 C Verkaufsorganisation im AVS/3 m - distribution-channel2 C Vertriebsweg im AVS/3 m - division 2 C Sparte im AVS/3 m vhs-attributes - client 4 C Mandanten-Nr. im VHS/3 k - service-provider 3 C Dienstleister-Kennung im VHS/3 k 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