pixiUpdateDeliveryItem

Aktualisiert eine bestehende Artikelposition einer Lieferantenlieferung (Menge, Einkaufspreis, Charge, MHD), optional mit Zuordnung zu einer Bestellposition.

Ändert eine bestehende Position (SDelDetail) einer Lieferantenlieferung. Der Aufruf legt keine neuen Positionen an. Aktualisiert wird nur eine Position, die für den Artikel auf der Lieferung bereits vorhanden ist.

1. Lieferung ermitteln. SDelHKey oder DeliveryNumber (SDelHNr) angeben. SDelHSupplNr kann die Suche einschränken. Verwendet wird der erste passende SDelHeader-Datensatz. Der Aufruf bricht ab, wenn:

   • keine Lieferung gefunden wird,
   • der Lieferungsstatus CLS oder INV ist,
   • die Lieferung durch Picco gesperrt ist (LockedByPicco gesetzt) und PiccoUser nicht dem sperrenden Benutzer entspricht.

   Danach wird für alle weiteren Schritte die Lieferantennummer der Lieferung selbst verwendet.

2. Artikel ermitteln. fpixi_GetItemKey ermittelt den Artikel über EANUPC oder, wenn keine EAN angegeben ist, über ItemNrInternal. Gesucht wird in scanbaren Artikelcodes (pixi.ItemCode verknüpft mit ItemCodeType, Scannable = 1). Sind beide Werte angegeben, wird nur EANUPC verwendet.

3. Optionale Bestellzuordnung. Dieser Schritt läuft nur, wenn InternalNumber oder ExternalCode angegeben ist. InternalNumber hat Vorrang. Der Aufruf sucht in pixi.SupplierOrder nach InternalNumber bzw. ExternalCode und prüft die Regeln Error01 bis Error07:

   • der externe Code darf nicht auf mehreren Bestellungen des Lieferanten der Lieferung vorkommen,
   • eine Bestellung muss gefunden werden,
   • die Bestellung muss zum Lieferanten der Lieferung gehören,
   • der Artikel muss auf der Bestellung stehen,
   • der Bestellstatus muss für die Lieferung zulässig sein.

   Die zulässigen Status hängen von der Einstellung ConfirmOrderedDocumentOnDelivery ab: 0 verwendet Status mit IsConfirmed = 1, 1 verwendet Status mit IsOrderedConfirmed = 1. Mit der Id der gefundenen Bestellposition wird anschließend die Lieferposition gesucht, deren SDelDsorderlineRef auf diese Bestellposition verweist.

4. Lieferposition ohne Bestellzuordnung ermitteln. Gelesen werden alle Positionen der Lieferung für den Artikel, bei Angabe von SdelDkey nur diese Position. Gibt es keine Position oder mehrere Positionen ohne SdelDkey, wird ein Fehler zurückgegeben.

5. Fehlende Werte ergänzen. Nicht angegebene Parameter behalten die Werte der bestehenden Position: gelieferte Menge, Charge, Mindesthaltbarkeitsdatum und Bestellpositionsreferenz. Die bestellte Menge wird immer aus der bestehenden Position übernommen.

6. Einkaufspreis aktualisieren. Ist SupplPrice ungleich 0, schreibt Pixi_SetAddItemsSupPrice den Preis in die Lieferanten-Artikeldaten (AddItems). Das geschieht nur bei positiven Preisen. Die Position erhält dann Preis, Mittelpreis und Endpreis = SupplPrice, die Rabatte werden auf 0 gesetzt. Ist SupplPrice 0, bleiben die bisherigen Preise der Position erhalten.

7. Position schreiben. GOS_SDelDetailInsertOrUpdate aktualisiert die Position und gibt sie vollständig zurück, einschließlich Auftragskennzahlen zum Artikel.

Parameter

Antwort

Result-Set 1 · Wenn eine Prüfung fehlschlägt (alle Fehler außer Error04)

Eine Zeile mit dem Fehlertext; es wird nichts geändert.

Result-Set 2 · Bei Error04 (Suche über ExternalCode, Artikel nicht auf der Bestellung)

Eine Zeile mit dem Fehlertext in einer Spalte ohne Alias; der Spaltenname in der Antwort ist im Code nicht festgelegt.

Result-Set 3 · Bei Erfolg

Die aktualisierte Lieferposition, wie von GOS_SDelDetailInsertOrUpdate zurückgegeben.

<SqlRowSet1>
  <row>
    <ERROR>Item not exist on delivery</ERROR>
  </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:pixiUpdateDeliveryItem>
      <!-- <SDelHKey>10452</SDelHKey> -->
      <!-- <DeliveryNumber>2024117</DeliveryNumber> -->
      <!-- <UserName>API</UserName> -->
      <!-- <ItemNrInternal>ART-100234</ItemNrInternal> -->
      <!-- <EANUPC>4006381333931</EANUPC> -->
      <!-- <SDelHSupplNr>LIEF</SDelHSupplNr> -->
      <!-- <DeliverdQty>24</DeliverdQty> -->
      <!-- <SupplPrice>12.50</SupplPrice> -->
      <!-- <PiccoUser>picco01</PiccoUser> -->
      <!-- <InternalNumber>5871</InternalNumber> -->
      <!-- <ExternalCode>PO-2024-0815</ExternalCode> -->
      <!-- <BatchNumber>CH-2024-07</BatchNumber> -->
      <!-- <BestBeforeDate>2025-12-31T00:00:00</BestBeforeDate> -->
      <!-- <SdelDkey>883104</SdelDkey> -->
    </ns1:pixiUpdateDeliveryItem>
  </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:pixiUpdateDeliveryItem>
      <!-- <SDelHKey>10452</SDelHKey> -->
      <!-- <DeliveryNumber>2024117</DeliveryNumber> -->
      <!-- <UserName>API</UserName> -->
      <!-- <ItemNrInternal>ART-100234</ItemNrInternal> -->
      <!-- <EANUPC>4006381333931</EANUPC> -->
      <!-- <SDelHSupplNr>LIEF</SDelHSupplNr> -->
      <!-- <DeliverdQty>24</DeliverdQty> -->
      <!-- <SupplPrice>12.50</SupplPrice> -->
      <!-- <PiccoUser>picco01</PiccoUser> -->
      <!-- <InternalNumber>5871</InternalNumber> -->
      <!-- <ExternalCode>PO-2024-0815</ExternalCode> -->
      <!-- <BatchNumber>CH-2024-07</BatchNumber> -->
      <!-- <BestBeforeDate>2025-12-31T00:00:00</BestBeforeDate> -->
      <!-- <SdelDkey>883104</SdelDkey> -->
    </ns1:pixiUpdateDeliveryItem>
  </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 = [
    // 'SDelHKey' => '10452',
    // 'DeliveryNumber' => '2024117',
    // 'UserName' => 'API',
    // 'ItemNrInternal' => 'ART-100234',
    // 'EANUPC' => '4006381333931',
    // 'SDelHSupplNr' => 'LIEF',
    // 'DeliverdQty' => '24',
    // 'SupplPrice' => '12.50',
    // 'PiccoUser' => 'picco01',
    // 'InternalNumber' => '5871',
    // 'ExternalCode' => 'PO-2024-0815',
    // 'BatchNumber' => 'CH-2024-07',
    // 'BestBeforeDate' => '2025-12-31T00:00:00',
    // 'SdelDkey' => '883104',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiUpdateDeliveryItem

Prozedur zuletzt geändert am 2026-10-05

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