Stock Lesen

pixiGetStockMovementForOrderline

Liefert alle Lagerbewegungen (Einträge des Lagerplatz-Artikel-Protokolls), die für eine Auftragsposition gebucht wurden, samt zugehörigem Lagerplatz.

Liest das Lagerbewegungsprotokoll InvBinItemLog und liefert jeden Eintrag, dessen ForOrderline dem Wert von OrderlineKey entspricht.

Jeder Protokolleintrag wird über die Lagerplatzreferenz (BinKey = BinRef) mit der Lagerplatztabelle InvBin verknüpft. Es handelt sich um einen Inner Join, daher werden Einträge, deren Lagerplatz in InvBin nicht mehr existiert, nicht geliefert.
Pro Bewegung werden Menge, Artikelreferenz, Mitarbeiter und Datum der Buchung, der Grund sowie die Lagerplatzdaten (BinKey, LocID, BinName) zurückgegeben.
Eine Sortierung ist nicht festgelegt; die Zeilen kommen in der Reihenfolge, die SQL Server liefert.
Es gibt kein Paging; alle passenden Zeilen werden geliefert.

Hinweise

Existiert für die Auftragsposition keine Bewegung (oder der Schlüssel existiert nicht), wird eine leere Ergebnismenge geliefert; es wird kein Fehler ausgelöst.
Der Kopfkommentar der Prozedur ist ein allgemeiner Vorlagentext und beschreibt diesen Aufruf nicht.
Die Abfrage verwendet keine NOLOCK-Hinweise. Die Spaltentypen sind im Code nicht deklariert und hängen von den Tabellendefinitionen von InvBinItemLog und InvBin ab.
Die Vorzeichenkonvention von Qty (z. B. negativ bei Abgängen) ist im Code nicht ersichtlich.

Parameter

Parameter	Typ	Standardwert	Beschreibung
`OrderlineKey` Pflicht	int	–	Schlüssel der Auftragsposition, deren Lagerbewegungen geliefert werden. Wird mit `InvBinItemLog.ForOrderline` verglichen. Beispiel: `123456`

Antwort

Result-Set 1 · Immer (kann leer sein)

Eine Zeile pro Lagerbewegungs-Protokolleintrag, der für die Auftragsposition gebucht wurde.

Spalte	Typ	Beschreibung
`Qty` Kann leer sein	int	Menge der Lagerbewegung.
`ItemRef` Kann leer sein	int	Referenz auf den bewegten Artikel.
`UpdateEmp` Kann leer sein	string	Mitarbeiter, der die Bewegung gebucht hat (aus `InvBinItemLog`).
`UpdateDate` Kann leer sein	dateTime	Datum und Uhrzeit des Bewegungseintrags (aus `InvBinItemLog`).
`ForOrderline` Kann leer sein	int	Auftragsposition, für die die Bewegung gebucht wurde; entspricht immer `OrderlineKey`.
`Reason` Kann leer sein	string	Grund der Lagerbewegung laut Protokoll.
`BinKey`	int	Schlüssel des Lagerplatzes, auf den sich die Bewegung bezieht.
`LocID` Kann leer sein	string	Lager-ID (Location) des Lagerplatzes.
`BinName` Kann leer sein	string	Name des Lagerplatzes.

Beispielantwort

<SqlRowSet1>
  <row>
    <Qty>-2</Qty>
    <ItemRef>4711</ItemRef>
    <UpdateEmp>JD</UpdateEmp>
    <UpdateDate>2024-03-12T10:15:32.000</UpdateDate>
    <ForOrderline>123456</ForOrderline>
    <Reason>PICK</Reason>
    <BinKey>812</BinKey>
    <LocID>001</LocID>
    <BinName>A-01-03</BinName>
  </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:pixiGetStockMovementForOrderline>
      <OrderlineKey>123456</OrderlineKey>
    </ns1:pixiGetStockMovementForOrderline>
  </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:pixiGetStockMovementForOrderline>
      <OrderlineKey>123456</OrderlineKey>
    </ns1:pixiGetStockMovementForOrderline>
  </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 = [
    'OrderlineKey' => '123456',
];

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

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

Verwendete Tabellen

InvBinItemLog · Lesen InvBin · Lesen

SQL-Objekt:: dbo.pipiGetStockMovementForOrderline