pixiSetStock

Setzt den Bestand eines Artikels auf einem Lagerplatz auf einen absoluten Wert, indem die Differenz als Einbuchung oder Ausbuchung gebucht wird.

Setzt die Menge eines Artikels auf einem Lagerplatz auf NewStockQty. Die Menge wird nicht direkt überschrieben. Es wird die Differenz zur aktuellen Menge berechnet und als Lagerbewegung gebucht.

Ablauf:

1. Prüft die Einstellung API_Stock_Movements. Ist sie nicht aktiviert, wird eine Statuszeile mit Status = ERROR geliefert und die Verarbeitung beendet.
2. Prüft, ob SMORef eine Lagerbewegungsoperation (StockMovementOperations.SMOKey) mit Application = API ist. Andernfalls wird ein Fehler ausgelöst.
3. Sucht den Artikel über EANUPC = EanUpc.
4. Ermittelt, ob der Artikel Chargennummern bzw. Mindesthaltbarkeitsdaten benötigt (Artikel-Tags -6 und -7). Benötigt der Artikel sie nicht, werden BatchNumber und BestBeforeDate ignoriert. Benötigt er sie, müssen sie gefüllt sein; sonst wird nichts gebucht.
5. Sucht den Lagerplatz über BinName. Ist LocId angegeben, werden nur Lagerplätze dieses Lagers berücksichtigt; sonst wird der erste Lagerplatz mit diesem Namen in einem beliebigen Lager verwendet und dessen Lager für die Buchung übernommen.
6. Berechnet die Differenz: NewStockQty minus Summe von BinItemQTY des Artikels auf diesem Lagerplatz (alle Zeilen, unabhängig von Charge oder MHD).
   • Differenz > 0: Einbuchung (Pixi_InvBinScanIn) der Differenz.
   • Differenz < 0: Ausbuchung (Pixi_InvBinTakeOut) der absoluten Differenz.
   • Differenz = 0: keine Buchung.
7. Vor der Buchung muss die Kombination aus SMORef und SMTref in StockMovementMatching existieren; sonst wird ein Fehler protokolliert und ausgelöst.
   • Ist SMTref nicht angegeben, werden beide Werte ersetzt: bei Einbuchung die API-Operation PutToStock mit Bewegungstyp 0201, bei Ausbuchung die API-Operation TakeOut mit Bewegungstyp 0301.
   • Ist SMTref angegeben, werden die übergebenen Werte SMORef und SMTref verwendet.
8. Abschließend wird der Artikel zur Bestandsneuberechnung und zum Shop-Export eingereiht (Pixi_ExportItemChangesToShop), auch wenn nichts gebucht wurde.

Die Prozedur liefert einen Rückgabewert: 0 = verarbeitet, 1 = Artikel nicht gefunden oder benötigte Charge/MHD fehlt, 2 = Lagerplatz nicht gefunden. Im Erfolgsfall wird keine Ergebnismenge geliefert.

Parameter

Antwort

Result-Set 1 · Nur wenn die Einstellung API_Stock_Movements nicht aktiviert ist.

Statuszeile mit dem Fehler. Im Erfolgsfall liefert der Aufruf keine Ergebnismenge.

<SqlRowSet1>
  <row>
    <Status>ERROR</Status>
    <StatusMessage>Setting "API Calls Stock Movements" (API_Stock_Movements) is not enabled.</StatusMessage>
  </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:pixiSetStock>
      <EanUpc>4012345678901</EanUpc>
      <BinName>A-01-02</BinName>
      <!-- <LocId>001</LocId> -->
      <NewStockQty>25</NewStockQty>
      <!-- <Username>ShopSync</Username> -->
      <!-- <SMORef>12</SMORef> -->
      <!-- <SMTref>5</SMTref> -->
      <!-- <BatchNumber>CH-2024-001</BatchNumber> -->
      <!-- <BestBeforeDate>2025-12-31T00:00:00</BestBeforeDate> -->
    </ns1:pixiSetStock>
  </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:pixiSetStock>
      <EanUpc>4012345678901</EanUpc>
      <BinName>A-01-02</BinName>
      <!-- <LocId>001</LocId> -->
      <NewStockQty>25</NewStockQty>
      <!-- <Username>ShopSync</Username> -->
      <!-- <SMORef>12</SMORef> -->
      <!-- <SMTref>5</SMTref> -->
      <!-- <BatchNumber>CH-2024-001</BatchNumber> -->
      <!-- <BestBeforeDate>2025-12-31T00:00:00</BestBeforeDate> -->
    </ns1:pixiSetStock>
  </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 = [
    'EanUpc' => '4012345678901',
    'BinName' => 'A-01-02',
    // 'LocId' => '001',
    'NewStockQty' => '25',
    // 'Username' => 'ShopSync',
    // 'SMORef' => '12',
    // 'SMTref' => '5',
    // 'BatchNumber' => 'CH-2024-001',
    // 'BestBeforeDate' => '2025-12-31T00:00:00',
];

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

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

Verwandte Calls

Verwendete Tabellen

SQL-Objekt:

dbo.pipiSetStock

Prozedur zuletzt geändert am 2026-10-05

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