pixiGetItemLogistics
Liefert aktive Artikel ohne Stücklisten mit Verpackungseinheit (VPE) und Tags für einen Fulfillment-Dienstleister, seitenweise nach Artikelschlüssel.
Liefert Stammdaten von Artikeln für einen externen Fulfillment-Dienstleister.
Filter
- Nur Artikel mit
Enabled = 1(aktive Artikel). - Nur Artikel mit
IsBundle = 0. Stücklistenartikel selbst werden nicht geliefert. - Nur Artikel mit
ItemKeygrößer alsStartKey.
Paging
- Das Ergebnis ist aufsteigend nach
ItemKeysortiert und aufRowCountZeilen begrenzt. - Für die nächste Seite wird der höchste
ItemKeyder vorherigen Seite alsStartKeyübergeben. Werden weniger alsRowCountZeilen geliefert, sind alle Daten gelesen.
VPE (Verpackungseinheit)
- Ein Artikel erhält seine
OrderUnit(bzw. 1, wennOrderUnitNULL ist) alsVPE, wenn er in mindestens einer Stückliste die einzige Komponente ist und die Menge dieser Komponente derOrderUnitdes Artikels (als Ganzzahl) entspricht. Solche Stücklisten bilden eine Verpackungseinheit des Artikels ab. - Alle anderen Artikel erhalten
VPE = 1.
Tags
Tagsenthält die Namen aller dem Artikel zugeordneten Tags, alphabetisch sortiert und durch|getrennt. Leerer String, wenn der Artikel keine Tags hat.
Hinweise
- Alle Tabellen werden mit
NOLOCKgelesen; das Ergebnis kann nicht festgeschriebene Daten enthalten. OrderUnitwird für den Vergleich mit der Stücklistenmenge nachINTkonvertiert; Nachkommastellen werden bei dieser Prüfung abgeschnitten.- Der Tag-String wird je Zeile über die Skalarfunktion
fpixi_GetItemTAGsAsStringgebildet und ist auf 8000 Zeichen begrenzt; großeRowCount-Werte können langsam sein. - Die genauen Datentypen von
ItemNameundOrderUnitsind in der Tabelleitemsdefiniert und im Code nicht sichtbar.
Parameter
| Parameter | Typ | Standardwert | Beschreibung |
|---|---|---|---|
StartKey
|
int | 0 |
Es werden nur Artikel mit einem Beispiel: |
RowCount
|
int | 1000 |
Maximale Anzahl der Zeilen pro Aufruf. Beispiel: |
Antwort
Result-Set 1 · Immer
Aktive Artikel ohne Stücklisten mit ItemKey > StartKey, aufsteigend nach ItemKey sortiert, höchstens RowCount Zeilen.
| Spalte | Typ | Beschreibung |
|---|---|---|
ItemKey
|
int |
Interner Schlüssel des Artikels; der letzte Wert dient als |
ItemName
Kann leer sein |
string |
Bezeichnung des Artikels. |
VPE
|
decimal |
Verpackungseinheit: die |
Tags
|
varchar(8000) string |
Tag-Namen des Artikels, alphabetisch sortiert und durch |
Beispielantwort
<SqlRowSet1>
<row>
<ItemKey>1012</ItemKey>
<ItemName>Kaffeebecher Keramik 300 ml</ItemName>
<VPE>6</VPE>
<Tags>Fragile|Kitchen</Tags>
</row>
<row>
<ItemKey>1015</ItemKey>
<ItemName>Teelöffel Edelstahl</ItemName>
<VPE>1</VPE>
<Tags/>
</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:pixiGetItemLogistics>
<!-- <StartKey>0</StartKey> -->
<!-- <RowCount>500</RowCount> -->
</ns1:pixiGetItemLogistics>
</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:pixiGetItemLogistics>
<!-- <StartKey>0</StartKey> -->
<!-- <RowCount>500</RowCount> -->
</ns1:pixiGetItemLogistics>
</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' => '500',
];
$soapArguments = [];
foreach ($arguments as $name => $value) {
$soapArguments[] = new SoapVar($value, XSD_STRING, '', '', $name);
}
$response = $soapClient->__soapCall('pixiGetItemLogistics', $soapArguments);
Verwendete Tabellen
- SQL-Objekt:
- dbo.pipiGetItemLogistics