PDF Export

getByOrderNumber (Version 3)

  • Object: /net/dsb/avs3/SubscriptionOrder
  • Method: getByOrderNumber
  • Version: 3.0.0
  • Fuba: /DSB/ISM_E_SEL_VBELN/

This method returns all subscription orders referenced by the given AVS/3 order numbers. Zero, one or more subscription orders may be returned. These can be both active and inactive. If no 'return-addresstype' is in the request, the 'WE' is sent back as default.

Important hint:

It is possible to customize which attributes (order or business-partner) are returned in the response. This is maintained in the customizing table /DSB/JET_MERK_RE or /DSB/JET_MERK_GP in AVS/3. Please get in touch with customer service if you would like to add additional values. All values are returned if the wildcard (*) is set.

Parameter

Name Type / Length Mandatory? Description
order-number AN / 10 y Subscription order number(n) (1..n)

Additional common selection parameter:

Name Type / max. length mandatory? Description
publication AN / 8 n Code for the magazine (publication), which should be observed in search of
return-address-type AN / 2 n Define which role will be available in the response (AG, WE, VM, RE)
return-address-at-time AN / 2 y 'L' = Address at last shipment date
'A' = active address
'Z' = Address at future shipment date
return-extended-communication-dataAN /1 n return extended communication data ( Y / N (Default) )
return-renewal-payment-data AN / 1 n Return additional renewal payment data ( Y / N (Default) )
return-renewal-issue-remaining AN / 1 n Y = Yes Return remaining isssues regarding the current cycle Otherwise return remaining issues regarding the whole subscription
return-current-suspension-data AN / 1 n Return additional data of the current suspension. If there is no current suspension the next in time is returned. ( Y / N (Default) )
return-extended-premium-data AN / 1 n Return extended premium data ( Y / N (Default) )
return-holiday-addresses BETA AN / 1 k BETA
Returns additional holiday addresses ( Y / N (Default) )

Response Element

XML-Structure 'subscription-order'.

Example 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>
    <order-number></order-number>
    <publication></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>

Example 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 Structure

This website uses cookies for visitor traffic analysis. By using the website, you agree with storing the cookies on your computer.More information