getStockInfoComplete

Liefert die kompletten Bestandsinformationen in Form einer Liste. Diese Form der Abfrage ist nur bei kleinen Artikelbeständen sinnvoll, da die übertragenen Menge sehr groß werden kann.
(Dieser Service geht aufs VIS)

Objekt: /net/dsb/vhs3/StockInfo
Methode: getStockInfoComplete
Version: 1.0.0

Parameter

Name	Typ / Länge	Kann / Muss	Beschreibung
stock-plant	AN / 2	K	0 .. n Werke
from-hit	N / 5	K	Falls die Ergebnismenge eingeschränkt werden soll, dann hier den ersten Treffer angegeben der zurückgeliefert werden soll. Standard ist 1.
max-hit-count	N / 5	K	Anzahl der max. zurückgelieferten Treffer. Default ist alle.

Rückgabe Element

XML Fragment stock-info.(siehe unten)

Beispiel Request

<?xml version="1.0" encoding="UTF-8"?>
<message version="1.0" system="vhs/3" >
  <header>
    <client>4711</client>
    <service-provider>999</service-provider>
  </header>
  <body>
    <!-- 0 .. n -->
    <stock-plant>1</stock-plant>
  </body>
</message>

Beispiel Response

<?xml version="1.0" encoding="UTF-8"?>
<message version="1.0" system="vhs/3">
  <header>
    <client>4711</client>
    <service-provider>999</service-provider>
  </header>
  <body>
    <!-- 0 .. 100 -->
    <stock-info>
    </stock-info>
  </body>
</message>

Response Struktur

Aufbau <stock-info> Version 1

<stock-info>
  <stock-article-number>3AKLOPF</stock-article-number>
  <stock-article-number-external>123</stock-article-number-external>
  <stock-article-description>BAMBI PLUESCH KLOPFER</stock-article-description>
  <stock-article-ean>3AKLOPF</stock-article-ean>
  <stock-available stock-plant="">47</stock-available>
  <stock-available-free stock-plant="">40</stock-available-free>
  <stock-blocked stock-plant=""></stock-blocked>
  <stock-returned stock-plant=""></stock-returned>
  <stock-damaged stock-plant=""></stock-damaged>
  <stock-reserved stock-plant=""></stock-reserved>
  <stock-client></stock-client>
  <stock-plant></stock-plant>
  <stock-available-sum>128</stock-available-sum>
  <stock-available-free-sum>120</stock-available-free-sum>
  <stock-blocked-sum></stock-blocked-sum>
  <stock-returned-sum></stock-returned-sum>
  <stock-damaged-sum></stock-damaged-sum>
  <stock-reserved-sum></stock-reserved-sum>
  <contingent-information>
    <!—- 0 to n -->
    <contingent distribution-channel=””></contingent>
  </contingent-information>
  <!—- 0 to n -->
  <distribution-article>
    <distribution-article-number></distribution-article-number>
    <distribution-article-number-external></distribution-article-number-external >
    <distribution-channel></distribution-channel>
    <delivery-code></delivery-code>
    <product-group></product-group>
    <stock-minimum></stock-minimum>
  </distribution-article>
</stock-info>

Aufbau <stock-info> Version 2 + 3

<stock-info>
  <stock-article-number/>
  <stock-article-number-external/>
  <stock-article-description>BAMBI PLUESCH KLOPFER</stock-article-description>
  <stock-article-ean/>
  <stock-client/>
  <timestamp-of-last-stock-update/>
  <!—- 0 to n -->
  <stock-plant-information>
    <stock-plant-nr>1</stock-plant-nr>
    <stock-available>5</stock-available>
    <stock-available-free>4</stock-available-free>
    <stock-blocked>0</stock-blocked>
    <stock-returned>4</stock-returned>
    <stock-damaged>4</stock-damaged>
    <stock-reserved>1</stock-reserved>
  </stock-plant-information>
  <stock-available-sum>5</stock-available-sum>
  <stock-available-free-sum>4</stock-available-free-sum>
  <stock-blocked-sum>0</stock-blocked-sum>
  <stock-returned-sum>4</stock-returned-sum>
  <stock-damaged-sum>4</stock-damaged-sum>
  <stock-reserved-sum>1</stock-reserved-sum>
  <!—- 0 to n -->
  <distribution-article>
    <distribution-article-number>0000001</distribution-article-number>
    <distribution-article-number-external/>
    <distribution-channel></distribution-channel>
    <delivery-code>F1</delivery-code>
    <product-group>0000</product-group>
    <stock-minimum>0</stock-minimum>
    <!-- erst ab Version 3.0.0 -->
    <stock-reorder-quantity>0</stock-reorder-quantity>
  </distribution-article>
</stock-info>

Elementdefinition

Feld	Länge	Art	Beschreibung
stock-article-number	18	AN	Lager-Artikelnummer
stock-article-number-external	n.a.	AN	Externe Artikelnummer
stock-article-description	30	AN	Lager-Artikelbeschreibung
stock-article-ean	13	AN	International Article Number (früher European Article Number)
stock-client	4	AN	Mandant (ab Service Version 2.0.0)
timestamp-of-last-stock-update	23	AN	Timestamp, des letzten Lagerartikel updates (ab Service Version 2.0.0) Format yyyy-MM-ddThh:MM:ss.S
stock-plant-information 0 … n
- stock-plant-nr	2	AN	Nr. des abgefragten bzw. des Default-Werkes (Ersatz für Attribute 'stock-plant' ab Service Version 2.0.0)
- stock-available	7	N	Bestand Kommissionier-Lager (des im Attribut angegebenen Werks) Dieser Wert entspricht der physikalisch vorhandenen Menge.
- stock-available - Attribute: stock-plant	2	AN	Nr. des abgefragten bzw. des Default-Werkes
- stock-available-free	7	N	Freier Bestand aus dem Kommissionier-Lager (des im Attribut angegebenen Werks) Dies ist ein virtueller Wert und entspricht dem kommissionierbaren Bestand abzüglich Reservierungen
- stock-available-free - Attribute: stock-plant	2	AN	Nr. des abgefragten bzw. des Default-Werkes
- stock-blocked	7	N	Bestand Sperrlager (des im Attribut angegebenen Werks)
- stock-blocked - Attribute: stock-plant	2	AN	Nr. des abgefragten bzw. des Default-Werkes
- stock-returned	7	N	Bestand Retourenlager (des im Attribut angegebenen Werks)
- stock-returned - Attribute: stock-plant	2	AN	Nr. des abgefragten bzw. des Default-Werkes
- stock-damaged	7	N	Bestand Defektenlager (des im Attribut angegebenen Werks)
- stock-damaged - Attribute: stock-plant	2	AN	Nr. des abgefragten bzw. des Default-Werkes
- stock-reserved	7	N	Bestand Reservierungslager (des im Attribut angegebenen Werks) z. B. Aufgrund von Reservierungen oder Rückständen
- stock-reserved - Attribute: stock-plant	2	AN	Nr. des abgefragten bzw. des Default-Werkes
stock-client	4	AN	Mandant
stock-plant	2	AN	Werk
stock-available-sum	7	N	Bestand Kommissionier-Lager (Summe über alle abgefragten Werke)
stock-available-free-sum	7	N	Frei verfügbarer Bestand (Summe über alle abgefragten Werke)
stock-blocked-sum	7	N	Bestand Sperrlager (Summe über alle abgefragten Werke)
stock-returned-sum	7	N	Bestand Retourenlager (Summe über alle abgefragten Werke)
stock-damaged-sum	7	N	Bestand Defektenlager (Summe über alle abgefragten Werke)
stock-reserved-sum	7	N	Bestand Reservierungslager (Summe über alle abgefragten Werke)
contingent-information 0 … n (nur in Version 1.0.0 verfügbar)
- contingent		N	Über Werke kumuliertes contingent für diesen Lagerartikel pro Vertriebssschiene
- contingent - Attribut: distributionchannel	4	AN	Vertriebssschiene
distribution-article 0 … n
- distribution-article-number	18	AN	Vertriebsartikelnummer
- distribution-article-numberexternal	20	AN	externe Vertriebsartikelnummer
- distribution-channel	4	AN	Vertriebsschiene
- delivery-code	4	AN	Lieferkennzeichen
- product-group	4	AN	Produktgruppe
- stock-minimum	9	N	Mindestbestand des Vertriebsartikels
- stock-reorder-quantity	9	N	Nur in Service Version 3.0.0 verfügbar

VIS Feldzuordnungen

XML-Element	Tabelle und Feld im VIS
stock-article-number	M_LAR.LAR_ARTNR
stock-article-description	M_LAR.LAR_BEZ
stock-article-ean	M_LAR.LAR_EAN_NR
stock-available	M_LAR.LAR_BEST_LAG1
stock-available-free	n. a.
stock-blocked	M_LAR.LAR_BEST_LAG2
stock-returned	M_LAR.LAR_BEST_LAG3
stock-damaged	M_LAR.LAR_BEST_LAG4
stock-reserved	M_LAR.LAR_RES_RUECK
stock-client	M_LAR.LAR_CLUSTER
stock-plant	M_LAR.LAR_WERK
stock-available-sum	n. a.
stock-available-free-sum	n. a.
stock-blocked-sum	n. a.
stock-returned-sum	n. a.
stock-damaged-sum	n. a.
stock-reserved-sum	n. a.
contingent-information - contingent	M_KONT.KON_MENGE(kumuliert über alle Werke)
contingent-information - contingent - distribution-channel	M_KONT.KON_VSCHIENE
distribution-article - distribution-article-number	M_VAR.VAR_ARTNR
distribution-article - distribution-article-numberexternal	M_VAR.VAR_ART_NR_EXT
distribution-article - delivery-code	M_VAR.VAR_LKZ_AKT
distribution-article - product-group	M_VAR.VAR_PROD_GRP
distribution-article - distribution-channel	M_VAR.VAR_VSCHIENE
distribution-article - stock-minimum	M_VAR.VAR_MIND_BEST
distribution-article - stock-reorder-quantity	n. a.