PDF Export

getByBpNumber (Version 3)

  • Objekt: /net/dsb/avs3/SubscriptionOrder
  • Methode: getByBpNumber
  • Version: 3.0.0
  • Fuba: /DSB/ISM_E_SEL_VBELN_TO_GP

Diese Methode liefert alle Abo-Aufträge anhand einer übergebenen Geschäftspartnernummer zurück. Es werden alle Aufträge geliefert, in denen der Geschäftspartner jemals in einer Rolle referenziert wurde. Also auch solche, die den Geschäftspartner in der Vergangenheit beinhalten. Sie müssen die Aufträge im Ergebnis prüfen und filtern, falls Sie nur Aufträge verarbeiten wollen, die den Geschäftspartner aktuell beinhalten.

Die Rückgabe kann keinen, einen oder mehrere Abo-Aufträge enthalten. Je nachdem wie only-active-subscription bestückt ist, wird sowohl innerhalb der aktiven als auch der inaktiven Aufträge gesucht.

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ängeKann / MussBeschreibung
bp-number AN / 10 m Geschäftspartner Nummer (1…10)
mix-type AN / 2 k Bezugstyp
from-hit N k Falls die Ergebnismenge eingeschränkt werden soll, dann hier den ersten Treffer angegeben der zurückgeliefert werden soll. Default ist 0.
max-hit-count N / 4 k Anzahl der maximal zurückgelieferten Treffer(1-100) , Default: 100
only-active-subscription AN / 1 k 'Y' wenn nur aktive Abos gefunden werden sollen(default), 'N' wenn alle zurückkommen sollen.

zusätzliche allgemeine Selektionsparameter:

Name Typ / LängeKann / MussBeschreibung
publication AN / 8 k Kennung für die Zeitschrift (Druckerzeugnis), welche beider Suche berücksichtigt werden sollen.
return-address-type AN / 2 k Hier können die zurückzuliefernden Rollen angegeben werden (AG, WE, VM, RE). Dieser Parameter kann mehrmals vorkommen.
return-address-at-time AN / 2 m 'L' = Adresse zum letzten Versandtermin
'A' = aktuelle Adresse
'Z' = Adresse zum zukuenftigen Versandtermin
return-extended-communication-dataAN /1 k Erweiterte Kommunikationsstruktur zurückgeben ( Y / N (Default) )
return-renewal-payment-data AN / 1 k Rückgabe zusätzlicher Renewal Zahlungsdaten ( Y / N (Default) )
return-renewal-issue-remaining AN / 1 k Rückgabe noch zu liefernde Ausgaben für das ganze Abo ( Y / N (Default) )
return-current-suspension-data AN / 1 k Rückgabe zusätzlicher Daten für Unterbrechung (aktuelle). Falls es keine aktuelle Unterbrechung gibt, wird die nächste geliefert. ( Y / N (Default) )
return-extended-premium-data AN / 1 k Rückgabe zusätzlicher Prämien Daten ( Y / N (Default) )
return-valid-to-by-erschdat BETA AN / 1 k BETA im Moment nur im getByOrderNumber-3.0.0 Service aktiv
Legt fest ob das Lieferende im Response anhand des ERSCHDAT bestimmt werden soll.
Y = ja
N = nein (Default)
return-strict-db-fields BETA AN / 1 k BETA im Moment nur im 3.0.0er Service aktiv
Y/N=default bei leer oder N ist das Standardverhalten aktiv. Bei Y wird ein 1:1 mapping der NAME1-4 Felder ohne Logik aktiv.
return-holiday-addresses BETA AN / 1 k BETA im Moment nur im 3.0.0er Service aktiv
Rückgabe zusätzlicher Urlaubsadressen ( Y / N (Default) )

Rückgabe Element

XML-Struktur 'subscription-order'. Diese Struktur entspricht der Beschreibung von 'new-subscription', 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>
    <bp-number>1003701415</bp-number>
    <publication></publication>
    <mix-type></mix-type>
    <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>
    <from-hit>100</from-hit>
    <max-hit-count>100</max-hit-count>
    <only-active-subscription>N</only-active-subscription>
  </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>
    <subscription-order>
      ...
    </subscription-order>
  </body>
</message>

Response Struktur

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. Weitere Information