# 1. Beschreibung

Das Plugin **Margen & Einkaufspreise in der Produktübersicht** erweitert die Produktliste im Shopware-Administrationsbereich um vier zusätzliche Spalten, die Einkaufspreise und Gewinnmargen direkt sichtbar machen — ohne dass Sie einzelne Produkte öffnen müssen.

![Produktliste mit Marge-Spalten und farbcodierten Indikatoren](https://2916094232-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtiS3-dzuXFp_IH7yRw-887967055%2Fuploads%2Fgit-blob-57165e6ea49f1e3eb45b97b2ddd5679d7c4e9a70%2F1.png?alt=media)

## Was das Plugin macht

Nach der Installation sehen Sie in **Kataloge → Produkte** vier neue Spalten:

| Spalte            | Beschreibung                                                     |
| ----------------- | ---------------------------------------------------------------- |
| **Einkaufspreis** | Der hinterlegte Einkaufspreis des Produkts                       |
| **Nettopreis**    | Automatisch aus Bruttopreis und Steuersatz berechnet             |
| **Marge**         | Absolute Marge (Nettopreis − Einkaufspreis), in der Shop-Währung |
| **Marge %**       | Prozentuale Marge mit farbcodierten Indikatoren                  |

Bei Produkten ohne hinterlegten Einkaufspreis erscheint in allen Marge-Spalten ein Strich (–).

## Farbcodierte Margen-Indikatoren

Die Spalte **Marge %** zeigt farbige Badges, damit Sie problematische Produkte auf einen Blick erkennen:

* **Rot** — Marge unterhalb des unteren Schwellenwerts (Standard: unter 10 %)
* **Gelb** — Marge zwischen den Schwellenwerten (Standard: 10–30 %)
* **Grün** — Marge oberhalb des oberen Schwellenwerts (Standard: 30 % und mehr)

Die Schwellenwerte können Sie in der Plugin-Konfiguration individuell anpassen.

## Sortierung und Filter

Das Plugin erweitert die Produktliste außerdem um:

* **Serverseitige Sortierung** nach Einkaufspreis, Marge und Marge % — klicken Sie auf einen Spalten-Header, um ASC/DESC zu sortieren. Die Sortierung gilt seitenübergreifend für den gesamten Katalog.
* **Einkaufspreis-Filter** im nativen Shopware-Filter-Panel: „Mit Einkaufspreis" oder „Ohne Einkaufspreis" — um schnell Produkte mit fehlenden Einkaufspreisen zu finden.

![Serverseitige Sortierung nach Marge %](https://2916094232-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LtiS3-dzuXFp_IH7yRw-887967055%2Fuploads%2Fgit-blob-adac66f12d73f95058468d6296850709fe6f007d%2F2.png?alt=media)

## Berechnungsmethode

Die prozentuale Marge lässt sich in der Plugin-Konfiguration zwischen zwei Methoden umschalten:

* **Handelsmarge** (Standard): `(Nettopreis − Einkaufspreis) / Nettopreis × 100`
* **Aufschlag (Markup)**: `(Nettopreis − Einkaufspreis) / Einkaufspreis × 100`

## Kompatibilität

* Shopware 6.6
* Vollständig übersetzt (Deutsch und Englisch)
* Keine Änderungen an Bestellprozess oder Storefront
