pixiUpdateSupplierOrder

Aktualisiert Status, Notiz für den Lieferanten, externe Bestellnummer und voraussichtliches Lieferdatum einer Lieferantenbestellung anhand ihrer internen Nummer.

Ändert eine Lieferantenbestellung (Bestellung beim Lieferanten), die über SupplierOrderNR (die InternalNumber der Bestellung) identifiziert wird.

Ablauf

1. Leere Zeichenketten in Status und SupplierOrderNRExtdrnal sowie eine leere Note gelten als NULL (nicht übergeben).
2. UserName muss als Pixi-Benutzer existieren; andernfalls wird eine ERROR-Zeile geliefert und ein SQL-Fehler ausgelöst.
3. Bestellung und aktueller Status werden gelesen. Wird Status nicht übergeben, gilt der aktuelle Statuscode der Bestellung.
4. Prüfungen (bei einem Fehler wird eine ERROR-Zeile geliefert, es wird nichts geändert):
   • die Bestellung muss existieren;
   • Status muss NEW, BES, CON oder CLS sein;
   • eine abgeschlossene Bestellung (CLS) akzeptiert kein neues EstimatedDeliveryDate und keine neue SupplierOrderNRExtdrnal;
   • eine bestätigte Bestellung (CON) akzeptiert keine neue SupplierOrderNRExtdrnal;
   • kein Rückwärtswechsel von CLS nach NEW/BES/CON und von CON nach NEW (CON → BES ist erlaubt);
   • kein Überspringen: NEW kann nicht direkt nach CON oder CLS, BES nicht direkt nach CLS wechseln.
5. Der Bestellkopf wird aktualisiert:
   • der Status wird gesetzt (NEW=1, BES=2, CON=3, CLS=4);
   • bei BES werden Bestelldatum und bestellender Benutzer auf jetzt bzw. den aufrufenden Benutzer gesetzt, bei CON Bestätigungsdatum und bestätigender Benutzer;
   • externe Nummer, Notiz für den Lieferanten und voraussichtliches Lieferdatum werden nur überschrieben, wenn ein Wert übergeben wird;
   • Änderungsbenutzer und -zeitpunkt werden gesetzt.
6. Wird EstimatedDeliveryDate übergeben, wird es zusätzlich in alle Positionen der Lieferantenbestellung geschrieben.
7. Hat sich der Status tatsächlich geändert, wird das Ereignis SupplierOrderStatusChanged mit der internen Bestell-Id veröffentlicht.
8. Eine Zeile mit ReturnCode = Ok wird geliefert und die Transaktion festgeschrieben.

Parameter

Antwort

Result-Set 1 · Immer eine Zeile: Ok bei Erfolg (außerhalb einer äußeren Transaktion), ERROR bei jedem Fehler.

Statuszeile der Aktualisierung.

<SqlRowSet1>
  <row>
    <ReturnCode>Ok</ReturnCode>
    <ErrorMessage>Supplier Order with SupplierOrderNR 10234 updated.</ErrorMessage>
  </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:pixiUpdateSupplierOrder>
      <SupplierOrderNR>10234</SupplierOrderNR>
      <!-- <Status>BES</Status> -->
      <!-- <Note>Please deliver on euro pallets.</Note> -->
      <!-- <EstimatedDeliveryDate>2024-06-15T00:00:00</EstimatedDeliveryDate> -->
      <!-- <SupplierOrderNRExtdrnal>AB-2024-0815</SupplierOrderNRExtdrnal> -->
      <!-- <UserName>API</UserName> -->
    </ns1:pixiUpdateSupplierOrder>
  </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:pixiUpdateSupplierOrder>
      <SupplierOrderNR>10234</SupplierOrderNR>
      <!-- <Status>BES</Status> -->
      <!-- <Note>Please deliver on euro pallets.</Note> -->
      <!-- <EstimatedDeliveryDate>2024-06-15T00:00:00</EstimatedDeliveryDate> -->
      <!-- <SupplierOrderNRExtdrnal>AB-2024-0815</SupplierOrderNRExtdrnal> -->
      <!-- <UserName>API</UserName> -->
    </ns1:pixiUpdateSupplierOrder>
  </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 = [
    'SupplierOrderNR' => '10234',
    // 'Status' => 'BES',
    // 'Note' => 'Please deliver on euro pallets.',
    // 'EstimatedDeliveryDate' => '2024-06-15T00:00:00',
    // 'SupplierOrderNRExtdrnal' => 'AB-2024-0815',
    // 'UserName' => 'API',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiUpdateSupplierOrder

Prozedur zuletzt geändert am 2026-10-05

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