Postman-Collection
Suppliers Lesen

pixiGetDeliveryItem

Liefert die Positionen von Lieferantenlieferungen (Wareneingängen) mit Artikeldaten, Preisen, Tags und Chargendetails, gefiltert nach Lieferung, Artikel und Zeitraum.

Liest Lieferpositionen aus SDelDetail zusammen mit dem Lieferkopf (SDelHeader) und liefert eine Zeile pro Position.

Normalisierung der Parameter

  • 0 bei SDelHKey/DeliveryNumber und Leerstrings bei ItemNrInternal/EANUPC gelten als nicht gesetzt.
  • RowCount ist bei NULL standardmäßig 100, Offset standardmäßig 0.

Auflösung der Filter

  • Artikel: ItemNrInternal wird als interne Artikelnummer und EANUPC als EAN in der Artikelcode-Tabelle gesucht. Sind beide angegeben, wird der erste Artikel verwendet, auf den einer der beiden Codes passt.
  • Lieferung: Ist SDelHKey nicht gesetzt, wird DeliveryNumber auf den Schlüssel der ersten Lieferung mit dieser Nummer aufgelöst. Ist SDelHKey gesetzt, wird DeliveryNumber ignoriert.
  • Startdatum: Ist DateFrom leer und eine Lieferung bekannt, ist das Startdatum der Tag der ältesten Position dieser Lieferung. Andernfalls gilt standardmäßig heute minus 700 Tage.
  • Enddatum: DateTo ist standardmäßig heute plus 365 Tage.

Auswahl Eine Position wird ausgewählt, wenn alle folgenden Bedingungen zutreffen:

  • SDelDkey > Offset.
  • Sie gehört zur aufgelösten Lieferung, sofern vorhanden.
  • Sie gehört zum aufgelösten Artikel, sofern vorhanden.
  • Ihr Anlagedatum liegt zwischen DateFrom (inklusive) und DateTo (exklusive).

Es werden die ersten RowCount Positionen in aufsteigender SDelDkey-Reihenfolge übernommen. Geliefert werden nur Positionen, die auch in der Wareneingangs-View pvGoodsReceiptItemDbo vorhanden sind; diese liefert die interne Lieferantenbestellnummer.

Anreicherung

  • Artikelstammdaten (interne und Lieferanten-Artikelnummer, EAN, Bildlinks) stammen aus items.
  • DeliveryItemNrSuppl ist die Lieferanten-Artikelnummer des liefernden Lieferanten aus AddItems.
  • ItemTAGs enthält alle Tag-Namen des Artikels, durch | getrennt und alphabetisch sortiert.
  • BatchManagementDetails wird nur für Artikel mit Tag -6 oder -7 (Chargen-/MHD-Verwaltung) gefüllt. Das Feld enthält ein XML-Fragment mit einem row-Element pro Lagerplatz-Logeintrag dieser Lieferung und dieses Artikels, der eine Charge oder ein MHD trägt. Jedes row-Element hat das Attribut BinItemLogId und die Unterelemente BinItemLogId, LocationId, BinRef, ItemRef, DeliveredQty, BatchNumber und BestBeforeDate.

Paging Das Paging ist schlüsselbasiert. Für die nächste Seite wird der höchste SDelDkey der vorherigen Seite als Offset übergeben.

Hinweise

  • Alle Lesezugriffe erfolgen mit NOLOCK, daher können nicht festgeschriebene Daten erscheinen.
  • Nicht auflösbare Filter: Kann DeliveryNumber, ItemNrInternal oder EANUPC nicht aufgelöst werden, entfällt der jeweilige Filter stillschweigend. Der Aufruf liefert dann Positionen aller Lieferungen bzw. Artikel im Zeitraum statt eines leeren Ergebnisses.
  • Lieferung ohne Positionen: Ist ein Lieferschlüssel bekannt, DateFrom aber leer und hat die Lieferung keine Positionen, wird das Startdatum NULL und es werden keine Zeilen geliefert.
  • DateTo ist exklusiv und wird nicht auf das Tagesende erweitert. Ein reiner Datumswert wie 2024-05-31 schließt diesen Tag aus.
  • Standard-Startdatum: Der Standardwert liegt 700 Tage zurück, nicht exakt zwei Jahre.
  • Offset ist keine Anzahl zu überspringender Zeilen. Der Wert wird mit SDelDkey verglichen.
  • Sortierung: Das Endergebnis hat kein ORDER BY, die Ausgabereihenfolge ist daher nicht garantiert. Bei Bedarf clientseitig nach SDelDkey sortieren.
  • Weniger Zeilen als RowCount: Positionen, deren Artikel nicht in items existiert, entfallen erst nach der RowCount-Begrenzung. Eine Seite kann daher weniger Zeilen enthalten.
  • Doppelte Zeilen: Enthält AddItems mehrere Zeilen für denselben Artikel und Lieferanten, kann eine Position mehrfach erscheinen.
  • Chargendetails pro Lieferung, nicht pro Position: Lagerplatz-Logeinträge werden nur über Lieferung und Artikel zugeordnet. Kommt ein Artikel auf mehreren Positionen einer Lieferung vor, zeigt jede Position alle Einträge. DeliveredQty im XML wird in eine Ganzzahl umgewandelt.

Parameter

Parameter Typ Standardwert Beschreibung
SDelHKey
int NULL

Interner Schlüssel der Lieferantenlieferung (Wareneingangskopf). 0 oder NULL bedeutet keinen Lieferungsfilter. Hat Vorrang vor DeliveryNumber.

Beispiel: 15432

DeliveryNumber
int NULL

Liefernummer (SDelHNr). Wird nur verwendet, wenn SDelHKey nicht gesetzt ist, und auf die erste passende Lieferung aufgelöst. Passt keine Lieferung, wird kein Lieferungsfilter angewendet.

Beispiel: 20240315

ItemNrInternal
varchar(50)
string
NULL

Interne Artikelnummer zur Filterung nach Artikel. Ein Leerstring bedeutet keinen Filter. Wird die Nummer nicht gefunden, wird kein Artikelfilter angewendet.

Beispiel: ART-10045

EANUPC
varchar(13)
string
NULL

EAN/UPC-Code zur Filterung nach Artikel. In Kombination mit ItemNrInternal wird der erste Artikel verwendet, auf den einer der beiden Codes passt.

Beispiel: 4006381333931

RowCount
int 100

Maximale Anzahl zurückgegebener Lieferpositionen (Seitengröße). NULL wird als 100 behandelt.

Beispiel: 100

Offset
int 0

Cursor für schlüsselbasiertes Paging. Es werden nur Positionen mit SDelDkey größer als dieser Wert geliefert; der letzte SDelDkey der vorherigen Seite wird übergeben.

Beispiel: 0

DateFrom
datetime
dateTime
NULL

Untergrenze (inklusive) für das Anlagedatum der Position. Standard: Tag der ältesten Position der angegebenen Lieferung, sonst heute minus 700 Tage.

Beispiel: 2024-01-01T00:00:00

DateTo
datetime
dateTime
NULL

Obergrenze (exklusiv) für das Anlagedatum der Position. Standard: heute plus 365 Tage.

Beispiel: 2024-04-01T00:00:00

Antwort

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

Eine Zeile pro Lieferantenlieferposition mit Kopfdaten, Artikeldaten, Preisen, Tags und Chargeninformationen.

Spalte Typ Beschreibung
SDelDkey
Kann leer sein
int

Schlüssel der Lieferposition; als Paging-Cursor verwendbar.

DeliveryNumber
Kann leer sein
int

Liefernummer (SDelHNr).

SDelHKey
Kann leer sein
int

Schlüssel des Lieferkopfs.

ItemKey
Kann leer sein
int

Interner Artikelschlüssel.

ItemNrInt
Kann leer sein
string

Interne Artikelnummer aus dem Artikelstamm.

ItemNrSuppl
Kann leer sein
string

Lieferanten-Artikelnummer aus dem Artikelstamm.

DeliveryItemNrSuppl
Kann leer sein
string

Lieferanten-Artikelnummer des liefernden Lieferanten (aus AddItems).

ItemName
Kann leer sein
varchar(200)
string

Artikelbezeichnung, wie in der Lieferposition gespeichert.

EANUPC
Kann leer sein
string

EAN/UPC des Artikels.

DeliveredQty
Kann leer sein
money
decimal

Gelieferte Menge.

OrderedQty
Kann leer sein
money
decimal

Bestellte Menge.

MidPrice
Kann leer sein
money
decimal

Durchschnittspreis der Position (SDelDsMidPrice).

Discount
Kann leer sein
money
decimal

Rabatt der Position.

EK
Kann leer sein
money
decimal

Einkaufspreis der Position.

FinalPrice
Kann leer sein
money
decimal

Endgültiger Einkaufspreis nach Rabatt.

ItemTAGs
Kann leer sein
varchar(8000)
string

Tag-Namen des Artikels, durch | getrennt, alphabetisch sortiert.

PicLinkLarge
Kann leer sein
string

Link zum großen Artikelbild.

PicLinkSmall
Kann leer sein
string

Link zum kleinen Artikelbild.

DeliveryCreateDate
Kann leer sein
datetime
dateTime

Anlagedatum des Lieferkopfs.

DeliveryItemCreateDate
Kann leer sein
datetime
dateTime

Anlagedatum der Lieferposition.

DeliveryItemLastUpdateDate
Kann leer sein
datetime
dateTime

Datum der letzten Änderung der Lieferposition.

DeliveryStatus
Kann leer sein
varchar(3)
string

Statuscode des Lieferkopfs.

BatchNumber
Kann leer sein
varchar(50)
string

In der Lieferposition gespeicherte Charge.

BestBeforeDate
Kann leer sein
datetime
dateTime

In der Lieferposition gespeichertes MHD.

BatchManagementDetails
Kann leer sein
xml

XML-Fragment aus row-Elementen mit Lagerplatz-Logeinträgen (Lagerplatz, Lager, Menge, Charge, MHD) für Artikel mit Tag -6/-7; sonst NULL.

InternalNumber
Kann leer sein
varchar(50)
string

Interne Nummer der Lieferantenbestellung, zu der die Position gehört.

ExternalReceiptNr
Kann leer sein
varchar(50)
string

Externe Belegnummer der Lieferung.

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:pixiGetDeliveryItem>
      <!-- <SDelHKey>15432</SDelHKey> -->
      <!-- <DeliveryNumber>20240315</DeliveryNumber> -->
      <!-- <ItemNrInternal>ART-10045</ItemNrInternal> -->
      <!-- <EANUPC>4006381333931</EANUPC> -->
      <!-- <RowCount>100</RowCount> -->
      <!-- <Offset>0</Offset> -->
      <!-- <DateFrom>2024-01-01T00:00:00</DateFrom> -->
      <!-- <DateTo>2024-04-01T00:00:00</DateTo> -->
    </ns1:pixiGetDeliveryItem>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Verwendete Tabellen

ItemCode · Lesen SDelHeader · Lesen SDelDetail · Lesen pvGoodsReceiptItemDbo · Lesen TagMatch · Lesen Tag · Lesen InvBinItemLog · Lesen items · Lesen AddItems · Lesen
SQL-Objekt:
dbo.pipiGetDeliveryItem
Prozedur zuletzt geändert am 2026-10-05
Dokumentation von claude-opus-5-5 am 2026-10-30 geschrieben