Suppliers Lesen

pixiGetSOrders

Liefert Lieferantenbestellungen eines Standorts, gefiltert nach Status, überfälligen/fehlenden Lieferterminen, Statusänderungsdatum und externen Bestellnummern.

Liefert Lieferantenbestellungen aus pixi.SupplierOrder zusammen mit Lieferant, Status, Standort, anlegendem/änderndem Benutzer und den zugehörigen Wareneingängen. Die Abfrage wird als dynamisches SQL aufgebaut und mit sp_executesql ausgeführt.

Filter

Nur Bestellungen, deren Lieferstandort die LocID = LocationID hat (Standard 001).
Es werden höchstens RLimit Zeilen geliefert (TOP (@RLimit)). Der Standardwert 0 liefert keine Zeilen; daher muss ein positiver Wert übergeben werden.
Statusfilter:
- Sind ShowDueDate und ShowNoDate beide 0, werden die Flags per ODER verknüpft: ShowNew → Statusflag IsNew, ShowOrd → IsOrdered, ShowCon → IsConfirmed, ShowCls → IsClosed.
- Bei ShowNoDate = 1 werden nur bestellte Bestellungen (IsOrdered) geliefert, die mindestens eine Position ohne voraussichtlichen Liefertermin haben. Dieser Filter hat Vorrang vor ShowDueDate.
- Bei ShowDueDate = 1 (und ShowNoDate = 0) werden nur bestellte Bestellungen geliefert, die mindestens eine Position mit voraussichtlichem Liefertermin vor dem aktuellen Zeitpunkt haben.
- In beiden Terminmodi werden ShowNew, ShowOrd, ShowCon und ShowCls ignoriert.
- Sind alle sechs Flags 0, entfällt der Statusfilter.
Statusänderungsdatum: Ist StatusChangeDateFrom und/oder StatusChangeDateTo gesetzt, werden nur Bestellungen geliefert, deren letzter Historieneintrag in hist.pixi_SupplierOrder (MAX(AuditDate)) im Bereich >= From und < To liegt.
Externe Bestellnummern: Ist ExtOrderNrs gesetzt (XML-Liste), werden nur Bestellungen geliefert, deren ExternalCode einer der übergebenen Nummern entspricht.

Wareneingänge Für jeden Wareneingang in SDelHeader wird das Feld SDelHextOrderNr am ; aufgeteilt. Numerische Teile werden der InternalNumber der Bestellung zugeordnet. Die Wareneingangsnummern (SDelHNr) werden in GoodsReceipts als mit ; getrennte Liste geliefert.

Sortierung nach OrderDate absteigend.

Hinweise

Stolperfalle RLimit: Der Standardwert 0 führt zu TOP (0) und damit zu einem leeren Ergebnis. Einen Wert für „unbegrenzt“ gibt es nicht.
Stolperfalle Statusänderungsdatum: Wird nur StatusChangeDateFrom übergeben, fällt die Obergrenze auf MAX(AuditDate) zurück. Die Bedingung MAX(AuditDate) < MAX(AuditDate) ist nie erfüllt, daher werden keine Bestellungen geliefert. Zusätzlich StatusChangeDateTo oder nur StatusChangeDateTo übergeben. Die Obergrenze ist exklusiv.
NULL für die Flags, LocationID und RLimit wird durch die Standardwerte ersetzt. Ein leeres oder nur aus Leerzeichen bestehendes ExtOrderNrs wird als NULL behandelt.
ExtOrderNrs wird elementbasiert per OPENXML unter dem Pfad /ExtOrders/ExtOrder gelesen, mit dem Kindelement ExtOrderNr. Das XML-Dokument wird nicht mit sp_xml_removedocument freigegeben.
Alle Tabellen werden mit NOLOCK gelesen; nicht festgeschriebene Daten können enthalten sein.
Bestellungen werden per INNER JOIN mit Lieferant, Status, Standort und für anlegenden wie ändernden Benutzer mit ucs_users verknüpft. Bestellungen ohne passenden Datensatz fehlen im Ergebnis.
GoodsReceipts wird über eine varchar(100)-Konvertierung gebildet; lange Listen werden abgeschnitten. Die Wareneingangsliste wird bei jedem Aufruf über die gesamte Tabelle SDelHeader berechnet, was bei großen Datenbanken langsam sein kann.
RecordBatchNr und PixiOrderCreated sind immer NULL und dienen nur der Kompatibilität.

Parameter

Parameter	Typ	Standardwert	Beschreibung
`LocationID`	varchar(3) string	001	Standortkürzel (`LocID`) des Lieferstandorts. Nur Bestellungen dieses Standorts werden geliefert. Beispiel: `001`
`RLimit`	int	0	Maximale Anzahl Zeilen (`TOP`). `0` liefert keine Zeilen; daher einen positiven Wert übergeben. Beispiel: `500`
`ShowNew`	bit boolean	1	Bestellungen mit Status „neu“ (`IsNew`) einbeziehen. Nur wirksam, wenn `ShowDueDate` und `ShowNoDate` `0` sind. Beispiel: `1`
`ShowOrd`	bit boolean	1	Bestellte Bestellungen (`IsOrdered`, Status BES) einbeziehen. Nur wirksam, wenn `ShowDueDate` und `ShowNoDate` `0` sind. Beispiel: `1`
`ShowCon`	bit boolean	1	Bestätigte Bestellungen (`IsConfirmed`, Status CON) einbeziehen. Nur wirksam, wenn `ShowDueDate` und `ShowNoDate` `0` sind. Beispiel: `1`
`ShowCls`	bit boolean	1	Abgeschlossene Bestellungen (`IsClosed`, Status CLS) einbeziehen. Nur wirksam, wenn `ShowDueDate` und `ShowNoDate` `0` sind. Beispiel: `0`
`ShowDueDate`	bit boolean	0	Bei `1` (und `ShowNoDate` = `0`): nur bestellte Bestellungen mit mindestens einer Position, deren voraussichtlicher Liefertermin in der Vergangenheit liegt. Beispiel: `0`
`ShowNoDate`	bit boolean	0	Bei `1`: nur bestellte Bestellungen mit mindestens einer Position ohne voraussichtlichen Liefertermin. Hat Vorrang vor `ShowDueDate`. Beispiel: `0`
`StatusChangeDateFrom`	datetime dateTime	NULL	Untergrenze (inklusiv) für die letzte Änderung in der Bestellhistorie. Allein übergeben liefert der Parameter keine Zeilen (siehe Hinweise). Beispiel: `2024-05-01T00:00:00`
`StatusChangeDateTo`	datetime dateTime	NULL	Obergrenze (exklusiv) für die letzte Änderung in der Bestellhistorie. Beispiel: `2024-06-01T00:00:00`
`ExtOrderNrs`	varchar(max) xml	NULL	Optionale XML-Liste externer Bestellnummern. Nur Bestellungen mit passendem `ExternalCode` werden geliefert. Beispiel: `<ExtOrders> <ExtOrder> <ExtOrderNr>PO-2024-0012</ExtOrderNr> </ExtOrder> <ExtOrder> <ExtOrderNr>PO-2024-0013</ExtOrderNr> </ExtOrder> </ExtOrders>`

Antwort

Result-Set 1 · Immer (leer bei `RLimit` = 0 oder ohne Treffer)

Lieferantenbestellungen, absteigend nach Bestelldatum sortiert.

Spalte	Typ	Beschreibung
`OrderNr`	int	Interne Bestellnummer (`InternalNumber`).
`SupplNr` Kann leer sein	string	Lieferantennummer.
`SupplGroup` Kann leer sein	string	Lieferantengruppe.
`OrderDate` Kann leer sein	datetime dateTime	Bestelldatum.
`Status` Kann leer sein	varchar(3) string	Statuscode, z. B. BES, CON, CLS.
`CreateDate` Kann leer sein	datetime dateTime	Anlagezeitpunkt.
`CreateEmp` Kann leer sein	string	Benutzername des Anlegers.
`UpdateDate` Kann leer sein	datetime dateTime	Zeitpunkt der letzten Änderung.
`UpdateEmp` Kann leer sein	string	Benutzername des letzten Bearbeiters.
`SOrderLocation`	string	Standortkürzel (`LocID`) des Lieferstandorts.
`RecordBatchNr` Kann leer sein	int	Immer `NULL` (Kompatibilitätsspalte).
`SOrderKey`	int	Technischer Schlüssel der Bestellung (`Id`).
`ExtOrderNr` Kann leer sein	string	Externe Bestellnummer (`ExternalCode`).
`XMLsent` Kann leer sein	boolean	Kennzeichen, ob das Direct-Fulfillment-XML versendet wurde (`DfXmlSent`).
`SupplierFulfillment` Kann leer sein	boolean	Kennzeichen für eine Streckenbestellung (`DirectFulfillmentOrder`).
`SOrdersNote` Kann leer sein	varchar(1024) string	Notiz für den Lieferanten.
`SupplName` Kann leer sein	string	Lieferantenname.
`PixiOrderCreated` Kann leer sein	bit boolean	Immer `NULL` (Kompatibilitätsspalte).
`GoodsReceipts` Kann leer sein	varchar(8000) string	Zugeordnete Wareneingangsnummern (`SDelHNr`), getrennt durch `;` . `NULL`, wenn keine vorhanden sind.

Beispielantwort

<SqlRowSet1>
  <row>
    <OrderNr>10452</OrderNr>
    <SupplNr>70001</SupplNr>
    <SupplGroup>A</SupplGroup>
    <OrderDate>2024-05-14T09:12:00</OrderDate>
    <Status>BES</Status>
    <CreateDate>2024-05-14T09:10:00</CreateDate>
    <CreateEmp>mmueller</CreateEmp>
    <UpdateDate>2024-05-15T11:30:00</UpdateDate>
    <UpdateEmp>mmueller</UpdateEmp>
    <SOrderLocation>001</SOrderLocation>
    <SOrderKey>8831</SOrderKey>
    <ExtOrderNr>PO-2024-0012</ExtOrderNr>
    <XMLsent>false</XMLsent>
    <SupplierFulfillment>false</SupplierFulfillment>
    <SOrdersNote>Bitte Liefertermin bestätigen</SOrdersNote>
    <SupplName>Muster Buchvertrieb GmbH</SupplName>
    <GoodsReceipts>5521; 5530</GoodsReceipts>
  </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:pixiGetSOrders>
      <!-- <LocationID>001</LocationID> -->
      <!-- <RLimit>500</RLimit> -->
      <!-- <ShowNew>1</ShowNew> -->
      <!-- <ShowOrd>1</ShowOrd> -->
      <!-- <ShowCon>1</ShowCon> -->
      <!-- <ShowCls>0</ShowCls> -->
      <!-- <ShowDueDate>0</ShowDueDate> -->
      <!-- <ShowNoDate>0</ShowNoDate> -->
      <!-- <StatusChangeDateFrom>2024-05-01T00:00:00</StatusChangeDateFrom> -->
      <!-- <StatusChangeDateTo>2024-06-01T00:00:00</StatusChangeDateTo> -->
      <!-- <ExtOrderNrs><![CDATA[<ExtOrders><ExtOrder><ExtOrderNr>PO-2024-0012</ExtOrderNr></ExtOrder><ExtOrder><ExtOrderNr>PO-2024-0013</ExtOrderNr></ExtOrder></ExtOrders>]]></ExtOrderNrs> -->
    </ns1:pixiGetSOrders>
  </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:pixiGetSOrders>
      <!-- <LocationID>001</LocationID> -->
      <!-- <RLimit>500</RLimit> -->
      <!-- <ShowNew>1</ShowNew> -->
      <!-- <ShowOrd>1</ShowOrd> -->
      <!-- <ShowCon>1</ShowCon> -->
      <!-- <ShowCls>0</ShowCls> -->
      <!-- <ShowDueDate>0</ShowDueDate> -->
      <!-- <ShowNoDate>0</ShowNoDate> -->
      <!-- <StatusChangeDateFrom>2024-05-01T00:00:00</StatusChangeDateFrom> -->
      <!-- <StatusChangeDateTo>2024-06-01T00:00:00</StatusChangeDateTo> -->
      <!-- <ExtOrderNrs><![CDATA[<ExtOrders><ExtOrder><ExtOrderNr>PO-2024-0012</ExtOrderNr></ExtOrder><ExtOrder><ExtOrderNr>PO-2024-0013</ExtOrderNr></ExtOrder></ExtOrders>]]></ExtOrderNrs> -->
    </ns1:pixiGetSOrders>
  </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 = [
    // 'LocationID' => '001',
    // 'RLimit' => '500',
    // 'ShowNew' => '1',
    // 'ShowOrd' => '1',
    // 'ShowCon' => '1',
    // 'ShowCls' => '0',
    // 'ShowDueDate' => '0',
    // 'ShowNoDate' => '0',
    // 'StatusChangeDateFrom' => '2024-05-01T00:00:00',
    // 'StatusChangeDateTo' => '2024-06-01T00:00:00',
    // 'ExtOrderNrs' => '<ExtOrders><ExtOrder><ExtOrderNr>PO-2024-0012</ExtOrderNr></ExtOrder><ExtOrder><ExtOrderNr>PO-2024-0013</ExtOrderNr></ExtOrder></ExtOrders>',
];

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

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

Verwendete Tabellen

pixi_SupplierOrder · Lesen SDelHeader · Lesen SupplierOrder · Lesen Suppliers · Lesen SupplierOrderStatus · Lesen Location · Lesen ucs_users · Lesen SupplierOrderLine · Lesen

SQL-Objekt:: dbo.pipiGetSOrders