Postman-Collection
Stock Lesen

pixiShopLinkGetItemsStock

Liefert den verfügbaren Bestand aller Artikel für den Shop-Bestandsexport, optional ohne Nullbestände und ohne Bestand in ausgeschlossenen Lagerplatzgruppen.

Liefert je Artikel eine Zeile mit der internen Artikelnummer und der Menge, die an den Shop exportiert werden kann.

Das Verhalten hängt von der Einstellung OldStockExport ab:

  • OldStockExport = 1: Die Prozedur sammelt Quantity aus Items in einer temporären Tabelle, liefert aber keine Ergebnismenge (das abschließende SELECT steht nur im anderen Zweig).
  • Sonst (Standard): Die verfügbare Menge wird je Artikel als ItemQtyIBIExportStock_locations abzüglich eines Abzugs berechnet:
    • ItemQtyOpenOrderLines, wenn Reservierungen deaktiviert sind (ReservePrepaymentOrders <> 1) oder ExportAvailableStock_WhenReservationsAreEnabled = 1 ist, und zugleich StockExportUsePhysicalStock = 0 ist und der Artikel kein Bundle ist;
    • ItemQtyOpenReservations, wenn Reservierungen aktiv sind, StockExportUsePhysicalStock = 0 ist und der Artikel kein Bundle ist;
    • kein Abzug (0) in allen anderen Fällen (Export des physischen Bestands oder Bundle-Artikel).

Filter und Korrekturen (nicht-Legacy-Zweig):

  1. Bei ExcludeZeros = 1 bleiben nur Artikel mit einer berechneten Menge größer 0. NULL wird als 0 behandelt (alle Artikel).
  2. Ist ExcludeBinGroups angegeben (kommagetrennte Liste von Lagerplatzgruppen), wird der Bestand je Artikel auf Lagerplätzen dieser Gruppen aus InvBinItemLog summiert und abgezogen. Für Bundles, deren Komponenten auf diesen Lagerplätzen liegen, ist der Abzug das Minimum über die Komponenten von CEILING(Komponentenmenge / Menge im Bundle). Die Zuordnung zur Ergebniszeile erfolgt über den Artikelcode mit CodeTypeId = 2 (Shop-Artikelnummer) gegen ItemNrInt.
  3. Negative Mengen werden auf 0 gesetzt.

Die Zeilen werden ohne definierte Sortierung geliefert.

Hinweise

  • Ist die Einstellung OldStockExport = 1, liefert der Aufruf gar keine Zeilen; ExcludeZeros und ExcludeBinGroups haben dann keine sichtbare Wirkung.
  • ExcludeZeros wird vor dem Abzug der Lagerplatzgruppen und vor dem Begrenzen auf 0 angewendet. Artikel können daher bei ExcludeZeros = 1 und gesetztem ExcludeBinGroups trotzdem mit AvailableQty = 0 erscheinen.
  • Der Abzug der Lagerplatzgruppen vergleicht pixi.ItemCode.Code (Codetyp 2, Shop-Artikelnummer) mit Items.ItemNrInt. Weichen diese Nummern bei einem Artikel ab, wird für ihn nichts abgezogen.
  • Einstellungen werden über fpixi_GetSetting gelesen; eine fehlende Einstellung gilt als 0.
  • Alle Tabellen werden WITH (NOLOCK) gelesen; das Ergebnis kann nicht festgeschriebene Daten enthalten.
  • Ohne Paging liefert der Aufruf alle Artikel, was bei großen Sortimenten eine umfangreiche Antwort ergibt.
  • Ein großer Block älterer Logik ist im Code auskommentiert und wird nicht ausgeführt.

Parameter

Parameter Typ Standardwert Beschreibung
ExcludeZeros
bit
boolean
NULL

Bei 1 werden nur Artikel mit einer berechneten Menge größer 0 geliefert. NULL wird als 0 behandelt.

Erlaubte Werte

  • 0 – Alle Artikel liefern (Standard).
  • 1 – Nur Artikel mit Bestand größer 0 liefern (im Legacy-Zweig: Menge ungleich 0).

Beispiel: 1

ExcludeBinGroups
varchar(max)
string
NULL

Kommagetrennte Liste von Lagerplatzgruppen (InvBin.BinGroup), deren Bestand von der verfügbaren Menge abgezogen wird. Leere Einträge werden ignoriert, Leerzeichen um die Einträge entfernt.

Beispiel: RETURNS,DEFECT

Antwort

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

Eine Zeile je Artikel mit der exportierbaren Bestandsmenge.

Spalte Typ Beschreibung
ItemNrInt
Kann leer sein
varchar(50)
string

Interne Artikelnummer (Items.ItemNrInt).

AvailableQty
Kann leer sein
int

Verfügbare Menge für den Bestandsexport nach Abzügen; nie negativ.

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:pixiShopLinkGetItemsStock>
      <!-- <ExcludeZeros>1</ExcludeZeros> -->
      <!-- <ExcludeBinGroups>RETURNS,DEFECT</ExcludeBinGroups> -->
    </ns1:pixiShopLinkGetItemsStock>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Verwendete Tabellen

Items · Lesen InvBin · Lesen InvBinItemLog · Lesen ItemCode · Lesen BundleItems · Lesen Settings · Lesen
SQL-Objekt:
dbo.pipiShopLinkGetItemsStock
Prozedur zuletzt geändert am 2026-10-05
Dokumentation von claude-opus-5-5 am 2026-10-30 geschrieben