pixiGetStockBinsEmpty

Liefert leere Lagerplätze (ohne Lagerplatzbestand-Datensatz), optional nur die in der Sortierung nahe an einem Referenz-Lagerplatz liegenden.

Sucht leere Lagerplätze. Ein Lagerplatz gilt als leer, wenn keine Zeile in InvBinItem auf ihn verweist (BinRef = BinKey).

1. Werden BinName und LocID übergeben, wird der Schlüssel des Lagerplatzes mit diesem Namen in diesem Lager ermittelt und als Referenz-Lagerplatz (NearBinKey) verwendet. Existiert kein solcher Lagerplatz, bleibt ein übergebener NearBinKey unverändert.
2. LocID leer oder NULL bedeutet alle Lager; andernfalls werden nur Lagerplätze dieses Lagers (BinLocID) berücksichtigt.
3. Ohne Referenz-Lagerplatz (NearBinKey ist NULL oder 0): Liefert die ersten Rows leeren Lagerplätze, aufsteigend nach BinSortNum sortiert.
4. Mit Referenz-Lagerplatz: Ermittelt die BinSortNum des Referenz-Lagerplatzes und liefert bis zu Rows / 2 (Ganzzahldivision) leere Lagerplätze mit BinSortNum kleiner oder gleich der Referenz (die nächstgelegenen, also die höchsten Sortiernummern darunter) sowie bis zu Rows / 2 leere Lagerplätze mit höherer BinSortNum (die nächstgelegenen darüber). Die Gesamtliste wird aufsteigend nach BinSortNum sortiert.

Der Referenz-Lagerplatz selbst ist im Ergebnis enthalten, wenn er leer ist und zum Lagerfilter passt.

Parameter

Antwort

Result-Set 1 · Wenn kein Referenz-Lagerplatz gesetzt ist (NearBinKey ist nach der optionalen Suche über BinName NULL oder 0)

Die ersten Rows leeren Lagerplätze, aufsteigend nach BinSortNum sortiert.

Result-Set 2 · Wenn ein Referenz-Lagerplatz gesetzt ist (NearBinKey nicht NULL/0)

Bis zu Rows / 2 leere Lagerplätze an oder unterhalb und bis zu Rows / 2 oberhalb der Referenz-Sortiernummer, aufsteigend nach BinSortNum sortiert.

<SqlRowSet1>
  <row>
    <BinSortNum>1020</BinSortNum>
    <BinLocID>001</BinLocID>
    <BinName>A-01-02</BinName>
    <BinKey>4711</BinKey>
    <BinGroup>REGAL</BinGroup>
  </row>
  <row>
    <BinSortNum>1030</BinSortNum>
    <BinLocID>001</BinLocID>
    <BinName>A-01-03</BinName>
    <BinKey>4712</BinKey>
    <BinGroup>REGAL</BinGroup>
  </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:pixiGetStockBinsEmpty>
      <!-- <LocID>001</LocID> -->
      <!-- <Rows>10</Rows> -->
      <!-- <NearBinKey>4711</NearBinKey> -->
      <!-- <BinName>A-01-02</BinName> -->
    </ns1:pixiGetStockBinsEmpty>
  </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:pixiGetStockBinsEmpty>
      <!-- <LocID>001</LocID> -->
      <!-- <Rows>10</Rows> -->
      <!-- <NearBinKey>4711</NearBinKey> -->
      <!-- <BinName>A-01-02</BinName> -->
    </ns1:pixiGetStockBinsEmpty>
  </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 = [
    // 'LocID' => '001',
    // 'Rows' => '10',
    // 'NearBinKey' => '4711',
    // 'BinName' => 'A-01-02',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiGetStockBinsEmpty

Prozedur zuletzt geändert am 2026-10-05

Dokumentation von claude-opus-5-5 am 2026-10-30 geschrieben