pixiDFGetOrders

Liefert die Auftragsköpfe mit Lieferadressdaten der Aufträge, die offene Direct-Fulfillment-Auftragspositionen (Status FUT) für einen Lieferanten enthalten.

Teil der Direct-Fulfillment-API (DF): Ein Lieferant ruft die Aufträge ab, die er direkt an den Kunden versenden soll.

Authentifizierung

• Die Einstellung DFAPIAllowFullAccessWithoutSecret wird gelesen. Ist sie nicht 1, wird der Lieferant über SupplNr zusammen mit Secret identifiziert; Secret muss der CustNr des Lieferanten (Kundennummer beim Lieferanten) entsprechen.
• Der Lieferant muss existieren, darf nicht deaktiviert sein und muss CanDoDirectFulfillment = 1 haben.
• Kann der Lieferant nicht identifiziert werden und ist die Einstellung nicht 1, wird eine einzelne Fehlerzeile mit Error = 403 zurückgegeben.
• Ist die Einstellung 1, wird das Secret nicht geprüft. Eine angegebene SupplNr muss trotzdem einem aktiven DF-Lieferanten entsprechen, sonst wird eine Fehlerzeile geliefert. Wird SupplNr weggelassen (oder 0), werden die Aufträge aller Lieferanten geliefert.

Auftragsauswahl

Ein Auftrag wird geliefert, wenn er mindestens eine Auftragsposition hat, die

• den Status FUT hat,
• dem Lieferanten zugeordnet ist (SupplInfo), außer wenn kein Lieferant gesetzt ist (Vollzugriff), und
• ClientNotified = 'N' hat (noch nicht übertragen), außer bei AllOrders = 1.

Aufträge mit gesperrter Lieferadresse oder gesperrtem Kunden werden ausgeschlossen. Nur Aufträge mit vorhandenem Kunden, Rechnungsadresse, Lieferadresse, Land und Währung werden geliefert (Inner Joins).

Das Ergebnis enthält eine Zeile pro Auftrag, sortiert nach OrderNr. AddrShopID und APayment stammen aus der Rechnungsadresse, alle anderen Adressfelder aus der Lieferadresse.

Parameter

Antwort

Result-Set 1 · Wenn der Lieferant nicht authentifiziert werden kann oder SupplNr ungültig ist

Einzelne Fehlerzeile; es folgt keine weitere Ergebnismenge.

Result-Set 2 · Bei erfolgreicher Authentifizierung

Eine Zeile pro Auftrag mit offenen DF-Auftragspositionen, sortiert nach OrderNR.

<SqlRowSet1>
  <row>
    <OrderNR>100234</OrderNR>
    <Anrede>Herr</Anrede>
    <FirstName>Max</FirstName>
    <LastName>Mustermann</LastName>
    <Street>Hauptstraße</Street>
    <ZIP>80331</ZIP>
    <HouseNr>12</HouseNr>
    <City>München</City>
    <Country>D</Country>
    <Email>max@example.com</Email>
    <Phone>089123456</Phone>
    <Shipdate>2024-05-14T00:00:00</Shipdate>
    <ShipVendorCode>DHL</ShipVendorCode>
    <AddrShopID>SH1</AddrShopID>
    <APayment>RE</APayment>
    <AddrNoChargeVAT>N</AddrNoChargeVAT>
    <discount>0.00</discount>
    <CntCodeISO2>DE</CntCodeISO2>
    <CntCodeISO3>DEU</CntCodeISO3>
    <ShipCost>4.90</ShipCost>
    <PartialDeliveryActive>0</PartialDeliveryActive>
    <PartialDeliveryForceCancelAfterShipout>0</PartialDeliveryForceCancelAfterShipout>
    <PartialDeliveryMultiple>0</PartialDeliveryMultiple>
    <OrderCurrencyCode>EUR</OrderCurrencyCode>
    <SubShopName>Webshop</SubShopName>
  </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:pixiDFGetOrders>
      <!-- <SupplNr>L001</SupplNr> -->
      <!-- <Secret>K123456</Secret> -->
      <!-- <AllOrders>0</AllOrders> -->
    </ns1:pixiDFGetOrders>
  </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:pixiDFGetOrders>
      <!-- <SupplNr>L001</SupplNr> -->
      <!-- <Secret>K123456</Secret> -->
      <!-- <AllOrders>0</AllOrders> -->
    </ns1:pixiDFGetOrders>
  </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' => 'K123456',
    // 'AllOrders' => '0',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiDFGetOrders

Prozedur zuletzt geändert am 2026-10-05

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