Items Lesen

pixiGetItemStatus

Liefert den Aktiv-/Inaktiv-Status (`Enabled`) eines Artikels, ermittelt über ItemKey oder interne Artikelnummer.

Ermittelt einen einzelnen Artikel und liefert dessen Aktiv-Status.

Der Artikel wird in der Tabelle Items gesucht. Eine Zeile passt, wenn ihr ItemKey gleich ItemKey ist (nur wenn ItemKey übergeben wurde) oder ihr ItemNrInt gleich ItemNrInt ist. Die erste passende Zeile (TOP 1, ohne Sortierung) liefert den ItemKey.
Anschließend werden ItemKey, ItemNrInt und Enabled dieses Artikels zurückgegeben.

Passt keiner der Parameter zu einem Artikel oder werden beide weggelassen, ist die Ergebnismenge leer.

Hinweise

Beide Parameter werden mit ODER verknüpft. Werden beide übergeben und verweisen auf unterschiedliche Artikel, ist nicht festgelegt, welcher Artikel geliefert wird (TOP 1 ohne ORDER BY). Daher nur einen der beiden Parameter übergeben.
Existiert ein übergebener ItemKey nicht und passt auch ItemNrInt nicht, ist die Ergebnismenge leer; es wird kein Fehler gemeldet.
Existiert ItemKey nicht, passt aber ItemNrInt, wird der über ItemNrInt gefundene Artikel geliefert.
Gelesen wird mit NOLOCK, nicht festgeschriebene Änderungen können daher sichtbar sein.
Datentyp und Bedeutung der Werte von Enabled sind aus dem Code nicht ersichtlich.

Parameter

Parameter	Typ	Standardwert	Beschreibung
`ItemNrInt`	varchar(50) string	NULL	Interne Artikelnummer des Artikels. Wird verwendet, wenn `ItemKey` nicht übergeben wird oder nicht passt. Beispiel: `ART-100234`
`ItemKey`	int	NULL	Interner Schlüssel des Artikels in der Tabelle `Items`. Beispiel: `4711`

Antwort

Result-Set 1 · Immer; enthält eine Zeile, wenn ein Artikel gefunden wurde, sonst keine Zeilen.

Status des ermittelten Artikels.

Spalte	Typ	Beschreibung
`ItemKey`	int	Interner Schlüssel des Artikels.
`ItemNrInt` Kann leer sein	varchar(50) string	Interne Artikelnummer.
`Enabled` Kann leer sein	string	Aktiv-/Inaktiv-Kennzeichen des Artikels, wie in `Items.Enabled` gespeichert.

Beispielantwort

<SqlRowSet1>
  <row>
    <ItemKey>4711</ItemKey>
    <ItemNrInt>ART-100234</ItemNrInt>
    <Enabled>1</Enabled>
  </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:pixiGetItemStatus>
      <!-- <ItemNrInt>ART-100234</ItemNrInt> -->
      <!-- <ItemKey>4711</ItemKey> -->
    </ns1:pixiGetItemStatus>
  </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:pixiGetItemStatus>
      <!-- <ItemNrInt>ART-100234</ItemNrInt> -->
      <!-- <ItemKey>4711</ItemKey> -->
    </ns1:pixiGetItemStatus>
  </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 = [
    // 'ItemNrInt' => 'ART-100234',
    // 'ItemKey' => '4711',
];

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

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

Verwendete Tabellen

Items · Lesen

SQL-Objekt:: dbo.pipiGetItemStatus