pixiGetPickListDetailForPico

Liefert die Positionen einer fertig erzeugten Pickliste inklusive ihrer Split-Picklisten mit Lagerplatz-, Artikel-, Charge- und Auftragsdaten für die Pico-App.

Liefert eine Zeile je Pickposition der Pickliste PLHkey. Der Aufruf übergibt den Schlüssel an eine interne Prozedur, Pixi_GetPickListDetailForPico, und ändert deren Standardfilter nicht.

Welche Picklisten enthalten sind

• Der Picklistenkopf mit PLHkey = @PLHkey.
• Alle Split-Picklisten mit PLHOriginalKey = @PLHkey.
• Nur Köpfe mit ExecutionFinished = 1.
• Köpfe mit beliebigem Pickstatus.

Wie die Zeilen gebildet werden

• Die Picklistenpositionen (PLitem) werden zu einer Zeile je Kombination zusammengefasst aus:
  • Picklistenkopf, Auftragsposition und Lagerplatz (InvBinItem.BinRef);
  • Charge und Mindesthaltbarkeitsdatum;
  • Artikel (BinItemRef) und pliBinRef.
• Qty ist die Anzahl der Picklistenpositionen in der Gruppe; jeder Datensatz steht für ein Stück.
• MinPlItemKey ist der kleinste PLIkey der Gruppe.
• Jede Zeile wird ergänzt um Daten aus:
  • dem Lagerplatz: Name, Sortiernummer, Lagerplatzgruppe;
  • dem Picklistenkopf: Ablaufdatum, Erstellungsdatum und -mitarbeiter, Kommentar, Kistenbereich, Pickstatus-Code, Originalschlüssel;
  • der Auftragsposition: Auftragsnummer und externe Auftragsnummer;
  • dem Artikel: Namen, Nummern, Bildlinks, Hersteller (items.Artist), Tags und Verpackungseinheit.

Berechnete Spalten

• ItemName ist der Artikelname mit einer vorangestellten Artikelnummer in Großbuchstaben und einem Leerzeichen. Die Einstellung PickListNumberColumn bestimmt die Nummer: EANUPC, ItemNrInt oder ItemNrSuppl. Bei einem anderen Wert oder ohne Einstellung entfällt das Präfix.
• OtherItemsCount zählt die InvBinItem-Datensätze desselben Lagerplatzes, die zu einem anderen Artikel gehören.
• DistinctBins ist die Anzahl unterschiedlicher Lagerplätze über alle Zeilen des Ergebnisses. Der Wert ist in jeder Zeile gleich.
• ItemTags listet die Tag-Namen des Artikels. Jeder Name endet mit einem Komma, die Namen sind durch Leerzeichen getrennt, z. B. Fragile, Heavy,.
• BestBeforeDate_Text ist das Mindesthaltbarkeitsdatum im Format dd.mm.yyyy.
• OrderUnit ist items.OrderUnit als Ganzzahl. Der Wert ist NULL, wenn er leer oder nicht numerisch ist.

Vertauschte Artikelnummer-Spalten

• ItemNrInt enthält die Lieferanten-Artikelnummer (ItemNrSuppl). Das dient der Abwärtskompatibilität.
• ItemNrInt1 enthält die interne Artikelnummer.

Existiert die Pickliste nicht oder ist sie nicht fertig erzeugt, ist die Ergebnismenge leer.

Parameter

Antwort

Result-Set 1 · Immer; leer, wenn die Pickliste nicht existiert oder nicht fertig erzeugt ist (ExecutionFinished <> 1).

Eine Zeile je Picklistenkopf, Auftragsposition, Lagerplatz, Charge, MHD und Artikel mit der zu pickenden Menge.

<SqlRowSet1>
  <row>
    <BinItemRef>10234</BinItemRef>
    <PLIheaderRef>48213</PLIheaderRef>
    <BinSortNum>120</BinSortNum>
    <ItemNameWithoutNumber>Coffee Mug Blue</ItemNameWithoutNumber>
    <BinName>A-01-03</BinName>
    <BinKey>5521</BinKey>
    <PLHexpiryDate>2024-05-15T18:00:00</PLHexpiryDate>
    <HeaderCreateDate>2024-05-14T08:12:00</HeaderCreateDate>
    <createEmp>JD</createEmp>
    <Qty>2</Qty>
    <PLcomment>Express</PLcomment>
    <ItemName>4006381333931 Coffee Mug Blue</ItemName>
    <ItemNrInt>SUP-7781</ItemNrInt>
    <EanUpc>4006381333931</EanUpc>
    <ItemNrInt1>MUG-BL-01</ItemNrInt1>
    <pliBinRef>5521</pliBinRef>
    <BinGroup>A</BinGroup>
    <PLIorderlineRef>998877</PLIorderlineRef>
    <PLHfromBox>1</PLHfromBox>
    <PLHtoBox>20</PLHtoBox>
    <PicLinkLarge>https://shop.example.com/img/mug_l.jpg</PicLinkLarge>
    <PicLinkSmall>https://shop.example.com/img/mug_s.jpg</PicLinkSmall>
    <BatchNumber>B2024-03</BatchNumber>
    <BestBeforeDate_Text>31.12.2025</BestBeforeDate_Text>
    <BestBeforeDate>2025-12-31T00:00:00</BestBeforeDate>
    <OrderNr>345678</OrderNr>
    <OrderNrExternal>SHOP-100234</OrderNrExternal>
    <OtherItemsCount>3</OtherItemsCount>
    <DistinctBins>7</DistinctBins>
    <ItemTags>Fragile,</ItemTags>
    <PickingStatusCode>OPEN</PickingStatusCode>
    <Manufacturer>Acme</Manufacturer>
    <MinPlItemKey>7712345</MinPlItemKey>
    <PLHOriginalKey>48213</PLHOriginalKey>
    <OrderUnit>6</OrderUnit>
  </row>
</SqlRowSet1>

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:pixiGetPickListDetailForPico>
      <PLHkey>48213</PLHkey>
    </ns1:pixiGetPickListDetailForPico>
  </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:pixiGetPickListDetailForPico>
      <PLHkey>48213</PLHkey>
    </ns1:pixiGetPickListDetailForPico>
  </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 = [
    'PLHkey' => '48213',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiGetPickListDetailForPico

Prozedur zuletzt geändert am 2026-10-05

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