Items Lesen

pixiGetEKPriceHistory

Liefert die Historie der Einkaufs- (EK) und Verkaufspreise aus der Artikelhistorie, optional gefiltert nach Artikelnummer und Zeitraum, mit Paging.

Liest Preis-Historiensätze aus ItemsHist und liefert sie seitenweise.

Filter

ItemNrInternal: wenn nicht leer, werden nur Historiensätze geliefert, deren interne Artikelnummer (ItemNrInt) diesem Wert entspricht. Leer oder NULL liefert alle Artikel.
FromDate / ToDate: Filter auf UpdateDate (an beiden Enden inklusive).
- beide gesetzt: UpdateDate zwischen FromDate und ToDate
- nur FromDate: UpdateDate >= FromDate
- nur ToDate: UpdateDate <= ToDate
- keiner: kein Datumsfilter

Sortierung und Paging

Die Zeilen werden mit RowNumber (ab 1) nummeriert, sortiert nach UpdateDate, dann Artikelschlüssel, dann Einkaufspreis, jeweils aufsteigend (älteste Änderung zuerst).
Geliefert werden nur Zeilen mit RowNumber zwischen StartRow und StartRow + RowCount (beide inklusive), sortiert nach RowNumber.
RowCount = 0 wird als 100 behandelt.

Zu jedem Historiensatz wird die aktuelle Lieferantennummer (SupplNr) aus dem Artikelstamm Items ergänzt.

Hinweise

Überlappung beim Paging: Der Seitenbereich ist an beiden Enden inklusive. Mit StartRow = 0 und RowCount = 100 werden die Zeilen 1–100 geliefert, mit StartRow = 100 die Zeilen 100–200 (101 Zeilen). Aufeinanderfolgende Seiten teilen sich daher eine Zeile, sofern StartRow nicht um RowCount + 1 erhöht wird.
Ein Kommentar im Code nennt einen Standard von 1000 Zeilen, tatsächlich verwendet der Code 100, wenn RowCount 0 ist.
Der Leerstring-Standard der Datumsparameter wird zu 1900-01-01 konvertiert; genau dieses Datum wird als „kein Filter“ behandelt.
ToDate wird inklusive Uhrzeit verglichen. Ein Datum ohne Uhrzeit (z. B. 2024-06-30T00:00:00) schließt spätere Änderungen desselben Tages aus.
Historiensätze mit NULL in UpdateDate oder ItemNrInt werden nie geliefert, da die Filterbedingungen immer ausgewertet werden.
SupplNr ist der aktuell in Items hinterlegte Lieferant, nicht der Lieferant zum Zeitpunkt der Änderung; er ist NULL, wenn der Artikel nicht mehr existiert.
Es werden keine NOLOCK-Hinweise verwendet. Ohne Artikelfilter läuft die Nummerierung über die gesamte Historientabelle, was bei großen Datenmengen langsam sein kann.

Parameter

Parameter	Typ	Standardwert	Beschreibung
`ItemNrInternal`	varchar(250) string	–	Interne Artikelnummer als Filter (`ItemNrInt`). Leer oder `NULL` liefert die Historie aller Artikel. Beispiel: `4711-BLK`
`FromDate`	datetime dateTime	–	Untergrenze (inklusive) für `UpdateDate`. Leer, `NULL` oder `1900-01-01` bedeutet keine Untergrenze. Beispiel: `2024-01-01T00:00:00`
`ToDate`	datetime dateTime	–	Obergrenze (inklusive, mit Uhrzeit) für `UpdateDate`. Leer, `NULL` oder `1900-01-01` bedeutet keine Obergrenze. Beispiel: `2024-06-30T23:59:59`
`RowCount`	int	100	Seitengröße bzw. Offset. Geliefert werden die Zeilen von `StartRow` bis `StartRow + RowCount`. `0` wird als 100 behandelt. Beispiel: `100`
`StartRow`	int	0	Erste `RowNumber` der Seite (inklusive). Die Nummerierung beginnt bei 1. Beispiel: `0`

Antwort

Result-Set 1 · Immer (kann leer sein)

Eine Zeile je passendem Preis-Historiensatz innerhalb der angeforderten Seite, sortiert nach RowNumber.

Spalte	Typ	Beschreibung
`RowNumber`	bigint long	Laufende Nummer der Zeile über das gesamte gefilterte Ergebnis (sortiert nach Änderungsdatum, Artikelschlüssel, Einkaufspreis).
`ItemKey` Kann leer sein	int	Interner Artikelschlüssel (`ItemRef` in `ItemsHist`).
`SupplNr` Kann leer sein	string	Aktuell im Artikelstamm hinterlegte Lieferantennummer; `NULL`, wenn der Artikel nicht mehr existiert.
`ItemNrSuppl` Kann leer sein	string	Lieferanten-Artikelnummer aus dem Historiensatz.
`ItemNrInt`	string	Interne Artikelnummer.
`EANUPC` Kann leer sein	string	EAN/UPC des Artikels aus dem Historiensatz.
`Price` Kann leer sein	decimal	Im Historiensatz gespeicherter Verkaufspreis.
`EKPrice` Kann leer sein	decimal	Im Historiensatz gespeicherter Einkaufspreis (`SupplPrice`).
`UpdateDate`	dateTime	Datum und Uhrzeit der in der Historie erfassten Änderung.

Beispielantwort

<SqlRowSet1>
  <row>
    <RowNumber>1</RowNumber>
    <ItemKey>1523</ItemKey>
    <SupplNr>70012</SupplNr>
    <ItemNrSuppl>SUP-88213</ItemNrSuppl>
    <ItemNrInt>4711-BLK</ItemNrInt>
    <EANUPC>4006381333931</EANUPC>
    <Price>19.9900</Price>
    <EKPrice>8.4500</EKPrice>
    <UpdateDate>2024-02-14T09:31:22</UpdateDate>
  </row>
  <row>
    <RowNumber>2</RowNumber>
    <ItemKey>1523</ItemKey>
    <SupplNr>70012</SupplNr>
    <ItemNrSuppl>SUP-88213</ItemNrSuppl>
    <ItemNrInt>4711-BLK</ItemNrInt>
    <EANUPC>4006381333931</EANUPC>
    <Price>21.9900</Price>
    <EKPrice>9.1000</EKPrice>
    <UpdateDate>2024-05-03T14:05:10</UpdateDate>
  </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:pixiGetEKPriceHistory>
      <!-- <ItemNrInternal>4711-BLK</ItemNrInternal> -->
      <!-- <FromDate>2024-01-01T00:00:00</FromDate> -->
      <!-- <ToDate>2024-06-30T23:59:59</ToDate> -->
      <!-- <RowCount>100</RowCount> -->
      <!-- <StartRow>0</StartRow> -->
    </ns1:pixiGetEKPriceHistory>
  </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:pixiGetEKPriceHistory>
      <!-- <ItemNrInternal>4711-BLK</ItemNrInternal> -->
      <!-- <FromDate>2024-01-01T00:00:00</FromDate> -->
      <!-- <ToDate>2024-06-30T23:59:59</ToDate> -->
      <!-- <RowCount>100</RowCount> -->
      <!-- <StartRow>0</StartRow> -->
    </ns1:pixiGetEKPriceHistory>
  </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 = [
    // 'ItemNrInternal' => '4711-BLK',
    // 'FromDate' => '2024-01-01T00:00:00',
    // 'ToDate' => '2024-06-30T23:59:59',
    // 'RowCount' => '100',
    // 'StartRow' => '0',
];

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

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

Verwendete Tabellen

ItemsHist · Lesen Items · Lesen

SQL-Objekt:: dbo.pipiGetEKPriceHistory