Postman-Collection
Orders Lesen

pixiGetOrderHeadersByOrderDate

Liefert Auftragsköpfe mit Zahlungs-, Versand-, Gutschein- und Tracking-Daten für alle Aufträge mit Auftragspositionen, deren Bestelldatum im angegebenen Zeitraum liegt.

Liefert eine Zeile je Auftragskopf für alle Aufträge mit mindestens einer Auftragsposition, deren Orderdate zwischen FromDate und ToDate liegt (inklusive, BETWEEN).

Filter

  • ShopID schränkt die Auftragspositionen auf diejenigen ein, deren CustomerOF dem angegebenen Shop entspricht. Ein Leerstring wird wie NULL behandelt, d. h. alle Shops.
  • Es werden nur Aufträge geliefert, zu denen ein Kunde, eine Rechnungsadresse (AddrRef) und eine Währung existieren (Inner Joins auf Customers, Addresses und pixi.Currency).

Aufbau des Ergebnisses

  1. Die Basisdaten stammen aus dem Auftragskopf, dem Kunden, der Rechnungsadresse (Bank- und Kreditkartendaten, PLZ) und der Währung (CurrencyCode). OrderLocked ist das Sperrkennzeichen der Lieferadresse, N, falls keine gefunden wird.
  2. PaymentType wird aus der Zahlungsart der Rechnungsadresse gefüllt.
  3. OrderNrExternal, OrderDate, VoucherID und VoucherAmount stammen aus den Auftragspositionen (bzw. dem Gutschein), ShipCost aus dem Auftragskopf.
  4. TrackingID (Sendungs-Tracking-ID, sonst die Direct-Fulfillment-Tracking-ID) und ShipVendor stammen aus den Rechnungen zu den Positionen des Auftrags.
  5. Shipdate ist das früheste und LastShipdate das späteste Scan-Out-Datum aller Rechnungen zu den Positionen des Auftrags.

Das Ergebnis ist nach OrderDate aufsteigend sortiert. Es gibt kein Paging.

Hinweise

  • Alle Lesezugriffe verwenden NOLOCK, daher können nicht festgeschriebene Daten geliefert werden.
  • BETWEEN ist inklusiv: Ist ToDate ein Datum ohne Uhrzeit (Mitternacht), werden spätere Auftragspositionen dieses Tages nicht erfasst. Für den ganzen Tag z. B. 2024-01-31T23:59:59 übergeben.
  • Der Shop-Filter wirkt auf CustomerOF der Auftragspositionen, das gelieferte ShopID ist dagegen CustomerOf des Kunden.
  • Bei Aufträgen mit mehreren Positionen oder Rechnungen werden OrderNrExternal, OrderDate, VoucherID, VoucherAmount, TrackingID und ShipVendor aus einer beliebigen passenden Zeile übernommen. OrderDate kann daher von einer Position außerhalb des angefragten Zeitraums stammen.
  • Shipdate, LastShipdate, TrackingID und ShipVendor sind NULL, solange keine Rechnung existiert.
  • Das Ergebnis enthält sensible Zahlungsdaten (Kreditkartennummer, Bankverbindung) der Rechnungsadresse.
  • Kein Paging: Große Zeiträume können große Ergebnisse und lange Laufzeiten verursachen.

Parameter

Parameter Typ Standardwert Beschreibung
FromDate
Pflicht
datetime
dateTime
–

Beginn des Zeitraums für das Bestelldatum der Auftragspositionen (inklusive).

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

ToDate
Pflicht
datetime
dateTime
–

Ende des Zeitraums für das Bestelldatum der Auftragspositionen (inklusive).

Beispiel: 2024-01-31T23:59:59

ShopID
varchar(3)
string
NULL

Shop-ID zur Filterung der Auftragspositionen (CustomerOF). NULL oder Leerstring liefert Aufträge aller Shops.

Beispiel: SHP

Antwort

Result-Set 1 · Immer (kann leer sein).

Eine Zeile je passendem Auftragskopf, sortiert nach OrderDate aufsteigend.

Spalte Typ Beschreibung
OrderHeaderKey int

Interner Schlüssel des Auftragskopfs.

OrderNr int

Pixi-Auftragsnummer.

CreateDate
Kann leer sein
dateTime

Anlagedatum des Auftragskopfs.

OrderNrExternal
Kann leer sein
varchar(50)
string

Externe (Shop-)Auftragsnummer aus einer Auftragsposition.

OrderTotal
Kann leer sein
money
decimal

Auftragssumme aus dem Auftragskopf.

OrderlinesTotal
Kann leer sein
money
decimal

Summe der Auftragspositionen aus dem Auftragskopf.

WholeOrderState
Kann leer sein
varchar(6)
string

Status des gesamten Auftrags (OrderStatus des Auftragskopfs).

Shipdate
Kann leer sein
datetime
dateTime

Frühestes Scan-Out-Datum der Rechnungen des Auftrags.

LastShipdate
Kann leer sein
datetime
dateTime

Spätestes Scan-Out-Datum der Rechnungen des Auftrags.

TrackingID
Kann leer sein
varchar(512)
string

Sendungs-Tracking-ID einer Rechnung, sonst deren Direct-Fulfillment-Tracking-ID.

ShipVendor
Kann leer sein
varchar(3)
string

Versanddienstleister einer Rechnung des Auftrags.

ShopID
Kann leer sein
string

Shop des Kunden (CustomerOf).

OrderDate
Kann leer sein
datetime
dateTime

Bestelldatum aus einer Auftragsposition des Auftrags.

ShipCost
Kann leer sein
money
decimal

Versandkosten aus dem Auftragskopf.

PaymentAddressId
Kann leer sein
int

Schlüssel der Rechnungsadresse (AddrRef).

ShipmentAddressId
Kann leer sein
int

Schlüssel der Lieferadresse (ShipAdrRef).

ShopNote
Kann leer sein
string

Shop-Notiz des Auftrags.

PaymentType
Kann leer sein
char(1)
string

Zahlungsart der Rechnungsadresse (APayment).

VoucherID
Kann leer sein
varchar(50)
string

Gutschein-ID aus einer Auftragsposition.

VoucherAmount
Kann leer sein
money
decimal

Betrag des Gutscheins.

CcCardType
Kann leer sein
string

Kreditkartentyp der Rechnungsadresse.

CcCardNr
Kann leer sein
string

Kreditkartennummer der Rechnungsadresse.

CcCardName
Kann leer sein
string

Name des Kreditkarteninhabers.

CcCardExp
Kann leer sein
string

Ablaufdatum der Kreditkarte.

Account
Kann leer sein
string

Kontonummer der Rechnungsadresse.

Blz
Kann leer sein
string

Bankleitzahl.

BankName
Kann leer sein
string

Name der Bank.

AccountName
Kann leer sein
string

Name des Kontoinhabers.

AddressRemarks
Kann leer sein
string

Adressbemerkungen des Auftrags.

AddrRef
Kann leer sein
int

Schlüssel der Rechnungsadresse (wie PaymentAddressId).

ZIP
Kann leer sein
string

PLZ der Rechnungsadresse.

CustKey int

Schlüssel des Kunden.

OrderLocked string

Sperrkennzeichen (ASlocked) der Lieferadresse, N, wenn keine Lieferadresse gefunden wird.

CurrencyCode
Kann leer sein
string

Alphabetischer Währungscode des Auftrags.

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:pixiGetOrderHeadersByOrderDate>
      <FromDate>2024-01-01T00:00:00</FromDate>
      <ToDate>2024-01-31T23:59:59</ToDate>
      <!-- <ShopID>SHP</ShopID> -->
    </ns1:pixiGetOrderHeadersByOrderDate>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Verwendete Tabellen

OrderHeader · Lesen Customers · Lesen Addresses · Lesen Currency · Lesen Orderlines · Lesen Voucher · Lesen Invoices · Lesen InvLines · Lesen
SQL-Objekt:
dbo.pipiGetOrderHeadersByOrderDate
Prozedur zuletzt geändert am 2026-10-05
Dokumentation von claude-opus-5-5 am 2026-10-30 geschrieben