pixiSetOrderlineLocation

Setzt das Lager (LocID) einer Auftragsposition oder einer Bundle-Position samt zugehöriger Bundle-Positionen um.

Ändert das Lager (LocationID und LastOrdLocationID) von Auftragspositionen. Der Aufruf übergibt an die interne Prozedur Pixi_UpdateOrderLocation mit dem Benutzernamen API und liefert eine Statuszeile.

Welche Datensätze geändert werden

• Nur OrderlineKey angegeben: Die Auftragsposition selbst wird umgesetzt. Gehört sie zu einem Bundle, werden auch alle weiteren Positionen desselben Bundles und die Bundle-Position (BundleOrderlines) umgesetzt.
• Nur BundleOrderlineKey angegeben: Alle Komponentenpositionen des Bundles und die Bundle-Position selbst werden umgesetzt. Die Komponentenpositionen werden nur umgesetzt, wenn die Bundle-Position einen zulässigen Status hat.
• Kein Schlüssel angegeben: Der Aufruf schlägt fehl, da kein Auftrag ermittelt werden kann.

Nur Positionen mit zulässigem Status werden aktualisiert. Zulässig sind alle nicht finalen Status aus OrderStates (FinalState = 'N') außer EIN, FUT und FUS. Positionen mit anderem Status werden ohne Meldung übergangen; der Aufruf liefert trotzdem OK.

Prüfungen

Die interne Prozedur prüft Folgendes und lehnt den Aufruf ab, wenn eine Prüfung fehlschlägt:

• Die Auftragsposition bzw. Bundle-Position existiert.
• LocationId existiert in Location.
• Mindestens eine Position des Auftrags hat den Status NEW, ANG, HAL, MIN, BES, STO oder NLB.
• Keine der betroffenen Auftragspositionen liegt auf einer Pickliste (PLitem).

POS-/Reservierungslager

Hat das Ziellager eine ResLocID, wird ResOnLocDate im Auftragskopf auf NULL gesetzt. Danach betrachtet die Prozedur andere Aufträge, die zulässige Positionen mit denselben Artikeln auf diesem Lager haben. Liegt das späteste ResOnLocDate dieser Aufträge vor dem frühesten Reservierungsdatum dieses Auftrags, erhalten alle Reservierungen dieses Auftrags dieses späteste ResOnLocDate plus eine Sekunde als neues ResDate.

Ergebnis

Bei Erfolg liefert der Aufruf ReturnCode = 'OK'. Andernfalls liefert er ReturnCode = 'ERROR' mit der allgemeinen Meldung Ilegal parameters.

Parameter

Antwort

Result-Set 1 · Immer

Statuszeile des Aufrufs.

<SqlRowSet1>
  <row>
    <ReturnCode>OK</ReturnCode>
    <ErrorMessage/>
  </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:pixiSetOrderlineLocation>
      <!-- <OrderlineKey>123456</OrderlineKey> -->
      <!-- <BundleOrderlineKey>4711</BundleOrderlineKey> -->
      <LocationId>001</LocationId>
    </ns1:pixiSetOrderlineLocation>
  </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:pixiSetOrderlineLocation>
      <!-- <OrderlineKey>123456</OrderlineKey> -->
      <!-- <BundleOrderlineKey>4711</BundleOrderlineKey> -->
      <LocationId>001</LocationId>
    </ns1:pixiSetOrderlineLocation>
  </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 = [
    // 'OrderlineKey' => '123456',
    // 'BundleOrderlineKey' => '4711',
    'LocationId' => '001',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiSetOrderlineLocation

Prozedur zuletzt geändert am 2026-10-05

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