pixiUpdateOrderline

Ändert Bezeichnung, Menge, Preise, Rabatte, Notiz, Seriennummer und DF-Typ einer Auftragsposition oder Bundle-Position, sofern die Position noch änderbar ist.

Ändert eine einzelne Auftragsposition (OrderlineKey) oder eine Bundle-Position (BundleOrderlineKey) und liefert eine Zeile result mit 1 (ausgeführt) oder 0 (abgelehnt).

Schlüsselwahl

• BundleOrderlineKey = 0 wird als NULL behandelt.
• Fehlen beide Schlüssel, wird eine Informationsmeldung ausgegeben und result = 0 geliefert.
• Ist BundleOrderlineKey gesetzt, wird OrderlineKey ignoriert.

Prüfung der Änderbarkeit Die Position, bei einem Bundle jede Komponenten-Position, muss alle folgenden Bedingungen erfüllen:

• ihr Auftragsstatus (OrderStates) ist kein Endstatus (FinalState ist N oder leer),
• ihr Status ist nicht EIN,
• sie ist nicht in einer Kiste verpackt (boxitems),
• sie steht auf keiner Rechnung (Invlines).

Erfüllt eine einzige Position die Prüfung nicht, wird nichts geändert und result = 0 geliefert.

Zusammenführen mit den aktuellen Werten Jeder nicht übergebene Parameter (NULL) behält den gespeicherten Wert der Position. Bei ArtName, oItemSpecialNote und SerialNumber behält auch ein Leerstring den gespeicherten Wert. Bei Bundles wird die Seriennummer nicht verarbeitet. Ist der resultierende Price höher als FullPrice, wird FullPrice auf Price angehoben. Dieselbe Regel gilt für die Nettowerte.

Aktualisierung Anschließend wird die interne Prozedur Pixi_UpdateOrderline mit dem Bearbeiter API ausgeführt. Sie führt Folgendes aus:

• aktualisiert die Auftragsposition bzw. Bundle-Position mit Menge, Brutto-/Nettopreis, Bestätigungsdatum, Bezeichnung, Notiz, Seriennummer, Vollpreisen, Rabattprozent/-wert und DF_type;
• setzt bei Bundles zusätzlich DF_type auf allen Komponenten-Positionen;
• schreibt die aktuellen Kopfwerte (Adressbemerkung, Geschenknachricht sowie bei vorhandener Versandanweisung auch Versandanweisung, Verfahren, Product, Extras) zurück in OrderHeader;
• gleicht den Gutschein des Auftrags ab (siehe Hinweise);
• baut die Reservierungen des gesamten Auftrags neu auf, wenn eine seiner Positionen eine Reservierung hat.

Zum Schluss wird result = 1 geliefert.

Parameter

Antwort

Result-Set 1 · Wenn kein Schlüssel übergeben wurde oder die Position (bzw. eine Bundle-Komponente) nicht mehr änderbar ist.

Statuszeile, die anzeigt, dass nichts geändert wurde.

Result-Set 2 · Nur wenn in der internen Aktualisierungsprozedur eine Ausnahme auftritt.

Fehlerzeile von Pixi_UpdateOrderline mit unbenannten Spalten. Clients sehen sie üblicherweise als Column1 und Column2. Die Änderungen werden zurückgerollt.

Result-Set 3 · Nachdem die Position die Prüfung bestanden hat und die interne Aktualisierung ausgeführt wurde (auch wenn sie nichts geändert hat oder fehlgeschlagen ist).

Statuszeile, die anzeigt, dass die Aktualisierung ausgeführt wurde.

<SqlRowSet1>
  <row>
    <result>1</result>
  </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:pixiUpdateOrderline>
      <!-- <OrderlineKey>123456</OrderlineKey> -->
      <!-- <ArtName>T-Shirt Basic blau XL</ArtName> -->
      <!-- <Qty>2</Qty> -->
      <!-- <Price>19.95</Price> -->
      <!-- <FullPrice>24.95</FullPrice> -->
      <!-- <oItemSpecialNote>Bitte als Geschenk verpacken</oItemSpecialNote> -->
      <!-- <DiscountValue>5.00</DiscountValue> -->
      <!-- <DiscountPerc>20</DiscountPerc> -->
      <!-- <DF_Type>N</DF_Type> -->
      <!-- <SerialNumber>SN-2024-000815</SerialNumber> -->
      <!-- <BundleOrderlineKey>0</BundleOrderlineKey> -->
    </ns1:pixiUpdateOrderline>
  </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:pixiUpdateOrderline>
      <!-- <OrderlineKey>123456</OrderlineKey> -->
      <!-- <ArtName>T-Shirt Basic blau XL</ArtName> -->
      <!-- <Qty>2</Qty> -->
      <!-- <Price>19.95</Price> -->
      <!-- <FullPrice>24.95</FullPrice> -->
      <!-- <oItemSpecialNote>Bitte als Geschenk verpacken</oItemSpecialNote> -->
      <!-- <DiscountValue>5.00</DiscountValue> -->
      <!-- <DiscountPerc>20</DiscountPerc> -->
      <!-- <DF_Type>N</DF_Type> -->
      <!-- <SerialNumber>SN-2024-000815</SerialNumber> -->
      <!-- <BundleOrderlineKey>0</BundleOrderlineKey> -->
    </ns1:pixiUpdateOrderline>
  </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 = [
    // 'OrderlineKey' => '123456',
    // 'ArtName' => 'T-Shirt Basic blau XL',
    // 'Qty' => '2',
    // 'Price' => '19.95',
    // 'FullPrice' => '24.95',
    // 'oItemSpecialNote' => 'Bitte als Geschenk verpacken',
    // 'DiscountValue' => '5.00',
    // 'DiscountPerc' => '20',
    // 'DF_Type' => 'N',
    // 'SerialNumber' => 'SN-2024-000815',
    // 'BundleOrderlineKey' => '0',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiUpdateOrderline

Prozedur zuletzt geändert am 2026-10-05

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