pixiShopLinkGetItemsStockRange

Liefert den exportierbaren verfügbaren Bestand und Mindestbestand der Artikel, seitenweise nach Artikelschlüssel, zum Abgleich der Shop-Bestände.

Liefert je Artikel eine Zeile mit dem verfügbaren Bestand für den Bestandsexport an einen Shop. Das Verhalten hängt von den Einstellungen OldStockExport, StockExportUsePhysicalStock, ReservePrepaymentOrders und ExportAvailableStock_WhenReservationsAreEnabled ab. Eine fehlende Einstellung gilt als 0.

Standardwerte der Parameter: FromItemKey NULL wird zu 0, RowCount NULL wird zu 1000, ExcludeZeros NULL wird zu 0.

Standardmodus (OldStockExport ist nicht 1):

• Es werden nur Artikel mit ItemKey >= FromItemKey gelesen. Höchstens RowCount Zeilen werden geliefert, aufsteigend sortiert nach ItemKey.
• AvailableQty ist der vorberechnete Exportbestand des Artikels (ItemQtyIBIExportStock_locations) abzüglich eines Abzugs:
  • Die Menge offener Auftragspositionen (ItemQtyOpenOrderLines), wenn Reservierungen deaktiviert sind oder wenn sie aktiv sind und ExportAvailableStock_WhenReservationsAreEnabled = 1 ist. Dies gilt nur, wenn StockExportUsePhysicalStock = 0 ist und der Artikel kein Bundle ist.
  • Die offenen Reservierungen (ItemQtyOpenReservations), wenn Reservierungen aktiv sind und die andere Einstellung nicht 1 ist. Auch dies gilt nur, wenn StockExportUsePhysicalStock = 0 ist und der Artikel kein Bundle ist.
  • Kein Abzug in allen anderen Fällen: physischer Bestand wird verwendet oder der Artikel ist ein Bundle.
• Mit ExcludeZeros = 1 werden nur Artikel mit AvailableQty > 0 geliefert.
• Mit ExcludeZeros = 0 werden alle Artikel im Bereich geliefert und negative Mengen auf 0 gesetzt.

Alter Modus (OldStockExport = 1):

• Liefert ItemNrInt, Quantity als AvailableQty (NULL wird zu 0) und MinStockQty für alle Artikel.
• Es gibt keine Spalte ItemKey, kein Paging und keine Sortierung.
• Mit ExcludeZeros = 1 werden Artikel mit Menge 0 ausgelassen.

Paging: Im Standardmodus erneut aufrufen mit FromItemKey = zuletzt geliefertes ItemKey + 1, bis weniger als RowCount Zeilen zurückkommen.

Parameter

Antwort

Result-Set 1 · Standardmodus (OldStockExport nicht 1) und ExcludeZeros = 0 oder NULL

Bis zu RowCount Artikel ab FromItemKey, sortiert nach ItemKey. Negative Mengen werden auf 0 gesetzt.

Result-Set 2 · Standardmodus (OldStockExport nicht 1) und ExcludeZeros = 1

Bis zu RowCount Artikel ab FromItemKey mit positivem verfügbarem Bestand, sortiert nach ItemKey.

Result-Set 3 · Alter Modus (OldStockExport = 1)

Alle Artikel, bei ExcludeZeros = 1 nur solche mit Menge ungleich 0. Kein Paging und keine Sortierung.

<SqlRowSet1>
  <row>
    <ItemKey>1001</ItemKey>
    <ItemNrInt>ART-10001</ItemNrInt>
    <AvailableQty>25</AvailableQty>
    <MinStockQty>5</MinStockQty>
  </row>
  <row>
    <ItemKey>1002</ItemKey>
    <ItemNrInt>ART-10002</ItemNrInt>
    <AvailableQty>0</AvailableQty>
    <MinStockQty>0</MinStockQty>
  </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:pixiShopLinkGetItemsStockRange>
      <!-- <FromItemKey>0</FromItemKey> -->
      <!-- <RowCount>500</RowCount> -->
      <!-- <ExcludeZeros>1</ExcludeZeros> -->
    </ns1:pixiShopLinkGetItemsStockRange>
  </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:pixiShopLinkGetItemsStockRange>
      <!-- <FromItemKey>0</FromItemKey> -->
      <!-- <RowCount>500</RowCount> -->
      <!-- <ExcludeZeros>1</ExcludeZeros> -->
    </ns1:pixiShopLinkGetItemsStockRange>
  </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 = [
    // 'FromItemKey' => '0',
    // 'RowCount' => '500',
    // 'ExcludeZeros' => '1',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiShopLinkGetItemsStockRange

Prozedur zuletzt geändert am 2026-10-05

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