pixiDeleteOrder

Löscht einen kompletten Auftrag, sofern alle Auftragspositionen den Status ANG, HAL oder STO haben und keine auf einer aktiven Pickliste steht.

Löscht den über OrderNr angegebenen Auftrag samt abhängigen Daten und liefert eine Statuszeile.

Prüfungen (vor jeder Änderung):

1. Der Auftragskopf wird über OrderNr gesucht und mit Auftragspositionen, Bankzuordnungen, Kundenkonto-Ereignissen und Picklistenpositionen verknüpft. Wird keine Zeile gefunden, lautet das Ergebnis 404.
2. Hat eine Auftragsposition einen anderen Status als ANG, HAL oder STO, lautet das Ergebnis 409.
3. Steht eine Auftragsposition auf einer Pickliste, deren Ablaufdatum (PLHexpiryDate) in der Zukunft liegt, lautet das Ergebnis 409 mit der Picklisten-Meldung. Diese Prüfung läuft zuletzt, ihre Meldung gewinnt also, wenn beide 409-Bedingungen zutreffen.

Schlägt eine Prüfung fehl, wird nichts geändert.

Löschschritte (in einer Transaktion):

• Für jede Auftragsposition wird ein OrderHistory-Eintrag mit Status NEW und Mitarbeiter API geschrieben.
• Die Auftragspositionen werden nicht physisch gelöscht, sondern vom Auftrag gelöst und zurückgesetzt: OrderNr, CustRef, AddrRef, ShipAdrRef werden 0, Status wird NEW, UpdateEmp wird API, Menge, Preise, Beträge, Rabatte, Steuer und Versandkosten werden 0, ItemRef, ShipRef, Order_Id, BundleOrderlineRef werden NULL.
• Referenzierte Bundle-Positionen (BundleOrderlines) werden gelöscht.
• Auftragskopf-Attribute (OrderHeaderAttribute) werden gelöscht.
• Reservierungen (Reservation) der Auftragspositionen werden gelöscht.
• Das mit der Bankzuordnung des Auftrags verknüpfte Kundenkonto-Ereignis wird über Pixi_CA_DeleteEvent gelöscht (dabei können auch die zugehörige Rechnung, Bankzuordnungen, Kundenkonto-Matches, DTAUS-Datensätze oder manuelle Buchungen gelöscht werden).
• Abschließend löscht Pixi_DeleteEmptyOrder Picklisten-Prüfeinträge, Tag-Zuordnungen, restliche Kopfattribute und den Auftragskopf selbst.

Bei Erfolg enthält die Statuszeile 200 und einen Bestätigungstext. Unerwartete SQL-Fehler werden protokolliert und als 500 mit der SQL-Fehlermeldung zurückgegeben.

Parameter

Antwort

Result-Set 1 · Immer (genau eine Zeile)

Statuszeile mit dem Ergebnis des Aufrufs.

<SqlRowSet1>
  <row>
    <Status>200</Status>
    <ErrorMsg>Order with OrderNr: 100234 was deleted.</ErrorMsg>
  </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:pixiDeleteOrder>
      <OrderNr>100234</OrderNr>
    </ns1:pixiDeleteOrder>
  </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:pixiDeleteOrder>
      <OrderNr>100234</OrderNr>
    </ns1:pixiDeleteOrder>
  </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',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiDeleteOrder

Prozedur zuletzt geändert am 2026-10-05

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