pixiAssignBoxesForPicklist

Ordnet einer Pickliste eine Menge von Boxen zu und ersetzt die bisherige Zuordnung, nachdem Existenz und ausreichende Anzahl der Boxen geprüft wurden.

Ersetzt die Boxenzuordnung einer Pickliste durch die als XML übergebene Liste von Boxnummern.

Ablauf:

1. Liest den Lagerort (PLHlocID) der Pickliste @PicklistNr aus PLHeader. Ist @PicklistNr NULL, <= 0 oder existiert die Pickliste nicht, wird eine Fehlerzeile geliefert.
2. Prüft, dass @BoxNumbers nicht NULL oder leer ist.
3. Wertet @BoxNumbers als XML aus und liest alle eindeutigen Werte /BoxNumbers/BoxNr als Ganzzahlen. Wird kein Wert ungleich 0 gefunden, wird eine Fehlerzeile geliefert.
4. Sucht jede Boxnummer in boxes am Lagerort der Pickliste (LocationID = Lagerort der Pickliste). Fehlt eine Box dort, wird eine Fehlerzeile mit den fehlenden Nummern geliefert und nichts geändert.
5. Ermittelt die Anzahl unterschiedlicher Aufträge auf der Pickliste (einschließlich daraus abgeteilter Picklisten über PLHOriginalKey). Sind weniger Boxen übergeben als Aufträge vorhanden, wird eine Fehlerzeile geliefert.
6. In einer Transaktion:
   • werden bestehende PicklistBox-Zuordnungen der Pickliste gelöscht, deren Box nicht in der neuen Liste enthalten ist,
   • werden Zuordnungen für noch nicht zugeordnete Boxen der Liste angelegt (angelegt/geändert durch den über @UserName ermittelten Benutzer),
   • werden PLHfromBox und PLHtoBox der Pickliste auf 0 gesetzt.
7. Liefert eine Zeile mit Status = 1 und Message = Success.

Das Ergebnis ist immer eine einzelne Status/Message-Zeile; Status = 0 bedeutet, dass die Prüfung fehlgeschlagen ist und keine Daten geändert wurden.

Parameter

<BoxNumbers>
  <BoxNr>1001</BoxNr>
  <BoxNr>1002</BoxNr>
  <BoxNr>1003</BoxNr>
</BoxNumbers>

Antwort

Result-Set 1 · Immer (außer bei einem Laufzeitfehler innerhalb der Transaktion oder wenn das XML nicht umgewandelt werden kann)

Statuszeile mit dem Ergebnis des Aufrufs.

<SqlRowSet1>
  <row>
    <Status>1</Status>
    <Message>Success</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:pixiAssignBoxesForPicklist>
      <PicklistNr>45872</PicklistNr>
      <BoxNumbers><![CDATA[<BoxNumbers><BoxNr>1001</BoxNr><BoxNr>1002</BoxNr><BoxNr>1003</BoxNr></BoxNumbers>]]></BoxNumbers>
      <!-- <UserName>API</UserName> -->
    </ns1:pixiAssignBoxesForPicklist>
  </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:pixiAssignBoxesForPicklist>
      <PicklistNr>45872</PicklistNr>
      <BoxNumbers><![CDATA[<BoxNumbers><BoxNr>1001</BoxNr><BoxNr>1002</BoxNr><BoxNr>1003</BoxNr></BoxNumbers>]]></BoxNumbers>
      <!-- <UserName>API</UserName> -->
    </ns1:pixiAssignBoxesForPicklist>
  </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 = [
    'PicklistNr' => '45872',
    'BoxNumbers' => '<BoxNumbers><BoxNr>1001</BoxNr><BoxNr>1002</BoxNr><BoxNr>1003</BoxNr></BoxNumbers>',
    // 'UserName' => 'API',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiAssignBoxesForPicklist

Prozedur zuletzt geändert am 2026-10-05

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