pixiGetChangedItemStock_LocID

Liefert Artikel, deren Bestand sich in einem Zeitraum geändert hat, mit physischem und verfügbarem Bestand, optional je Lager und ohne bestimmte Lagerplatzgruppen.

Delta-Bestandsexport je Lager. Der Aufruf sammelt geänderte Artikel, berechnet deren Bestandswerte und liefert eine Seite von Zeilen.

1. Kandidaten

• Kandidaten sind Nicht-Bundle-Artikel mit Einträgen im Bestandsbewegungsprotokoll InvBinItemLog.
• Als Änderungsdatum gilt COALESCE(items.LastCalculateStockDate, InvBinItemLog.UpdateDate, jetzt). Es muss zwischen Since und DateTo liegen.
• Ist LocID nicht leer, zählen nur Protokolleinträge dieses Lagers.
• StockChange ist die Summe der protokollierten Mengen.

2. Bundles

• Zu jeder geänderten Komponente werden die zugehörigen Bundle-Artikel mit BundleItem = 1 ergänzt.
• Deren StockChange ist die Komponentenänderung geteilt durch die Komponentenmenge im Bundle (Ganzzahldivision).

3. Paging

• Die Zeilen werden nach Änderungsdatum aufsteigend, dann nach dem höchsten Protokollschlüssel nummeriert (RowNr).
• Start ist ein nullbasierter Offset. Zeilen ab Start + 1 werden übernommen, höchstens Rowcount Zeilen werden geliefert.

4. Bereinigung

• Zeilen für nicht mehr existierende Artikel werden entfernt.
• Zeilen für Artikel, die inzwischen Bundles sind, aber als Nicht-Bundle gesammelt wurden, werden entfernt.

5. Artikeldaten

• ItemNrInt, EANUPC, ItemNrSuppl, Enabled und MinStockQty stammen aus dem Artikelstamm.
• PhysicalStock ist bei leerem LocID die Summe aller positiven LocationQuantity-Werte, sonst die Lagermenge von LocID.
• AvailableStock wird zunächst auf items.Quantity gesetzt.

6. Nur Nicht-Bundle-Artikel

AvailableStock wird neu berechnet als Summe der Lagerplatzmengen (InvBinItem) im Lager (bzw. allen Lagern) abzüglich eines Abzugs:

• Ist die Einstellung ReservePrepaymentOrders nicht 1: Die Mengen der Auftragspositionen mit Status ANG oder HAL werden abgezogen.
• Sonst: Die Anzahl der Reservierungsdatensätze wird abgezogen. Gezählt werden Auftragspositionen in nicht-finalen Status außer EIN, FUT und FUS.
• Beide Abzüge greifen nur, wenn die Einstellung StockExportUsePhysicalStock den Wert 0 hat.

Zusätzlich werden befüllt:

• OpenSupplierOrderQTY: offene Menge der Lieferantenbestellpositionen, deren Status IsAllOpen = 1 hat.
• EstimatedDelivery: aus Item_EstimatedDelivery.ExportEstimatedDelivery.

7. Ausgeschlossene Lagerplatzgruppen

• Ist ExcludeBinGroups gesetzt (kommagetrennte Liste), werden die protokollierten Mengen aller Lagerplätze dieser Gruppen je Artikel summiert. Es zählen nur Protokolleinträge bis DateTo.
• Für Bundles wird das Ergebnis in Bundle-Einheiten umgerechnet.
• Diese Menge wird von AvailableStock, PhysicalStock und StockChange abgezogen.

8. Ergebnis

Das Ergebnis ist nach RowNr sortiert.

Parameter

Antwort

Result-Set 1 · Immer

Geänderte Artikel mit Bestandswerten, sortiert nach RowNr.

<SqlRowSet1>
  <row>
    <ItemKey>4711</ItemKey>
    <ItemNrInt>ART-1001</ItemNrInt>
    <EANUPC>4006381333931</EANUPC>
    <ItemNrSuppl>SUP-55</ItemNrSuppl>
    <PhysicalStock>25</PhysicalStock>
    <AvailableStock>20</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:15:00</OriginalUpdateDate>
    <BundleItem>false</BundleItem>
    <RowNr>1</RowNr>
  </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_LocID>
      <Since>2024-05-01T00:00:00</Since>
      <!-- <Rowcount>500</Rowcount> -->
      <!-- <LocID>001</LocID> -->
      <!-- <DateTo>2024-05-02T00:00:00</DateTo> -->
      <!-- <Start>0</Start> -->
      <!-- <ExcludeBinGroups>RETOURE,SPERR</ExcludeBinGroups> -->
    </ns1:pixiGetChangedItemStock_LocID>
  </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_LocID>
      <Since>2024-05-01T00:00:00</Since>
      <!-- <Rowcount>500</Rowcount> -->
      <!-- <LocID>001</LocID> -->
      <!-- <DateTo>2024-05-02T00:00:00</DateTo> -->
      <!-- <Start>0</Start> -->
      <!-- <ExcludeBinGroups>RETOURE,SPERR</ExcludeBinGroups> -->
    </ns1:pixiGetChangedItemStock_LocID>
  </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' => 'RETOURE,SPERR',
];

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

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

Verwandte Calls

Verwendete Tabellen

SQL-Objekt:

dbo.pipiGetChangedItemStock_LocID

Prozedur zuletzt geändert am 2026-10-05

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