pixiGetChangedOrders

Liefert die Kopfdaten aller Aufträge, die seit einem Zeitpunkt angelegt oder geändert wurden, einschließlich Änderungen an Auftragspositionen oder Adressen.

Der Aufruf dient der Delta-Synchronisation von Aufträgen. Er liefert eine Zeile je geändertem Auftrag.

Zeitfenster

• Das Ende des Fensters, DateTimeTo, ist die Serverzeit bei der Ausführung (GETDATE()). Es wird in jeder Zeile zurückgegeben.
• Liegt DateTimeFrom später als fünf Minuten vor der Serverzeit, wird der Wert auf jetzt minus 5 Minuten zurückgesetzt. Jeder Aufruf deckt damit mindestens die letzten fünf Minuten ab.

Welche Aufträge als geändert gelten

Ein Auftrag wird ausgewählt, wenn mindestens einer der folgenden Zeitstempel bei oder nach DateTimeFrom und nicht nach DateTimeTo liegt:

1. Auftragskopf: UpdateDate, oder CreateDate, falls der Auftrag nie geändert wurde.
2. Eine Auftragsposition: deren UpdateDate, oder CreateDate bei nie geänderten Positionen.
3. Rechnungsadresse (AddrRef) oder Lieferadresse (ShipAdrRef) des Auftrags: UpdateDate, oder CreateDate, falls nie geändert.

Filter Direct Fulfillment

• ReturnOnlyDFOrders = 0 (Standard): Alle geänderten Aufträge werden geliefert.
• ReturnOnlyDFOrders = 1: Nur geänderte Aufträge mit mindestens einer Auftragsposition, zu der ein OrderHistory-Eintrag mit Status FUT existiert, werden geliefert.

Gelieferte Daten

• Die Kopffelder stammen aus dem Auftragskopf, dem Kunden (ShopID ist CustomerOf des Kunden) und den Adressen. PaymentType ist die Zahlungsart der Rechnungsadresse. OrderLocked ist das Sperrkennzeichen der Lieferadresse (N, falls leer).
• Je Auftrag aggregierte Positionsfelder:
  • OrderDate: das späteste Bestelldatum der Positionen, bei Einstellung UseInitialOrderDate = 1 das früheste.
  • VoucherID: die höchste Gutschein-ID mit dem zugehörigen VoucherAmount.
  • OrderCurrency: der Währungscode.
  • EstimatedDelivery: der späteste voraussichtliche Liefertermin.
• Es werden nur Aufträge mit vorhandenem Kunden, vorhandener Rechnungsadresse und vorhandener Lieferadresse geliefert. Die Zeilen sind nicht sortiert.

Parameter

Antwort

Result-Set 1 · Immer; leer, wenn im Zeitraum kein Auftrag geändert wurde.

Eine Zeile je geändertem Auftrag mit Kopf-, Kunden-, Adress- und aggregierten Positionsdaten.

<SqlRowSet1>
  <row>
    <DateTimeTo>2024-05-14T10:15:32.457</DateTimeTo>
    <OrderHeaderKey>48211</OrderHeaderKey>
    <OrderNr>100482</OrderNr>
    <CreateDate>2024-05-14T09:58:10.123</CreateDate>
    <OrderNrExternal>SHOP-2024-77812</OrderNrExternal>
    <WholeOrderState>AUF</WholeOrderState>
    <ShipVendorCode>DHL</ShipVendorCode>
    <ShopID>WEB</ShopID>
    <ShipCost>4.9500</ShipCost>
    <PaymentAddressId>90311</PaymentAddressId>
    <ShipmentAddressId>90312</ShipmentAddressId>
    <Referrer>google</Referrer>
    <PaymentType>V</PaymentType>
    <CustKey>55120</CustKey>
    <CustomerEmail>max.mustermann@example.com</CustomerEmail>
    <CustomerNrExternal>K-10077</CustomerNrExternal>
    <OrderLocked>N</OrderLocked>
    <OrderDate>2024-05-14T09:57:44</OrderDate>
    <OrderCurrency>EUR</OrderCurrency>
  </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:pixiGetChangedOrders>
      <DateTimeFrom>2024-05-14T08:00:00</DateTimeFrom>
      <!-- <skipGetXMLValue>1</skipGetXMLValue> -->
      <!-- <ReturnOnlyDFOrders>0</ReturnOnlyDFOrders> -->
    </ns1:pixiGetChangedOrders>
  </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:pixiGetChangedOrders>
      <DateTimeFrom>2024-05-14T08:00:00</DateTimeFrom>
      <!-- <skipGetXMLValue>1</skipGetXMLValue> -->
      <!-- <ReturnOnlyDFOrders>0</ReturnOnlyDFOrders> -->
    </ns1:pixiGetChangedOrders>
  </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 = [
    'DateTimeFrom' => '2024-05-14T08:00:00',
    // 'skipGetXMLValue' => '1',
    // 'ReturnOnlyDFOrders' => '0',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiGetChangedOrders

Prozedur zuletzt geändert am 2026-10-05

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