Postman-Collection
Orders Lesen

pixiGetShippableOrders

Liefert die Auftragspositionen vollständig lieferbarer Aufträge oder eine Zusammenfassung dieser Aufträge.

Wrapper um pipiReportGetShippableOrders. ShowDetails wird in ein Bit umgewandelt und als @ViewDetails übergeben. Die übrigen Optionen sind fest vorgegeben: keine Teillieferungen, kein Shop-Filter, @IncludeOrdersWithAnyShipDate = 0, keine Ausgabe je Lager.

Berücksichtigte Aufträge

  • Auftragspositionen mit Status ANG oder EIN, gesetzter Artikelreferenz (ItemRef nicht NULL) und Qty > 0.
  • Der Auftrag muss zu einem vorhandenen Kunden gehören.
  • Weder die Liefer- noch die Rechnungsadresse des Auftrags darf gesperrt sein (ASlocked = 'Y').
  • Der Auftrag darf nicht gesperrt sein (OhSLocked = 'Y').
  • Das Versanddatum muss leer oder kleiner als morgen sein. Aufträge mit Versanddatum in der Zukunft werden ausgeschlossen.

Bestandsprüfung

  • Der Bestand wird je Position über pixi_CalculateStockForOrderLines berechnet, und zwar über die Lager mit SpecialStock = 0.
  • Es werden nur vollständig lieferbare Aufträge zurückgegeben. Ist eine einzige Position nicht lieferbar, entfällt der gesamte Auftrag.

Ausgabe

  • ShowDetails ≠ 0 (Standard 1): eine Zeile je Auftragsposition, sortiert nach OrderNr und OrderlineRef.
  • ShowDetails = 0 oder NULL: eine Summenzeile mit Anzahl der Aufträge, Auftragssumme (Summe aus Price * Qty), summierten Versandkosten und Anzahl Picks (Summe Qty).

Währung

  • Ist die Einstellung MultiCurrencyEnabled aktiv, werden Preise und Versandkosten in die Datenbankwährung umgerechnet. Dafür wird der Wechselkurs desselben Datums verwendet, und der Währungscode wird in dbCurrency geliefert.
  • Andernfalls bleiben die Werte in Auftragswährung, und dbCurrency ist NULL.

Hinweise

  • Alle Lesezugriffe erfolgen mit NOLOCK, daher können nicht festgeschriebene Daten enthalten sein.
  • Die Bestandsberechnung in pixi_CalculateStockForOrderLines liegt nicht vor, daher lassen sich ihre genauen Regeln (Reservierungen, Mindestbestand) hier nicht dokumentieren. Sie wird mit @SkipZeroStockItemsCalc = 1 aufgerufen.
  • Bei aktiver Mehrwährung teilt der Code durch 1, wenn kein passender Wechselkurs gefunden wird. Der Wert bleibt dann ohne Hinweis in Auftragswährung.
  • Im Detailmodus ist ShipCost der Versandkostenbetrag des gesamten Auftrags und wird in jeder Position wiederholt. Er darf nicht je Position aufsummiert werden.
  • Im Summenmodus werden die Versandkosten über eindeutige Paare aus OrderNr und ShipCost summiert.
  • Gibt es keine passenden Aufträge, liefert die Summenzeile trotzdem Orders = 0 und ShipCost = 0; OrderTotal und Picks sind dann NULL.
  • Für Teillieferungen, Shop-Filter oder Ausgabe je Lager pixiReportGetShippableOrders direkt aufrufen.

Parameter

Parameter Typ Standardwert Beschreibung
ShowDetails
int 1

Steuert die Ausgabe. Jeder Wert ungleich 0 liefert eine Zeile je Auftragsposition; 0 oder NULL liefert eine Summenzeile.

Erlaubte Werte

  • 1 – Detailzeilen je lieferbarer Auftragsposition (jeder Wert ungleich 0 wirkt gleich)
  • 0 – Eine Summenzeile (Aufträge, Summe, Versandkosten, Picks)

Beispiel: 1

Antwort

Result-Set 1 · Wenn ShowDetails weder 0 noch NULL ist (Standard)

Eine Zeile je Auftragsposition vollständig lieferbarer Aufträge, sortiert nach OrderNr und OrderlineRef.

Spalte Typ Beschreibung
OrderlineRef int

Schlüssel der Auftragsposition

OrderNr
Kann leer sein
int

Auftragsnummer

Qty int

Bestellmenge der Position

ItemRef int

Artikelreferenz

Status
Kann leer sein
varchar(3)
string

Positionsstatus (ANG oder EIN)

ShipCost
Kann leer sein
money
decimal

Versandkosten des gesamten Auftrags, je Position wiederholt; bei aktiver Mehrwährung in Datenbankwährung

Price
Kann leer sein
money
decimal

Einzelpreis der Position; bei aktiver Mehrwährung in Datenbankwährung

Shippable int

Immer 1

dbCurrency
Kann leer sein
varchar(3)
string

Code der Datenbankwährung bei aktiver Mehrwährung, sonst NULL

Result-Set 2 · Wenn ShowDetails 0 oder NULL ist

Eine Summenzeile über alle vollständig lieferbaren Aufträge.

Spalte Typ Beschreibung
Orders int

Anzahl eindeutiger lieferbarer Aufträge

OrderTotal
Kann leer sein
money
decimal

Summe aus Price * Qty über alle Positionen

ShipCost money
decimal

Summe der Versandkosten der Aufträge (einmal je Auftrag)

Picks
Kann leer sein
int

Summe der Mengen aller Positionen

dbCurrency
Kann leer sein
varchar(3)
string

Code der Datenbankwährung bei aktiver Mehrwährung, sonst NULL

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:pixiGetShippableOrders>
      <!-- <ShowDetails>1</ShowDetails> -->
    </ns1:pixiGetShippableOrders>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Verwendete Tabellen

OrderStates · Lesen Orderlines · Lesen OrderHeader · Lesen Customers · Lesen Addresses · Lesen ExchRate · Lesen Location · Lesen
SQL-Objekt:
dbo.pipiGetShippableOrders
Prozedur zuletzt geändert am 2026-10-05
Dokumentation von claude-opus-5-5 am 2026-10-30 geschrieben