Suppliers Lesen

pixiGetItemSuppliers

Liefert die Lieferantenzuordnungen von Artikeln (Lieferantenartikelnummer, EAN, Einkaufspreis, Mindestbestellmenge, Lieferzeiten), gefiltert nach Artikel oder Lieferant.

Liest die Artikel-Lieferanten-Zuordnungen aus AddItems und verknüpft sie mit den Stammdaten aus Suppliers. Es werden nur Zuordnungen geliefert, deren Lieferant in Suppliers existiert.

Normalisierung der Parameter

ItemKey = 0 und leere Zeichenketten bei EAN, ItemNrSuppl, ItemNrInt und SupplNr gelten als nicht gesetzt.

Prüfungen

Mindestens einer der Parameter ItemKey, EAN, ItemNrSuppl, ItemNrInt oder SupplNr muss gesetzt sein. OnlyActiveSuppliers allein genügt nicht. Andernfalls wird eine Fehlerzeile geliefert.
Ist SupplNr gesetzt, muss der Lieferant existieren. Andernfalls wird eine Fehlerzeile geliefert.

Filterlogik

Die Artikelfilter ItemKey, EAN, ItemNrSuppl und ItemNrInt werden mit ODER verknüpft. Eine Zeile wird geliefert, wenn einer der angegebenen Werte passt. Jeder Filter wird mit seiner Spalte in AddItems verglichen: ItemRef, EANUPC, ItemNrSuppl und ItemNrInt.
SupplNr wird mit UND verknüpft. Es schränkt das Ergebnis auf diesen einen Lieferanten ein.
Ist nur SupplNr angegeben, werden alle diesem Lieferanten zugeordneten Artikel geliefert.
Bei OnlyActiveSuppliers = 1 werden nur Zeilen geliefert, bei denen der Lieferant nicht deaktiviert ist und die Artikel-Lieferanten-Zuordnung aktiv ist (AddItems.Active = 1).

Eine Sortierreihenfolge ist nicht festgelegt.

Hinweise

Alle Lesezugriffe erfolgen mit NOLOCK, daher können nicht festgeschriebene Daten geliefert werden.
EAN wird mit der lieferantenspezifischen EAN AddItems.EANUPC verglichen, nicht mit einem anderen EAN-Feld des Artikels.
Fehler werden nicht als SQL-Fehler ausgelöst. Sie werden als normale Zeile mit den Spalten Error und ErrorMsg geliefert. Vor dem Auswerten der Datenspalten sollte auf die Spalte Error geprüft werden.
Werden mehrere Artikelfilter angegeben, ist das Ergebnis die Vereinigung aller Treffer, nicht deren Schnittmenge.
Ein Aufruf nur mit SupplNr kann bei Lieferanten mit vielen Artikeln eine große Ergebnismenge liefern. Paging ist nicht vorgesehen.

Parameter

Parameter	Typ	Standardwert	Beschreibung
`ItemKey`	int	NULL	Interner Artikelschlüssel (`AddItems.ItemRef`). `0` gilt als nicht gesetzt. Beispiel: `12345`
`EAN`	varchar(13) string	NULL	EAN/UPC der Lieferantenzuordnung (`AddItems.EANUPC`). Eine leere Zeichenkette gilt als nicht gesetzt. Beispiel: `4006381333931`
`ItemNrSuppl`	varchar(50) string	NULL	Artikelnummer des Lieferanten (`AddItems.ItemNrSuppl`). Eine leere Zeichenkette gilt als nicht gesetzt. Beispiel: `LF-98765`
`ItemNrInt`	varchar(50) string	NULL	Interne Artikelnummer (`AddItems.ItemNrInt`). Eine leere Zeichenkette gilt als nicht gesetzt. Beispiel: `ART-1001`
`OnlyActiveSuppliers`	bit boolean	0	Bei `1` werden nur Zuordnungen geliefert, deren Lieferant nicht deaktiviert ist und deren Zuordnung aktiv ist. Erlaubte Werte `0` – Alle Zuordnungen unabhängig vom Status liefern. `1` – Nur Zuordnungen nicht deaktivierter Lieferanten mit `AddItems.Active` = 1 liefern. Beispiel: `1`
`SupplNr`	varchar(4) string	NULL	Lieferantennummer. Schränkt das Ergebnis auf diesen Lieferanten ein und muss in `Suppliers` existieren. Eine leere Zeichenkette gilt als nicht gesetzt. Beispiel: `L001`

Antwort

Result-Set 1 · Wenn kein Filterparameter gesetzt ist oder `SupplNr` nicht existiert

Fehlerzeile; die Prozedur endet danach.

Spalte	Typ	Beschreibung
`Error`	varchar(5) string	Immer `Error`.
`ErrorMsg`	varchar string	Fehlertext.

Result-Set 2 · Nach erfolgreicher Prüfung (kann leer sein)

Eine Zeile je passender Artikel-Lieferanten-Zuordnung.

Spalte	Typ	Beschreibung
`ItemKey` Kann leer sein	int	Interner Artikelschlüssel (`AddItems.ItemRef`).
`EANUPC` Kann leer sein	string	EAN/UPC der Lieferantenzuordnung.
`ItemNrSuppl` Kann leer sein	string	Artikelnummer des Lieferanten.
`ItemNrInt` Kann leer sein	string	Interne Artikelnummer.
`SupplNr`	string	Lieferantennummer.
`SupplPrice` Kann leer sein	decimal	Einkaufspreis bei diesem Lieferanten.
`SupplierDisabled` Kann leer sein	boolean	Gibt an, ob der Lieferant deaktiviert ist (`Suppliers.Disabled`).
`MinOrderQty` Kann leer sein	decimal	Mindestbestellmenge bei diesem Lieferanten.
`OnlyPU` Kann leer sein	boolean	Nur in Verpackungseinheiten bestellen (`AddItems.OrderOnlyPackageUnits`).
`ItemDeliveryTime` Kann leer sein	int	Artikelspezifische Lieferzeit des Lieferanten (`AddItems.SupplDeliveryTime`).
`DeliveryTime` Kann leer sein	int	Standard-Liefertage des Lieferanten (`Suppliers.DefaultDeliveryDays`).

Beispielantwort

<SqlRowSet1>
  <row>
    <ItemKey>12345</ItemKey>
    <EANUPC>4006381333931</EANUPC>
    <ItemNrSuppl>LF-98765</ItemNrSuppl>
    <ItemNrInt>ART-1001</ItemNrInt>
    <SupplNr>L001</SupplNr>
    <SupplPrice>4.9500</SupplPrice>
    <SupplierDisabled>false</SupplierDisabled>
    <MinOrderQty>10</MinOrderQty>
    <OnlyPU>false</OnlyPU>
    <ItemDeliveryTime>5</ItemDeliveryTime>
    <DeliveryTime>3</DeliveryTime>
  </row>
</SqlRowSet1>

Fehlermeldungen

Status	Meldung	Ursache
Error	Please specify at least one parameter	Keiner der Parameter `ItemKey`, `EAN`, `ItemNrSuppl`, `ItemNrInt`, `SupplNr` ist gesetzt; `0` und leere Zeichenketten gelten als nicht gesetzt. Mindestens einen dieser Parameter angeben.
Error	Supplier not found	Die angegebene `SupplNr` existiert nicht in `Suppliers`. Eine gültige Lieferantennummer verwenden.

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:pixiGetItemSuppliers>
      <!-- <ItemKey>12345</ItemKey> -->
      <!-- <EAN>4006381333931</EAN> -->
      <!-- <ItemNrSuppl>LF-98765</ItemNrSuppl> -->
      <!-- <ItemNrInt>ART-1001</ItemNrInt> -->
      <!-- <OnlyActiveSuppliers>1</OnlyActiveSuppliers> -->
      <!-- <SupplNr>L001</SupplNr> -->
    </ns1:pixiGetItemSuppliers>
  </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:pixiGetItemSuppliers>
      <!-- <ItemKey>12345</ItemKey> -->
      <!-- <EAN>4006381333931</EAN> -->
      <!-- <ItemNrSuppl>LF-98765</ItemNrSuppl> -->
      <!-- <ItemNrInt>ART-1001</ItemNrInt> -->
      <!-- <OnlyActiveSuppliers>1</OnlyActiveSuppliers> -->
      <!-- <SupplNr>L001</SupplNr> -->
    </ns1:pixiGetItemSuppliers>
  </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' => '12345',
    // 'EAN' => '4006381333931',
    // 'ItemNrSuppl' => 'LF-98765',
    // 'ItemNrInt' => 'ART-1001',
    // 'OnlyActiveSuppliers' => '1',
    // 'SupplNr' => 'L001',
];

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

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

Verwendete Tabellen

AddItems · Lesen Suppliers · Lesen

SQL-Objekt:: dbo.pipiGetItemSuppliers