getNewOrders (Version 3)

Objekt: /net/dsb/avs3/SubscriptionOrder
Methode: getNewOrders
Version: 3.0.0
Fuba: /DSB/_ISM_E_SEL_NEUERF

Diese Methode erwartet ein Datum, eine Uhrzeit und ein Druckerzeugnis. Der so übergebene Zeitpunkt wird benutzt, alle Abos zu ermitteln, welche nach diesem Zeitpunkt angelegt bzw. erzeugt wurden. Diese werden dann von dieser Methode zurückgegeben. Dies Suche erfolgt innerhalb der aktiven und inaktiven Abos. Desweiteren wird das Datum und die Uhrzeit des jüngsten Eintrages zurückgegeben. Dieser Zeitpunkt sollte dann für die nächste Abfrage benutzt werden.

Wichtiger Hinweis:
Im AVS/3 kann festgelegt werden welche Auftrags- bzw. Geschäftspartner-Attribute im Response zurückgeliefert werden. Dies wird über die Customizing Tabellen /DSB/JET_MERK_RE bzw. /DSB/JET_MERK_GP gepflegt. Bitte wenden Sie sich an Ihren Kundenbetreuer, wenn hier weitere Werte bzw. die Wildcard ( * ) aufgenommen werden sollen.

Parameter

Name	Typ / Länge	Kann / Muss	Beschreibung
body	n.a.	m	Beschreibung des XML-Fragments siehe Abschnitt unten

Rückgabe Element

Beschreibung des XML-Fragment siehe Abschnitt unten.

Diese Methode ergibt alleine gesehen nur in den wenigsten Fällen Sinn. Normalerweise geht es darum, alle aktiven Abos zu ermitteln und diese an die Gegenstelle zu übermitteln. Deshalb wird als Ergänzung zu dieser Methode eine Möglichkeit angeboten, die unten aufgeführte Rückgabestruktur einmal pro Tag als Datei zu erhalten. Diese Datei enthält dann alle aktiven Abos für den Mandanten. Dadurch, dass alle aktiven Abos übermittelt werden, kann auf der Gegenstelle natürlich auch festgestellt werden, welche Abonnenten gekündigt haben. Beide Dienste (liefern der Daten per Datei bzw. per Webservice) können unabhängig voneinander einzeln oder kombiniert benutzt werden.

Folgende Szenarien sind vorstellbar:

Die Gegenseite ist nur an Neuzugängen von Abos interessiert ⇒ der Webservice kann alleine benutzt werden.
Alle aktiven Abos müssen an die Gegenseite übermittelt werden, dabei müssen Neuabos nicht sehr zeitnah (> 24 h) übermittelt werden ⇒ Übermittlung der Daten per Datei ist ausreichend.
Alle aktiven Abos müssen an die Gegenseite übermittelt werden, dabei müssen Neuabos zeitnah (< 24 h) übermittelt werden ⇒ Übermittlung der Daten per Datei und Übermittlung aller Neuabos per Webservice. Falls beide Verfahren gleichzeitig benutzt werden, ist darauf zu achten, dass beide Datenübermittlungen synchronisiert ablaufen, da ansonsten ein Datenverlust auftreten kann. Eine Möglichkeit, dies zu gewährleisten, besteht darin, die per Webservice übermittelten Abos generell eine vorgegebene Zeitspanne (wie z.B. 1 Woche) nicht zu löschen.

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>
    <from-date>2004-09-07</from-date>
    <from-time>22:10:59</from-time>
    <publication>00010729</publication>
    <return-address-type>AG</return-address-type>
    <return-address-type>RE</return-address-type>
    <return-address-type>WE</return-address-type>
    <return-address-at-time>L</return-address-at-time>
    <return-extended-communication-data>Y</return-extended-communication-data>
    <return-renewal-payment-data>Y</return-renewal-payment-data>
    <return-renewal-issue-remaining>N</return-renewal-issue-remaining>
    <return-current-suspension-data>N</return-current-suspension-data>
    <return-extended-premium-data>N</return-extended-premium-data>
  </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>
    <next-date>2004-06-14</next-date>
    <next-time>11:53:57</next-time>
    <client>999</client>
    <new-subscription>
      <order-number>4270055033</order-number>
      <publication>00000187</publication>
      <edition>00000187</edition>
      <mix-type>01</mix-type>
      <issue-nr-from>0004/2004</issue-nr-from>
      <issue-nr-to/>
      <valid-to>0000-00-00</valid-to>
      <end-reason/>
      <promotion-source>505Q32</promotion-source>
      <pr-source-var/>
      <reference-doc>WEBWEB1106</reference-doc>
      <cust-order-nr>1050691121569</cust-order-nr>
      <cust-order-date>20030418</cust-order-date>
      <subscr-phase/>
      <price-group/>
      <price-key>CP01</price-key>
      <business-partner>
        <role>WE</role>
        <bp-number>1003698418</bp-number>
        <full-salutation>Sehr geehrter Herr Tester</full-salutation>
        <first-name>Martin</first-name>
        <full-last-name>Tester</full-last-name>
        <name-addition/>
        <titel/>
        <salutation>Herr</salutation>
        <company1/>
        <company2/>
        <company3/>
        <zipcode>94036</zipcode>
        <street>GleiwitzerStr.3C</street>
        <po-box-zipcode/>
        <po-box/>
        <po-box-city/>
        <major-cust-zip/>
        <city>Passau</city>
        <district/>
        <country-code>DE</country-code>
        <country>Deutschland</country>
        <phone-number>0851-8519784</phone-number>
        <fax-number/>
        <email-address>hallo@web.de</email-address>
      </business-partner>
      <order-attribute>
        <type>EMAIL</type>
        <value>hallo@web.de</value>
      </order-attribute>
      <order-attribute>
        <type>ARCHIV</type>
        <value>123456789</value>
      </order-attribute>
    </new-subscription>
  ...
  </body>
</message>

Request Struktur

Aufbau getNewOrders-3.0.0 Request

<body>
  <from-date></from-date>
  <from-time></from-time>
  <publication></publication>
  <mix-type></mix-type>
  <max-hit-count></max-hit-count>
  <!-- 0 ... n -->
  <return-address-type></return-address-type>
  <return-address-at-time></return-address-at-time>
  <return-extended-communication-data></return-extended-communication-data>
  <return-renewal-payment-data></return-renewal-payment-data>
  <return-renewal-issue-remaining></return-renewal-issue-remaining>
  <return-current-suspension-data></return-current-suspension-data>
  <return-extended-premium-data></return-extended-premium-data>
</body>

Elementdefinition

Feldname	Länge	Typ	Text	m = Muss k = Kann (m) = bedingtes Muss	Bemerkung, Feldversorgung oder Umschlüsselung
from-date	10	D	Datum, ab welchem die neuen Abos geliefert werden sollen	m	Dieser Wert sollte sich bei einem Folgeaufruf aus der zuvor zurückgegeben 'next-date' und 'next-time' ergeben.
from-time	8	T	Uhrzeit, ab welchem die neuen Abos geliefert werden sollen	m	Nur wenn der Zeitstempel eines Abos größer ist als das übergebene Datum, wird das entsprechende Abo übergeben.
publication	8	C		k	DRERZ
mix-type	2	C		k	Bezugstyp
max-hit-count	3	N	Blockgröße 1 - 500	k	Max. Anzahl zurückgelieferter Abos, pro Request
return-address-type	2	C	Hier können die zurückzuliefernden Rollen angegeben werden.	k	(AG, WE, VM, RE) Dieser Parameter kann n-Mal vorkommen
return-address-at-time	1	C		m	'L' = Adresse zum letzten Versandtermin 'A' = aktuelle Adresse 'Z' = Adresse zum zukuenftigen Versandtermin
return-extended-communication-data	1	C		k	return extended communication data Y = Ja N = Nein
return-renewal-payment-data	1	C	k	Rückgabe zusätzlicher Renewal Zahlungsdaten	Y = Ja N = Nein
return-renewal-issue-remaining	1	C	k	Rückgabe noch zu liefernde Ausgaben für das ganze Abo	Y = Ja N = Nein
return-current-suspension-data	1	C	k	Rückgabe zusätzlicher Daten für Unterbrechung( aktuelle)	Y = Ja N = Nein
return-extended-premium-data	1	C	k	Rückgabe zusätzlicher Prämien Daten	Y = Ja N = Nein

Response Struktur

XML-Beschreibung Rückgabe (getNewOrders,getOrdersBy...)

Aufbau

<body>
  <next-date></next-date>
  <next-time></next-time>
  <client></client>
  <!--0 to n possible -->
  <new-subscription>
    ...
  </new-subscription>
</body>

Elementdefinition

Feldname	Länge	Typ	Text	Hinweise oder Attributaufstellungen
next-date	10	D	Datum des jüngsten zurückgegebenen Abos.	Sollte bei nachfolgenden Aufrufen verwendet werden.
next-time	8	T	Uhrzeit des jüngsten zurückgegebenen Abos.	Sollte bei nachfolgenden Aufrufen verwendet werden.
client	3	C	Mandant, für welchen dieser Aufruf erfolgte.
new-subscription				Siehe Beschreibung unten

new-subscription bzw. subscription-order

Aufbau

<new-subscription>
  <order-number></order-number>
  <publication></publication>
  <publication-name></publication-name>
  <edition></edition>
  <mix-type></mix-type>
  <purchase-frequency></purchase-frequency>
  <delivery-type></delivery-type>
  <order-status></order-status>
  <is-renewal>true</is-renewal>
  <is-timebased>true</is-timebased>
  <order-currency></order-currency>
  <issue-nr-from></issue-nr-from>
  <issue-nr-to></issue-nr-to>
  <issue-nr-first-bill></issue-nr-first-bill>
  <valid-from></valid-from>
  <valid-to></valid-to>
  <valid-from-evt><valid-from-evt>
  <valid-to-evt></valid-to-evt>
  <valid-from-on-sale-date><valid-from-on-sale-date>
  <valid-to-on-sale-date></valid-to-on-sale-date>
  <end-reason></end-reason>
  <promotion-source></promotion-source>
  <pr-source-var></pr-source-var>
  <reference-doc></reference-doc>
  <cust-order-nr></cust-order-nr>
  <cust-order-date></cust-order-date>
  <subscr-phase></subscr-phase>
  <price-group></price-group>
  <price-key></price-key>
  <payment-method></payment-method>
  <payment-method-details>
    <sub-payment-method-code></sub-payment-method-code>
    <repeating-transaction-id></repeating-transaction-id>
  </payment-method-details>
  <billing-frequency></billing-frequency>
  <billing-frequency-short-description></billing-frequency-short-description>
  <quantity></quantity>
  <sales-organization></sales-organization>
  <dsb-media1></dsb-media1>
  <dsb-media2></dsb-media2>
  <dsb-media3></dsb-media3>
  <dsb-media4></dsb-media4>
  <dsb-media2b></dsb-media2b>
  <dsb-media7></dsb-media7>
  <agent-number></agent-number>
  <material-number></material-number>
  <premium-description></premium-description>
  <premium-dispatch-date></premium-dispatch-date>
  <billing-payed-to></billing-payed-to>
  <issue-number-next-bill></issue-number-next-bill>
  <issue-number-from-last-bill></issue-number-from-last-bill>
  <issue-number-to-last-bill></issue-number-to-last-bill>
  <current-dunning-level></current-dunning-level>
  <ct-commitment-period></ct-commitment-period>
  <ct-cancelation-period></ct-cancelation-period>
  <ct-renewal></ct-renewal>
  <dsb-urpos-lief></dsb-urpos-lief>
  <sales-source></sales-source>
  <advertising-medium></advertising-medium>
  <sales-document-type></sales-document-type>
  <dispatch-type></dispatch-type>
  <dispatch-text></dispatch-text>
  <contract-account-balance></contract-account-balance>
  <postage-key></postage-key>
  <renewal>
    <expiry-date></expiry-date>
    <expiry-issue-nr></expiry-issue-nr>
    <renewal-due-date></renewal-due-date>
    <number-issues-remaining></number-issues-remaining>
    <current-cycle-number-of-issues></current-cycle-number-of-issues>
    <current-cycle-start-issue-nr></renewal-cycle-start-issue-nr>
    <current-cycle-start-date></renewal-cycle-start-date>
    <current-cycle-expiry-issue-nr></current-cycle-expiry-issue-nr>
    <current-cycle-expiry-date></current-cycle-expiry-date>
    <current-cycle-acceptance-date></current-cycle-acceptance-date>
    <current-cycle-offer></current-cycle-offer>
    <current-cycle-offer-type></current-cycle-offer-type >
    <current-cycle-offer-description></current-cycle-offer-description >
    <current-cycle-offer-marketingtext></current-cycle-offer-marketingtext >
    <offer-classification></offer-classification>
    <offer-classification-definition></offer-classification-definition>
    <current-cycle-paid-amount></current-cycle-paid-amount>
    <current-cycle-bundle-paid-amount></current-cycle-bundle-paid-amount>
    <order-currency></order-currency>
    <renewal-bundle-component></renewal-bundle-component>
    <auto-renewal></auto-renewal>
    <auto-renewal-next-payment-amount></auto-renewal-next-payment-amount>
    <auto-renewal-next-payment-frequency-code></auto-renewal-next-payment-frequency-code>
    <auto-renewal-next-payment-frequency-text></auto-renewal-next-payment-frequency-text>
    <auto-renewal-last-payment-date></auto-renewal-next-payment-date>
    <auto-renewal-last-payment-amount></auto-renewal-last-payment-amount>
    <auto-renewal-last-payment-frequency-code></auto-renewal-last-payment-frequency-code>
    <auto-renewal-last-payment-frequency-text></auto-renewal-last-payment-frequency-text>
    <auto-renewal-last-payment-date></auto-renewal-last-payment-date>
    <auto-renewal-actual-claim-counter></auto-renewal-actual-claim-counter>
    <auto-renewal-increase-claim-counter></auto-renewal-increase-claim-counter>
  </renewal>
  <!— 0 to n -- >
  <bundled-subscription-info>
    <bundle-order-number></bundle-order-number>
    <publication></publication>
    <edition></edition>
    <quantity></quantity>
  </bundled-subscription-info>
  <current-suspension>
    <suspended-from-date></suspended-from-date>
    <suspended-to-date></suspended-to-date>
    <suspended-from-issue-nr></suspended-from-issue-nr>
    <suspended-to-issue-nr></suspended-to-issue-nr>
    <suspended-reason-code></suspended-reason-code>
  </current-suspension>
  <change-info>
    <future-mix-type />
    <future-mix-type-from-issue-nr />
    <future-mix-type-to-issue-nr />
    <former-mix-type />
    <former-mix-type-to-issue-nr />
    <future-delivery-quantity>0</future-delivery-quantity>
    <future-delivery-quantity-from-issue-nr />
    <former-delivery-quantity>0</former-delivery-quantity>
    <former-delivery-quantity-to-issue-nr />
    <future-delivery-type />
    <future-delivery-type-from-issue-nr />
    <former-delivery-type />
    <former-delivery-type-to-issue-nr />
    <future-dispatch-type />
    <future-dispatch-type-from-issue-nr />
    <former-dispatch-type />
    <former-dispatch-type-to-issue-nr></former-dispatch-type-to-issue-nr>
    <future-dispatch-text />
    <future-dispatch-text-from-issue-nr />
    <former-dispatch-text />
    <former-dispatch-text-to-issue-nr></former-dispatch-text-to-issue-nr>
  </change-info>
  <!-- 1 to 3 possible -->
  <business-partner>
    ...
  </business-partner>
  <!-- 0 to n possible -->
  <order-attribute>
    ...
  </order-attribute>
</new-subscription>

Elementdefinition

Feldname	Länge	Typ	Text	Hinweise oder Attributaufstellungen
order-number	10	C	Abonummer	Entspricht der Auftragsnummer
publication	8	C	Druckerzeugnis
publication-name	30	C	Bezeichnung des Druckerzeugnis
edition	8	C	Planvertriebsausgabe
mix-type	2	C	Bezugstyp
purchase-frequency	2	C	Bezugsperiodizität
delivery-type	2	C	Lieferart
order-status	2	C	Auftragsstatus
is-renewal		B	handelt es sich um ein Renewal-Abo ?
is-timebased	B	handelt es sich um ein zeitbasiertes Renewal-Abo ? (true/false)
order-currency	3	C		Währungscode des Auftrags
issue-nr-from	9	C	Lieferbeginn Heftnummer	Heftnummer der ersten zu liefernden Vertriebsausgabe. Standard Format: HHHH/JJJJ oder mandantespezifisches Format /Freitext.
issue-nr-to	9	C	Lieferende Heftnummer	Heftnummer der letzten zu liefernden Vertriebsausgabe. Standard Format: HHHH/JJJJ oder mandantespezifisches Format /Freitext.
issue-nr-first-bill	9	C	Heftnummer der 1. Rechnung	Standard Format: HHHH/JJJJ oder mandantespezifisches Format /Freitext.
valid-from	10	D	Lieferbeginn Datum	Datum der ersten zu liefernden Vertriebsausgabe bezogen auf den Fakturamonat. Das Datum ist in der Form: yyyymmdd (VALID_FROM)
valid-to	10	D	Lieferende Datum	Datum der letzten zu liefernden Vertriebsausgabe bezogen auf den Fakturamonat. Das Datum ist in der Form:yyyymmdd (VALID_TO)
valid-from-evt	10	D	Datum des ersten Versandtages	Gültig von EVT, wobei EVT „Datum des ersten Versandtages“ ist. Das Datum ist in der Form: yyyymmdd (VALID_FROM_EVT)
valid-to-evt	10	D	Datum des letzten Versandtages	Gültig bis EVT, wobei EVT „Datum des letzten Versandtages“ ist. Das Datum ist in der Form: yyyymmdd (VALID_TO_EVT)
valid-from-on-sale-date	10	D	Erstverkaufstag(EVT) des ersten zu liefernden Hefts	Das Datum ist in der Form: yyyymmdd (VALID_FROM_DSBEVT)
valid-to-on-sale-date	10	D	Erstverkaufstag(EVT) des letzten gelieferten Hefts	Hefts Das Datum ist in der Form: yyyymmdd (VALID_TO_DSBEVT)
end-reason	3	C	Grund der Liefereinstellung	Die einzelenen Werte sind mandantenabhängigb
promotion-source	10	C	Bestellquelle
pr-source-var	1	C	Bestellquellen-Variante
reference-doc	20	C	Referenzbeleg	Enthält die Auftragsnummer des Alt-Systems. Ist ansonsten identisch mit dem Feld order-number
cust-order-nr	20	C	Bestellnummer des Kunden
custorder-date	10	D	Bestelldatum des Kunden	Das Datum ist in der Form: yyyy-mm-dd
subscr-phase	3	C	Phase, in der sich das Abo momentan befindet
price-group	2	C	Preisgruppe des Kunden	Legt evtl. vorhandene Ermäßigungen auf den Basispreis fest
price-key	4	C	Preisschlüssel des Kunden	Legt den Basispreis fest
payment-method	1	C	Zahlweg	E → Zahlung per Bankeinzug K→ Zahlung per Kreditkarte R → Zahlung per Rechnung. Für ausländische Kunden sind evtl. noch weitere Zahlwege vorgesehen
payment-method-details
- sub-payment-methodcode	3	C	Zahlweg Untergruppe	Unterkategorie zu 'payment-method' (z.B. Zahlungsgrupp)
- repeating-transaction-id	255	C	ID für den wiederholten Zahlungseinzug
billing-frequency	2	C	Fakturaperioditität
billing-frequency-short-description	15	C	Fakturaperioditität Kurz-Beschreibung
quantity	10	C	Bezugsmenge
sales-organization	4	C	Verkaufsorganisation
dsb-media1	1	C	Feld zur freien Verfügung.	Wird beim Auftrag gespeichert.
dsb-media2	2	C	Feld zur freien Verfügung.	Wird beim Auftrag gespeichert.
dsb-media3	3	C	Feld zur freien Verfügung.	Wird beim Auftrag gespeichert.
dsb-media4	4	C	Feld zur freien Verfügung.	Wird beim Auftrag gespeichert.
dsb-media2b	2	C	Feld zur freien Verfügung.	Wird beim Auftrag gespeichert.
dsb-media7	7	C	Feld zur freien Verfügung.	Wird beim Auftrag gespeichert.
agent-number	10	C	Vertreternummer
material-number	18	C	Prämien-Nr.	Materialnummer der Sachprämie
premium-description	50	C	Prämien Beschreibung	Beschreibung der Sachprämie
premium-dispatch-date	10	C	Meldedatum an VHS	Timestamp date ( YYYY-MM-TT )
billing-payed-to	9	C	Faktura bezahlt bis heftnummer	Format: HHHH/JJJJ
issue-number-next-bill	9	C	Heftnummer der nächsten Rechnung	Standard Format: HHHH/JJJJ oder mandantespezifisches Format /Freitext.
issue-number-from-last-bill	9	C	Heftnummer VON der letzten Rechnung	Standard Format: HHHH/JJJJ oder mandantespezifisches Format /Freitext.
issue-number-to-last-bill	9	C	Heftnummer BIS der letzten Rechnung	Standard Format: HHHH/JJJJ oder mandantespezifisches Format /Freitext.
current-dunning-level	2	C	Mahnstufe
ct-commitment-period	2	N	Bindungsfrist	Vertragsbedingung: Dauer der Bindungsfrist (reguläre Kündig. nach x Monaten möglich)
ct-cancelation-period	2	N	Kündigungsfrist	Vertragsbedingungen:Kündigungsfrist
ct-renewal	2	N	Verlängerung Vertragsbedingung:	(autom.) Verlängerung der Bindungsfrist
dsb-urpos-lief	6	N	Lieferpositionsreferenz	Gibt an, welches die ursprüngliche Lieferposition dieses Auftrags ist.
sales-source	4	C	Werbeart	Gibt die Werbeart an.
advertising-medium	10	C	Werbträger	Werbeträger
sales-document-type	4	C	Verkaufsbelegart	Auftragsart
dispatch-type	2	C	Versandart	Versandart
dispatch-text	5	C	Versandtext	Weiteres Trennkriterium im Versand
contract-account-balance	15	C	Saldo des Vertragskontos	Bitte beachten! Dieser Wert ist nur Tagesaktuell! Bei Sammelrechnungen kann es der Saldo aus mehreren Verträgen sein. negatives Vorzeichen = Kundenguthaben positives Vorzeichen = offene Vorderungen vorhanden
postage-key	2	C	Portoschlüssel	(für Versandkostenermittlung)
renewal
- expiry-date	10	C	Datum, an dem das Ganze Abo abläuft.	Timestamp date ( YYYY-MM-TT )
- expiry-issue-nr	9	C	Letzte Heftnummer, die der Abonnent bekommt	Standard Format: HHHH/JJJJ oder mandantespezifisches Format /Freitext.[OUT_ABO.RENEWAL_EXPIRY_ISSUE]
- renewal-due-date	10	C	Fälligkeit für nächste Zahlung	Timestamp date (YYYY-MM-TT )
- number-issues-remaining		N	Anzahl der Hefte	Wenn Request Flag gesetzt('Y') Anzahl noch zu liefernder Ausgaben über das ganze Abo. Sonst, Anzahl noch zu liefernder Ausgaben über den aktuellen Zyklus
- current-cycle-numberof-issues		N	Anzahl der Hefte
- current-cycle-start-issue-nr	9	C	Erste Heftnummer beim Start	Standard Format: HHHH/JJJJ oder mandantespezifisches Format /Freitext.[OUT_ABO.RENEWAL_CYCLE_START_ISSUE]
- current-cycle-startdate	10	C	Startdatum des Renewal-Abos	Timestamp date (YYYY-MM-TT )
- current-cycle-expiryissue-nr	9	C	Heftnummer am Ende des Abozeitraums	Standard Format: HHHH/JJJJ oder mandantespezifisches Format /Freitext.[OUT_ABO.RENEWAL_CYCLE_EXPIRY_ISSUE]
- current-cycle-expirydate	10	C	Enddatum des Renewal - Abos	Timestamp date ( YYYY-MM-TT )
- current-cycle-acceptance-date	10	C	Datum, an dem der Abonnent das Renewal Abo aktzeptiert	Timestamp date (YYYY-MM-TT ) [OUT_ABO.RENEWAL_CYCLE_ACCEPTANCE_DATE]
- current-cycle-offer	5	C	Renewal Angebot des aktuellen Zyklus
- current-cycle-offertype	2	C	Typ des Renewal Angebots des aktuellen Zyklus(RN, DD or BU)
- current-cycle-offerdescription	100	C	Beschreibung des Renewal Angebots des aktuellen Zyklus
- current-cycle-offermarketingtext	100	C	Marketingtext des Renewal Angebots des aktuellen Zyklus
- offer-classification	1	C	Klassifikation (Bundle, Membership, Normal etc.)
- offer-classification-definition	4	C	Offer classification definition
- current-cycle-paidamount	11,2	C	Zahlbetrag Zyklus des Auftrages
- current-cycle-bundlepaid-amount	11,2	C	Gesamt-Zahlbetrag Bundle
- order-currency	5	C	Auftragswährung
- renewal-bundle-component	C	M = Master, S = Slave
- auto-renewal	1	C	Y / N Kennzeichen, ob Subscription automatisch erneuert wird
- auto-renewal-nextpayment-amount	11,2	N	Zahlbetrag des nächsten Einzugs in der entsprechenden Auftrags Währung
- auto-renewal-nextpayment-frequencycode	2	C
- auto-renewal-nextpayment-frequencytext	15	C
- auto-renewal-nextpayment-date	10	C	Datum des nächsten Einzugs	Timestamp date (YYYY-MM-TT )
- auto-renewal-lastpayment-amount	11,2	N	Zahlbetrag des letzten Einzugs in der entsprechenden Auftrags Währung
- auto-renewal-lastpayment-frequencycode	2	C
- auto-renewal-lastpayment-frequencytext	15	C
- auto-renewal-lastpayment-date	10	C	Datum des letzten Einzugs	Timestamp date (YYYY-MM-TT )
- auto-renewal-actual-claim-counter		N	actual claim counter
- auto-renewal-increase-claim-counter		N	increase claim counter
bundled-subscription-info 0 … n
- bundle-order-number	10	C	Auftragsnummer des Unterauftrags
- publication	8	C	Druckerzeugnis
- edition	8	C	Planvertriebsausgabe
- quantity	10	N	Menge
current-suspension
- suspended-from-date	10	C	Unterbrechung von Datum	Timestamp date (YYYY-MM-TT )
- suspended-to-date	10	C	Unterbrechung bis Datum	Timestamp date (YYYY-MM-TT )
- suspended-from-issue-nr	9	C	Unterbrechung von Heft Nr.
- suspended-to-issue-nr	9	C	Unterbrechung bis Heft Nr.
- suspended-reason-code	3	C	Code für Grund der Unterbrechung
change-info			(Um diese Daten zu erhalten, setzen Sie sich bitte mit ihrem Kundenberater in Verbindung. Das customizing flag x_change_info muss gesetzt werden.)
- future-mix-type	2	C	zukünftiger Bezugstyp
- future-mix-type-from-issue-nr	9	C	ab Heftnummer	Bsp. 0009/2015
- future-mix-type-to-issue-nr	9	C	bis Heftnummer	Bsp. 0009/2015
- former-mix-type	2	C	ehemaliger Bezugstyp
- former-mix-type-to-issue-nr	9	C	bis Heftnummer	Bsp. 0009/2015
- future-delivery-quantity	10	N	zukünftige Liefermenge
- future-delivery-quantity-from-issue-nr	9	C	ab Heftnummer	Bsp. 0009/2015
- former-delivery-quantity	10	N	ehemalige Liefermenge
- former-delivery-quantity-to-issue-nr	9	C	bis Heftnummer	Bsp. 0009/2015
- future-delivery-type	2	C	zukünftige Lieferart
- future-delivery-type-from-issue-nr	9	C	ab Heftnummer	Bsp. 0009/2015
- former-delivery-type	2	C	ehemalige Lieferart
- former-delivery-type-to-issue-nr	9	C	bis Heftnummer	Bsp. 0009/2015
- future-dispatch-type	2	C	zukünftige Versandart
- future-dispatch-type-from-issue-nr	9	C	ab	Heftnummer
- former-dispatch-type	2	C	ehemalige Versandart
- former-dispatch-type-to-issue-nr	9	C	bis Heftnummer	Bsp. 0009/2015
- future-dispatch-text	5	C	zukünftiger Versand-Text
- future-dispatch-text-from-issue-nr	9	C	ab	Heftnummer
- former-dispatch-text	5	C	ehemaliger Versand-Text
- former-dispatch-text-to-issue-nr	9	C	bis Heftnummer	Bsp. 0009/2015
business-partner				Siehe Beschreibung unten
order-attribute				Siehe Beschreibung unten

Geschäftspartner Response (business-partner)

Aufbau

<business-partner>
  <role></role>
  <bp-number></bp-number>
  <full-salutation></full-salutation>
  <last-name1></last-name1>
  <last-name2></last-name2>
  <first-name></first-name>
  <nick-name></nick-name>
  <full-last-name></full-last-name>
  <name-addition></name-addition>
  <job-titel></job-titel>
  <titel></titel>
  <salutation-code></salutation-code>
  <salutation></salutation>
  <company1></company1>
  <company2></company2>
  <company3></company3>
  <company4></company4>
  <department></department>
  <zipcode></zipcode>
  <street></street>
  <street-suffix></street-suffix>
  <street-name></street-name>
  <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>
  <po-box-zipcode></po-box-zipcode>
  <po-box></po-box>
  <po-box-city></po-box-city>
  <major-cust-zip></major-cust-zip>
  <city></city>
  <district></district>
  <region-code></region-code>
  <region-text></region-text>
  <country-code></country-code>
  <country></country>
  <advertisement></advertisement>
  <block-tag></block-tag>
  <eu-sales-tax-number></eu-sales-tax-number>
  <date-of-birth></date-of-birth>
  <bic-master-number></bic-master-number>
  <sector></sector>
  <mobile-phone-number></mobile-phone-number>
  <phone-number>/phone-number>
  <fax-number></fax-number>
  <email-address/></email-address>
  <!-- 0 ... n -->
  <ext-communication>
    <communication-type></communication-type>
    <communication-value></communication-value>
    <communication-default></communication-default>
  </ext-communication>
  <attribute>
    <attribute-type></attribute-type>
    <attribute-value></attribute-value>
  </attribute>
  <holiday-address>
    <valid-from></valid-from>
    <valid-to></valid-to>
    <street></street>
    <street-number></street-number>
    <street-number-suffix></street-number-suffix>
    <zipcode></zipcode>
    <zipcode-extension></zipcode-extension>
    <city></city>
    <district></district>
    <po-box></po-box>
    <po-box-extension></po-box-extension>
    <po-box-zipcode></po-box-zipcode>
    <po-box-city></po-box-zipcode>
    <major-cust-zip></major-cust-zip>      
    <major-cust-zip-extension></major-cust-zip-extension>
    <country-code></country-code>
  </holiday-address>
</business-partner>

Elementdefinition

Feldname	Länge	Typ	Text	Bemerkung, Feldversorgung oder Umschlüsselung
role	2	C	Art des Geschäftspartners	z.B. AG = Auftraggeber, WE = Warenempfänger, RE = Rechnungsempfänger VM = Vermittler
bp-number	10	C	Geschäftspartnernummer
full-salutation	60	C	Montierte persönliche Briefanrede
last-name1	35	C	Nachname 1
last-name2	35	C	Nachname 2
first-name	35	C	Vorname
nick-name	35	C	Rufname
full-last-name	35	C	Montierter Nachname	Inkl. Nachname, Zusatz, Vorsatz
name-addition	30	C	Namenszusatz	Zusatz zum Namen wie z.B. Berufsbezeichnung
job-titel	35	C	Berufs-Bezeichnung für Druck
titel	35	C	Akademischer Titel
salutation-code	2	C	Anrede-Code im AVS/3	z. B. 01 = Herr 02 = Frau
salutation	35	C	Anrede	z.B. Herr, Frau
company1	35	C	Firma 1. Zeile der Firmenadresse.	Falls dieses Feld gefüllt ist, ist der obige Name der Ansprechpartner dieser Firma.
company2	35	C	Firma 2. Zeile der Firmenadresse.	Enthält z.B. Abteilung oder die Fortsetzung des Firmennamens
company3	35	C	Firma 3. Zeile der Firmenadresse.
company4	35	C	Firma 4. Zeile der Firmenadresse.
department	30	C	Abteilung
zipcode	10	C	Postleitzahl zur Straße
street	35	C	Straße mit Hausnummer und Zusatz zur Hausnummer
street-suffix	35	C	Zusatz zur Straße
street-name	40	C	Straßenname
street-number	20	C	Hausnummer
street-number-suffix	20	C	Hausnummer Zusatz
address-line-1	35	C	Adresse Zeile 1 für UK Adressen
address-line-2	35	C	Adresse Zeile 2 für UK Adressen
address-line-3	35	C	Adresse Zeile 3 für UK Adressen
po-box-zipcode	10	C	Postleitzahl zum Postfach	Nur gefüllt bei einer Postfach-Adresse
po-box	35	C	Postfach	Nur gefüllt bei einer Postfach-Adresse
po-box-city	35	C	Ort zum Postfach	Nur gefüllt bei einer Postfach-Adresse
major-cust-zip	10	C	Großkundenpostleitzahl
city	35	C	Ort
district	35	C	Zusatz zum Ort
region-code	3	C		Codetabelle, Inhalt legt Fachbereich fest
region-text	25	C		Region als Klartext (z.B. Bundesland, County…)
country-code	2	C	Länderkennzeichen	Zweistelliges Länderkennzeichen(z.B. 'de' für Deutschland).
country	30	C	Land
advertisement	1	C	Werbung erlaubt	Y = Werbung erwünscht N = Werbung nicht erwünscht
block-tag	1	C	Allgemeine Kundesperre	X = Sperre gesetzt <leer></html> = keine Sperre
eu-sales-tax-number	20	C	EG-UST Identnummer
date-of-birth	10	D	Geburtsdatum (JJJJ-MMTT)
bic-master-number	10	C	Partner-ID des Masters	(z.B. Firma des Ansprechpartners)
sector	10	C	Branche
mobile-phone-number	30	C	Handy-Nr.: Vorwahl + Anschluss
phone-number	30	C	Telefon-Nr.: Vorwahl +Anschluss
fax-number	30	C	Fax-Nr.: Vorwahl + Anschluss
email-address	50	C	IS-M: E-Mailnummer
ext-communication	0 … n
- communication-type	2	C	Wertebereich
- communication-value	50	C	Communication value
- communication-default	1	C	Default value	Y = yes N = no
attribute
- attribute-type	6	C	Funktion des Geschäftspartner Merkmals	z. B. Adressart
- attribute-value	50	C	Wert des Geschäftspartner Merkmals
holiday-address	0 … n
- valid-from	10	C	Gültig von YYYY-MM-DD
- valid-to	10	C	Gültig bis YYYY-MM-DD
- street	35	C	Straßenname
- street-number	10	C	Hausnummer
- street-number-suffix	8	C	Ergänzung zur Hausnummer
- zipcode	10	C	Postleitzahl
- zipcode-extension	4	C	Erweiterung der Postleitzahl
- city	35	C	Ortsname
- district	35	C	Ortsteil
- po-box	35	C	Postfach
- po-box-extension	4	C	Erweiterung zum Postfach
- po-box-zipcode	10	C	Postleitzahl des Postfachs
- po-box-city	35	C	Ort zum Postfach
- major-cust-zip	10	C	Postleitzahl der Firma
- major-cust-zip-extension	4	C	Erweiterung zur Postleitzahl der Firma
- country-code	3	C	Länderschlüssel

Aufbau <order-attribute>

<order-attribute>
  <type> </type>
  <value> </value>
</order-attribute>

Elementdefinition

Feldname	Länge	Typ	Text	Bemerkung, Feldversorgung oder Umschlüsselung
type	6	C	Kennzeichnet die Art des Merkmals
value	50	C	Eigentlicher Merkmalswert