Postman-Collection
Orders Lesen

pixiGetOrdersReadyForPickup

Liefert die Aufträge mit reservierten Auftragspositionen, die Kunden an einem bestimmten POS-Standort abholen können, samt Kundenreferenz.

Listet Aufträge auf, die an einem POS-Standort zur Abholung durch den Kunden bereitstehen.

Ein Auftrag wird geliefert, wenn er mindestens eine Auftragsposition hat, die alle folgenden Bedingungen erfüllt:

  • die LocationID der Position entspricht LocationId;
  • der Standort der Position existiert in Location und hat einen Reservierungsstandort (ResLocID), der ebenfalls in Location existiert;
  • die CustRef der Position verweist auf einen vorhandenen Kunden in Customers;
  • für die Position existiert eine Reservierung in Reservation (ResOrderlineRef = Schlüssel der Auftragsposition);
  • der Positionsstatus ist ANG oder HAL;
  • das Auftragsdatum ist nicht älter als die Reservierungsfrist in Tagen: ResExpDays des Reservierungsstandorts oder, falls dieser NULL ist, der Wert der Einstellung ReservationExpiry.

Zusätzlich wird der gesamte Auftrag ausgeschlossen, wenn irgendeine seiner Auftragspositionen einen Artikel betrifft, für den kein ItemLocationSpecific-Datensatz zum Reservierungsstandort existiert. Geprüft wird nur das Vorhandensein dieses Datensatzes, nicht der Bestand.

Das Ergebnis ist je Auftragsnummer und Kunde eindeutig und aufsteigend nach Auftragsnummer sortiert.

Hinweise

  • Wird LocationId weggelassen (NULL), trifft der Vergleich mit LocationID nie zu und das Ergebnis ist immer leer. Es sollte immer ein Standort übergeben werden.
  • Falle beim Fristwert: Auf 14 Tage wird nur zurückgegriffen, wenn die Einstellung ReservationExpiry einen Leerstring liefert. fPIXI_GetSetting liefert '0', wenn die Einstellung nicht existiert; ohne Einstellung und ohne ResExpDays am Reservierungsstandort werden daher nur Aufträge mit heutigem Datum geliefert.
  • Die Frist wird in Kalendertagen zwischen Auftragsdatum und aktuellem Serverdatum gemessen (DATEDIFF in Tagen).
  • Alle Tabellen werden mit NOLOCK gelesen; nicht festgeschriebene Daten können erscheinen.
  • Nur lesend; es werden keine Daten geändert.

Parameter

Parameter Typ Standardwert Beschreibung
LocationId
varchar(50)
string
NULL

ID des POS-Standorts (Location.LocID), dessen Auftragspositionen geprüft werden. Muss gesetzt sein; bei NULL werden keine Zeilen geliefert.

Beispiel: POS

Antwort

Result-Set 1 · Immer (kann leer sein)

Eine Zeile je abholbereitem Auftrag, aufsteigend nach Auftragsnummer sortiert.

Spalte Typ Beschreibung
ordernr int

Auftragsnummer (Orderlines.OrderNr).

CustRef int

Kundenschlüssel der Auftragsposition (Orderlines.CustRef, verweist auf Customers.CustKey).

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:pixiGetOrdersReadyForPickup>
      <!-- <LocationId>POS</LocationId> -->
    </ns1:pixiGetOrdersReadyForPickup>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Verwendete Tabellen

Orderlines · Lesen Location · Lesen Customers · Lesen Reservation · Lesen ItemLocationSpecific · Lesen Settings · Lesen
SQL-Objekt:
dbo.pipiGetOrdersReadyForPickup
Prozedur zuletzt geändert am 2026-10-05
Dokumentation von claude-opus-5-5 am 2026-10-30 geschrieben