pixiCanConvertBundle
Prüft, ob ein Artikel in ein Bundle bzw. aus einem Bundle umgewandelt werden kann, und liefert seine Stammdaten mit dem Kennzeichen `CanConvert`.
Ermittelt einen Artikel und prüft, ob er bereits verwendet wird, was eine Umwandlung (Änderung des Bundle-Status) verhindert.
Ermittlung des Artikels (leere Zeichenketten werden als NULL behandelt):
- Wird
ItemKeyübergeben, werdenItemNrIntundEANignoriert. - Andernfalls wird bei Angabe von
ItemNrIntder Artikel über die Artikelcodes (Codetyp 2 = interne Artikelnummer) gesucht;EANwird dann ignoriert. - Andernfalls wird bei Angabe von
EANder Artikel über die Artikelcodes (Codetyp 1 = EAN) gesucht.
Passen mehrere Artikel zu einem Code, wird der erste gefundene Treffer verwendet.
Prüfung: CanConvert ist 0, wenn der Artikel in mindestens einem der folgenden Bereiche referenziert wird, sonst 1:
- Auftragspositionen (
Orderlines) - Bundle-Auftragspositionen (
BundleOrderlines) - Lagerplatzbestände (
InvBinItem)
Ergebnis: eine Zeile mit Artikelschlüssel, interner Artikelnummer, EAN, Bundle-Kennzeichen und dem Kennzeichen CanConvert. Wird kein Artikel gefunden, ist die Ergebnismenge leer.
Hinweise
- Der Aufruf prüft nur; es wird nichts umgewandelt.
- Alle Lesezugriffe erfolgen mit
NOLOCK, das Ergebnis kann daher nicht festgeschriebene Daten enthalten. - Wurde der Artikel über
EANgefunden, liefert die SpalteEANdie übergebene EAN (ggf. eine Zusatz-EAN) statt der Haupt-EANEANUPCdes Artikels. - Eine unbekannte
ItemNrIntführt nicht zu einer Suche überEAN; das Ergebnis ist dann leer. - Es gibt keine Fehlerzeile: Ein leeres Ergebnis bedeutet, dass der Artikel nicht gefunden wurde.
Parameter
| Parameter | Typ | Standardwert | Beschreibung |
|---|---|---|---|
ItemKey
|
int | NULL |
Interner Schlüssel des Artikels. Hat Vorrang vor Beispiel: |
ItemNrInt
|
varchar(50) string |
NULL |
Interne Artikelnummer, Suche über die Artikelcodes (Codetyp 2). Wird nur verwendet, wenn Beispiel: |
EAN
|
varchar(13) string |
NULL |
EAN des Artikels, Suche über die Artikelcodes (Codetyp 1). Wird nur verwendet, wenn weder Beispiel: |
Antwort
Result-Set 1 · Immer; leer, wenn kein Artikel gefunden wurde.
Der Artikel mit Bundle-Status und dem Ergebnis der Umwandlungsprüfung.
| Spalte | Typ | Beschreibung |
|---|---|---|
ItemKey
|
int |
Interner Schlüssel des Artikels. |
ItemNrInt
Kann leer sein |
varchar(50) string |
Interne Artikelnummer. |
EAN
Kann leer sein |
varchar(13) string |
Die übergebene EAN, wenn der Artikel über die EAN gefunden wurde, sonst |
IsBundle
Kann leer sein |
bit boolean |
Gibt an, ob der Artikel aktuell ein Bundle ist. |
CanConvert
|
bit boolean |
|
Beispielantwort
<SqlRowSet1>
<row>
<ItemKey>4711</ItemKey>
<ItemNrInt>ART-10023</ItemNrInt>
<EAN>4006381333931</EAN>
<IsBundle>false</IsBundle>
<CanConvert>true</CanConvert>
</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:pixiCanConvertBundle>
<!-- <ItemKey>4711</ItemKey> -->
<!-- <ItemNrInt>ART-10023</ItemNrInt> -->
<!-- <EAN>4006381333931</EAN> -->
</ns1:pixiCanConvertBundle>
</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:pixiCanConvertBundle>
<!-- <ItemKey>4711</ItemKey> -->
<!-- <ItemNrInt>ART-10023</ItemNrInt> -->
<!-- <EAN>4006381333931</EAN> -->
</ns1:pixiCanConvertBundle>
</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' => '4711',
// 'ItemNrInt' => 'ART-10023',
// 'EAN' => '4006381333931',
];
$soapArguments = [];
foreach ($arguments as $name => $value) {
$soapArguments[] = new SoapVar($value, XSD_STRING, '', '', $name);
}
$response = $soapClient->__soapCall('pixiCanConvertBundle', $soapArguments);Verwendete Tabellen
- SQL-Objekt:
- dbo.pipiCanConvertBundle