pixiGetItemInfoPickList

Liefert Artikelstammdaten für einen oder mehrere Artikel an einem Lager sowie offene Picklistenpositionen, gepackte Kartonmengen und einen kombinierten Statuscode.

Sucht einen oder mehrere Artikel und liefert deren Stammdaten zusammen mit Informationen zu Picklisten und Kartons, in denen sie aktuell vorkommen.

Prüfung

• Sind ItemKey, EANUPC, ItemNrSuppl, ItemNrInt und ItemXML alle leer, liefert der Aufruf eine Zeile mit Status = 0 und einer Meldung, gefolgt von der abschließenden Statuszeile 0000. LocID allein genügt nicht. ItemKey = 0 gilt ebenfalls als leer.

Artikelsuche

• Ein einzelner Artikel wird über COALESCE(EANUPC, ItemNrInt, ItemNrSuppl) in den scanbaren Artikelcodes ermittelt (pixi.ItemCode mit einem Codetyp, bei dem Scannable = 1 ist). Verwendet wird der erste Treffer. Ist ItemKey übergeben, hat er Vorrang vor der Code-Suche.
• Zusätzlich kann ItemXML mehrere Artikel enthalten (/ITEMS/ITEM mit den Kindelementen ITEMNRINT, ITEMNRSUPPL, ITEMKEY, EAN). Jeder Eintrag findet Artikel, deren interne Nummer, EAN, Artikelschlüssel oder Lieferantenartikelnummer einem der Werte entspricht. Diese Artikel werden zum Einzelartikel aus den Parametern hinzugefügt.

Ergebnismengen bei Erfolg (in dieser Reihenfolge)

1. Artikeldaten aus items, verknüpft mit den lagerspezifischen Werten aus ItemLocationSpecific für LocID (Bestand, Mindestbestand, Mindestbestellmenge), Kategoriename, MwSt-Stufe, Tags, ABC-Klasse, voraussichtliche Lieferzeit und Bildlinks.
2. Picklistenpositionen: je Artikel und Pickliste die Anzahl nicht abgelaufener Picklistenpositionen, deren Auftragsposition nicht im Status AUS, NLB, RET, STO oder EIN ist. Bei gesetztem LocID nach dem Lager der Auftragsposition gefiltert.
3. Kartonpositionen: je Artikel, Karton und verwendeter Picklistennummer die summierte Menge in Kartons für Auftragspositionen im Status EIN. Bei gesetztem LocID nach dem Lager der Auftragsposition gefiltert.
4. Eine Statuszeile mit vierstelligem Code: Zugriff / Artikel gefunden / auf Pickliste / im Karton. Mögliche Werte sind 0000 (kein Parameter), 1000 (keine Artikeldaten gefunden), 1100, 1101, 1110 und 1111.

Parameter

<ITEMS>
  <ITEM>
    <ITEMNRINT>4711</ITEMNRINT>
    <ITEMNRSUPPL>SUP-4711</ITEMNRSUPPL>
    <ITEMKEY>1234</ITEMKEY>
    <EAN>4006381333931</EAN>
  </ITEM>
  <ITEM>
    <ITEMNRINT>4712</ITEMNRINT>
    <ITEMNRSUPPL>SUP-4712</ITEMNRSUPPL>
    <ITEMKEY>1235</ITEMKEY>
    <EAN>4006381333948</EAN>
  </ITEM>
</ITEMS>

Antwort

Result-Set 1 · Nur wenn kein Artikelparameter (ItemKey, EANUPC, ItemNrSuppl, ItemNrInt, ItemXML) angegeben ist

Fehlerzeile der Prüfung.

Result-Set 2 · Wenn mindestens ein Artikelparameter angegeben ist

Artikelstammdaten mit lagerspezifischen Werten für LocID; eine Zeile je gefundenem Artikel. Leer, wenn LocID NULL ist oder kein lagerspezifischer Datensatz existiert.

Result-Set 3 · Wenn mindestens ein Artikelparameter angegeben ist

Picklistenpositionen der gefundenen Artikel, eine Zeile je Artikel, Artikelnummer und Pickliste.

Result-Set 4 · Wenn mindestens ein Artikelparameter angegeben ist

Kartonmengen der gefundenen Artikel für Auftragspositionen im Status EIN, eine Zeile je Artikel, Karton und verwendeter Pickliste.

Result-Set 5 · Immer (letzte Ergebnismenge)

Kombinierter Statuscode: Stelle 1 = Parameter angegeben, 2 = Artikeldaten gefunden, 3 = auf Pickliste, 4 = im Karton.

<SqlRowSet1>
  <row>
    <ItemKey>1234</ItemKey>
    <SupplPrice>4.5000</SupplPrice>
    <ItemName>USB-Kabel 2m</ItemName>
    <VPE>10</VPE>
    <MinStockQty>20</MinStockQty>
    <MinOrderQty>50</MinOrderQty>
    <SupplNR>L100</SupplNR>
    <Category>Zubehör</Category>
    <ItemNrInt>4711</ItemNrInt>
    <ItemNrSuppl1>SUP-4711</ItemNrSuppl1>
    <Quantity>135</Quantity>
    <PriceVK>9.9900</PriceVK>
    <VATLevel>MwSt_High</VATLevel>
    <Enabled>1</Enabled>
    <ItemTAGs>A|Kabel</ItemTAGs>
    <EANUPC>4006381333931</EANUPC>
    <ItemNrSuppl>SUP-4711</ItemNrSuppl>
    <ABC>A</ABC>
    <ExportEstimatedDelivery>2</ExportEstimatedDelivery>
    <PicLinkLarge>https://shop.example.com/img/4711_l.jpg</PicLinkLarge>
    <PicLinkSmall>https://shop.example.com/img/4711_s.jpg</PicLinkSmall>
  </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:pixiGetItemInfoPickList>
      <!-- <ItemKey>1234</ItemKey> -->
      <!-- <ItemNrInt>4711</ItemNrInt> -->
      <!-- <EANUPC>4006381333931</EANUPC> -->
      <!-- <ItemNrSuppl>SUP-4711</ItemNrSuppl> -->
      <!-- <LocID>001</LocID> -->
      <!-- <ItemXML><![CDATA[<ITEMS><ITEM><ITEMNRINT>4711</ITEMNRINT><ITEMNRSUPPL>SUP-4711</ITEMNRSUPPL><ITEMKEY>1234</ITEMKEY><EAN>4006381333931</EAN></ITEM><ITEM><ITEMNRINT>4712</ITEMNRINT><ITEMNRSUPPL>SUP-4712</ITEMNRSUPPL><ITEMKEY>1235</ITEMKEY><EAN>4006381333948</EAN></ITEM></ITEMS>]]></ItemXML> -->
    </ns1:pixiGetItemInfoPickList>
  </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:pixiGetItemInfoPickList>
      <!-- <ItemKey>1234</ItemKey> -->
      <!-- <ItemNrInt>4711</ItemNrInt> -->
      <!-- <EANUPC>4006381333931</EANUPC> -->
      <!-- <ItemNrSuppl>SUP-4711</ItemNrSuppl> -->
      <!-- <LocID>001</LocID> -->
      <!-- <ItemXML><![CDATA[<ITEMS><ITEM><ITEMNRINT>4711</ITEMNRINT><ITEMNRSUPPL>SUP-4711</ITEMNRSUPPL><ITEMKEY>1234</ITEMKEY><EAN>4006381333931</EAN></ITEM><ITEM><ITEMNRINT>4712</ITEMNRINT><ITEMNRSUPPL>SUP-4712</ITEMNRSUPPL><ITEMKEY>1235</ITEMKEY><EAN>4006381333948</EAN></ITEM></ITEMS>]]></ItemXML> -->
    </ns1:pixiGetItemInfoPickList>
  </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 = [
    // 'ItemKey' => '1234',
    // 'ItemNrInt' => '4711',
    // 'EANUPC' => '4006381333931',
    // 'ItemNrSuppl' => 'SUP-4711',
    // 'LocID' => '001',
    // 'ItemXML' => '<ITEMS><ITEM><ITEMNRINT>4711</ITEMNRINT><ITEMNRSUPPL>SUP-4711</ITEMNRSUPPL><ITEMKEY>1234</ITEMKEY><EAN>4006381333931</EAN></ITEM><ITEM><ITEMNRINT>4712</ITEMNRINT><ITEMNRSUPPL>SUP-4712</ITEMNRSUPPL><ITEMKEY>1235</ITEMKEY><EAN>4006381333948</EAN></ITEM></ITEMS>',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiGetItemInfoPickList

Prozedur zuletzt geändert am 2026-10-05

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