Postman-Collection
Stock Lesen

pixiGetChangedItems

Liefert alle seit einem Zeitpunkt geänderten Artikel mit verfügbarem Bestand und frühestem erwarteten Liefertermin aus offenen Lieferantenbestellungen.

Liefert je Artikel aus Items, dessen UpdateDate größer oder gleich @Since ist, eine Zeile. Damit eignet sich der Aufruf für einen Delta-Abgleich von Beständen, z. B. mit einem Onlineshop.

Je Artikel wird berechnet:

  • AvailableStock: Artikelbestand (Items.Quantity) abzüglich offener Auftragsmengen und offener Reservierungen. Negative Ergebnisse werden als 0 geliefert.
    • Offene Aufträge ermittelt fPIXI_OpenOrdersCountForItem_ForStockExport. Die Funktion summiert OrderLines.Qty für Positionen mit Status ANG oder BES sowie für Positionen mit Status HAL, deren Bestelldatum höchstens HalOrdersActiveDays Tage zurückliegt.
    • Offene Reservierungen sind die Summe von InvBinItem.BinItemQty über Picklistenpositionen, deren Picklistenkopf eine ReservedOrderNr und ein Ablaufdatum (PLHexpiryDate) in der Zukunft hat.
  • EstimatedDelivery: frühester EstimatedDeliveryDate der Lieferantenbestellpositionen des Artikels mit offener Restmenge, also bestellt minus geliefert minus nicht geliefert größer 0. Berücksichtigt werden nur Lieferantenbestellungen, deren Status IsOrderedConfirmed = 1 hat; ein Code-Kommentar nennt diese als bestellt/bestätigt. Der Wert ist NULL, wenn keine solche Position existiert.

Die Zeilen werden nicht sortiert, und es gibt kein Paging.

Hinweise

  • Alle Tabellen werden WITH (NOLOCK) gelesen; das Ergebnis kann daher nicht festgeschriebene Daten enthalten.
  • Das HAL-Zeitfenster stammt aus der Einstellung HalOrdersActiveDays, gelesen über fPIXI_GetSetting (nicht beigefügt). Ist die Einstellung 0 oder leer, gelten 7 Tage.
  • Ein Artikel wird nur über Änderungen an Items.UpdateDate ausgewählt. Aus dem Code geht nicht hervor, ob neue Aufträge, Reservierungen oder Lieferantenbestellungen diese Spalte aktualisieren. Bestandsänderungen durch solche Datensätze werden daher möglicherweise nicht gemeldet.
  • Ist @Since NULL, werden keine Zeilen geliefert.
  • Die Berechnung führt je Artikel eine Skalarfunktion und zwei Unterabfragen aus. Ein möglichst aktueller Wert für @Since hält das Ergebnis klein.

Parameter

Parameter Typ Standardwert Beschreibung
Since
Pflicht
datetime
dateTime
–

Untergrenze für Items.UpdateDate (inklusive). Es werden nur Artikel geliefert, die zu oder nach diesem Zeitpunkt geändert wurden.

Beispiel: 2024-05-01T08:00:00

Antwort

Result-Set 1 · Immer (ggf. leer)

Eine Zeile je seit @Since geändertem Artikel mit verfügbarem Bestand und frühestem erwarteten Liefertermin.

Spalte Typ Beschreibung
ItemNrInt
Kann leer sein
string

Interne Artikelnummer.

ItemKey int

Interner Schlüssel des Artikels.

EANUPC
Kann leer sein
string

EAN/UPC-Code des Artikels.

ItemNrSuppl
Kann leer sein
string

Artikelnummer des Lieferanten.

AvailableStock int

Bestand abzüglich offener Aufträge und offener Reservierungen; nie kleiner als 0.

EstimatedDelivery
Kann leer sein
datetime
dateTime

Frühester erwarteter Liefertermin offener, bestellter/bestätigter Lieferantenbestellpositionen des Artikels; NULL, wenn keine vorhanden.

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:pixiGetChangedItems>
      <Since>2024-05-01T08:00:00</Since>
    </ns1:pixiGetChangedItems>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Verwendete Tabellen

Items · Lesen PLHeader · Lesen PLitem · Lesen InvBinItem · Lesen SupplierOrderLine · Lesen SupplierOrder · Lesen SupplierOrderStatus · Lesen OrderLines · Lesen
SQL-Objekt:
dbo.pipiGetChangedItems
Prozedur zuletzt geändert am 2026-10-05
Dokumentation von claude-opus-5-5 am 2026-10-30 geschrieben