Postman-Collection
Stock Lesen

pixiInventoryItemsToRefill

Liefert die Artikel, die von einem Quell- an ein Ziellager umgelagert werden müssen, um Mindestbestand und offene Kundenaufträge zu decken, samt Quell-Lagerplätzen.

Erstellt eine Nachschubliste (Umlagerungsliste) zwischen zwei Lagern. Der Aufruf reicht alle Parameter an die interne Prozedur CR_InventoryItemsToRefill weiter, die die eigentliche Arbeit erledigt.

Bedarf im Ziellager (ToLocID)

  • Offene Kundenaufträge: Summe von Orderlines.Qty je Artikel in ToLocID mit Status ANG, BES, BOR und HAL. HAL entfällt, wenn die Einstellung InventoryItemsToRefill_NoHAL den Wert 1 hat.
  • Zurückgehaltene Aufträge: Summe von Qty der Auftragspositionen mit Status HAL in ToLocID. Dieser Wert dient nur zur Information.
  • Bestände je Lager stammen aus ItemLocationSpecific (LocationQuantity, MinStockQty, TargetStock).

Welche Artikel ausgewählt werden

  • Der Artikel hat einen ItemLocationSpecific-Eintrag für ToLocID.
  • FromLocID ist ungleich ToLocID.
  • Positiver Mindestbestand plus offene Kundenauftragsmenge ist größer als der Bestand in ToLocID.
  • Der Artikel liegt auf mindestens einem Lagerplatz (InvBin) von FromLocID.

Fehlmenge

Sie wird berechnet als positiver MinStockQty + offene Kundenauftragsmenge − Bestand in ToLocID − Bestand in AdditionalLocID (der letzte Term nur, wenn AdditionalLocID gesetzt ist).

Zuordnung zu Quell-Lagerplätzen

  • Verwendet werden alle Lagerplatzeinträge (InvBinItem) des Artikels in FromLocID. Einträge, die von einer nicht abgelaufenen Picklistenposition (PLitem) referenziert werden, werden übersprungen.
  • Die Einträge werden nach Alter nummeriert, älteste zuerst (CreateDate). Nur die ersten Fehlmenge Einträge bleiben erhalten.
  • Das Ergebnis enthält eine Zeile je Artikel und Quell-Lagerplatz. MissingQty ist die Anzahl der Einträge, die von diesem Lagerplatz genommen werden. FromBinqty ist die Gesamtmenge des Artikels auf diesem Lagerplatz.
  • ToLocIDbinName/ToLocIDbinSortNum zeigen einen Lagerplatz des Artikels in ToLocID, sofern vorhanden.

Sortierung

Bei SortBy = '1' wird nach ToLocIDbinSortNum sortiert, sonst nach FromLocIDbinSortNum. Innerhalb davon wird nach ItemName sortiert.

Hinweise

  • Nur lesend. Alle Tabellen werden WITH (NOLOCK) gelesen, daher kann das Ergebnis nicht festgeschriebene Daten enthalten.
  • Die Zuordnung zählt Lagerplatzeinträge (InvBinItem-Zeilen), keine Mengen. Das je Lagerplatz gelieferte MissingQty ist daher die Anzahl der Einträge, die von diesem Lagerplatz genommen werden. Die Summe über alle Lagerplätze eines Artikels kann kleiner als die berechnete Fehlmenge sein, wenn weniger Einträge vorhanden sind.
  • Der Auswahlfilter zieht den Bestand von AdditionalLocID nicht ab, die Fehlmenge dagegen schon. Deckt das Zusatzlager den Bedarf, ist die Fehlmenge 0 oder kleiner und der Artikel erscheint nicht.
  • ToLocIDbinName wird per TOP 1 ohne ORDER BY ermittelt. Hat der Artikel mehrere Lagerplätze in ToLocID, ist nicht festgelegt, welcher angezeigt wird.
  • Die Einstellung wird über fpixi_GetSetting gelesen, deren Definition nicht vorliegt. Liefert sie NULL statt eines leeren Werts, wird HAL ebenfalls ausgeschlossen.
  • FromLocQty und MinStockQty können leer sein, wenn kein passender ItemLocationSpecific-Wert existiert.
  • Ist FromLocID gleich ToLocID, ist das Ergebnis immer leer.

Parameter

Parameter Typ Standardwert Beschreibung
FromLocID
Pflicht
varchar(3)
string
–

Quelllager, von dessen Lagerplätzen die Ware entnommen wird.

Beispiel: 001

ToLocID
Pflicht
varchar(3)
string
–

Ziellager, das aufgefüllt werden soll. Für dieses Lager werden Bestand, Mindestbestand und offene Kundenaufträge ausgewertet.

Beispiel: 002

AdditionalLocID
varchar(3)
string
NULL

Optionales Zusatzlager, dessen Bestand von der Fehlmenge abgezogen wird. Bei NULL oder leer wird kein Zusatzlager berücksichtigt.

Beispiel: 003

SortBy
varchar(1)
string
0

Sortierung des Ergebnisses.

Erlaubte Werte

  • 1 – Sortierung nach Sortiernummer des Ziel-Lagerplatzes, dann nach Artikelname.
  • 0 – (Standard, ebenso jeder andere Wert) Sortierung nach Sortiernummer des Quell-Lagerplatzes, dann nach Artikelname.

Beispiel: 0

Antwort

Result-Set 1 · Immer (kann leer sein).

Eine Zeile je Artikel und Quell-Lagerplatz, der zum Auffüllen des Ziellagers verwendet werden soll.

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

Name des Quell-Lagerplatzes in FromLocID.

FromLocIDbinSortNum
Kann leer sein
int

Sortiernummer des Quell-Lagerplatzes.

ToLocIDbinName
Kann leer sein
varchar(50)
string

Name eines Lagerplatzes des Artikels in ToLocID. Leer, wenn der Artikel dort keinen hat.

ToLocIDbinSortNum
Kann leer sein
int

Sortiernummer dieses Ziel-Lagerplatzes.

EanUpc
Kann leer sein
varchar(13)
string

EAN/UPC des Artikels.

ItemName
Kann leer sein
varchar(120)
string

Artikelname.

ToLocQty int

Bestand des Artikels im Ziellager (0, falls keiner).

FromLocQty
Kann leer sein
int

Bestand des Artikels im Quelllager laut ItemLocationSpecific.

FromBinqty
Kann leer sein
int

Menge des Artikels auf diesem Quell-Lagerplatz (Summe von BinItemQTY, nur Einträge ohne aktive Pickliste).

MissingQty
Kann leer sein
int

Anzahl der Lagerplatzeinträge, die von diesem Quell-Lagerplatz zur Deckung der Fehlmenge entnommen werden sollen.

MinStockQty
Kann leer sein
int

Mindestbestand des Artikels im Ziellager.

SupplPrice
Kann leer sein
money
decimal

Lieferantenpreis (Einkaufspreis) des Artikels.

OpenCustOrdersQty int

Menge in offenen Kundenauftragspositionen im Ziellager (Status ANG, BES, BOR und HAL, sofern nicht per Einstellung ausgeschlossen).

OrdersOnHoldQty int

Menge in Auftragspositionen mit Status HAL im Ziellager.

ParFromLocID
Kann leer sein
varchar(3)
string

Wert des Parameters FromLocID.

ParToLocID
Kann leer sein
varchar(3)
string

Wert des Parameters ToLocID.

SortBy
Kann leer sein
varchar(1)
string

Wert des Parameters SortBy.

PicLinkSmall
Kann leer sein
varchar(512)
string

Link zum kleinen Artikelbild.

PicLinkLarge
Kann leer sein
varchar(512)
string

Link zum großen Artikelbild.

ItemNrInt
Kann leer sein
varchar(50)
string

Interne Artikelnummer.

TargetStock
Kann leer sein
int

Zielbestand des Artikels im Ziellager.

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:pixiInventoryItemsToRefill>
      <FromLocID>001</FromLocID>
      <ToLocID>002</ToLocID>
      <!-- <AdditionalLocID>003</AdditionalLocID> -->
      <!-- <SortBy>0</SortBy> -->
    </ns1:pixiInventoryItemsToRefill>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Verwendete Tabellen

Orderlines · Lesen ItemLocationSpecific · Lesen Items · Lesen InvBinItem · Lesen InvBin · Lesen PLitem · Lesen
SQL-Objekt:
dbo.pipiInventoryItemsToRefill
Prozedur zuletzt geändert am 2026-10-05
Dokumentation von claude-opus-5-5 am 2026-10-30 geschrieben