Items Lesen

pixiGetItemLogisticsEAN

Liefert seitenweise die EANs aktiver Nicht-Bundle-Artikel sowie die EANs von Einzelartikel-Bundles, die als Verpackungseinheit (VPE) dienen.

Stellt EAN-Daten von Artikeln für einen Fulfillment-Dienstleister bereit, einschließlich der EANs von Verpackungseinheiten, die als Bundles abgebildet sind.

Paging

Es werden die ersten @RowCount Artikel mit ItemKey größer als @StartKey ausgewählt, aufsteigend sortiert nach ItemKey.
Nur Artikel mit Enabled = 1 und IsBundle = 0 gelangen in die Seite.

Ergebniszeilen

Für jeden Artikel der Seite gibt es eine Zeile mit der eigenen EANUPC des Artikels und VPE = 1.
Zusätzlich werden VPE-Bundles gesucht: Bundles mit genau einer Bundle-Position, deren Menge der OrderUnit des enthaltenen Artikels (als int) entspricht. Für jedes solche Bundle, dessen enthaltener Artikel in der aktuellen Seite liegt, wird eine Zeile geliefert mit:
- ItemKey = der enthaltene Artikel,
- EANUPC = die EAN des Bundles,
- VPE = die OrderUnit des enthaltenen Artikels.

Beide Teile werden per UNION zusammengeführt (exakte Duplikate entfallen) und nach ItemKey sortiert.

Alle Artikel durchlaufen

Mit StartKey = 0 beginnen und den höchsten ItemKey der letzten Antwort als nächsten StartKey übergeben. Abbrechen, wenn ein Aufruf keine Zeilen mehr liefert.

Hinweise

Derselbe ItemKey kann in mehreren Zeilen vorkommen (eigene EAN plus je eine Zeile pro VPE-Bundle). Die Zeilenanzahl kann daher @RowCount übersteigen; @RowCount begrenzt die Anzahl unterschiedlicher Artikel, nicht der Zeilen.
Das Bundle selbst wird nicht nach Enabled gefiltert; auch deaktivierte Bundles, die die VPE-Kriterien erfüllen, werden geliefert.
Bundles mit mehr als einer Bundle-Position oder mit einer Menge ungleich der OrderUnit des enthaltenen Artikels werden ignoriert.
Die meisten Joins lesen mit NOLOCK (Dirty Reads möglich); der Join für die eigene EAN des Artikels verwendet keinen Locking-Hint.
EANUPC kann leer oder NULL sein, wenn keine EAN gepflegt ist.
Der genaue Datentyp von VPE hängt vom Spaltentyp von Items.OrderUnit ab, der im Code nicht ersichtlich ist.

Parameter

Parameter	Typ	Standardwert	Beschreibung
`StartKey`	int	0	Es werden nur Artikel mit einem `ItemKey` größer als dieser Wert geliefert. `0` für die erste Seite, danach der höchste `ItemKey` der vorherigen Antwort. Beispiel: `0`
`RowCount`	int	1000	Maximale Anzahl Artikel (aktiv, kein Bundle) pro Seite. Die Anzahl der gelieferten Zeilen kann durch zusätzliche VPE-Zeilen höher sein. Beispiel: `1000`

Antwort

Result-Set 1 · Immer (leer, wenn nach `@StartKey` keine Artikel mehr existieren)

EANs je Artikel: eigene EAN mit VPE 1 sowie EANs von VPE-Bundles mit ihrer Einheitengröße, sortiert nach ItemKey.

Spalte	Typ	Beschreibung
`ItemKey`	int	Schlüssel des (Einzel-)Artikels. Bei VPE-Zeilen der im Bundle enthaltene Artikel.
`EANUPC` Kann leer sein	string	EAN/UPC: die eigene EAN des Artikels bzw. bei VPE-Zeilen die EAN des Bundles.
`VPE` Kann leer sein	decimal	Verpackungseinheit: `1` für die eigene EAN des Artikels, sonst die `OrderUnit` des enthaltenen Artikels (Stückzahl, die die Bundle-EAN repräsentiert).

Beispielantwort

<SqlRowSet1>
  <row>
    <ItemKey>1001</ItemKey>
    <EANUPC>4006381333931</EANUPC>
    <VPE>1</VPE>
  </row>
  <row>
    <ItemKey>1001</ItemKey>
    <EANUPC>4006381333948</EANUPC>
    <VPE>12</VPE>
  </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:pixiGetItemLogisticsEAN>
      <!-- <StartKey>0</StartKey> -->
      <!-- <RowCount>1000</RowCount> -->
    </ns1:pixiGetItemLogisticsEAN>
  </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:pixiGetItemLogisticsEAN>
      <!-- <StartKey>0</StartKey> -->
      <!-- <RowCount>1000</RowCount> -->
    </ns1:pixiGetItemLogisticsEAN>
  </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 = [
    // 'StartKey' => '0',
    // 'RowCount' => '1000',
];

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

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

Verwendete Tabellen

Items · Lesen BundleItems · Lesen

SQL-Objekt:: dbo.pipiGetItemLogisticsEAN