pixiReportInventoryItemsToRefillMinStock

Liefert eine Pickliste der Artikel, die von einem Quell- an einen Ziellagerort umzulagern sind, mit Menge je Quell-Lagerplatz nach einem von drei Auffüllmodi.

Der Aufruf gibt alle Parameter unverändert an die interne Report-Prozedur Report_InventoryItemsToRefillMinStock weiter und liefert deren Ergebnis.

Schritt 1 – Kandidaten-Artikel

Ein Artikel ist nur dann ein Kandidat, wenn:

• FromLocID und ToLocID verschieden sind,
• der Artikel für FromLocID und ToLocID je einen ItemLocationSpecific-Datensatz hat,
• der Artikel mindestens einem Lagerplatz (InvBinItem/InvBin) in FromLocID zugeordnet ist,
• die berechnete Fehlmenge größer als 0 ist.

Offene Auftragsmengen werden aus den Orderlines des Artikels an einem Auftragslagerort summiert. Dieser ist ToLocID bei Type 1 und 3, sonst FromLocID. Die Status ANG, BES und BOR zählen als offene Kundenaufträge, HAL als angehaltene Aufträge. Steht die Einstellung InventoryItemsToRefill_NoHAL auf 1, bleiben angehaltene Mengen in den Berechnungen unberücksichtigt.

Der verfügbare Bestand am Quelllagerort ist der Lagerortbestand in FromLocID, abzüglich:

• des Mindestbestands von FromLocID (nur bei MinStock = 1 und Type = 2),
• der offenen Kundenauftragsmenge (nur wenn der Auftragslagerort FromLocID ist),
• der angehaltenen Menge (sofern die Einstellung sie nicht ausschließt).

Die Fehlmenge am zusätzlichen Lagerort ist Mindestbestand minus Lagerortbestand in AdditionalLocID. Liegt der Bestand nicht unter dem Mindestbestand, ist sie 0.

Die Fehlmenge hängt von Type ab:

• 1: Bedarf = offene Kundenaufträge in ToLocID + angehaltene Menge + Mindestbestand von ToLocID (nur bei MinStock = 1). Passt der Bedarf in den verfügbaren Bestand, ist das Ziel die Fehlmenge am zusätzlichen Lagerort plus Bedarf, sonst der verfügbare Bestand. Ergebnis ist Ziel minus aktueller Bestand in ToLocID, mindestens 0.
• 2: Fehlmenge am zusätzlichen Lagerort, begrenzt auf den verfügbaren Bestand am Quelllagerort.
• 3: Nur wenn alle folgenden Bedingungen erfüllt sind: Mindestbestand in ToLocID ist 0, Bestand in AdditionalLocID ist 0, Bestand in FromLocID ist größer 0 und es gibt offene Kundenaufträge in ToLocID. Ergebnis ist der kleinere Wert aus offenen Kundenaufträgen und Bestand in FromLocID.

Schritt 2 – Verteilung auf Lagerplätze

Je Kandidat werden die InvBinItem-Datensätze des Artikels auf Lagerplätzen in FromLocID nach InvBinItemKey nummeriert. Verwendet werden nur die ersten n Datensätze, wobei n die Fehlmenge ist. Die Zeilen werden je Quell-Lagerplatz gruppiert. MissingQty in der Ausgabe ist die Anzahl dieser Datensätze auf dem jeweiligen Lagerplatz. Das entspricht einer Stückzahl, wenn jeder Lagerplatz-Datensatz für ein Stück steht. Zusätzlich wird ein Lagerplatz in ToLocID als Ziel-Lagerplatz ausgegeben, falls vorhanden.

Sortierung

Bei SortBy = 1 wird nach der Sortiernummer des Ziel-Lagerplatzes sortiert, sonst nach der des Quell-Lagerplatzes. Innerhalb davon wird nach ItemName sortiert.

Parameter

Antwort

Result-Set 1 · Immer; leer, wenn kein Artikel qualifiziert, FromLocID = ToLocID oder Type nicht 1, 2 oder 3 ist

Eine Zeile je Artikel und Quell-Lagerplatz mit der von dort umzulagernden Menge.

<SqlRowSet1>
  <row>
    <FromLocIDbinName>A-01-03</FromLocIDbinName>
    <FromLocIDbinSortNum>103</FromLocIDbinSortNum>
    <ToLocIDbinName>S-12-01</ToLocIDbinName>
    <ToLocIDbinSortNum>1201</ToLocIDbinSortNum>
    <EanUpc>4012345678901</EanUpc>
    <ItemName>Trinkflasche 750 ml</ItemName>
    <ToLocQty>2</ToLocQty>
    <FromLocQty>40</FromLocQty>
    <MinStockQty>5</MinStockQty>
    <SupplPrice>3.20</SupplPrice>
    <OpenCustOrdersQty>4</OpenCustOrdersQty>
    <OrdersOnHoldQty>0</OrdersOnHoldQty>
    <ParFromLocID>002</ParFromLocID>
    <ParToLocID>001</ParToLocID>
    <SortBy>1</SortBy>
    <MissingQty>7</MissingQty>
    <FromBinqty>12</FromBinqty>
    <PicLinkSmall>https://shop.example.com/img/s/4711.jpg</PicLinkSmall>
    <PicLinkLarge>https://shop.example.com/img/l/4711.jpg</PicLinkLarge>
  </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:pixiReportInventoryItemsToRefillMinStock>
      <FromLocID>002</FromLocID>
      <!-- <MinStock>1</MinStock> -->
      <ToLocID>001</ToLocID>
      <!-- <AdditionalLocID>003</AdditionalLocID> -->
      <!-- <SortBy>1</SortBy> -->
      <!-- <Type>1</Type> -->
    </ns1:pixiReportInventoryItemsToRefillMinStock>
  </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:pixiReportInventoryItemsToRefillMinStock>
      <FromLocID>002</FromLocID>
      <!-- <MinStock>1</MinStock> -->
      <ToLocID>001</ToLocID>
      <!-- <AdditionalLocID>003</AdditionalLocID> -->
      <!-- <SortBy>1</SortBy> -->
      <!-- <Type>1</Type> -->
    </ns1:pixiReportInventoryItemsToRefillMinStock>
  </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 = [
    'FromLocID' => '002',
    // 'MinStock' => '1',
    'ToLocID' => '001',
    // 'AdditionalLocID' => '003',
    // 'SortBy' => '1',
    // 'Type' => '1',
];

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

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

Verwendete Tabellen

SQL-Objekt:

dbo.pipiReportInventoryItemsToRefillMinStock

Prozedur zuletzt geändert am 2026-10-05

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