Suppliers Lesen

pixiGetSuppliers

Liefert Stammdaten der Lieferanten inklusive Hauptansprechpartner, optional beschränkt auf aktive Lieferanten oder eine Lieferantennummer.

Liest die Lieferantenstammdaten aus Suppliers. Jeder Lieferant wird über ContactId mit seinem Hauptansprechpartner aus pixi.Contact verknüpft.

Filterung:

Ein leerer Wert in SupplNr wird wie NULL behandelt.
Ist SupplNr gesetzt, wird nur der Lieferant mit dieser Nummer geliefert, und zwar unabhängig vom Aktiv-Status. OnlyActive hat in diesem Fall keine Wirkung.
Ist SupplNr nicht gesetzt und OnlyActive gleich 0, werden alle Lieferanten geliefert, auch inaktive.
Ist SupplNr nicht gesetzt und OnlyActive hat einen anderen Wert (Standard 1), werden nur Lieferanten mit Disabled = 0 geliefert.

Das Ergebnis ist nach SupplName sortiert.

Die Felder des Hauptansprechpartners (MainContact_*) werden als Leerstring geliefert, wenn kein Ansprechpartner hinterlegt ist oder das Feld leer ist. Die Spalte SupplierIsInactive enthält das Disabled-Kennzeichen des Lieferanten.

Hinweise

Beide Tabellen werden mit NOLOCK gelesen, nicht festgeschriebene Änderungen können daher sichtbar sein.
Jeder Wert ungleich 0 in OnlyActive wirkt wie 1. Mit diesem Filter werden Lieferanten, deren Disabled-Wert NULL ist, nicht geliefert.
Einige Spalten sind gegenüber der Tabelle umbenannt: SupplFaxNr → SupplFaxNR, CustNr → CustNR, MailBox → eMail, Disabled → SupplierIsInactive, SupplComment → SupplierComment.
Die Spaltentypen sind im Code nicht sichtbar; sie stammen aus den Tabellen Suppliers und pixi.Contact.

Parameter

Parameter Typ Standardwert Beschreibung

Parameter	Typ	Standardwert	Beschreibung
`OnlyActive`	int	1	`0` liefert alle Lieferanten inklusive inaktiver; jeder andere Wert liefert nur aktive Lieferanten. Wird ignoriert, wenn `SupplNr` gesetzt ist. Erlaubte Werte `0` – Aktive und inaktive Lieferanten liefern. `1` – Nur aktive Lieferanten liefern (`Disabled = 0`). Beispiel: `1`
`SupplNr`	varchar(4) string	NULL	Lieferantennummer. Wenn gesetzt, wird nur dieser Lieferant geliefert, auch wenn er inaktiv ist. Leerstring oder `NULL` liefert alle Lieferanten gemäß `OnlyActive`. Beispiel: `LI01`

OnlyActive

int

0 liefert alle Lieferanten inklusive inaktiver; jeder andere Wert liefert nur aktive Lieferanten. Wird ignoriert, wenn SupplNr gesetzt ist.

Erlaubte Werte

0 – Aktive und inaktive Lieferanten liefern.
1 – Nur aktive Lieferanten liefern (`Disabled = 0`).

Beispiel: 1

SupplNr

varchar(4)
string

NULL

Lieferantennummer. Wenn gesetzt, wird nur dieser Lieferant geliefert, auch wenn er inaktiv ist. Leerstring oder NULL liefert alle Lieferanten gemäß OnlyActive.

Beispiel: LI01

Antwort

Result-Set 1 · Immer (kann leer sein, wenn kein Lieferant passt).

Eine Zeile pro Lieferant mit Stammdaten und Hauptansprechpartner, sortiert nach SupplName.

Spalte	Typ	Beschreibung
`SupplNr`	string	Lieferantennummer.
`SupplName` Kann leer sein	string	Name des Lieferanten.
`SupplNameExt` Kann leer sein	string	Erweiterter Lieferantenname.
`DefaultDeliveryDays` Kann leer sein	int	Standard-Lieferzeit in Tagen.
`SupplFaxNR` Kann leer sein	string	Faxnummer des Lieferanten (Spalte `SupplFaxNr`).
`CustNR` Kann leer sein	string	Eigene Kundennummer beim Lieferanten (Spalte `CustNr`).
`eMail` Kann leer sein	string	E-Mail-Adresse des Lieferanten (Spalte `MailBox`).
`SupAnrede` Kann leer sein	string	Anrede der Lieferantenadresse.
`SupName2` Kann leer sein	string	Zweite Namenszeile der Lieferantenadresse.
`SupAddress` Kann leer sein	string	Straße/Adresse des Lieferanten.
`SupZip` Kann leer sein	string	Postleitzahl des Lieferanten.
`SupPhone1` Kann leer sein	string	Erste Telefonnummer des Lieferanten.
`CanDoDirectFulfillment` Kann leer sein	boolean	Kennzeichen, ob der Lieferant Direktversand (Streckengeschäft) durchführen kann.
`SupplGroup` Kann leer sein	string	Lieferantengruppe.
`SupCity` Kann leer sein	string	Ort des Lieferanten.
`SupPhone2` Kann leer sein	string	Zweite Telefonnummer des Lieferanten.
`SupplCtry` Kann leer sein	string	Land des Lieferanten.
`CurrencyId` Kann leer sein	string	Währung des Lieferanten.
`eMailSupplOrder` Kann leer sein	string	E-Mail-Adresse für Lieferantenbestellungen.
`HomePageUrl` Kann leer sein	string	Webseite des Lieferanten.
`MainContact_Title`	string	Titel des Hauptansprechpartners; Leerstring, wenn nicht vorhanden.
`MainContact_FirstName`	string	Vorname des Hauptansprechpartners; Leerstring, wenn nicht vorhanden.
`MainContact_LastName`	string	Nachname des Hauptansprechpartners; Leerstring, wenn nicht vorhanden.
`MainContact_JobTitle`	string	Berufsbezeichnung des Hauptansprechpartners; Leerstring, wenn nicht vorhanden.
`MainContact_JobFunction`	string	Funktion des Hauptansprechpartners; Leerstring, wenn nicht vorhanden.
`MainContact_Phone`	string	Telefonnummer des Hauptansprechpartners; Leerstring, wenn nicht vorhanden.
`MainContact_MobilePhone`	string	Mobilnummer des Hauptansprechpartners; Leerstring, wenn nicht vorhanden.
`MainContact_Fax`	string	Faxnummer des Hauptansprechpartners; Leerstring, wenn nicht vorhanden.
`MainContact_Email`	string	E-Mail-Adresse des Hauptansprechpartners; Leerstring, wenn nicht vorhanden.
`SupplierIsInactive` Kann leer sein	boolean	Inaktiv-Kennzeichen des Lieferanten (Spalte `Disabled`); `0` = aktiv.
`SupplierComment` Kann leer sein	string	Kommentar zum Lieferanten (Spalte `SupplComment`).

Beispielantwort

<SqlRowSet1>
  <row>
    <SupplNr>LI01</SupplNr>
    <SupplName>Muster Großhandel GmbH</SupplName>
    <SupplNameExt>Abteilung Einkauf</SupplNameExt>
    <DefaultDeliveryDays>3</DefaultDeliveryDays>
    <SupplFaxNR>+49 89 1234567-9</SupplFaxNR>
    <CustNR>K-100234</CustNR>
    <eMail>info@muster-grosshandel.de</eMail>
    <SupAnrede>Firma</SupAnrede>
    <SupName2/>
    <SupAddress>Industriestraße 12</SupAddress>
    <SupZip>80331</SupZip>
    <SupPhone1>+49 89 1234567-0</SupPhone1>
    <CanDoDirectFulfillment>0</CanDoDirectFulfillment>
    <SupplGroup>A</SupplGroup>
    <SupCity>München</SupCity>
    <SupPhone2/>
    <SupplCtry>DE</SupplCtry>
    <CurrencyId>EUR</CurrencyId>
    <eMailSupplOrder>bestellung@muster-grosshandel.de</eMailSupplOrder>
    <HomePageUrl>https://www.muster-grosshandel.de</HomePageUrl>
    <MainContact_Title/>
    <MainContact_FirstName>Anna</MainContact_FirstName>
    <MainContact_LastName>Schmidt</MainContact_LastName>
    <MainContact_JobTitle>Key Account Managerin</MainContact_JobTitle>
    <MainContact_JobFunction>Vertrieb</MainContact_JobFunction>
    <MainContact_Phone>+49 89 1234567-21</MainContact_Phone>
    <MainContact_MobilePhone>+49 171 2345678</MainContact_MobilePhone>
    <MainContact_Fax/>
    <MainContact_Email>a.schmidt@muster-grosshandel.de</MainContact_Email>
    <SupplierIsInactive>0</SupplierIsInactive>
    <SupplierComment>Lieferung nur werktags</SupplierComment>
  </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:pixiGetSuppliers>
      <!-- <OnlyActive>1</OnlyActive> -->
      <!-- <SupplNr>LI01</SupplNr> -->
    </ns1:pixiGetSuppliers>
  </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:pixiGetSuppliers>
      <!-- <OnlyActive>1</OnlyActive> -->
      <!-- <SupplNr>LI01</SupplNr> -->
    </ns1:pixiGetSuppliers>
  </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 = [
    // 'OnlyActive' => '1',
    // 'SupplNr' => 'LI01',
];

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

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

Verwendete Tabellen

Suppliers · Lesen Contact · Lesen

SQL-Objekt:: dbo.pipiGetSuppliers