Items Lesen

pixiGetEanByItemNr

Liefert den EAN/UPC-Code eines Artikels anhand seiner internen Artikelnummer.

Skalarfunktion, die in Items den Artikel sucht, dessen ItemNrInt dem Parameter ItemNrInt entspricht, und dessen EANUPC-Wert zurückgibt.

Wird kein Artikel gefunden, ist das Ergebnis NULL.
Ist EANUPC beim Artikel leer oder NULL, wird dieser Wert unverändert zurückgegeben.

Hinweise

Die Tabelle wird mit NOLOCK gelesen; nicht festgeschriebene Änderungen können zurückgegeben werden.
Der Rückgabetyp ist varchar(13); längere Werte in EANUPC würden auf 13 Zeichen gekürzt.
Gäbe es mehrere Zeilen mit derselben ItemNrInt, würde der Wert einer davon ohne definierte Reihenfolge zurückgegeben.

Parameter

Parameter	Typ	Standardwert	Beschreibung
`ItemNrInt` Pflicht	varchar(50) string	–	Interne Artikelnummer (`ItemNrInt`) des Artikels, dessen EAN abgefragt wird. Beispiel: `10001234`

Antwort

Result-Set 1 · Immer

Einzelwert mit dem EAN/UPC-Code des Artikels oder NULL, wenn der Artikel nicht gefunden wird.

Spalte	Typ	Beschreibung
`Ean` Kann leer sein	varchar(13) string	EAN/UPC-Code aus `Items.EANUPC`.

Beispielantwort

<SqlRowSet1>
  <row>
    <Ean>4012345678901</Ean>
  </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:pixiGetEanByItemNr>
      <ItemNrInt>10001234</ItemNrInt>
    </ns1:pixiGetEanByItemNr>
  </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:pixiGetEanByItemNr>
      <ItemNrInt>10001234</ItemNrInt>
    </ns1:pixiGetEanByItemNr>
  </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' => '10001234',
];

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

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

Verwendete Tabellen

Items · Lesen

SQL-Objekt:: dbo.pipiGetEanByItemNr