pixiGetOrderlinesForOrder

Liefert die Auftragspositionen eines oder mehrerer Aufträge, optional mit zusammengefassten Stücklisten-Positionen, inklusive Bestands-, Rechnungs- und Versanddaten.

Ermittelt die zu lesenden Aufträge und liefert deren Auftragspositionen in einer Ergebnismenge.

Auswahl der Aufträge

• Der Auftrag mit OrderNr = @OrderNr wird immer berücksichtigt (sofern vorhanden).
• Ist @OrderXML angegeben, wird jedes Element /ORDERS/ORDER (elementbasiert) mit den Unterelementen ORDERNR und ORDERNREXTERNAL gelesen. Jeder Auftrag, dessen OrderNr zu ORDERNR oder dessen OrderNrExternal zu ORDERNREXTERNAL passt, wird hinzugefügt.

Stücklisten-Modus

• @ReturnBundle bestimmt den Modus. Ist der Wert NULL, wird die Einstellung APIBundleOrderlines verwendet (fehlende Einstellung = 0).
• 0: Jede Auftragsposition wird mit ihren eigenen Werten geliefert (ArtName, Qty, Price, Status, ...).
• 1: Auftragspositionen, die zu einer Stückliste gehören (BundleOrderlineRef gesetzt), werden zu einer Zeile pro Stückliste zusammengefasst (die Position mit der kleinsten OrderlineKey). Bezeichnung, Menge, Preis, externe Nummern, Datum, Artikel, Notiz, Rabatte, Betrag, Steuersatz und Nettopreis werden, soweit vorhanden, aus der Stücklisten-Position (BundleOrderlines) übernommen. Der Status der Stückliste wird abhängig von der Einstellung APIBundleOneAllAUS aus allen zugehörigen Positionen berechnet: Bei 1 wird der gemeinsame Status geliefert, wenn alle Positionen denselben Status haben, sonst der Status mit der kleinsten OrderStateKey; bei 0 der Status mit der größten OrderStateKey.

Berechnete Spalten

• StatusText: Text des Status aus OrderStates.
• OrderCurrency: Währungscode (CodeA) des Auftrags.
• VATRate: H, wenn der Steuersatz der Rechnungsposition (bzw. der Stückliste) dem TaxRateHigh des Auftrags entspricht, L bei TaxRateLow, sonst N (auch wenn keine Rechnungsposition existiert).
• PriceNoVAT: Nettopreis der Rechnungsposition (bzw. der Stückliste), auf 2 Nachkommastellen gerundet.
• AvailStockOrderLine: verfügbare Menge des Artikels am Lager der Position (Lagermenge abzüglich offener Reservierungen des Artikels).
• ReservedCount: der kleinere Wert aus Qty und AvailStockOrderLine, jedoch nicht kleiner als 0.
• ShipDate: ScanOutDate der zugehörigen Rechnung.

Das Ergebnis hat keine explizite Sortierung.

Parameter

<ORDERS>
  <ORDER>
    <ORDERNR>100235</ORDERNR>
    <ORDERNREXTERNAL/>
  </ORDER>
  <ORDER>
    <ORDERNR/>
    <ORDERNREXTERNAL>SHOP-4711</ORDERNREXTERNAL>
  </ORDER>
</ORDERS>

Antwort

Result-Set 1 · Immer (kann leer sein, wenn kein Auftrag passt).

Auftragspositionen der ausgewählten Aufträge; im Stücklisten-Modus eine Zeile pro Stückliste plus alle übrigen Positionen.

<SqlRowSet1>
  <row>
    <OrderlineKey>553201</OrderlineKey>
    <ArtName>Laufschuh Pro 42</ArtName>
    <Qty>1</Qty>
    <Price>89.9000</Price>
    <Status>AUS</Status>
    <StatusText>Ausgeliefert</StatusText>
    <ItemNrExternal>LS-PRO-42</ItemNrExternal>
    <OrderNr>100234</OrderNr>
    <OrderNrExternal>SHOP-4711</OrderNrExternal>
    <OrderCurrency>EUR</OrderCurrency>
    <OrderDate>2024-03-12T10:15:00</OrderDate>
    <ItemRef>8812</ItemRef>
    <oItemSpecialNote/>
    <DiscountValue>0.0000</DiscountValue>
    <DiscountPerc>0</DiscountPerc>
    <FullPrice>89.9000</FullPrice>
    <VATRate>H</VATRate>
    <PriceNoVAT>75.55</PriceNoVAT>
    <AvailStockOrderLine>14</AvailStockOrderLine>
    <ItemNrInt>100-8812</ItemNrInt>
    <ShipDate>2024-03-13T14:02:00</ShipDate>
    <ReservedCount>1</ReservedCount>
    <ItemNrSuppl>SUP-77812</ItemNrSuppl>
  </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:pixiGetOrderlinesForOrder>
      <OrderNr>100234</OrderNr>
      <!-- <OrderXML><![CDATA[<ORDERS><ORDER><ORDERNR>100235</ORDERNR><ORDERNREXTERNAL></ORDERNREXTERNAL></ORDER><ORDER><ORDERNR></ORDERNR><ORDERNREXTERNAL>SHOP-4711</ORDERNREXTERNAL></ORDER></ORDERS>]]></OrderXML> -->
      <!-- <ReturnBundle>1</ReturnBundle> -->
    </ns1:pixiGetOrderlinesForOrder>
  </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:pixiGetOrderlinesForOrder>
      <OrderNr>100234</OrderNr>
      <!-- <OrderXML><![CDATA[<ORDERS><ORDER><ORDERNR>100235</ORDERNR><ORDERNREXTERNAL></ORDERNREXTERNAL></ORDER><ORDER><ORDERNR></ORDERNR><ORDERNREXTERNAL>SHOP-4711</ORDERNREXTERNAL></ORDER></ORDERS>]]></OrderXML> -->
      <!-- <ReturnBundle>1</ReturnBundle> -->
    </ns1:pixiGetOrderlinesForOrder>
  </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' => '100234',
    // 'OrderXML' => '<ORDERS><ORDER><ORDERNR>100235</ORDERNR><ORDERNREXTERNAL></ORDERNREXTERNAL></ORDER><ORDER><ORDERNR></ORDERNR><ORDERNREXTERNAL>SHOP-4711</ORDERNREXTERNAL></ORDER></ORDERS>',
    // 'ReturnBundle' => '1',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiGetOrderlinesForOrder

Prozedur zuletzt geändert am 2026-10-05

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