pixiSetOrderlinesInBoxToAUS

Bucht einen Auftrag aus, der allein in genau einer Box liegt: setzt die Auftragspositionen der Box auf Status AUS und leert die Box.

Führt das Ausbuchen (Scan-Out) eines in einer Box gesammelten Auftrags durch und leert die Box.

Ablauf:

1. Ermittelt alle Boxen, die Auftragspositionen von OrderNr enthalten (über boxitems), sowie alle Aufträge, die in diesen Boxen liegen.
2. Prüft, ob mindestens eine der Einstellungen Premium_API oder Centralized_Ship_Out aktiviert ist. Andernfalls wird ein Fehler zurückgegeben.
3. Prüft, ob der Auftrag in genau einer Box liegt. Wird keine Box gefunden oder ist der Auftrag auf mehrere Boxen verteilt, wird ein Fehler zurückgegeben.
4. Prüft, ob die Box keinen weiteren Auftrag enthält. Ist das der Fall, wird ein Fehler zurückgegeben.
5. Liest die Lieferadresse der Box (boxes.SAddrRef) und prüft die Liefersperre. Geprüft werden das Kundenkennzeichen Customers.SLocked und das Adresskennzeichen Addresses.ASLocked. Steht eines davon auf Y, wird ein Fehler zurückgegeben.
6. Sind alle Prüfungen bestanden, laufen drei interne Prozeduren:
   • GOSScanOutOrderline mit Status AUS. Sie setzt die Auftragspositionen der Box mit Status EIN auf AUS. Ebenso setzt sie Positionen derselben Rechnungen auf AUS, die den Status MIN oder einen in der Einstellung PutThisStatusesOnInvoice genannten Status haben. Für diese Positionen setzt sie ShipDate, aktualisiert den Auftragskopfstatus, schreibt die Auftragshistorie, löscht Reservierungen, aktualisiert Bundle-Positionen und schließt zugehörige Retourenpositionen und Retourenfälle.
   • GOSDeleteAllItemsForBox entfernt alle boxitems der Box.
   • GOSEmptyBox setzt die Box zurück: Kunde, Adressen und Auftrag werden auf 0 gesetzt, BoxEndDate auf das aktuelle Datum, und die Warte- und Sperrkennzeichen werden zurückgesetzt.

Der Aufruf liefert immer genau eine Zeile mit Status (SUCCESS oder ERROR) und Info. UserName wird als ändernder Mitarbeiter in den geänderten Datensätzen gespeichert.

Parameter

Antwort

Result-Set 1 · Immer

Eine Statuszeile mit dem Ergebnis des Aufrufs.

<SqlRowSet1>
  <row>
    <Status>SUCCESS</Status>
    <Info>Box: 17 was emptied. Order: 104523 was set to status AUS.</Info>
  </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:pixiSetOrderlinesInBoxToAUS>
      <OrderNr>104523</OrderNr>
      <!-- <UserName>WarehouseApp</UserName> -->
    </ns1:pixiSetOrderlinesInBoxToAUS>
  </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:pixiSetOrderlinesInBoxToAUS>
      <OrderNr>104523</OrderNr>
      <!-- <UserName>WarehouseApp</UserName> -->
    </ns1:pixiSetOrderlinesInBoxToAUS>
  </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 = [
    'OrderNr' => '104523',
    // 'UserName' => 'WarehouseApp',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiSetOrderlinesInBoxToAUS

Prozedur zuletzt geändert am 2026-10-05

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