Stock Lesen

pixiGetItemLogisticsStock

Liefert den gesamten Lagerplatzbestand eines Artikels an einem Standort und die nach Abzug offener FUT-Auftragspositionen noch verfügbare Menge.

Berechnet den Bestand eines einzelnen Artikels für Direct-Fulfillment-Zwecke (DF), laut Code-Kommentar Bestand auf Basis offener DF-Aufträge.

Ablauf:

Summiert BinItemQty aller Lagerplatzeinträge in InvBinItem für den Artikel @ItemKey, deren Lagerplatz (InvBin) zum Standort @Location (BinLocId) gehört. Diese Summe wird als TotalQty zurückgegeben (0, wenn keine passenden Lagerplätze existieren).
Summiert Qty aller Auftragspositionen in Orderlines für den Artikel, die
- den Status FUT haben,
- Qty > 0 haben und
- keinen Eintrag in OrderHistory mit Status FUT und ClientNotified = 'N' besitzen.
Liefert TotalQty abzüglich dieser Positionssumme als FulfillmentAvailableQty sowie den übergebenen @Location.

Der Aufruf liefert immer genau eine Zeile, da ohne Gruppierung aggregiert wird.

Hinweise

Wird @Location weggelassen (NULL), trifft der Vergleich BinLocId = NULL nie zu; TotalQty ist dann immer 0 und FulfillmentAvailableQty 0 oder negativ. Es sollte daher immer ein Standort übergeben werden.
Die Menge offener Auftragspositionen wird nicht nach Standort gefiltert: FUT-Positionen aller Standorte werden vom Bestand des angegebenen Standorts abgezogen.
FulfillmentAvailableQty kann negativ werden, wenn die offenen FUT-Mengen den Lagerplatzbestand übersteigen.
Ein unbekannter @ItemKey erzeugt keinen Fehler; es wird eine Zeile mit Werten 0 geliefert.
Alle Tabellen werden mit NOLOCK gelesen, das Ergebnis kann daher nicht festgeschriebene Daten enthalten.

Parameter

Parameter	Typ	Standardwert	Beschreibung
`ItemKey` Pflicht	int	–	Interner Schlüssel des Artikels, dessen Bestand berechnet wird (Abgleich mit `InvBinItem.BinItemRef` und `Orderlines.ItemRef`). Beispiel: `10452`
`Location`	char(3) string	NULL	Standortkürzel (`InvBin.BinLocId`), dessen Lagerplätze summiert werden. Wird im Ergebnis zurückgegeben. Bei NULL passt kein Lagerplatz und der Bestand ist 0. Beispiel: `001`

Antwort

Result-Set 1 · Immer (genau eine Zeile)

Bestandswerte des Artikels am angefragten Standort.

Spalte	Typ	Beschreibung
`FulfillmentAvailableQty`	int	Lagerplatzbestand am Standort abzüglich der Menge offener FUT-Auftragspositionen des Artikels (alle Standorte). Kann negativ sein.
`TotalQty`	int	Summe von `BinItemQty` aller Lagerplätze des Artikels am Standort; 0, wenn keine vorhanden.
`Location` Kann leer sein	char(3) string	Der in `@Location` übergebene Standort.

Beispielantwort

<SqlRowSet1>
  <row>
    <FulfillmentAvailableQty>37</FulfillmentAvailableQty>
    <TotalQty>45</TotalQty>
    <Location>001</Location>
  </row>
</SqlRowSet1>

Beispiele

POST https://apigateway.descartes.com/tms/pixi/
Content-Type: text/xml; charset=utf-8
Authorization: Basic BASE64(USERNAME:PASSWORD)

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="https://apigateway.descartes.com/tms/pixi/">
  <SOAP-ENV:Body>
    <ns1:pixiGetItemLogisticsStock>
      <ItemKey>10452</ItemKey>
      <!-- <Location>001</Location> -->
    </ns1:pixiGetItemLogisticsStock>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

curl -X POST 'https://apigateway.descartes.com/tms/pixi/' \
  --user 'USERNAME:PASSWORD' \
  --header 'Content-Type: text/xml; charset=utf-8' \
  --data-binary @- <<'XML'
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="https://apigateway.descartes.com/tms/pixi/">
  <SOAP-ENV:Body>
    <ns1:pixiGetItemLogisticsStock>
      <ItemKey>10452</ItemKey>
      <!-- <Location>001</Location> -->
    </ns1:pixiGetItemLogisticsStock>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
XML

<?php

$soapClient = new SoapClient(null, [
    'login' => 'USERNAME',
    'password' => 'PASSWORD',
    'location' => 'https://apigateway.descartes.com/tms/pixi/',
    'uri' => 'https://apigateway.descartes.com/tms/pixi/',
]);

$arguments = [
    'ItemKey' => '10452',
    // 'Location' => '001',
];

$soapArguments = [];
foreach ($arguments as $name => $value) {
    $soapArguments[] = new SoapVar($value, XSD_STRING, '', '', $name);
}

$response = $soapClient->__soapCall('pixiGetItemLogisticsStock', $soapArguments);

Verwendete Tabellen

InvBinItem · Lesen InvBin · Lesen Orderlines · Lesen OrderHistory · Lesen

SQL-Objekt:: dbo.pipiGetItemLogisticsStock