PDF Export

getByOrderNumber (Version 2)

  • Object: /net/dsb/avs3/SubscriptionOrder
  • Method: getByOrderNumber
  • Version: 2.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.

The returned business-partners match to the following rules:

BP-Role Contained in response … Address point in time …
WE = consignee (goods rescipient) always - address at the time of last shipment (default)
- current address, if parameter
“return-current-we-address” is set to Y
AG = orderer only if parameter “send-orderer ” is set to Ycurrent address
RE = invoice recipient only if parameter “send-invoice-recipient” is set to Yaddress at the time of last shipment

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

NameType / max. lengthmandatory?Description
order-number AN / 10 m Abo-Auftragsnummer(n) (1..n)
publication AN / 8 k Filter for publication
send-invoice-recipient AN / 1 k ‚Y‘ enter, in case if also the consignee should receive drifted receipt of invoice ‚N‘ if not
send-orderer AN / 1 k ‚Y‘ enter, if also drifted orders have to be sent back to the consignee ‚N‘ if not
return-current-we-addressAN / 1 k Specifies, wether the current address of the business-partner in role WE should be returned. othterwise the address of the last inital shipment date (EVT) is returned.
Y = Yes
N = No (default)
return-valid-to-by-evtAN / 1 k Specifies, wether the valid-to value should be determined by the inital shipment date (EVT).
Y = Yes
N = No (default)

Response Element

XML-Structure 'subscription-order'. This structure meet the description of 'newsubscription', see below.

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>
    <send-invoice-recipient></send-invoice-recipient>
    <send-orderer></send-orderer>
  </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