PDF Export

getByBpNumber (Version 2)

  • Objekt: /net/dsb/avs3/SubscriptionOrder
  • Methode: getByBpNumber
  • Version: 2.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.

Für die zurückgelieferten Geschäftspartner gelten folgende Regeln:

GP-Rolle In Response enthalten … Adresse zum Zeitpunkt …
WE = Warenempfänger immer - Adresse zum letzten Versand (default)
- aktuelle Adresse, wenn über Parameter
„return-current-we-address“ angefordert
AG = Auftraggeber nur wenn über Parameter „send-orderer „angefordert aktuelle Adresse
RE = Rechnungsempfängernur wenn über Parameter „send-invoice-recipient“ angefordertAdresse zum letzten Versand

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 / Muss Beschreibung
bp-number AN / 10 m Geschäftspartner Nummer
role-ag AN / 1 k 'Y' / 'N'. Soll der Auftraggeber zu den Abos im Ergebnis geliefert werden?
role-re AN / 1 k 'Y' / 'N'. Soll der Rechnungsempfänger zu den Abos im Ergebnis geliefert werden?
role-vm AN / 1 k 'Y' / 'N'. Soll der Vermittlerzu den Abos im Ergebnis geliefert werden?
role-we AN / 1 k 'Y' / 'N'. Soll der Warenempfängerzu den Abos im Ergebnis geliefert werden?
publication AN / 8 k Kennung für die Zeitschrift (Druckerzeugnis), welche beider Suche berücksichtigt werden sollen.
mix-type AN / 2 k Bezugstyp
send-invoice-recipient AN / 1 k ‚Y‘ eintragen, falls auch zum Warenempfänger abweichende Rechnungsempfänger zurückgegeben werden sollen. ‚N‘ wenn nicht
send-orderer AN / 1 k ‚Y‘ eintragen, falls auch zum Warenempfänger abweichende Auftraggeber zurückgegeben werden sollen. ‚N‘ wenn nicht
return-current-we-addressAN / 1 k Legt fest ob beim WE die tagesaktuelle Adresse gelesen werden soll. Ansonsten wird die Adresse die zum Zeitpunkt des letzten Versandes gültig war verwendet.
Y = ja
N = nein (Default)
return-valid-to-by-evt AN / 1 k Legt fest ob das Lieferende im Response anhand des EVT bestimmt werden soll.
Y = ja
N = nein (Default)
only-active-subscription AN / 1 k Bestimmt, ob nur die aktiven Abos abgerufen werden, oder auch die inaktiven.
Y = ja (Default)
N = nein

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>
    <role-ag>Y</role-ag>
    <role-re>Y</role-re>
    <role-vm>Y</role-vm>
    <role-we>Y</role-we>
    <return-current-we-address>N</return-current-we-address>
    <return-valid-to-by-evt>N</return-valid-to-by-evt>
    <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