Suppliers Lesen

pixiGetItemDeliveryInfo

Liefert die bestellten bzw. bestätigten Lieferantenbestellpositionen eines Artikels mit Lieferantennummer, Menge und voraussichtlichem Liefertermin.

Ermittelt die erwarteten Lieferantenlieferungen für einen Artikel.

Leere Zeichenketten in EAN, ItemNrSuppl und ItemNrInt sowie der Wert 0 in ItemKey werden als nicht gesetzt behandelt.
Der Artikel wird über einen der übergebenen Identifikatoren bestimmt. Die Kriterien werden mit ODER verknüpft: Eine Lieferantenbestellposition wird geliefert, wenn ihr Artikel zu ItemKey oder zur EAN/UPC (EANUPC) oder zur Lieferantenartikelnummer oder zur internen Artikelnummer passt.
Es werden nur Lieferantenbestellpositionen geliefert, deren Lieferantenbestellung einen als bestellt/bestätigt gekennzeichneten Status hat (IsOrderedConfirmed = 1, also die Status BES und BGT) und deren Menge größer als 0 ist.
Je Position werden Lieferantenbestellnummer, Lieferantennummer, bestellte Menge und voraussichtlicher Liefertermin ausgegeben.

Sortierung: Positionen mit voraussichtlichem Liefertermin zuerst, aufsteigend nach diesem Datum; Positionen ohne Liefertermin am Ende.

Wird kein Identifikator übergeben, werden keine Zeilen geliefert.

Hinweise

Alle Tabellen werden mit NOLOCK gelesen; nicht festgeschriebene Daten können erscheinen.
Da die Identifikatoren mit ODER verknüpft werden, liefert die Übergabe mehrerer Identifikatoren verschiedener Artikel die Positionen aller dieser Artikel. Das Ergebnis enthält keine Artikelspalte, sodass die Zeilen nachträglich keinem Artikel zugeordnet werden können. Für eindeutige Ergebnisse nur einen Identifikator übergeben.
SupplierOrderQty ist die gespeicherte Menge der Lieferantenbestellposition; bereits eingegangene Mengen werden nicht abgezogen.
EstimatedDelivery wird nach datetime konvertiert und ist leer, wenn die Position keinen voraussichtlichen Liefertermin hat.

Parameter

Parameter	Typ	Standardwert	Beschreibung
`ItemKey`	int	NULL	Interner Schlüssel des Artikels (`ItemKey`). `0` wird als nicht gesetzt behandelt. Beispiel: `4711`
`EAN`	varchar(13) string	NULL	EAN/UPC des Artikels, verglichen mit `EANUPC`. Eine leere Zeichenkette wird als nicht gesetzt behandelt. Beispiel: `4006381333931`
`ItemNrSuppl`	varchar(50) string	NULL	Lieferantenartikelnummer des Artikels (`ItemNrSuppl`). Eine leere Zeichenkette wird als nicht gesetzt behandelt. Beispiel: `LF-100-BLK`
`ItemNrInt`	varchar(50) string	NULL	Interne Artikelnummer (`ItemNrInt`). Eine leere Zeichenkette wird als nicht gesetzt behandelt. Beispiel: `A-10023`

Antwort

Result-Set 1 · Immer; leer, wenn kein Identifikator übergeben wird oder keine passende bestellte/bestätigte Lieferantenbestellposition existiert.

Eine Zeile je passender Lieferantenbestellposition, Positionen mit Liefertermin zuerst (aufsteigend), Positionen ohne Liefertermin zuletzt.

Spalte	Typ	Beschreibung
`SupplierOrderNr`	int	ID der Lieferantenbestellung (`SupplierOrder.Id`).
`SupplNr` Kann leer sein	string	Lieferantennummer des Lieferanten der Bestellung.
`SupplierOrderQty`	decimal	Menge der Lieferantenbestellposition (immer größer als 0).
`EstimatedDelivery` Kann leer sein	datetime dateTime	Voraussichtlicher Liefertermin der Position, nach `datetime` konvertiert; leer, wenn nicht gesetzt.

Beispielantwort

<SqlRowSet1>
  <row>
    <SupplierOrderNr>10234</SupplierOrderNr>
    <SupplNr>L1001</SupplNr>
    <SupplierOrderQty>50</SupplierOrderQty>
    <EstimatedDelivery>2024-06-12T00:00:00</EstimatedDelivery>
  </row>
  <row>
    <SupplierOrderNr>10251</SupplierOrderNr>
    <SupplNr>L1007</SupplNr>
    <SupplierOrderQty>20</SupplierOrderQty>
  </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:pixiGetItemDeliveryInfo>
      <!-- <ItemKey>4711</ItemKey> -->
      <!-- <EAN>4006381333931</EAN> -->
      <!-- <ItemNrSuppl>LF-100-BLK</ItemNrSuppl> -->
      <!-- <ItemNrInt>A-10023</ItemNrInt> -->
    </ns1:pixiGetItemDeliveryInfo>
  </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:pixiGetItemDeliveryInfo>
      <!-- <ItemKey>4711</ItemKey> -->
      <!-- <EAN>4006381333931</EAN> -->
      <!-- <ItemNrSuppl>LF-100-BLK</ItemNrSuppl> -->
      <!-- <ItemNrInt>A-10023</ItemNrInt> -->
    </ns1:pixiGetItemDeliveryInfo>
  </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',
    // 'EAN' => '4006381333931',
    // 'ItemNrSuppl' => 'LF-100-BLK',
    // 'ItemNrInt' => 'A-10023',
];

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

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

Verwendete Tabellen

SupplierOrderLine · Lesen SupplierOrder · Lesen SupplierOrderStatus · Lesen Suppliers · Lesen items · Lesen

SQL-Objekt:: dbo.pipiGetItemDeliveryInfo