pixiDFGetChanges

Liefert die neuesten, noch nicht gemeldeten Fulfillment-Statusänderungen von `FUT`-Auftragspositionen für einen Direct-Fulfillment-Lieferanten inklusive Adress-, Artikel- und Auftragsdaten.

API-Aufruf für Direct-Fulfillment-Lieferanten (DF), der die noch zu verarbeitenden Änderungen an Auftragspositionen abruft.

Authentifizierung

• Der Lieferant wird in Suppliers über SupplNr gesucht. Secret muss der CustNr des Lieferanten entsprechen. Der Lieferant darf nicht deaktiviert sein und muss CanDoDirectFulfillment = 1 haben.
• Wird kein Lieferant gefunden und ist die Einstellung DFAPIAllowFullAccessWithoutSecret gleich 0 (oder nicht vorhanden), wird eine einzelne Zeile mit Error = 403 geliefert.
• Wird kein Lieferant gefunden und ist die Einstellung ungleich 0, läuft der Aufruf ohne Lieferantenfilter weiter und liefert die Änderungen aller Lieferanten.

Auswahl

Je Auftragsposition wird nur der neueste OrderHistory-Eintrag (höchster OrderHistKey) berücksichtigt, und nur wenn alle folgenden Bedingungen gelten:

• die Auftragsposition hat den Status FUT;
• der Historienstatus ist ein Status in OrderStates mit FulfilmentStatus = 'Y';
• SupplInfo der Position entspricht dem authentifizierten Lieferanten (falls einer gefunden wurde);
• Lieferadresse (ASlocked) und Kunde (SLocked) sind nicht gesperrt, außer bei LockedCustomers = 1;
• OrderNrExternal entspricht OrderNRExternal, sofern dieser Parameter angegeben ist;
• der Auftragskopf wurde vor mehr als 5 Minuten angelegt.

Zusätzlich muss der Historieneintrag ClientNotified = 'N' haben. Positionen, deren Status in ExcludeStatuses enthalten ist, werden übersprungen.

Ausgabe

• Kommt eine Auftragsposition mehrfach im Ergebnis vor, wird statt der Daten eine einzelne Meldungszeile geliefert und der Aufruf beendet.
• Andernfalls werden alle Zeilen nach StatusChangeDate sortiert geliefert. In Datenbanken, deren Name mit pixi_PSP beginnt, wird nach ordernr und dann StatusChangeDate sortiert.

Parameter

Antwort

Result-Set 1 · Wenn kein passender DF-Lieferant gefunden wird und DFAPIAllowFullAccessWithoutSecret gleich 0 ist.

Fehlerzeile bei fehlender Berechtigung.

Result-Set 2 · Wenn eine Auftragsposition mehrfach in den gesammelten Änderungen vorkommt.

Einzelne Meldungszeile mit einer Spalte ohne Namen. In diesem Fall werden keine Daten geliefert.

Result-Set 3 · Bei erfolgreicher Authentifizierung (oder erlaubtem Vollzugriff) und ohne doppelte Auftragspositionen.

Eine Zeile je geänderter Auftragsposition mit Lieferadresse, Auftrags-, Artikel- und Statusdaten.

<SqlRowSet1>
  <row>
    <Anrede>Frau</Anrede>
    <CareOf/>
    <FirstName>Anna</FirstName>
    <LastName>Muster</LastName>
    <Street>Hauptstraße</Street>
    <ZIP>80331</ZIP>
    <HouseNr>12</HouseNr>
    <City>München</City>
    <Country>DE</Country>
    <Email>anna.muster@example.com</Email>
    <Phone>089123456</Phone>
    <Address_remarks/>
    <AddrNoChargeVAT>N</AddrNoChargeVAT>
    <ShipInstruct/>
    <Shipdate>2024-05-14T00:00:00</Shipdate>
    <ShipVendorCode>DHL</ShipVendorCode>
    <ArtName>Kaffeemaschine X200</ArtName>
    <EANUPC>4012345678901</EANUPC>
    <ItemNrSuppl>X200-BLK</ItemNrSuppl>
    <itemNrExternal>SKU-4711</itemNrExternal>
    <Qty>1</Qty>
    <Price>129.90</Price>
    <Status>FUT</Status>
    <OrderHistKey>884512</OrderHistKey>
    <OrderLineRef>553210</OrderLineRef>
    <StatusChangeDate>2024-05-13T10:15:22</StatusChangeDate>
    <OrderDate>2024-05-13T09:58:01</OrderDate>
    <OrderNrExternal>SHOP-2024-004711</OrderNrExternal>
    <AddrShopID>WEB</AddrShopID>
    <oItemSpecialNote/>
    <SupplInfo>L001</SupplInfo>
    <APayment>PP</APayment>
    <discount>0.00</discount>
    <ShipCost>4.90</ShipCost>
    <InvoiceNrExternal/>
    <DF_Type>DF</DF_Type>
    <ordernr>120345</ordernr>
    <CustomerLock>N</CustomerLock>
    <AddressLock>N</AddressLock>
    <OrderCurrencyCode>EUR</OrderCurrencyCode>
  </row>
</SqlRowSet1>

Fehlermeldungen

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:pixiDFGetChanges>
      <!-- <SupplNr>L001</SupplNr> -->
      <!-- <Secret>K10023</Secret> -->
      <!-- <OrderNRExternal>SHOP-2024-004711</OrderNRExternal> -->
      <!-- <ExcludeStatuses>STO</ExcludeStatuses> -->
      <!-- <LockedCustomers>0</LockedCustomers> -->
    </ns1:pixiDFGetChanges>
  </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:pixiDFGetChanges>
      <!-- <SupplNr>L001</SupplNr> -->
      <!-- <Secret>K10023</Secret> -->
      <!-- <OrderNRExternal>SHOP-2024-004711</OrderNRExternal> -->
      <!-- <ExcludeStatuses>STO</ExcludeStatuses> -->
      <!-- <LockedCustomers>0</LockedCustomers> -->
    </ns1:pixiDFGetChanges>
  </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 = [
    // 'SupplNr' => 'L001',
    // 'Secret' => 'K10023',
    // 'OrderNRExternal' => 'SHOP-2024-004711',
    // 'ExcludeStatuses' => 'STO',
    // 'LockedCustomers' => '0',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiDFGetChanges

Prozedur zuletzt geändert am 2026-10-05

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