pixiCreatePicklist

Erstellt eine Pickliste auf Basis eines Picklistenprofils, entweder sofort oder über einen Eintrag in der Ausführungs-Warteschlange.

Startet die Erstellung einer Pickliste mit den Einstellungen eines gespeicherten Picklistenprofils. Einzelne Profilwerte lassen sich über Parameter übersteuern.

1. Premium-API-Prüfung. Die Einstellung Premium_API muss aktiv sein. Andernfalls wird eine ERROR-Zeile geliefert.
2. Profil. Ist ProfileId angegeben (0 gilt als nicht angegeben), muss das Profil in PL_Profile existieren. Ohne Angabe wird das zuletzt geänderte Standardprofil (PLP_Default = 1) verwendet, das kein 1SS-Profil ist (PLP_1SS = 0).
3. Lager. Eine leere LocationId wird zu 001.
4. Auftragseinschränkung (optional).
   • Nur OrderNr: Der Auftrag muss in OrderHeader existieren.
   • Nur OrderNrExternal: Ein Auftrag mit dieser externen Nummer muss existieren.
   • Beide: Ein Auftrag mit beiden Werten muss existieren. Danach wird nur OrderNr verwendet und OrderNrExternal geleert.
   • OrderNr = 0 und eine leere OrderNrExternal gelten als nicht angegeben.
5. Lagerplatzbereich (optional). BinFrom und BinTo müssen Lagerplatznamen (InvBin.BinName) im gewählten Lager sein. Ihre BinSortNum ersetzt den Lagerplatz-Sortierbereich des Profils.
6. Benutzer und Kommentar. UserName wird getrimmt; ist er leer, wird API verwendet. Comment wird getrimmt und als Picklistenkommentar übernommen.
7. Profilparameter. Alle Parameter des Profils werden geladen. Danach werden Lager, Profil-ID, Auftragseinschränkung, Lagerplatzbereich, Benutzername und Kommentar mit den Werten aus den Schritten 2–6 überschrieben.
8. Exklusive Sperre. Der Aufruf fordert die Application-Lock ExclusivePickListCreation ohne Wartezeit an. Hält eine andere Session die Sperre, wird eine ERROR-Zeile geliefert.
9. Ausführung. Aus der aktuellen Zeit wird eine Ausführungsnummer im Format yyMMddHHmmss gebildet.
   • ExecuteAsynchronous = 1 (Standard): Eine Anweisung EXEC dbo.Pixi_CreatePickList … mit allen Parametern wird in ExecQueries geschrieben. Es wird eine INFO-Zeile geliefert.
   • ExecuteAsynchronous = 0: Pixi_CreatePickList wird sofort ausgeführt. Die Prozedur liest ihre Parameter aus der temporären Parametertabelle.

Anschließend wird die Sperre freigegeben.

Parameter

Antwort

Result-Set 1 · Bei einem Validierungsfehler, wenn die Sperre nicht verfügbar ist, oder nach dem Einreihen (asynchroner Modus).

Statuszeile des Aufrufs.

Result-Set 2 · Synchroner Modus (ExecuteAsynchronous = 0), nachdem alle Prüfungen bestanden wurden.

Ergebnismengen von Pixi_CreatePickList. Diese Prozedur ist nicht beigefügt, daher ist ihre Struktur unbekannt.

<SqlRowSet1>
  <row>
    <Status>INFO</Status>
    <Message>Picklist creation added to the queue.</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:pixiCreatePicklist>
      <!-- <ProfileId>3</ProfileId> -->
      <!-- <LocationId>001</LocationId> -->
      <!-- <OrderNr>1045873</OrderNr> -->
      <!-- <BinFrom>A-01-01</BinFrom> -->
      <!-- <BinTo>A-10-05</BinTo> -->
      <!-- <UserName>shopsync</UserName> -->
      <!-- <Comment>Express wave 14:00</Comment> -->
      <!-- <ExecuteAsynchronous>1</ExecuteAsynchronous> -->
      <!-- <OrderNrExternal>SHOP-100234</OrderNrExternal> -->
    </ns1:pixiCreatePicklist>
  </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:pixiCreatePicklist>
      <!-- <ProfileId>3</ProfileId> -->
      <!-- <LocationId>001</LocationId> -->
      <!-- <OrderNr>1045873</OrderNr> -->
      <!-- <BinFrom>A-01-01</BinFrom> -->
      <!-- <BinTo>A-10-05</BinTo> -->
      <!-- <UserName>shopsync</UserName> -->
      <!-- <Comment>Express wave 14:00</Comment> -->
      <!-- <ExecuteAsynchronous>1</ExecuteAsynchronous> -->
      <!-- <OrderNrExternal>SHOP-100234</OrderNrExternal> -->
    </ns1:pixiCreatePicklist>
  </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 = [
    // 'ProfileId' => '3',
    // 'LocationId' => '001',
    // 'OrderNr' => '1045873',
    // 'BinFrom' => 'A-01-01',
    // 'BinTo' => 'A-10-05',
    // 'UserName' => 'shopsync',
    // 'Comment' => 'Express wave 14:00',
    // 'ExecuteAsynchronous' => '1',
    // 'OrderNrExternal' => 'SHOP-100234',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiCreatePicklist

Prozedur zuletzt geändert am 2026-10-05

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