pixiBinUpdate

Aktualisiert einen oder mehrere bestehende Lagerplätze aus einer XML-Liste und liefert je Lagerplatz eine Statuszeile.

Aktualisiert bestehende Lagerplätze in InvBin. Lagerplätze werden über BinKey identifiziert; neue Lagerplätze werden nicht angelegt.

1. Ist BinsXML leer oder nicht als XML lesbar, wird eine einzelne ERROR-Zeile geliefert und nichts geändert.
2. Jedes Element /Bins/Bin wird gelesen: BinKey, Name, LocId, Group, SortNr, MaxItems, TransportBin.
3. Jeder Lagerplatz wird geprüft. Ein Lagerplatz, der eine Prüfung nicht besteht, erhält Status = ERROR und eine Meldung und wird übersprungen. Die erste fehlgeschlagene Prüfung gilt. Die Prüfungen sind:
   • BinKey fehlt oder ist 0.
   • SortNr oder MaxItems ist keine ganze Zahl oder ist negativ.
   • LocId weicht vom aktuellen Lager ab und der Lagerplatz hat noch Bestand (InvBinItem).
   • Der resultierende Name existiert bereits bei einem anderen Lagerplatz:
     • im selben Lager, immer geprüft;
     • in einem anderen Lager, nur geprüft, wenn die Einstellung FilterStockOperationsWithLocation den Wert 0 hat;
     • bei übergebenem TransportBin = 1 unter allen Transportlagerplätzen.
   • Die angegebene LocId existiert nicht in Location.
   • Es gibt keinen Lagerplatz mit diesem BinKey.
4. Alle gültigen Lagerplätze werden in einer Transaktion aktualisiert. Nicht übergebene Elemente behalten ihren aktuellen Wert. Die Aktualisierung setzt BinName, BinLocID, BinGroup, BinSortNum, BinMaxItems und TransportBin sowie UpdateEmp und UpdateDate.
5. Pro Bin-Element wird eine Zeile geliefert, sortiert nach der Position im XML (Row). Jede Zeile hat Status = UPDATED oder ERROR.

Parameter

<Bins>
  <Bin>
    <BinKey>1234</BinKey>
    <Name>A-01-02</Name>
    <LocId>001</LocId>
    <Group>Regal A</Group>
    <SortNr>10</SortNr>
    <MaxItems>50</MaxItems>
    <TransportBin>0</TransportBin>
  </Bin>
  <Bin>
    <BinKey>1235</BinKey>
    <SortNr>20</SortNr>
  </Bin>
</Bins>

Antwort

Result-Set 1 · Wenn BinsXML leer ist oder nicht als XML gelesen werden kann.

Einzelne Fehlerzeile; es wird nichts aktualisiert.

Result-Set 2 · Nach der Prüfung und erfolgreicher Aktualisierung.

Eine Zeile je Bin-Element der Eingabe, sortiert nach Position, mit den übergebenen Werten und dem Aktualisierungsstatus.

Result-Set 3 · Wenn bei der Aktualisierung ein unerwarteter Fehler auftritt.

Fehlerzeile, nachdem der Fehler protokolliert und die Transaktion zurückgerollt wurde.

<SqlRowSet1>
  <row>
    <Row>1</Row>
    <BinKey>1234</BinKey>
    <BinName>A-01-02</BinName>
    <LocId>001</LocId>
    <BinGroup>Regal A</BinGroup>
    <SortNr>10</SortNr>
    <MaxItems>50</MaxItems>
    <Status>UPDATED</Status>
    <Message/>
    <TransportBin>false</TransportBin>
  </row>
  <row>
    <Row>2</Row>
    <BinKey>9999</BinKey>
    <SortNr>20</SortNr>
    <Status>ERROR</Status>
    <Message>Bin not updated (Bin does not exist).</Message>
  </row>
</SqlRowSet1>

Fehlermeldungen

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:pixiBinUpdate>
      <BinsXML><![CDATA[<Bins><Bin><BinKey>1234</BinKey><Name>A-01-02</Name><LocId>001</LocId><Group>Regal A</Group><SortNr>10</SortNr><MaxItems>50</MaxItems><TransportBin>0</TransportBin></Bin><Bin><BinKey>1235</BinKey><SortNr>20</SortNr></Bin></Bins>]]></BinsXML>
      <!-- <UpdateEmp>WMS</UpdateEmp> -->
    </ns1:pixiBinUpdate>
  </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:pixiBinUpdate>
      <BinsXML><![CDATA[<Bins><Bin><BinKey>1234</BinKey><Name>A-01-02</Name><LocId>001</LocId><Group>Regal A</Group><SortNr>10</SortNr><MaxItems>50</MaxItems><TransportBin>0</TransportBin></Bin><Bin><BinKey>1235</BinKey><SortNr>20</SortNr></Bin></Bins>]]></BinsXML>
      <!-- <UpdateEmp>WMS</UpdateEmp> -->
    </ns1:pixiBinUpdate>
  </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 = [
    'BinsXML' => '<Bins><Bin><BinKey>1234</BinKey><Name>A-01-02</Name><LocId>001</LocId><Group>Regal A</Group><SortNr>10</SortNr><MaxItems>50</MaxItems><TransportBin>0</TransportBin></Bin><Bin><BinKey>1235</BinKey><SortNr>20</SortNr></Bin></Bins>',
    // 'UpdateEmp' => 'WMS',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiBinUpdate

Prozedur zuletzt geändert am 2026-10-05

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