Deckungsbeitrags-Übersicht

Zweck

Die Seite /contribution-margin zeigt den Deckungsbeitrag (DB) je Produkt über alle Lieferanten hinweg — also wie profitabel ein Produkt je nach Bezugsquelle ist. Die Berechnung folgt der zentralen Preis-Engine, siehe Produkt-Lieferanten-Preise & Deckungsbeitrag.

Voraussetzungen

- Berechtigung `view:FE_Product` + `view:Product`. - Produkte mit mindestens einem [Lieferanten](/products-suppliers) und gepflegten Preisen. - Marge-Schwellwerte für die Ampel-Farben, siehe [Produkt-Einstellungen](/settings/products).

Berechtigungen (CASL)

Action	Subject	Wirkung
view	FE_Product	Seite aufrufbar
view	Product	Deckungsbeitrags-Daten lesen

Spalten

Pro Produkt aggregiert SpeamCore die Deckungsbeiträge aller zugeordneten Lieferanten:

Spalte	Feld	Bedeutung
Produkt-Nr.	productNo	Artikelnummer (sortierbar)
Bezeichnung	title	Produkttitel (sortierbar)
Verkaufspreis	sellPrice	eigener Verkaufspreis des Produkts (sortierbar)
Lieferanten	supplierCount	Anzahl zugeordneter Lieferanten
DB-Bereich	dbMinPct – dbMaxPct	niedrigste bis höchste Marge in % über die Lieferanten
Median	dbMedianPct	Median der Lieferanten-Margen
Durchschnitt	dbAvgPct	Mittelwert der Lieferanten-Margen

dbCount zählt, für wie viele Lieferanten überhaupt ein Deckungsbeitrag berechenbar war. Der DB-Bereich ist nach den Marge-Schwellwerten farblich bewertet (rot/gelb/grün).

Die hier gezeigte Marge ist der **Deckungsbeitrag** (`Verkaufspreis − Einkaufspreis`), nicht der einkaufsseitige Rabatt. Den Unterschied erklärt das Konzept [Produkt-Lieferanten-Preise](/konzepte/produkt-lieferanten-preise#das-problem).

Suchen und Sortieren

• Suche über Produkt-Nr. oder Bezeichnung (searchTerm).
• Sortierung nach productNo, title, sellPrice oder sequenceId.

Verknüpfungen zu anderen Modulen

• Produkt — Lieferanten — Pflege von VK/EK/Rabatt je Lieferant (Datenbasis).
• Produkt-Einstellungen — Schwellwerte der Marge-Ampel.
• Produkte — Produkt-Stammdaten.

Wiederverwendbare Konzepte

• Produkt-Lieferanten-Preise & Deckungsbeitrag
• Berechtigungen verstehen (CASL)

API/Schnittstellen

Methode	Endpoint	Zweck	CASL
GET	/api/contribution-margin/products	Aggregierter DB je Produkt (paginiert, searchTerm, sort)	view Product

Versionshinweise

• 2026-06-22: Initiale Veröffentlichung — Deckungsbeitrags-Übersicht je Produkt über alle Lieferanten (DB-Bereich, Median, Durchschnitt) mit Marge-Ampel. Verifiziert an contributionMargin.router.ts, contributionMargin.service.ts.