PDF Export

getByOrderAttribute (Version 2)

  • Object: /net/dsb/avs3/SubscriptionOrder
  • Method: getByOrderAttribute
  • Version: 2.0.0
  • Fuba: /DSB/ISM_E_SEL_MERKM/

This method sends all subscription orders back which have a particular order attribute. The return can obtain one, several or none subscription orders. Besides it is searched for within active as well as inactive orders.

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-attribute n.a. m XML-Fragment ‚order-attribute‘ see below
publication AN / 8 k Code for the magazine (publication), in search of which should be considered
mix-type AN / 2 k mix type
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.
Otherwise 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'

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-attribute>
      <type>EXTKEY</type>
      <value>1234567890</value>
    </order-attribute>
    <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>

Request Structure

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