pixiGetOrderTotals

Liefert die Auftragspositionen eines Auftrags zusammen mit Auftragssummen, MwSt.- und Versandkostenbeträgen, wie sie die Rechnung ergeben würde.

Sucht einen Auftrag und liefert eine Zeile pro Auftragsposition; die Summen aus dem Auftragskopf werden in jeder Zeile wiederholt.

Auswahl des Auftrags

• Ist OrderNr gesetzt (nicht 0/NULL), werden die Positionen dieser Pixi-Auftragsnummer verwendet. OrderNrExternal wird dann ignoriert.
• Andernfalls werden bei nicht leerem OrderNrExternal die Positionen mit dieser externen Auftragsnummer verwendet.
• Ist keines von beiden angegeben, wird nichts gefunden.
• CustKey schränkt das Ergebnis optional auf Positionen dieses Kunden ein. 0 oder NULL deaktiviert den Filter.

Verknüpfungen

Die Positionen benötigen einen passenden Artikel, eine Rechnungsadresse, eine Lieferadresse, einen Kunden, den Shop des Kunden, die Zahlungsart der Rechnungsadresse, einen Auftragskopf und die Auftragswährung. Positionen, bei denen etwas davon fehlt, werden nicht geliefert.

Statusauswertung

• Werden keine Positionen gefunden, wird eine Zeile mit ErrorMessage = No results found geliefert.
• Haben alle gefundenen Positionen den Status STO (storniert), wird eine Zeile mit ErrorMessage = Only orderlines with status STO found geliefert.
• Andernfalls werden alle Positionen mit einem Status ungleich STO geliefert, mit Positionswerten (EAN, Lieferantenartikelnummer, Bezeichnung, Menge, Preis, Nettowerte, Notiz) und Kopfwerten (Auftragssumme, Rabatt, MwSt. gesamt/voll/ermäßigt inklusive MwSt. der Versandkosten, Nettosumme der Positionen, Versandkosten brutto und netto, Steuersätze, Währungscode).

Es wird keine Sortierung angewendet.

Parameter

Antwort

Result-Set 1 · Wenn mindestens eine nicht stornierte Auftragsposition gefunden wird

Eine Zeile pro Auftragsposition mit Status ungleich STO, einschließlich der Summen aus dem Auftragskopf.

Result-Set 2 · Wenn keine Positionen gefunden werden oder alle gefundenen Positionen den Status STO haben

Einzelne Statuszeile mit Fehlermeldung (wird anstelle der Positionsergebnismenge geliefert).

<SqlRowSet1>
  <row>
    <OrderNr>123456</OrderNr>
    <EANUPC>4006381333931</EANUPC>
    <ItemNrSuppl>STB-200</ItemNrSuppl>
    <ArtName>Stabilo Boss Textmarker gelb</ArtName>
    <Qty>2</Qty>
    <Price>11.9</Price>
    <Subtotal>23.8</Subtotal>
    <OrderNrExternal>SHOP-100045</OrderNrExternal>
    <ItemNote/>
    <ItemPriceNoVat>10</ItemPriceNoVat>
    <ItemAmountNoVat>20</ItemAmountNoVat>
    <OrderTotal>28.75</OrderTotal>
    <Discount>0</Discount>
    <VATTotal>4.59</VATTotal>
    <VATHigh>4.59</VATHigh>
    <VATLow>0</VATLow>
    <NettoTotal>20</NettoTotal>
    <ShipCost>4.95</ShipCost>
    <ShipCostNoVAT>4.16</ShipCostNoVAT>
    <TaxRateHigh>19</TaxRateHigh>
    <TaxRateLow>7</TaxRateLow>
    <OrderCurrencyCode>EUR</OrderCurrencyCode>
  </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:pixiGetOrderTotals>
      <!-- <OrderNr>123456</OrderNr> -->
      <!-- <OrderNrExternal>SHOP-100045</OrderNrExternal> -->
      <!-- <CustKey>4711</CustKey> -->
    </ns1:pixiGetOrderTotals>
  </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:pixiGetOrderTotals>
      <!-- <OrderNr>123456</OrderNr> -->
      <!-- <OrderNrExternal>SHOP-100045</OrderNrExternal> -->
      <!-- <CustKey>4711</CustKey> -->
    </ns1:pixiGetOrderTotals>
  </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' => '123456',
    // 'OrderNrExternal' => 'SHOP-100045',
    // 'CustKey' => '4711',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiGetOrderTotals

Prozedur zuletzt geändert am 2026-10-05

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