getIssuesByOrderNumber

Objekt: /net/dsb/avs3/SubscriptionOrder
Methode: getIssuesByOrderNumber
Version: 2.0.0
Fuba: /DSB/ISM_E_GET_VA_AUFTR

Liefert die zukünftigen Vertriebsausgaben(VA) zu der übergebenen Auftragsnummer und dem angegebenen Filter bis zum angegebenen Enddatum.

Filter	Regel
A	Es werden alle Vertriebsausgaben bis zum gesetzten Enddatum zurückgeliefert
E	Abhängig davon, ob es ein Renewal (REN) oder „normales“ Abo(ABO/ABOS) ist, werden beim Ersteren diejenigen zurückgeliefert, bei denen X_IN_EXPIRY_PERIOD = true(X) ist. Beim Abo werden nur jene zurückgeliefert, bei denen X_IN_DELIVERY_PERIOD = true(X)ist, bis zum angegebenen Enddatum
C	Es werden nur diejenigen Vertriebsausgaben zurückgeliefert, die berechnet sind, bis zum angegebenen Enddatum
P	Es werden nur diejenigen Vertriebsausgaben zurückgeliefert, die bezahlt sind, bis zum angegebenen Enddatum

Parameter

Name	Typ / Länge	Kann / Muss	Beschreibung
order-number	AN / 10	M	Auftragsnummer
date-to	AN / 10	M	End Datum im Format YYYY-MM-DD
date-type	AN / 1	-	Worauf bezieht sich das Datumsfeld? 1: Erstverkaufstag / EVT 2: Versanddatum (noch nicht implementiert) 3: Erscheinungsdatum (default)
filter	AN / 1	M	A → All, E → Expiry, C → Calculated, P → Payed

Rückgabe Element

issue-result Element siehe Abschnitt unten

Beispiel Request

<?xml version="1.0" encoding="UTF-8"?>
<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>123</order-number>
    <date-to>2011-10-02</date-to>
    <filter>A</filter>
  </body>
</message>

Beispiel Response

<?xml version="1.0" encoding="UTF-8"?>
<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>
   <issue-result>
    ...
    </issue-result>
  </body>
</message>

Response Struktur

Aufbau <issue-result>

<issue-result>
    <order-type>ABO</order-type>
    <!-- 0 ... n -->
    <issue-details>
    …
    </issue-details>
</issue-result>

Elementdefinition

Feldname	Länge	Typ	Bemerkung, Feldversorgung oder Umschlüsselung
order-type		C	Auftragsart (REN, ABO, ABOS)
issue-details			0 … n siehe unten

Aufbau <issue-details>

<!-- 0 ... n -->
<issue-details>
    <issue>0000000815</issue>
    <publication>00000001</publication>
    <edition>00000001</edition>
    <date-of-publication>2010-07-16</date-of-publication>
    <year-of-issue>2010</year-of-issue>
    <issue-number-in-year>0028</issue-number-in-year>
    <issue-number>00000815</issue-number>
    <distribution-article-number></distribution-article-number>
    <mix-type></mix-type>
    <ean></ean>
    <date-of-first-sale>2010-07-16</date-of-first-sale>
    <date-of-first-shipping>2010-07-22</date-of-first-shipping>
    <description></description>
    <is-payed>false</is-payed>
    <is-calculated>false</is-calculated>
    <is-in-expiry-period>true</is-in-expiry-period>
</issue-details>

Elementdefinition

Feldname	Länge	Typ	Bemerkung, Feldversorgung oder Umschlüsselung
- issue	10	C	Vertriebsausgabe
- publication	8	C	Druckerzeugnis
- edition	8	C	Planvertriebsausgabe
- date-of-publication	10	D	Erscheinungsdatum im Format YYYY-MM-DD
- year-of-issue	4	C	Jahrgang der Ausgabe Format YYYY
- issue-numberin-year	4	C	Ausgabennummer (innerhalb des Jahrgangs)
- issue-number	9	C	Heftnummer der Vertriebsausgabe im Standard Format HHHH/YYYY oder mandantespezifisches Format/Freitext.
- distribution-article-number	13	C	Vertriebsartikel Nummer nicht im subscription basierenden Response enthalten
- mix-type	2	C	Bezugstyp
- ean	18	D	Europäische Artikelnummer der Vertriebsausgabe
- date-of-first-sale	10	D	Erstverkaufstag im Format YYYY-MM-DD
- date-of-firstshipping	10	D	Erstversandtag im Format YYYY-MM-DD
- description	50	C	VA Beschreibung
- is-payed		B	Ausgabe bezahlt
- is-calculated		B	Ausgabe berechnet
- is-in-expiry-period		B	Ausgabe innerhalb des Gültigkeitsbereich