Postman-Collection
Reports Lesen

pixiReport_StockValue_Hist

Liefert den historischen Lagerwert je Artikel zu einem Stichtag, bewertet mit historischen Lieferantenpreisen und Netto-Verkaufspreisen.

Wrapper um die interne Report-Prozedur Report_StockValue_Hist. Sie läuft immer mit ShowDetails = 0. Der Lieferantenfilter verwendet immer den Hauptlieferanten des Artikels (AllItemsForSupplier = 0).

Ablauf:

  1. Stichtag: ParamDate wird auf das Tagesende gesetzt. Ohne Angabe wird das Ende des aktuellen Tages verwendet.
  2. Artikelfilter: Leere Zeichenketten für LocID, Category und SupplNr gelten als "kein Filter".
    • SupplNr filtert auf den Hauptlieferanten des Artikels (Items.SupplNr).
    • Category filtert auf Items.ConfigType.
  3. Bestand zum Stichtag: Je Artikel werden alle Mengenbewegungen aus InvBinItemLog bis zum Stichtag summiert.
    • Mit LocID zählen nur Lagerplätze dieses Lagers (InvBin.BinLocID).
    • Bewegungen auf Lagerplätzen, die erst nach dem Stichtag gelöscht wurden, werden ebenfalls berücksichtigt. Diese Lagerplätze stehen in InvBinHist mit Vermerk Deleted.
    • Artikel mit resultierendem Bestand 0 entfallen.
  4. Historische Lieferantenpreise: Die Bestände werden an interne Hilfsprozeduren übergeben. Diese ermitteln historische Einkaufspreise aus Lieferantenlieferungen. Ein Artikel kann daher in mehreren Zeilen erscheinen, je eine pro Lieferantenlieferung, aus der sich der Bestand zusammensetzt.
  5. Verkaufspreis:
    • VK_Netto ist der Bruttopreis Items.Price geteilt durch (1 + MwSt-Satz), gerundet auf 2 Nachkommastellen.
    • Der MwSt-Satz ergibt sich aus dem MwStSatz des Artikels: 1 = voller Satz, 2 = ermäßigter Satz, jeder andere Wert = 0. Es gelten die Sätze des Standardlandes.

Sortierung nach Artikelname, dann SupplDelDate, dann MwSt-Satz.

Hinweise

  • Alle permanenten Tabellen werden WITH (NOLOCK) gelesen; das Ergebnis kann nicht festgeschriebene Daten enthalten.
  • Die historischen Lieferantenpreise stammen aus Report_SaveSupplierPrices und pixi_HistorySupplierPriceForItems. Deren Definitionen liegen nicht vor. Ob sie in permanente Tabellen schreiben und wie SupplPriceHist, SupplPriceType und SupplPriceMessage genau ermittelt werden, ist hier nicht ersichtlich.
  • Die MwSt-Sätze werden zum aktuellen Datum ermittelt, nicht zum ParamDate. Historische Satzänderungen fließen daher nicht in VK_Netto ein.
  • Bestand ist der Gesamtbestand des Artikels zum Stichtag und wiederholt sich in jeder Lieferungszeile dieses Artikels. Für zeilenweise Summen SupplDelQty verwenden. Sum_VK_Netto und Sum_SupplPriceHist basieren bereits auf SupplDelQty.
  • par_Category und par_SupplNR enthalten -alle-, wenn kein Filter gesetzt ist. Andernfalls enthalten sie den Kategorietext bzw. den Namen des Lieferanten des Artikels, nicht die Nummer.
  • Der Report wertet das gesamte Lagerplatz-Bewegungsprotokoll aus und kann bei großen Datenbanken langsam sein.

Parameter

Parameter Typ Standardwert Beschreibung
ParamDate
datetime
dateTime
NULL

Stichtag für den Lagerwert. Verwendet wird das Ende dieses Tages. Ohne Angabe gilt das Ende des aktuellen Tages.

Beispiel: 2024-12-31T00:00:00

LocID
varchar(10)
string
NULL

Lager-ID. Nur Bestand auf Lagerplätzen dieses Lagers wird gezählt. Leer oder nicht angegeben bedeutet alle Lager.

Beispiel: 001

Category
varchar(10)
string
NULL

Artikelkategorie, verglichen mit Items.ConfigType. Leer oder nicht angegeben bedeutet alle Kategorien.

Beispiel: 1

SupplNr
varchar(10)
string
NULL

Lieferantennummer. Nur Artikel, deren Hauptlieferant (Items.SupplNr) übereinstimmt, werden berücksichtigt. Leer oder nicht angegeben bedeutet alle Lieferanten.

Beispiel: L0042

Antwort

Result-Set 1 · Immer; eine Zeile je Artikel mit Bestand ≠ 0 zum Stichtag, ggf. mehrere Zeilen je Artikel (je Lieferantenlieferung).

Historischer Lagerwert je Artikel, bewertet mit historischen Lieferantenpreisen und Netto-Verkaufspreisen.

Spalte Typ Beschreibung
ItemKey int

Interner Artikelschlüssel.

LieferantenArtikelnummer
Kann leer sein
string

Artikelnummer des Lieferanten (Items.ItemNrSuppl).

Artikelnummer
Kann leer sein
string

Interne Artikelnummer (Items.ItemNrInt).

Barcode
Kann leer sein
string

EAN/UPC-Barcode.

Artikelname
Kann leer sein
string

Artikelname.

Kategorie
Kann leer sein
string

Kategorietext aus TontrArten.

SupplNr
Kann leer sein
string

Nummer des Hauptlieferanten des Artikels.

SupplName
Kann leer sein
string

Name des Hauptlieferanten.

Bestand
Kann leer sein
int

Gesamtbestand des Artikels zum Stichtag.

VK_Brutto
Kann leer sein
decimal

Aktueller Brutto-Verkaufspreis (Items.Price).

VK_Netto
Kann leer sein
decimal

Netto-Verkaufspreis, Bruttopreis geteilt durch (1 + MwSt-Satz), auf 2 Stellen gerundet.

MwStSatz
Kann leer sein
numeric
decimal

MwSt-Satz in Prozent.

Sum_VK_Netto
Kann leer sein
decimal

SupplDelQty × VK_Netto.

SupplPrice
Kann leer sein
decimal

Aktueller Lieferantenpreis des Artikels.

SupplPriceHist
Kann leer sein
money
decimal

Für diese Zeile ermittelter historischer Lieferantenpreis.

Sum_SupplPriceHist
Kann leer sein
money
decimal

SupplDelQty × SupplPriceHist.

SupplPriceType
Kann leer sein
int

Art/Quelle des historischen Lieferantenpreises, gesetzt von der internen Preisprozedur.

SupplPriceMessage
Kann leer sein
varchar(200)
string

Hinweis, wie der historische Preis ermittelt wurde.

SupplDelQty
Kann leer sein
int

Durch diese Lieferantenlieferung abgedeckte Menge; ohne gefundene Lieferung gilt Bestand.

SupplDelNr
Kann leer sein
int

Nummer der Lieferantenlieferung.

SupplDelDate
Kann leer sein
datetime
dateTime

Datum der Lieferantenlieferung.

par_paramdate datetime
dateTime

Verwendeter Stichtag (Tagesende).

par_LocID varchar(10)
string

Verwendeter Lagerfilter oder -alle-.

par_Category
Kann leer sein
string

-alle- ohne Kategoriefilter, sonst der Kategorietext des Artikels.

par_SupplNR
Kann leer sein
string

-alle- ohne Lieferantenfilter, sonst der Lieferantenname.

DatabaseCurrencyCode
Kann leer sein
varchar(3)
string

Währungscode der Datenbank.

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:pixiReport_StockValue_Hist>
      <!-- <ParamDate>2024-12-31T00:00:00</ParamDate> -->
      <!-- <LocID>001</LocID> -->
      <!-- <Category>1</Category> -->
      <!-- <SupplNr>L0042</SupplNr> -->
    </ns1:pixiReport_StockValue_Hist>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Verwendete Tabellen

Items · Lesen AddItems · Lesen InvBinItemLog · Lesen InvBin · Lesen InvBinHist · Lesen TontrArten · Lesen Suppliers · Lesen
SQL-Objekt:
dbo.pipiReport_StockValue_Hist
Prozedur zuletzt geändert am 2026-10-05
Dokumentation von claude-opus-5-5 am 2026-10-30 geschrieben