Suppliers Lesen

pixiReadDeliveryHeaders

Liefert Lieferungskopfdaten (Wareneingänge von Lieferanten) aus `SDelHeader`, seitenweise nach Schlüssel und optional nach Anlage- und/oder Änderungsdatum gefiltert.

Liest Lieferungskopfdaten (Lieferungen von Lieferanten / Wareneingänge) aus der Tabelle SDelHeader.

Vorbereitung

Wird SDelHKey nicht übergeben, wird er auf 0 gesetzt.
Ist RowCount NULL, wird 1000 verwendet.

Auswahl des Filters – es wird genau ein Filtermodus angewendet, in dieser Priorität:

CreateAndUpdateDateFrom / CreateAndUpdateDateTo: Ein Datensatz erfüllt die Untergrenze, wenn Anlage- oder Änderungsdatum >= dem From-Wert ist, und die Obergrenze, wenn Anlage- oder Änderungsdatum < dem To-Wert ist.
CreateDateFrom / CreateDateTo: Filter auf SDelHCreateDate (From inklusive, To exklusive).
UpdateDateFrom / UpdateDateTo: Filter auf SDelHUpdateDate (From inklusive, To exklusive).
Kein Datumsparameter: alle Datensätze.

Parameter eines niedriger priorisierten Modus werden ignoriert, sobald ein höher priorisierter Modus verwendet wird (z. B. wird CreateDateFrom ignoriert, wenn CreateAndUpdateDateFrom gesetzt ist).

Paging In jedem Modus werden nur Datensätze mit SDelHKey größer als SDelHKey geliefert, höchstens RowCount Zeilen, aufsteigend sortiert nach SDelHKey. Für die nächste Seite wird der höchste SDelHKey der vorherigen Seite übergeben.

Hinweise

SDelHKey ist kein Filter auf genaue Übereinstimmung: Bei Übergabe eines Schlüssels werden die Datensätze nach diesem Schlüssel geliefert. Der Code enthält zwar einen Zweig für die Abfrage eines einzelnen Schlüssels und einen Zweig mit leerem Ergebnis, beide sind aber nicht erreichbar, da SDelHKey und RowCount nach der Vorbelegung nie NULL sind. Für einen bestimmten Lieferungskopf SDelHKey = Schlüssel − 1 und RowCount = 1 übergeben und den gelieferten Schlüssel prüfen.
Der kombinierte Anlage-/Änderungsfilter verknüpft beide Grenzen per ODER und ist daher weiter als ein strikter Zeitraum: Ein vor From angelegter, aber nach To geänderter Datensatz kann beide Grenzen erfüllen.
Die Tabelle wird mit NOLOCK gelesen; nicht festgeschriebene Daten können enthalten sein.
Ein negativer RowCount führt zu einem SQL-Fehler bei TOP; 0 liefert keine Zeilen.
Die Spalte SDelHfinalDicsount ist in der Datenbank so geschrieben.

Parameter

Parameter	Typ	Standardwert	Beschreibung
`SDelHKey`	int	NULL	Paging-Cursor: Es werden nur Lieferungsköpfe mit einem Schlüssel größer als dieser Wert geliefert. NULL wird als 0 behandelt. Beispiel: `0`
`CreateDateFrom`	datetime dateTime	NULL	Untergrenze (inklusive) für `SDelHCreateDate`. Wird ignoriert, wenn ein CreateAndUpdate-Datum gesetzt ist. Beispiel: `2024-01-01T00:00:00`
`CreateDateTo`	datetime dateTime	NULL	Obergrenze (exklusive) für `SDelHCreateDate`. Wird ignoriert, wenn ein CreateAndUpdate-Datum gesetzt ist. Beispiel: `2024-02-01T00:00:00`
`UpdateDateFrom`	datetime dateTime	NULL	Untergrenze (inklusive) für `SDelHUpdateDate`. Wird nur verwendet, wenn weder ein CreateAndUpdate- noch ein Create-Datum gesetzt ist. Beispiel: `2024-01-15T00:00:00`
`UpdateDateTo`	datetime dateTime	NULL	Obergrenze (exklusive) für `SDelHUpdateDate`. Wird nur verwendet, wenn weder ein CreateAndUpdate- noch ein Create-Datum gesetzt ist. Beispiel: `2024-01-16T00:00:00`
`CreateAndUpdateDateFrom`	datetime dateTime	NULL	Untergrenze (inklusive): trifft zu, wenn Anlage- oder Änderungsdatum an oder nach diesem Wert liegt. Hat die höchste Priorität unter den Datumsfiltern. Beispiel: `2024-01-15T00:00:00`
`CreateAndUpdateDateTo`	datetime dateTime	NULL	Obergrenze (exklusive): trifft zu, wenn Anlage- oder Änderungsdatum vor diesem Wert liegt. Hat die höchste Priorität unter den Datumsfiltern. Beispiel: `2024-01-16T00:00:00`
`RowCount`	int	1000	Maximale Anzahl gelieferter Zeilen. NULL wird als 1000 behandelt. Beispiel: `500`

Antwort

Result-Set 1 · Immer (ggf. leer).

Lieferungsköpfe, die dem aktiven Filter entsprechen, höchstens RowCount Zeilen, aufsteigend sortiert nach SDelHKey.

Spalte	Typ	Beschreibung
`SDelHKey`	int	Interner Schlüssel des Lieferungskopfs; als Paging-Cursor verwenden.
`SDelHDate` Kann leer sein	dateTime	Lieferdatum.
`SDelHLocationID` Kann leer sein	string	Lager (Location) der Lieferung.
`SDelHSupplNr` Kann leer sein	string	Lieferantennummer.
`SDelHNr` Kann leer sein	string	Lieferungsnummer (z. B. Lieferscheinnummer).
`SDelHNote` Kann leer sein	string	Bemerkung zur Lieferung.
`SDelHStatus` Kann leer sein	string	Status der Lieferung.
`SDelHCreateDate` Kann leer sein	dateTime	Anlagedatum des Datensatzes.
`SDelHCreateEmp` Kann leer sein	string	Mitarbeiter, der den Datensatz angelegt hat.
`SDelHUpdateDate` Kann leer sein	dateTime	Datum der letzten Änderung.
`SDelHUpdateEmp` Kann leer sein	string	Mitarbeiter, der die letzte Änderung vorgenommen hat.
`SDelHextInvoiceNr` Kann leer sein	string	Externe Rechnungsnummer (des Lieferanten).
`SDelHextOrderNr` Kann leer sein	string	Externe Bestellnummer.
`SDelHfinalDicsount` Kann leer sein	decimal	Schlussrabatt der Lieferung (Spaltenname in der Datenbank so geschrieben).
`PiccoUser` Kann leer sein	string	Picco-Benutzer (mobiles Gerät), der mit der Lieferung verknüpft ist.
`LockedByPicco` Kann leer sein	boolean	Gibt an, ob die Lieferung durch Picco gesperrt ist.
`WasReopened` Kann leer sein	boolean	Gibt an, ob die Lieferung wieder geöffnet wurde.

Beispielantwort

<SqlRowSet1>
  <row>
    <SDelHKey>1201</SDelHKey>
    <SDelHDate>2024-01-15T00:00:00</SDelHDate>
    <SDelHLocationID>001</SDelHLocationID>
    <SDelHSupplNr>70012</SDelHSupplNr>
    <SDelHNr>LS-458812</SDelHNr>
    <SDelHNote>Teillieferung</SDelHNote>
    <SDelHStatus>OK</SDelHStatus>
    <SDelHCreateDate>2024-01-15T09:12:44</SDelHCreateDate>
    <SDelHCreateEmp>MM</SDelHCreateEmp>
    <SDelHUpdateDate>2024-01-15T10:03:10</SDelHUpdateDate>
    <SDelHUpdateEmp>MM</SDelHUpdateEmp>
    <SDelHextInvoiceNr>RE-2024-0099</SDelHextInvoiceNr>
    <SDelHextOrderNr>B-10234</SDelHextOrderNr>
    <SDelHfinalDicsount>0.00</SDelHfinalDicsount>
    <PiccoUser/>
    <LockedByPicco>0</LockedByPicco>
    <WasReopened>0</WasReopened>
  </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:pixiReadDeliveryHeaders>
      <!-- <SDelHKey>0</SDelHKey> -->
      <!-- <CreateDateFrom>2024-01-01T00:00:00</CreateDateFrom> -->
      <!-- <CreateDateTo>2024-02-01T00:00:00</CreateDateTo> -->
      <!-- <UpdateDateFrom>2024-01-15T00:00:00</UpdateDateFrom> -->
      <!-- <UpdateDateTo>2024-01-16T00:00:00</UpdateDateTo> -->
      <!-- <CreateAndUpdateDateFrom>2024-01-15T00:00:00</CreateAndUpdateDateFrom> -->
      <!-- <CreateAndUpdateDateTo>2024-01-16T00:00:00</CreateAndUpdateDateTo> -->
      <!-- <RowCount>500</RowCount> -->
    </ns1:pixiReadDeliveryHeaders>
  </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:pixiReadDeliveryHeaders>
      <!-- <SDelHKey>0</SDelHKey> -->
      <!-- <CreateDateFrom>2024-01-01T00:00:00</CreateDateFrom> -->
      <!-- <CreateDateTo>2024-02-01T00:00:00</CreateDateTo> -->
      <!-- <UpdateDateFrom>2024-01-15T00:00:00</UpdateDateFrom> -->
      <!-- <UpdateDateTo>2024-01-16T00:00:00</UpdateDateTo> -->
      <!-- <CreateAndUpdateDateFrom>2024-01-15T00:00:00</CreateAndUpdateDateFrom> -->
      <!-- <CreateAndUpdateDateTo>2024-01-16T00:00:00</CreateAndUpdateDateTo> -->
      <!-- <RowCount>500</RowCount> -->
    </ns1:pixiReadDeliveryHeaders>
  </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 = [
    // 'SDelHKey' => '0',
    // 'CreateDateFrom' => '2024-01-01T00:00:00',
    // 'CreateDateTo' => '2024-02-01T00:00:00',
    // 'UpdateDateFrom' => '2024-01-15T00:00:00',
    // 'UpdateDateTo' => '2024-01-16T00:00:00',
    // 'CreateAndUpdateDateFrom' => '2024-01-15T00:00:00',
    // 'CreateAndUpdateDateTo' => '2024-01-16T00:00:00',
    // 'RowCount' => '500',
];

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

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

Verwendete Tabellen

SDelHeader · Lesen

SQL-Objekt:: dbo.pipiReadDeliveryHeaders