pixiDFGetOrderlines_new

Liefert die Direct-Fulfillment-Auftragspositionen (Status FUT) eines Auftrags für einen berechtigten Streckenlieferanten inklusive Artikel-, Historien- und Währungsdaten.

Schnittstellenaufruf für Direct-Fulfillment-Lieferanten (Streckengeschäft), um die zu erfüllenden Positionen eines einzelnen Auftrags abzurufen.

Berechtigung

1. Leere Strings in SupplNr und Secret werden als NULL behandelt.
2. In Suppliers wird ein Lieferant gesucht, dessen SupplNr gleich SupplNr und dessen CustNr gleich Secret ist, der nicht deaktiviert ist und CanDoDirectFulfillment = 1 hat.
3. Wird kein solcher Lieferant gefunden und ist die Einstellung DFAPIAllowFullAccessWithoutSecret gleich 0 (oder nicht vorhanden), wird ausschließlich eine Fehlerzeile mit Error = 403 geliefert.
4. Andernfalls werden die Auftragspositionen geliefert.

Auswahl der Positionen

• Nur Positionen des Auftrags OrderNR mit Positionsstatus FUT.
• Jede Position wird mit ihrem neuesten OrderHistory-Eintrag mit Status FUT verknüpft; dieser Status muss in OrderStates ein Fulfillment-Status sein (FulfilmentStatus = 'Y').
• Standardmäßig werden nur noch nicht bestätigte Positionen geliefert (ClientNotified = 'N'); mit AllOrderlines = 1 auch bereits bestätigte.
• Ist SupplNr angegeben, werden nur Positionen geliefert, deren SupplInfo gleich SupplNr ist und deren Lieferant ein Direct-Fulfillment-Lieferant ist. Ist SupplNr leer (nur möglich, wenn Vollzugriff ohne Secret erlaubt ist), werden Positionen aller Lieferanten geliefert.
• Positionen werden ausgeschlossen, wenn die Lieferadresse gesperrt ist (ASLocked = 'Y') oder der Kunde gesperrt ist (SLocked = 'Y').
• Positionen ohne passende Rechnungsadresse, Kunde, Auftragskopf oder Währung werden nicht geliefert (Inner Joins).

Artikeldaten

Der Artikel wird aus Items gelesen; der lieferantenspezifische Zusatzartikel-Datensatz in AddItems (passend zum Lieferanten der Position, neuester nach UpdateDate) liefert ItemNrSuppl vorrangig, während EANUPC zuerst vom Artikel und nur ersatzweise aus AddItems stammt.

Das Ergebnis ist DISTINCT und hat keine definierte Sortierung.

Parameter

Antwort

Result-Set 1 · Wenn die Prüfung von Lieferant/Secret fehlschlägt und DFAPIAllowFullAccessWithoutSecret gleich 0 ist.

Einzelne Fehlerzeile.

Result-Set 2 · Wenn die Berechtigung erfolgreich ist oder Vollzugriff ohne Secret erlaubt ist.

Eine Zeile je passender Direct-Fulfillment-Position des Auftrags.

<SqlRowSet1>
  <row>
    <OrderLineRef>587341</OrderLineRef>
    <OrderNr>104523</OrderNr>
    <ArtName>Gartenstuhl Teak natur</ArtName>
    <EANUPC>4012345678901</EANUPC>
    <ItemNrSuppl>GS-TK-100</ItemNrSuppl>
    <itemNrExternal>SHOP-55821</itemNrExternal>
    <Qty>2</Qty>
    <Price>89.90</Price>
    <Status>FUT</Status>
    <OrderHistKey>2210457</OrderHistKey>
    <StatusChangeDate>2024-05-14T09:12:33</StatusChangeDate>
    <OrderDate>2024-05-13T18:47:02</OrderDate>
    <OrderNrExternal>400017722</OrderNrExternal>
    <oItemSpecialNote/>
    <SupplInfo>DF01</SupplInfo>
    <InvoiceNrExternal/>
    <DF_Type>1</DF_Type>
    <ItemRef>33012</ItemRef>
    <OrderlineConfirmed>N</OrderlineConfirmed>
    <OrderCurrencyCode>EUR</OrderCurrencyCode>
    <BundleOrderlineRef/>
    <ItemNrInt>GS100</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_new>
      <OrderNR>104523</OrderNR>
      <!-- <SupplNr>DF01</SupplNr> -->
      <!-- <Secret>K-778812</Secret> -->
      <!-- <AllOrderlines>0</AllOrderlines> -->
    </ns1:pixiDFGetOrderlines_new>
  </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_new>
      <OrderNR>104523</OrderNR>
      <!-- <SupplNr>DF01</SupplNr> -->
      <!-- <Secret>K-778812</Secret> -->
      <!-- <AllOrderlines>0</AllOrderlines> -->
    </ns1:pixiDFGetOrderlines_new>
  </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_new', $soapArguments);

Verwendete Tabellen

SQL-Objekt:

dbo.pipiDFGetOrderlines_new

Prozedur zuletzt geändert am 2026-10-05

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