pixiGetOrderHeadersForCustomer

Liefert die Auftragsköpfe eines Kunden, ermittelt über Kundenschlüssel oder externe Kundennummer bzw. E-Mail, inklusive Zahlungs-, Gutschein- und Versanddaten.

Liefert eine Zeile pro Auftrag (OrderHeader) eines Kunden, sortiert nach OrderDate absteigend.

Kundenauswahl

• Ist CustKey ungleich 0, werden nur Aufträge mit CustRef = CustKey geliefert. CustomerNrExternal und ShopID werden in diesem Fall ignoriert.
• Ist CustKey gleich 0 (Standard), werden die Aufträge aller Kunden geliefert, deren CustomerNrExternal oder E-Mail-Adresse (CeMail) dem Wert von CustomerNrExternal entspricht. Ist ShopID angegeben, muss der Kunde zusätzlich zu diesem Shop gehören (CustomerOf). Eine leere ShopID wird als NULL behandelt (kein Shop-Filter).

Weitere Filter

• OrderDateFrom: nur Aufträge mit OrderDate ab diesem Zeitpunkt. NULL oder leer bedeutet 1900-01-01.
• OrderStatus: OPEN, HOLD oder CLOSED filtert auf den Auftragsstatus. Jeder andere Wert (oder NULL) deaktiviert den Statusfilter.

Gelieferte Daten pro Auftrag

• Kopfdaten wie Auftragsnummer, externe Auftragsnummer, Summen, Versandkosten, Shop-Notiz, Adressbemerkungen und Währungscode (OrderCurrencyCode aus der Währung des Auftrags).
• Zahlungsdaten aus der Rechnungsadresse (AddrRef): Zahlungsart, Kreditkarten- und Bankverbindungsfelder, PLZ.
• ShopID ist der Shop, zu dem der Kunde gehört (CustomerOf).
• OrderLocked ist das Sperrkennzeichen (ASlocked) der Lieferadresse, N falls nicht gesetzt.
• VoucherID / VoucherAmount: höchste Gutschein-ID und höchster Gutscheinbetrag aus den Auftragspositionen (über Positionen referenzierte Gutscheine); NULL, wenn der Auftrag keinen Gutschein hat.
• Shipdate / LastShipdate: frühestes und spätestes Scan-Out-Datum aller Rechnungen zu den Auftragspositionen.
• TrackingID / ShipVendor: aus der Rechnung mit dem höchsten InvoiceKey; fehlt dort die Tracking-ID, wird die Direktversand-Tracking-ID der Auftragsposition verwendet. NULL, wenn der Auftrag noch nicht berechnet wurde.

Parameter

Antwort

Result-Set 1 · Immer (kann leer sein)

Eine Zeile pro gefundenem Auftrag, sortiert nach OrderDate absteigend.

<SqlRowSet1>
  <row>
    <OrderHeaderKey>558812</OrderHeaderKey>
    <OrderNr>400123</OrderNr>
    <CreateDate>2024-03-11T09:14:22</CreateDate>
    <OrderNrExternal>WEB-100245</OrderNrExternal>
    <OrderTotal>89.9000</OrderTotal>
    <OrderLinesTotal>84.9000</OrderLinesTotal>
    <WholeOrderState>CLOSED</WholeOrderState>
    <Shipdate>2024-03-12T15:02:10</Shipdate>
    <LastShipdate>2024-03-12T15:02:10</LastShipdate>
    <TrackingID>00340434161094042557</TrackingID>
    <ShipVendor>DHL</ShipVendor>
    <ShopID>SH1</ShopID>
    <OrderDate>2024-03-11T09:10:00</OrderDate>
    <ShipCost>5.0000</ShipCost>
    <PaymentAddressId>912345</PaymentAddressId>
    <ShipmentAddressId>912346</ShipmentAddressId>
    <ShopNote/>
    <PaymentType>R</PaymentType>
    <AddressRemarks/>
    <AddrRef>912345</AddrRef>
    <ZIP>80331</ZIP>
    <CustKey>10234</CustKey>
    <OrderLocked>N</OrderLocked>
    <OrderCurrencyCode>EUR</OrderCurrencyCode>
  </row>
</SqlRowSet1>

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:pixiGetOrderHeadersForCustomer>
      <!-- <CustKey>10234</CustKey> -->
      <!-- <CustomerNrExternal>max.mustermann@example.com</CustomerNrExternal> -->
      <!-- <ShopID>SH1</ShopID> -->
      <!-- <OrderStatus>OPEN</OrderStatus> -->
      <!-- <OrderDateFrom>2024-01-01T00:00:00</OrderDateFrom> -->
    </ns1:pixiGetOrderHeadersForCustomer>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

curl -X POST 'https://apigateway.descartes.com/tms/pixi/' \
  --user 'USERNAME:PASSWORD' \
  --header 'Content-Type: text/xml; charset=utf-8' \
  --data-binary @- <<'XML'
<?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:pixiGetOrderHeadersForCustomer>
      <!-- <CustKey>10234</CustKey> -->
      <!-- <CustomerNrExternal>max.mustermann@example.com</CustomerNrExternal> -->
      <!-- <ShopID>SH1</ShopID> -->
      <!-- <OrderStatus>OPEN</OrderStatus> -->
      <!-- <OrderDateFrom>2024-01-01T00:00:00</OrderDateFrom> -->
    </ns1:pixiGetOrderHeadersForCustomer>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
XML

<?php

$soapClient = new SoapClient(null, [
    'login' => 'USERNAME',
    'password' => 'PASSWORD',
    'location' => 'https://apigateway.descartes.com/tms/pixi/',
    'uri' => 'https://apigateway.descartes.com/tms/pixi/',
]);

$arguments = [
    // 'CustKey' => '10234',
    // 'CustomerNrExternal' => 'max.mustermann@example.com',
    // 'ShopID' => 'SH1',
    // 'OrderStatus' => 'OPEN',
    // 'OrderDateFrom' => '2024-01-01T00:00:00',
];

$soapArguments = [];
foreach ($arguments as $name => $value) {
    $soapArguments[] = new SoapVar($value, XSD_STRING, '', '', $name);
}

$response = $soapClient->__soapCall('pixiGetOrderHeadersForCustomer', $soapArguments);

Verwendete Tabellen

SQL-Objekt:

dbo.pipiGetOrderHeadersForCustomer

Prozedur zuletzt geändert am 2026-10-05

Dokumentation von claude-opus-5-5 am 2026-10-30 geschrieben