pixiGetChangedItemStock

Liefert Artikel, deren Bestand sich in einem Zeitraum geändert hat, mit physischem und verfügbarem Bestand, offener Lieferantenbestellmenge und Meldebestand, seitenweise.

Erstellt eine Delta-Liste von Bestandsänderungen für einen Bestandsexport.

Zeitraum und Lager

• Since bis DateTo definiert den Zeitraum. DateTo ist standardmäßig die aktuelle Zeit; Werte bis 1990-01-01 werden ebenfalls durch die aktuelle Zeit ersetzt.
• LocID schränkt auf ein Lager ein; leer bedeutet alle Lager.

Kandidaten

1. Nicht-Bundle-Artikel mit Einträgen in InvBinItemLog im Zeitraum in den gewählten Lagern. StockChange ist die Summe der protokollierten Mengen, UpdateDate das letzte Protokolldatum.
2. Bei IncludeOrderLineChanges = 1 werden Artikel mit im Zeitraum geänderten Auftragspositionen in den gewählten Lagern ergänzt (sofern nicht bereits Kandidat). Sie benötigen mindestens einen InvBinItemLog-Eintrag; StockChange ist dann die Summe aller protokollierten Mengen in den Lagern, UpdateDate ist items.LastCalculateStockDate (Ersatz: letztes Protokolldatum, dann jetzt).
3. Für jeden Kandidaten, der Bestandteil eines Bundles ist (BundleItems), wird auch der Bundle-Artikel ergänzt, mit StockChange = Änderung des Bestandteils ganzzahlig geteilt durch die Bestandteilmenge.

Sortierung und Paging Die Kandidaten werden nach UpdateDate aufsteigend, dann nach dem letzten InvBinItemLog-Schlüssel nummeriert. Es werden Zeilen mit Nummer >= Start + 1 übernommen, höchstens Rowcount. Bundle-Artikel ohne Bundle-Kennzeichen sowie nicht mehr in items vorhandene Artikel werden übersprungen. Die gelieferte RowNr wird innerhalb der Seite ab 1 neu nummeriert.

Bestandswerte

• PhysicalStock = items.Quantity.
• MinStockQty = Summe der nicht negativen ItemLocationSpecific.MinStockQty für das Lager (oder alle Lager).
• Für Nicht-Bundles: AvailableStock = Summe von ItemLocationSpecific.LocationQuantity über alle Lager ohne Sonderbestand, abzüglich je nach Einstellung entweder offener Auftragsmengen (ANG-Positionen plus HAL-Positionen nicht älter als HalOrdersActiveDays Tage) oder der Anzahl Reservierungen auf nicht finalen Auftragspositionen (ohne Status EIN, FUT, FUS). OpenSupplierOrderQTY ist die offene Menge der Lieferantenbestellpositionen mit vollständig offenem Status; EstimatedDelivery stammt aus Item_EstimatedDelivery.ExportEstimatedDelivery.
• Für Bundles: AvailableStock bleibt items.Quantity, OpenSupplierOrderQTY 0, EstimatedDelivery NULL.

Ausgeschlossene Lagerplatzgruppen Ist ExcludeBinGroups angegeben (kommagetrennt), wird die bis DateTo protokollierte Menge auf Lagerplätzen dieser Gruppen (Lager ohne Sonderbestand) von AvailableStock, PhysicalStock und StockChange abgezogen; bei Bundles über die Bestandteilmenge abgeleitet. PhysicalStockLoc ist dann die Lagerplatzmenge in den gewählten Lagern außerhalb dieser Gruppen. Ohne ExcludeBinGroups ist PhysicalStockLoc die Summe von ItemLocationSpecific.LocationQuantity in den gewählten Lagern für Nicht-Bundles (0 für Bundles).

Parameter

Antwort

Result-Set 1 · Immer (ggf. leer).

Eine Zeile je geändertem Artikel, sortiert nach Änderungsdatum.

<SqlRowSet1>
  <row>
    <ItemKey>4711</ItemKey>
    <ItemNrInt>ART-1001</ItemNrInt>
    <EANUPC>4006381333931</EANUPC>
    <ItemNrSuppl>SUP-55</ItemNrSuppl>
    <PhysicalStock>25</PhysicalStock>
    <AvailableStock>21</AvailableStock>
    <StockChange>-3</StockChange>
    <EstimatedDelivery>2024-05-10T00:00:00</EstimatedDelivery>
    <MinStockQty>5</MinStockQty>
    <Enabled>true</Enabled>
    <OpenSupplierOrderQTY>50</OpenSupplierOrderQTY>
    <UpdateDate>2024-05-01T08:15:00</UpdateDate>
    <OriginalUpdateDate>2024-05-01T08:20:00</OriginalUpdateDate>
    <BundleItem>false</BundleItem>
    <RowNr>1</RowNr>
    <PhysicalStockLoc>25</PhysicalStockLoc>
  </row>
</SqlRowSet1>

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:pixiGetChangedItemStock>
      <Since>2024-05-01T00:00:00</Since>
      <!-- <Rowcount>500</Rowcount> -->
      <!-- <LocID>001</LocID> -->
      <!-- <DateTo>2024-05-02T00:00:00</DateTo> -->
      <!-- <Start>0</Start> -->
      <!-- <ExcludeBinGroups>RETURNS,QUARANTINE</ExcludeBinGroups> -->
      <!-- <IncludeOrderLineChanges>1</IncludeOrderLineChanges> -->
    </ns1:pixiGetChangedItemStock>
  </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:pixiGetChangedItemStock>
      <Since>2024-05-01T00:00:00</Since>
      <!-- <Rowcount>500</Rowcount> -->
      <!-- <LocID>001</LocID> -->
      <!-- <DateTo>2024-05-02T00:00:00</DateTo> -->
      <!-- <Start>0</Start> -->
      <!-- <ExcludeBinGroups>RETURNS,QUARANTINE</ExcludeBinGroups> -->
      <!-- <IncludeOrderLineChanges>1</IncludeOrderLineChanges> -->
    </ns1:pixiGetChangedItemStock>
  </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 = [
    'Since' => '2024-05-01T00:00:00',
    // 'Rowcount' => '500',
    // 'LocID' => '001',
    // 'DateTo' => '2024-05-02T00:00:00',
    // 'Start' => '0',
    // 'ExcludeBinGroups' => 'RETURNS,QUARANTINE',
    // 'IncludeOrderLineChanges' => '1',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiGetChangedItemStock

Prozedur zuletzt geändert am 2026-10-05

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