pixiGetChangedItemStock2

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

Delta-Export von Bestandsänderungen, typischerweise zum Abgleich der Shop-Bestände.

1. Lager. Alle Lager oder nur LocID, falls gesetzt.

2. Geänderte Artikel. Nicht-Bundle-Artikel mit Einträgen im Lagerplatz-Log (InvBinItemLog), deren UpdateDate zwischen Since und DateTo liegt, in den gewählten Lagern.

• StockChange ist die Summe der protokollierten Mengen im Zeitraum.
• UpdateDate ist das letzte Log-Datum.
• OriginalUpdateDate ist LastCalculateStockDate des Artikels, ersatzweise das letzte Log-Datum.

3. Auftragspositions-Änderungen. Bei IncludeOrderLineChanges = 1 werden Artikel mit Auftragspositionen ergänzt, die im Zeitraum geändert wurden, sofern sie noch nicht enthalten sind. Die LocationID der Position muss zu den gewählten Lagern gehören, und der Artikel muss in diesen Lagern Log-Einträge haben.

• Für diese Artikel ist StockChange die Summe aller Log-Einträge in diesen Lagern, nicht nur der Einträge im Zeitraum.
• UpdateDate ist LastCalculateStockDate, ersatzweise das letzte Log-Datum, ersatzweise die aktuelle Zeit.

4. Bundles. Zu jeder geänderten Komponente werden die Bundle-Artikel ergänzt, die sie enthalten (BundleItem = 1). Ihr StockChange ist die größte Komponentenänderung, ganzzahlig geteilt durch die Komponentenmenge im Bundle. Bundle-Kopfartikel werden nur als Bundle-Zeile geliefert.

5. Sortierung und Paging. Die Kandidaten werden nach UpdateDate aufsteigend nummeriert, danach nach dem höchsten Log-Schlüssel. Geliefert werden Zeilen mit einer Nummer ab Start + 1, höchstens Rowcount Stück.

6. Bestandswerte.

• PhysicalStock: items.Quantity.
• MinStockQty: Summe der nicht negativen MinStockQty-Werte aus ItemLocationSpecific für LocID bzw. für alle Lager.
• Für Nicht-Bundles:
  • AvailableStock = Summe von LocationQuantity über alle Lager ohne Sonderbestand, abzüglich der reservierten Menge (siehe Hinweise).
  • OpenSupplierOrderQTY = Summe von Qty - DeliveredQty - UndeliveredQty über Lieferantenbestellungen, deren Status IsAllOpen = 1 hat.
  • EstimatedDelivery stammt aus Item_EstimatedDelivery.ExportEstimatedDelivery.
• Für Bundles bleibt AvailableStock = items.Quantity, OpenSupplierOrderQTY ist 0 und EstimatedDelivery leer.

7. Ausgeschlossene Lagerplatzgruppen. Ist ExcludeBinGroups gesetzt, wird die Menge in Lagerplätzen dieser Gruppen von PhysicalStock, AvailableStock und StockChange abgezogen. Diese Menge ist die Summe aller Log-Einträge bis DateTo. Für Bundles wird sie aus den Komponenten abgeleitet. PhysicalStockLoc ist dann die Summe der Lagerplatzmengen in den gewählten Lagern ohne die ausgeschlossenen Gruppen.

Ohne ExcludeBinGroups ist PhysicalStockLoc die Summe von LocationQuantity in den gewählten Lagern, nur für Nicht-Bundles.

Das gelieferte RowNr wird innerhalb der Seite ab 1 neu nummeriert.

Parameter

Antwort

Result-Set 1 · Immer (kann leer sein)

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

<SqlRowSet1>
  <row>
    <ItemKey>10452</ItemKey>
    <ItemNrInt>ART-10452</ItemNrInt>
    <EANUPC>4012345678901</EANUPC>
    <ItemNrSuppl>SUP-889</ItemNrSuppl>
    <PhysicalStock>25</PhysicalStock>
    <AvailableStock>21</AvailableStock>
    <StockChange>-3</StockChange>
    <MinStockQty>5</MinStockQty>
    <Enabled>true</Enabled>
    <OpenSupplierOrderQTY>50</OpenSupplierOrderQTY>
    <UpdateDate>2024-05-01T09:15:22</UpdateDate>
    <OriginalUpdateDate>2024-05-01T09:16:00</OriginalUpdateDate>
    <BundleItem>false</BundleItem>
    <RowNr>1</RowNr>
    <PhysicalStockLoc>25</PhysicalStockLoc>
  </row>
  <row>
    <ItemKey>20877</ItemKey>
    <ItemNrInt>SET-20877</ItemNrInt>
    <EANUPC>4012345678918</EANUPC>
    <ItemNrSuppl/>
    <PhysicalStock>0</PhysicalStock>
    <AvailableStock>4</AvailableStock>
    <StockChange>-1</StockChange>
    <MinStockQty>0</MinStockQty>
    <Enabled>true</Enabled>
    <OpenSupplierOrderQTY>0</OpenSupplierOrderQTY>
    <UpdateDate>2024-05-01T09:15:22</UpdateDate>
    <OriginalUpdateDate>2024-05-01T09:15:22</OriginalUpdateDate>
    <BundleItem>true</BundleItem>
    <RowNr>2</RowNr>
    <PhysicalStockLoc>0</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:pixiGetChangedItemStock2>
      <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,DEFECT</ExcludeBinGroups> -->
      <!-- <IncludeOrderLineChanges>1</IncludeOrderLineChanges> -->
    </ns1:pixiGetChangedItemStock2>
  </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:pixiGetChangedItemStock2>
      <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,DEFECT</ExcludeBinGroups> -->
      <!-- <IncludeOrderLineChanges>1</IncludeOrderLineChanges> -->
    </ns1:pixiGetChangedItemStock2>
  </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,DEFECT',
    // 'IncludeOrderLineChanges' => '1',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiGetChangedItemStock2

Prozedur zuletzt geändert am 2026-10-05

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