pixiShippingGetPicklistDetails
Liefert die Positionen einer Pickliste, gruppiert nach Artikel, Lagerplatz und Auftragsposition, mit Lagerplatz-, Artikel-, Auftrags- und Kistendaten, optional gefiltert.
Liest den Picklistenkopf (PLheader) mit dem Schlüssel PicklistKey zusammen mit seinen Picklistenpositionen (PLItem). Jede Position wird mit dem Lagerplatzbestand (InvBinItem), dem Artikel (Items), dem Lagerplatz (InvBin) und der Auftragsposition (Orderlines) verknüpft.
Die Picklistenpositionen werden je Artikel, Lagerplatz und Auftragsposition gruppiert. Qty ist die Anzahl der Picklistenpositionen in der Gruppe. Die Artikelnummern (ItemNrSuppl, EanUpc, ItemNrInt) werden in Großbuchstaben geliefert.
Je Gruppe werden zusätzlich geliefert:
OtherItemsCount:1, wenn auf dem Lagerplatz andere Artikel liegen, sonst0PLHfromBox/PLHtoBoxdes PicklistenkopfsBundleItemName: Name der Bundle-Auftragsposition oder LeerstringTotalItemsOnBin: Gesamtmenge aller Artikel auf dem LagerplatzTotalSimilarItemsOnBin: Gesamtmenge dieses Artikels auf dem Lagerplatz
Optionale Filter, die bei NULL oder Leerstring ignoriert werden:
FilterLocation: exakter Vergleich mit der Lager-ID des LagerplatzesFilterBinGroup:LIKE-Vergleich mit der Lagerplatzgruppe, Platzhalter wie%sind möglichFilterBinName:LIKE-Vergleich mit dem Lagerplatznamen, Platzhalter wie%sind möglich
Die Sortierung erfolgt nach BinGroup, BinSortNum und ItemName, was einer Laufreihenfolge durch das Lager entspricht.
Hinweise
PicklistKeyhat den StandardwertNULL, auch0wird zuNULL. In beiden Fällen passt keine Pickliste, das Ergebnis ist leer. Praktisch muss der Parameter also übergeben werden.- Alle Tabellen werden mit
NOLOCKgelesen, nicht festgeschriebene Daten können daher erscheinen. - Die Spalte
PLIorderlineRefkommt im Ergebnis zweimal vor (aus den gruppierten Daten und als zusätzliche Spalte). Je nach Client wird das zweite Vorkommen umbenannt (z. B.PLIorderlineRef1) oder überschreibt das erste; beide enthalten denselben Wert. OtherItemsCountist trotz des Namens ein Kennzeichen (0/1), keine Anzahl.- Die Gruppierung berücksichtigt auch den Ersteller der Pickliste und das Anlagedatum der Auftragsposition, die nicht ausgegeben werden; scheinbar identische Zeilen können daher mehrfach erscheinen.
- Die Datentypen der meisten Spalten hängen von den Tabellendefinitionen ab, die nicht Teil des Codes sind.
Parameter
| Parameter | Typ | Standardwert | Beschreibung |
|---|---|---|---|
PicklistKey
|
int | NULL |
Schlüssel der Pickliste ( Beispiel: |
FilterLocation
|
varchar(3) string |
NULL |
Optionale Lager-ID; nur Lagerplätze dieses Lagers werden geliefert (exakter Vergleich). Leerstring bedeutet kein Filter. Beispiel: |
FilterBinGroup
|
varchar(20) string |
NULL |
Optionales Muster für die Lagerplatzgruppe, Vergleich mit Beispiel: |
FilterBinName
|
varchar(50) string |
NULL |
Optionales Muster für den Lagerplatznamen, Vergleich mit Beispiel: |
Antwort
Result-Set 1 · Immer; leer, wenn die Pickliste nicht existiert, PicklistKey 0/NULL ist oder die Filter nichts treffen.
Eine Zeile je Artikel, Lagerplatz und Auftragsposition der Pickliste, sortiert nach Lagerplatzgruppe, Lagerplatz-Sortiernummer und Artikelname.
| Spalte | Typ | Beschreibung |
|---|---|---|
BinItemRef
|
int |
Artikelschlüssel des Lagerplatzbestands ( |
PLIheaderRef
|
int |
Schlüssel des Picklistenkopfs. |
BinSortNum
Kann leer sein |
int |
Sortiernummer des Lagerplatzes (Laufreihenfolge). |
ItemName
Kann leer sein |
string |
Artikelname. |
BinName
Kann leer sein |
string |
Name des Lagerplatzes. |
BinKey
|
int |
Schlüssel des Lagerplatzes. |
PicklistExpiryDate
Kann leer sein |
dateTime |
Ablaufdatum der Pickliste ( |
PicklistCreateDate
Kann leer sein |
dateTime |
Anlagedatum der Pickliste. |
Qty
|
int |
Anzahl der Picklistenpositionen in dieser Gruppe. |
PicklistComment
Kann leer sein |
string |
Kommentar der Pickliste. |
ItemNrSuppl
Kann leer sein |
string |
Lieferantenartikelnummer in Großbuchstaben. |
EanUpc
Kann leer sein |
string |
EAN/UPC des Artikels in Großbuchstaben. |
ItemNrInt
Kann leer sein |
string |
Interne Artikelnummer in Großbuchstaben. |
BinRef
Kann leer sein |
int |
Am Picklistenposten gespeicherte Lagerplatzreferenz ( |
BinGroup
Kann leer sein |
string |
Lagerplatzgruppe. |
PLIorderlineRef
|
int |
Schlüssel der Auftragsposition des Picklistenpostens. |
Location
Kann leer sein |
string |
Lager-ID des Lagerplatzes ( |
PicLinkSmall
|
string |
Link zum kleinen Artikelbild, Leerstring wenn keines vorhanden. |
PicLinkLarge
Kann leer sein |
string |
Link zum großen Artikelbild. |
OrderNr
Kann leer sein |
int |
Auftragsnummer. |
OrderNrExternal
Kann leer sein |
string |
Externe Auftragsnummer. |
ItemNrExternal
Kann leer sein |
string |
Externe Artikelnummer. |
BundleOrderlineRef
|
int |
Schlüssel der Bundle-Auftragsposition, |
CustKey
Kann leer sein |
int |
Kundenschlüssel ( |
OtherItemsCount
|
int |
|
PLHfromBox
Kann leer sein |
string |
Von-Kiste des Picklistenkopfs. |
PLHtoBox
Kann leer sein |
string |
Bis-Kiste des Picklistenkopfs. |
PLIorderlineRef
|
int |
Zweites Vorkommen des Auftragspositionsschlüssels (gleicher Wert wie oben). |
BundleItemName
|
string |
Name der Bundle-Auftragsposition ( |
TotalItemsOnBin
Kann leer sein |
int |
Summe von |
TotalSimilarItemsOnBin
Kann leer sein |
int |
Summe von |
Beispielantwort
<SqlRowSet1>
<row>
<BinItemRef>1234</BinItemRef>
<PLIheaderRef>4711</PLIheaderRef>
<BinSortNum>10</BinSortNum>
<ItemName>T-Shirt Blue M</ItemName>
<BinName>A-01-03</BinName>
<BinKey>553</BinKey>
<PicklistExpiryDate>2024-05-03T18:00:00</PicklistExpiryDate>
<PicklistCreateDate>2024-05-02T09:15:00</PicklistCreateDate>
<Qty>2</Qty>
<PicklistComment>Express</PicklistComment>
<ItemNrSuppl>TS-BL-M</ItemNrSuppl>
<EanUpc>4012345678901</EanUpc>
<ItemNrInt>100234</ItemNrInt>
<BinRef>553</BinRef>
<BinGroup>A</BinGroup>
<PLIorderlineRef>98765</PLIorderlineRef>
<Location>001</Location>
<PicLinkSmall>https://shop.example.com/img/s/100234.jpg</PicLinkSmall>
<PicLinkLarge>https://shop.example.com/img/l/100234.jpg</PicLinkLarge>
<OrderNr>50123</OrderNr>
<OrderNrExternal>WEB-2024-0815</OrderNrExternal>
<ItemNrExternal>SKU-100234</ItemNrExternal>
<BundleOrderlineRef>0</BundleOrderlineRef>
<CustKey>3321</CustKey>
<OtherItemsCount>1</OtherItemsCount>
<PLHfromBox>1</PLHfromBox>
<PLHtoBox>20</PLHtoBox>
<PLIorderlineRef1>98765</PLIorderlineRef1>
<BundleItemName/>
<TotalItemsOnBin>35</TotalItemsOnBin>
<TotalSimilarItemsOnBin>12</TotalSimilarItemsOnBin>
</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:pixiShippingGetPicklistDetails>
<!-- <PicklistKey>4711</PicklistKey> -->
<!-- <FilterLocation>001</FilterLocation> -->
<!-- <FilterBinGroup>A%</FilterBinGroup> -->
<!-- <FilterBinName>A-01-%</FilterBinName> -->
</ns1:pixiShippingGetPicklistDetails>
</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:pixiShippingGetPicklistDetails>
<!-- <PicklistKey>4711</PicklistKey> -->
<!-- <FilterLocation>001</FilterLocation> -->
<!-- <FilterBinGroup>A%</FilterBinGroup> -->
<!-- <FilterBinName>A-01-%</FilterBinName> -->
</ns1:pixiShippingGetPicklistDetails>
</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 = [
// 'PicklistKey' => '4711',
// 'FilterLocation' => '001',
// 'FilterBinGroup' => 'A%',
// 'FilterBinName' => 'A-01-%',
];
$soapArguments = [];
foreach ($arguments as $name => $value) {
$soapArguments[] = new SoapVar($value, XSD_STRING, '', '', $name);
}
$response = $soapClient->__soapCall('pixiShippingGetPicklistDetails', $soapArguments);
Verwendete Tabellen
- SQL-Objekt:
- dbo.pipiShippingGetPicklistDetails