pixiGetOrder

Liefert alle Details zu einem oder mehreren Aufträgen inkl. Adressen, Kunde, Auftragspositionen, Bundle-Positionen, Rechnungen und Kundenkonto als verschachteltes XML.

Sammelt aus den drei Eingabeparametern eine Menge von Auftragsnummern und liefert pro eindeutiger Auftragsnummer eine Zeile mit den Feldern des Auftragskopfs und mehreren verschachtelten XML-Dokumenten.

Auswahl der Aufträge (alle Parameter sind kombinierbar; die Ergebnisse werden zusammengeführt und dedupliziert):

• OrderNr: wird direkt übernommen, wenn größer als 0. Es erfolgt keine Prüfung gegen OrderHeader.
• OrderNrExternal: alle Aufträge mit exakt passender OrderNrExternal werden übernommen.
• OrderNrXML: XML-Dokument mit Wurzel OrderNrs; jedes Element OrderNr fügt diese Auftragsnummer hinzu, jedes Element OrderNrExternal alle Aufträge mit dieser externen Nummer.

Wird keine Auftragsnummer ermittelt, liefert der Aufruf kein Resultset.

Pro Auftrag enthält die Zeile:

• Felder des Auftragskopfs aus OrderHeader (Versanddienstleister, Geschenknachricht, Status, Summen, Referenzen, Kennzeichen, OrderType, ShipCost …).
• BillingAddress und ShippingAddress: XML der über AddrRef / ShipAdrRef referenzierten Adresse, ergänzt um Ländernamen und Ländercodes (ISO2, ISO3, Afterbuy, Plenty).
• Customer: XML des über CustRef referenzierten Kunden.
• Orderlines: XML aller Auftragspositionen mit Währungscode (OrderCurrency), Artikeldaten und PickListNr.
• BundleOrderlines: XML der Bundle-Auftragspositionen.
• Invoices: XML aller Rechnungen, die mindestens eine Rechnungsposition zu einer Auftragsposition dieses Auftrags enthalten; jede Rechnung enthält ihre InvoiceLines.
• CustomerAccount: XML der Kundenkontobuchungen des Kunden, die entweder zu einer dieser Rechnungen gehören oder ohne Rechnung über einen Bankabgleich mit dem Auftrag verknüpft sind; sortiert nach CustomerAccountKey aufsteigend.
• OnPicklist: Picklistenstatus der Auftragspositionen (None, Partial, All).
• VoucherID: die höchste VoucherID der Auftragspositionen.

Die Reihenfolge der Zeilen ist nicht definiert (kein ORDER BY).

Parameter

<OrderNrs>
  <OrderNr>100234</OrderNr>
  <OrderNr>100235</OrderNr>
  <OrderNrExternal>SHOP-4711</OrderNrExternal>
</OrderNrs>

Antwort

Result-Set 1 · Wenn aus den Parametern mindestens eine Auftragsnummer ermittelt wurde

Eine Zeile pro eindeutiger Auftragsnummer mit Kopffeldern und verschachtelten XML-Dokumenten.

<SqlRowSet1>
  <row>
    <OrderNr>100234</OrderNr>
    <BillingAddress>
      <row AddrKey="55012" AddrType="B">
        <AddrNr>55012</AddrNr>
        <FirstName>Anna</FirstName>
        <LastName>Muster</LastName>
        <Street>Hauptstr.</Street>
        <HouseNr>5</HouseNr>
        <City>München</City>
        <ZIP>80331</ZIP>
        <CountryCodePixi>D</CountryCodePixi>
        <CountryCodeISO2>DE</CountryCodeISO2>
      </row>
    </BillingAddress>
    <Customer>
      <row CustKey="30871">
        <PaymentCode>PP</PaymentCode>
        <ShopID>SHP</ShopID>
      </row>
    </Customer>
    <OrderShippingVendor>DHL</OrderShippingVendor>
    <CreateDate>2024-03-11T09:42:17</CreateDate>
    <OrderNrExternal>SHOP-4711</OrderNrExternal>
    <OrderStatus>AUF</OrderStatus>
    <OrderTotal>59.90</OrderTotal>
    <Orderlines>
      <row OrderlineKey="812345">
        <OrderlineKey>812345</OrderlineKey>
        <ArtNr>TS-100-M</ArtNr>
        <ArtName>T-Shirt M</ArtName>
        <Qty>2</Qty>
        <Price>24.95</Price>
        <Status>AUF</Status>
        <OrderCurrency>EUR</OrderCurrency>
        <ItemNrInt>4711</ItemNrInt>
      </row>
    </Orderlines>
    <OrderType>B2C</OrderType>
    <OnPicklist>None</OnPicklist>
    <ShipCost>4.95</ShipCost>
  </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:pixiGetOrder>
      <!-- <OrderNr>100234</OrderNr> -->
      <!-- <OrderNrXML><![CDATA[<OrderNrs><OrderNr>100234</OrderNr><OrderNr>100235</OrderNr><OrderNrExternal>SHOP-4711</OrderNrExternal></OrderNrs>]]></OrderNrXML> -->
      <!-- <OrderNrExternal>SHOP-4711</OrderNrExternal> -->
    </ns1:pixiGetOrder>
  </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:pixiGetOrder>
      <!-- <OrderNr>100234</OrderNr> -->
      <!-- <OrderNrXML><![CDATA[<OrderNrs><OrderNr>100234</OrderNr><OrderNr>100235</OrderNr><OrderNrExternal>SHOP-4711</OrderNrExternal></OrderNrs>]]></OrderNrXML> -->
      <!-- <OrderNrExternal>SHOP-4711</OrderNrExternal> -->
    </ns1:pixiGetOrder>
  </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',
    // 'OrderNrXML' => '<OrderNrs><OrderNr>100234</OrderNr><OrderNr>100235</OrderNr><OrderNrExternal>SHOP-4711</OrderNrExternal></OrderNrs>',
    // 'OrderNrExternal' => 'SHOP-4711',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiGetOrder

Prozedur zuletzt geändert am 2026-10-05

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