createQuestionnaire Diese Methode legt einen Fragebogen (Antworten eines Reagierers) im AVS/3 an und startet die evtl. davon abhängigen Prozesse. Ein abhängiger Nachfolgeprozess ist zum Beispiel die Anlage eines VTL-Satzes. Objekt: /net/dsb/avs3/Questionnaire Methode: createQuestionnaire Version: 2.0.0 Fuba: /DSB/ISM_H_STAPEL_EINSPIELEN Parameter Name Typ / LängeKann / MussBeschreibung questionnairen. a. m XML-Fragment ‚questionnaire‘ einer Fragebogen-Anlage siehe unten Rückgabe Element XML Struktur ‚questionnaire-create-response‘ siehe unten Beispiel Request <?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> <questionnaire> ... </questionnaire> </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> <questionnaire-create-response> <stack-name-for-questionnaire></stack-name-for-questionnaire> <number-in-stack-for-questionnaire></number-in-stack-for-questionnaire> <bp-number></bp-number> <stack-name-for-business-partner></stack-name-for-business-partner> <number-in-stack-for-business-partner></number-in-stack-for-business-partner> </questionnaire-create-response> </body> </message> Request Struktur Aufbau <questionnaire> <questionnaire> <questionnaire-id/> <questionnaire-campaign-id/> <questionnaire-date/> <questionnaire-aggreement/> <questionnaire-signed/> <questionnaire-signature-type/> <questionnaire-signature-text/> <questionnaire-origin/> <questionnaire-source/> <questionnaire-submit-type/> <archiv-type/> <archiv-id/> <barcode-type/> <barcode-id/> <input-office></input-office> <input-date></input-date> <input-user></input-user> <stack-name-for-questionnaire></stack-name-for-questionnaire > <stack-name-for-business-partner></stack-name-for-business-partner> <stack-description></stack-description> <!-- 0 to n --> <answer> <answer-code/> <answer-text/> </answer> <vtl-details> <delivery-quantity/> <valid-from-date/> <valid-to-date/> <valid-from-issue-number/> <valid-to-issue-number/> </vtl-details> <business-partner role-type="AG"> ... </business-partner> </questionnaire> Elementdefinition Feld LängeTypm = Muss k = Kann (m) = bedingtes MussBemerkung, Feldversorgung oder Umschlüsselung questionnaire-id 10 C m Fragebogen ID questionnaire-campaign-id 10 C m Fragebogen Aktions-ID questionnaire-date 10 D m Fragebogen-Datum (z. B. Datum der Unterschrift oder Datum der Übertragung) questionnaire-aggreement 1 C k Wurde Einverständnis gegeben Y = Ja N = Nein questionnaire-signed 1 C k Ist Fragebogen unterschrieben (Original oder Ersatzunterschrift) Y = Ja N = Nein questionnaire-signature-type 2 C k Art der Unterschrift <leer></html> = schriftlich (Defaultwert) 01 = Augenfarbe 02 = Schuhgröße 03 = Geburtsmonat questionnaire-signature-text 40 C k Text der Ersatzunterschrift. Zum Beispiel „blau“ bei Unterschrift-Typ Augenfarbe. questionnaire-origin 2 C k Datenursprung 01 = Import 02 = manuelle Erfassung questionnaire-source 2 C k Datenquelle 01 = persönliche Direktanfrage vom Empfänger 02 = Anfrage von der Firma des Empfängers 03 = Verbände oder Mitgliedschaften (individuell) 04 = Verbände oder Mitgliedschaften (organisiert) 05 = Sonstige Anfragen von Empfänger oder Empfängerfirmen questionnaire-submit-type 2 C k Form der Erhebung 01 = schriftlich 02 = Email, Internet 03 = Telefon archiv-type 2 C k Archiv-Typ <leer> = Sonstiges 01 = ArchiveLink 02 = Übernahme archiv-id 132 C k Archiv-ID-Wert barcode-type 2 C k Barcode-Type barcode-id 40 C k Barcode-ID-Wert input-office 12 C k Erfassungsbüro input-date 10 C k Anlage Datum input-user 12 C k Erfasser stack-name-for-questionnaire 17 C k Stapelname Fragebogen stack-name-for-business-partner17 C k Stapelname Geschäftspartner stack-description 50 C k Stapel Beschreibung answer 0 … n - answer-code 10 C m Antwortcode, der jede Antwort eindeutig identifiziert - answer-text 132 C (m) Freitext bei Antworten mit Freitexteingabe. Dies ist z. B. bei Antworten vom Typ „Sonstiges ….“ der Fall vtl-details - delivery-quantity 7 N m Liefermenge der generierten VTL - valid-from-date 10 D (m) Belieferungs-Zeitraum von Datum (Format YYYY-MM-DD) - valid-to-date 10 C (m) Belieferungs-Zeitraum bis Datum (Format YYYY-MM-DD) - valid-from-issue-number 9 C (m) Belieferungs-Zeitraum von Heft (Standard Format NNNN/YYYY oder mandantespezifisches Format/Freitext. - valid-to-issue-number 9 C (m) Belieferungs-Zeitraum bis Datum (Format NNNN/YYYY) oder mandantespezifisches Format/Freitext. business-partner siehe unten (Hinweis: avs-attribute ist bei Fragebögen eine Pflicht 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 <questionnaire-create-response> <questionnaire-create-response> <stack-name-for-questionnaire></stack-name-for-questionnaire> <number-in-stack-for-questionnaire></number-in-stack-for-questionnaire> <bp-number></bp-number> <stack-name-for-business-partner></stack-name-for-business-partner> <number-in-stack-for-business-partner></number-in-stack-for-business-partner> </questionnaire-create-response> Elementdefinition Feldname LängeTyp stack-name-for-questionnaire AN number-in-stack-for-questionnaire AN bp-number AN stack-name-for-business-partner AN number-in-stack-for-business-partner AN 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