pixiDFGetOrderlines

Liefert die offenen Direct-Fulfillment-Auftragspositionen (Status FUT) eines Auftrags für einen Direct-Fulfillment-Lieferanten, authentifiziert über Lieferantennummer und Secret.

Wird von Direct-Fulfillment-Lieferanten (Streckengeschäft) verwendet, um die zu versendenden Positionen eines Auftrags abzurufen.

Authentifizierung

• Leere Zeichenketten in SupplNr und Secret werden als NULL behandelt.
• Gesucht wird ein Lieferant in Suppliers, dessen SupplNr gleich SupplNr und dessen CustNr gleich Secret ist. Der Lieferant darf nicht deaktiviert sein und muss CanDoDirectFulfillment = 1 haben.
• Wird kein solcher Lieferant gefunden und ist die Einstellung DFAPIAllowFullAccessWithoutSecret gleich 0 (oder nicht vorhanden), wird nur eine Zeile mit Error = '403' geliefert.
• Ist die Einstellung ungleich 0, entfällt die Prüfung, und der Aufruf funktioniert ohne gültiges Secret.

Gelieferte Auftragspositionen

Nur Positionen, die alle folgenden Bedingungen erfüllen:

• Die Position gehört zum Auftrag OrderNR.
• Die Position hat den Status FUT; verwendet wird der neueste OrderHistory-Eintrag mit Status FUT (OrderHistKey, StatusChangeDate, ClientNotified).
• Der Status FUT ist in OrderStates als Fulfilment-Status gekennzeichnet (FulfilmentStatus = 'Y').
• Ohne AllOrderlines = 1 werden nur noch nicht bestätigte Positionen (ClientNotified = 'N') geliefert.
• Ist SupplNr angegeben, werden nur Positionen mit SupplInfo = SupplNr geliefert, und dieser Lieferant muss Direct Fulfillment unterstützen. Ist SupplNr leer (nur bei deaktivierter Secret-Prüfung möglich), werden Positionen aller Lieferanten geliefert.
• Die Lieferadresse darf nicht gesperrt sein (ASlocked), der Kunde ebenfalls nicht (SLocked).
• Auftragskopf, Rechnungsadresse, Kunde und Währung müssen vorhanden sein (Inner Joins).

Artikeldaten

EANUPC, ItemNrSuppl und ItemNrInt stammen aus dem lieferantenspezifischen AddItems-Datensatz (Lieferant = SupplInfo der Position, zuletzt aktualisierter Datensatz); fehlt ein Wert dort, wird der Wert aus Items verwendet.

Doppelte Zeilen werden entfernt (DISTINCT). Eine Sortierung ist nicht festgelegt.

Parameter

Antwort

Result-Set 1 · Wenn der Lieferant authentifiziert ist oder die Einstellung DFAPIAllowFullAccessWithoutSecret ungleich 0 ist

Eine Zeile je passender Direct-Fulfillment-Auftragsposition; kann leer sein.

Result-Set 2 · Wenn zu SupplNr/Secret kein passender DF-Lieferant gefunden wird und DFAPIAllowFullAccessWithoutSecret gleich 0 ist

Einzelne Fehlerzeile anstelle der Auftragspositionen.

<SqlRowSet1>
  <row>
    <OrderLineRef>558812</OrderLineRef>
    <OrderNr>104523</OrderNr>
    <ArtName>Gartenstuhl Teak natur</ArtName>
    <EANUPC>4006381333931</EANUPC>
    <ItemNrSuppl>GS-TEAK-01</ItemNrSuppl>
    <itemNrExternal>SHOP-77812</itemNrExternal>
    <Qty>2</Qty>
    <Price>89.90</Price>
    <Status>FUT</Status>
    <OrderHistKey>9912034</OrderHistKey>
    <StatusChangeDate>2024-05-14T09:32:11</StatusChangeDate>
    <OrderDate>2024-05-14T08:15:00</OrderDate>
    <OrderNrExternal>WEB-2024-55123</OrderNrExternal>
    <oItemSpecialNote/>
    <SupplInfo>DF01</SupplInfo>
    <InvoiceNrExternal/>
    <DF_Type>DF</DF_Type>
    <ItemRef>33417</ItemRef>
    <OrderlineConfirmed>N</OrderlineConfirmed>
    <OrderCurrencyCode>EUR</OrderCurrencyCode>
    <BundleOrderlineRef>0</BundleOrderlineRef>
    <ItemNrInt>100245</ItemNrInt>
  </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:pixiDFGetOrderlines>
      <OrderNR>104523</OrderNR>
      <!-- <SupplNr>DF01</SupplNr> -->
      <!-- <Secret>K-778812</Secret> -->
      <!-- <AllOrderlines>0</AllOrderlines> -->
    </ns1:pixiDFGetOrderlines>
  </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:pixiDFGetOrderlines>
      <OrderNR>104523</OrderNR>
      <!-- <SupplNr>DF01</SupplNr> -->
      <!-- <Secret>K-778812</Secret> -->
      <!-- <AllOrderlines>0</AllOrderlines> -->
    </ns1:pixiDFGetOrderlines>
  </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 = [
    'OrderNR' => '104523',
    // 'SupplNr' => 'DF01',
    // 'Secret' => 'K-778812',
    // 'AllOrderlines' => '0',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiDFGetOrderlines

Prozedur zuletzt geändert am 2026-10-05

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