Stock Lesen

pixiGetItemsOnStockBin

Liefert die Artikel auf einem Lagerplatz oder einer Lagerplatzgruppe mit Bestand, Charge und Mindesthaltbarkeitsdatum.

Listet den Lagerplatzbestand (InvBinItem) eines Lagerplatzes oder aller Lagerplätze einer Lagerplatzgruppe zusammen mit den Artikelstammdaten auf.

Leere Zeichenketten in BinName, LocID und BinGroup werden wie NULL behandelt.
Mindestens einer der Parameter BinName oder BinGroup muss gesetzt sein. Sind beide leer, liefert der Aufruf eine leere Ergebnismenge.
BinName filtert auf den exakten Lagerplatznamen, BinGroup auf die exakte Lagerplatzgruppe, LocID beschränkt die Lagerplätze auf ein Lager. Alle gesetzten Filter werden mit UND verknüpft.
Die interne Artikelnummer in InternalItemNumber stammt aus den Artikelcodes mit Codetyp 3. Sie ist leer, wenn der Artikel keinen solchen Code hat.

Der Parameter GroupItems steuert die Gruppierung:

0 (Standard): eine Zeile je Artikel, Lagerplatz, Charge, Mindesthaltbarkeitsdatum und Änderungsdatum des Lagerplatzbestands. Sortierung aufsteigend nach UpdateDate.
1: eine Zeile je Artikel, Lagerplatz, Charge und Mindesthaltbarkeitsdatum. Die Mengen werden summiert, UpdateDate enthält das jüngste Änderungsdatum. Sortierung aufsteigend nach diesem Datum.

StockLevel ist die Summe der Lagerplatzmengen innerhalb jeder Gruppe.

Hinweise

Alle Tabellen werden mit NOLOCK gelesen; das Ergebnis kann daher nicht festgeschriebene Daten enthalten.
Bei GroupItems = 0 kann derselbe Artikel auf demselben Lagerplatz mehrfach erscheinen, wenn seine Lagerplatzbestände unterschiedliche Änderungsdaten haben. Für eine Zeile je Artikel, Lagerplatz, Charge und Mindesthaltbarkeitsdatum GroupItems = 1 verwenden.
Hat ein Artikel mehrere Artikelcodes vom Typ 3, erscheint er einmal je Code.
Wird nur BinName ohne LocID übergeben, werden gleichnamige Lagerplätze aller Lager geliefert. Das Lager ist nicht Teil der Ausgabe; daher LocID angeben, wenn Lagerplatznamen nicht lagerübergreifend eindeutig sind.
Jeder Wert von GroupItems ungleich 0 wirkt wie 1.

Parameter

Parameter	Typ	Standardwert	Beschreibung
`BinName`	varchar(50) string	NULL	Exakter Name des Lagerplatzes. Eine leere Zeichenkette wird wie NULL behandelt. Dieser Parameter oder `BinGroup` muss gesetzt sein. Beispiel: `A-01-03`
`LocID`	varchar(3) string	NULL	Lagerkennung; beschränkt die Lagerplätze auf dieses Lager. Leer oder NULL bedeutet alle Lager. Beispiel: `001`
`GroupItems`	bit boolean	0	Steuert, ob Lagerplatzbestände mit unterschiedlichem Änderungsdatum zu einer Zeile zusammengefasst werden. Erlaubte Werte `0` – Eine Zeile je Artikel, Lagerplatz, Charge, Mindesthaltbarkeitsdatum und Änderungsdatum; sortiert nach Änderungsdatum. `1` – Eine Zeile je Artikel, Lagerplatz, Charge und Mindesthaltbarkeitsdatum mit dem jüngsten Änderungsdatum; danach sortiert. Beispiel: `1`
`BinGroup`	varchar(20) string	NULL	Exakte Lagerplatzgruppe; liefert die Artikel aller Lagerplätze dieser Gruppe. Eine leere Zeichenkette wird wie NULL behandelt. Dieser Parameter oder `BinName` muss gesetzt sein. Beispiel: `PICK`

Antwort

Result-Set 1 · Immer; leer, wenn weder `BinName` noch `BinGroup` gesetzt ist oder nichts passt.

Artikel mit ihrem Bestand auf den gewählten Lagerplätzen, aufsteigend sortiert nach Änderungsdatum.

Spalte	Typ	Beschreibung
`ItemKey`	int	Interner Schlüssel des Artikels.
`EANUPC` Kann leer sein	string	EAN/UPC des Artikels.
`ItemNRInt` Kann leer sein	string	Interne Artikelnummer aus dem Artikelstamm.
`ItemNrSuppl` Kann leer sein	string	Artikelnummer des Lieferanten.
`StockLevel` Kann leer sein	int	Summe der Lagerplatzmengen dieser Gruppe.
`UpdateDate` Kann leer sein	datetime dateTime	Änderungsdatum des Lagerplatzbestands; bei `GroupItems = 1` das jüngste.
`ItemName` Kann leer sein	string	Bezeichnung des Artikels.
`InternalItemNumber` Kann leer sein	string	Artikelcode vom Codetyp 3; NULL, wenn keiner vorhanden ist.
`BinGroup` Kann leer sein	varchar(20) string	Lagerplatzgruppe des Lagerplatzes.
`BinName` Kann leer sein	varchar(50) string	Name des Lagerplatzes.
`BatchNumber` Kann leer sein	string	Charge des Lagerplatzbestands.
`BestBeforeDate` Kann leer sein	datetime dateTime	Mindesthaltbarkeitsdatum des Lagerplatzbestands.

Beispielantwort

<SqlRowSet1>
  <row>
    <ItemKey>10452</ItemKey>
    <EANUPC>4006381333931</EANUPC>
    <ItemNRInt>ART-10452</ItemNRInt>
    <ItemNrSuppl>SUP-7781</ItemNrSuppl>
    <StockLevel>24</StockLevel>
    <UpdateDate>2024-03-12T09:41:00</UpdateDate>
    <ItemName>Kugelschreiber blau</ItemName>
    <InternalItemNumber>INT-10452</InternalItemNumber>
    <BinGroup>PICK</BinGroup>
    <BinName>A-01-03</BinName>
    <BatchNumber>CH2024-03</BatchNumber>
    <BestBeforeDate>2026-03-31T00:00:00</BestBeforeDate>
  </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:pixiGetItemsOnStockBin>
      <!-- <BinName>A-01-03</BinName> -->
      <!-- <LocID>001</LocID> -->
      <!-- <GroupItems>1</GroupItems> -->
      <!-- <BinGroup>PICK</BinGroup> -->
    </ns1:pixiGetItemsOnStockBin>
  </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:pixiGetItemsOnStockBin>
      <!-- <BinName>A-01-03</BinName> -->
      <!-- <LocID>001</LocID> -->
      <!-- <GroupItems>1</GroupItems> -->
      <!-- <BinGroup>PICK</BinGroup> -->
    </ns1:pixiGetItemsOnStockBin>
  </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 = [
    // 'BinName' => 'A-01-03',
    // 'LocID' => '001',
    // 'GroupItems' => '1',
    // 'BinGroup' => 'PICK',
];

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

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

Verwendete Tabellen

InvBinItem · Lesen items · Lesen InvBin · Lesen ItemCode · Lesen

SQL-Objekt:: dbo.pipiGetItemsOnStockBin