Manuelle Anpassung des Verkaufspreises (Lieferantenkompensation)

Wozu diese Funktion dient#

Klassische Situation: Sie starten für ein Produkt eine Rabattaktion und der Lieferant kompensiert Ihnen den Rabatt mit einer Gutschrift (damit Sie die Promo-Aktion nicht selbst zahlen, sondern er). Margly weiß davon aus dem Import jedoch nichts — sieht nur den reduzierten Verkaufspreis im E-Shop-Feed, die Gutschrift vom Lieferanten nicht. Ergebnis: Die Marge in Margly fällt stark ab, es sieht aus, als würden Sie unter dem Einkaufspreis verkaufen, und der Wachstumsplan oder der KI-Berater beginnen zu empfehlen „dieses Produkt nicht mehr zu verkaufen".

Die manuelle Anpassung des Verkaufspreises ist die Lösung. Sie sagen Margly: „vom 1. März bis 31. März nimm für die Margenberechnung statt des aktuellen Verkaufspreises den ursprünglichen Preis aus der Preisliste — den Rabatt kompensiert mir der Lieferant." Margly berechnet die Margen im angegebenen Fenster aus dem von Ihnen angegebenen Preis und nimmt in anderen Zeiträumen normal den Preis aus dem Import.

Wer die Anpassung einstellen kann#

Die Schaltfläche „Preis anpassen" neben der Produktmarge sehen Eigentümer und Editor. Ein Gast aus einer Partnerfirma (über Zugriffsfreigabe zwischen Konten) hat das Recht auf Datenbearbeitung, aber diese konkrete Schaltfläche in der Produkttabelle ist in der aktuellen Margly-Version für Gäste ausgeblendet (auf Serverebene würde die Anpassung sonst durchgehen — die UI zeigt sie einfach nicht an).

Wo Sie die Anpassung finden#

1. 1

   Öffnen Sie den Bereich Produkte

   Im linken Menü Produkte. Die Tabelle hat die Spalten ABC, Code, Name, Menge, Umsatz (inkl./exkl. MwSt. nach Ihrer Einstellung), Anteil %, Marge, Marge %, Storno %, Einkaufspreis, MwSt.-Satz, Kunden.

2. 2

   Finden Sie die Zeile des konkreten Produkts

   Oben in der Karte ist der Filter Kategorie, der Schalter ABC (Alle / A / B / C), der Schalter Marge (Alle / ≥ 30 % / 10–30 % / < 10 % / „Einkaufspreis fehlt") und das Suchfeld „Code, Name suchen…".

3. 3

   Klicken Sie auf den Link Preis anpassen unter der Marge

   Bei jedem Produkt ist unter dem Margenwert ein kleiner Link „Preis anpassen" (Rabatt-/„Ticket Percent"-Symbol). Öffnet den Dialog „Manuelle Anpassung des Verkaufspreises" mit Code und Name des Produkts im Untertitel.

Ausfüllen des Formulars#

Der Dialog enthält ein erläuterndes Banner (einklappbar — merkt sich Ihre Entscheidung im Browser), dann ein Beispiel (Sie sehen es nur bis zur ersten erstellten Anpassung) und darunter das eigentliche Formular „Neue Anpassung hinzufügen".

Felder, die Sie ausfüllen#

Berechnungsvorschau#

Unter dem Formular gibt es eine Live-„Berechnungsvorschau" — sobald Sie beginnen, den Preis auszufüllen, zeigt Margly in Echtzeit:

• Ihre Eingabe — Preis exkl. MwSt. und inkl. MwSt. (hervorgehoben ist der, den Sie ausgefüllt haben).
• Aktueller Preis aus dem Import — was Margly aktuell in den Daten aus dem E-Shop sieht.
• Marge vor der Anpassung — was Margly ohne Ihre Anpassung berechnen würde. Rot, wenn negativ; gelb unter 10 %; grün ab 10 % aufwärts.
• Marge nach der Anpassung — was Margly im Promo-Fenster berechnen wird. Farben gleich.
• Differenz — wie viel CZK/Stk. (oder Einheiten Ihrer Währung) die Änderung in der Marge ausmacht.

Wenn der Preis Unsinn ergibt (z. B. Tippfehler mit einer Null), sehen Sie es in der Vorschau sofort noch vor dem Speichern.

Speichern#

Mit Klick auf „Anpassung speichern" macht Margly:

1. Fügt die Anpassung in die Datenbank ein (beide Spalten inkl. MwSt. und exkl. MwSt., MwSt.-Satz, Notiz, Ihre Benutzer-ID und Uhrzeit).
2. Berechnet synchron die Margen aller Bestellungen dieses Produkts im angegebenen Fenster neu — kein Warten, Dashboard und Produkttabelle zeigen sofort neue Werte.
3. Aktualisiert den denormalisierten Snapshot der Produktrentabilität (im Hintergrund).
4. Invalidiert den Dashboard-Cache — das nächste Laden zeigt bereits neue Margen.

Nach dem Speichern sehen Sie die Meldung „Anpassung gespeichert. Die Produktmarge wurde neu berechnet."

Bestehende Anpassungen und ihre Stati#

Wenn Sie für ein Produkt bereits eine Anpassung (oder mehrere) gespeichert haben, sehen Sie im Dialog über dem Formular den Bereich „Bestehende Anpassungen". Jeder Eintrag hat ein Statuslabel:

• Aktiv bis Datum (blaues Label) — die Anpassung gilt gerade, das Dashboard berechnet die Margen daraus.
• Beginnt Datum (gelbes Label) — für die Zukunft geplant, hat noch keinen Einfluss auf aktuelle Berechnungen.
• Beendet Datum (graues Label) — historische Anpassung. Das Dashboard reproduziert die Margen in ihrem ursprünglichen Fenster weiterhin daraus (deshalb wird sie nicht automatisch gelöscht).

Bei jedem Eintrag sehen Sie Zeitraum, Preis (hervorgehoben im aktiven Anzeigemodus, der andere in Klammern), Notiz, Datum und Ersteller. Rechts ist das Mülleimer-Symbol zum Löschen.

Regeln für den Zeitraum#

• Das Ende muss strikt nach dem Anfang liegen (Prüfung sowohl auf Client als auch auf Server — sonst Meldung „Ungültiger Anpassungszeitraum. Das Enddatum muss nach dem Anfangsdatum liegen.").
• Für ein Produkt dürfen sich die Zeiträume nicht überlappen. Wenn Sie versuchen, eine Anpassung zu speichern, deren Fenster in eine bereits bestehende Anpassung desselben Produkts hineinreicht, gibt Margly die Meldung „Der angegebene Zeitraum überlappt sich mit einer anderen bestehenden Anpassung für dieses Produkt." zurück. Diese Regel überwacht die Datenbank, sie kann nicht umgangen werden.
• Der Preis muss ≥ 0 sein, der MwSt.-Satz im Bereich 0–30 %.

Wenn Sie eine aktive Anpassung haben, aber der Lieferant inzwischen die Preisliste im E-Shop geändert hat#

Im Dialog sehen Sie einen blauen Informationsstreifen:

Aktueller Preis aus dem Import ist X. Ihre Anpassung (Y) hat Vorrang bei der Margenberechnung bis Enddatum. Importe überschreiben Ihren Eintrag nicht.

Margly sagt damit: Der Preis im E-Shop hat sich geändert (z. B. nach Ende der Promo haben Sie bereits einen anderen Wert in der Preisliste), aber Ihre Anpassung hat im Rahmen ihres Zeitraums Vorrang. Keine Überraschung, kein stilles Überschreiben.

Löschen einer Anpassung#

Mit Klick auf das Mülleimer-Symbol beim Eintrag erscheint ein internes Bestätigungsfeld mit Text je nach Status der Anpassung:

Nach dem Löschen startet Margly erneut die Margenneuberechnung (synchron) und invalidiert den Dashboard-Cache. Die Toast-Meldung bestätigt, was passiert ist.

Wie sich die Anpassung im Dashboard zeigt#

Wenn Sie eine aktive Anpassung haben, sehen Sie in Margly folgende visuelle Spuren:

• In der Produkttabelle erscheint neben der Produktmarge ein blaues Label „Manueller Preis" und unter der Marge der Monospace-Text „Aus angepasstem Preis: X". Beim Hovern erscheint ein Tooltip: „Die Produktmarge wird aus dem von Ihnen eingegebenen angepassten Verkaufspreis (X) statt aus dem aktuellen Preis im Import (Y) berechnet. Kompensation vom Lieferanten für den gewährten Rabatt. Gültigkeit: von – bis."
• Wenn die Anpassung beendet ist, aber historisch die Margen im gewählten Dashboard-Zeitraum beeinflusst hat, ist das Label grau: „Promo im Zeitraum" (mit informativem Tooltip).
• Im Bereich Margen (linkes Menü → Margen, Trend-up-Symbol) klappt sich unter der COGS-Zeile eine Mini-Aufteilung „Brutto-COGS", „Promo-Kompensation vom Lieferanten" (mit negativem Betrag in Grün) und „Effektive COGS nach Kompensation" (kursiv) aus. Darunter eine kleine Notiz mit Link zurück zu den Produkten.
• Der KI-Berater verwendet für Margenanalysen dieselben RPCs, die die Anpassung berücksichtigen (get_margin_cascade gibt bereits die effektive COGS zurück, get_top_products lädt selling_price_uplift_per_unit aus den Bestellpositionen). Empfehlungen und Produkt-Rankings im Berater werden daher im Promo-Monat nicht verzerrt.

Was die Anpassung NICHT tut (und warum)#

• Ändert die Umsätze nicht. Kunden haben den rabattierten Preis bezahlt, das ist Fakt. Buchhalterisch und in Umsatzreports bleibt das so.
• Überschreibt nicht die Daten aus dem E-Shop. Der Shop (Shoptet / Shopify / Upgates / CSV-Feeds) weiß überhaupt nichts von der Anpassungstabelle — die Produktsynchronisation schreibt oder liest nie aus product_selling_price_overrides. Es ist rein eine „Aufsatz-Ebene", die der Händler kontrolliert.
• Löscht sich nicht selbst nach Ende der Promo. Historische Einträge bleiben, damit sich historische Margen exakt reproduzieren lassen (auf die Werte aus dem Moment, in dem das Dashboard oder der Berater sie gesehen hat).
• Beeinflusst COGS nicht außerhalb des eingestellten Fensters. Außerhalb valid_from – valid_to nimmt Margly normal den aktuellen Einkaufspreis und Verkaufspreis aus dem Import.
• Berechnet nicht nur Produkte ohne Anpassungen neu — wenn Sie keine Anpassung haben, ändert sich nichts (Sie müssen nicht befürchten, dass die Funktion „einen Abdruck" auf anderen Produkten hinterlässt).

Sichere Bereiche und Limits#

• Rate Limit: 30 Speicherungen und 30 Löschungen pro 5 Minuten je Konto (jede Aktion hat ein eigenes separates Fenster — POST und DELETE werden nicht zusammen gezählt). Größere Stapel verteilen Sie zeitlich.
• Notiz max. 500 Zeichen.
• MwSt.-Satz 0–30 %, Preis ≥ 0 (Validierung Client und Server).
• Preis gespeichert mit einer Genauigkeit von 4 Dezimalstellen in der Datenbank (Anzeige auf 2 gerundet).
• Die Zeitzone der Anpassungen ist mandantenweit — das Fenster wird mit dem Bestelldatum verglichen, das in die Zeitzone Ihres Kontos konvertiert wurde (abgeleitet aus dem Rechnungsland).

Häufige Fehler und was tun#

Wie geht's weiter#

• Margen verstehen — wie Margly Bruttomarge, CM1 und Nettomarge berechnet
• MwSt.-Einstellungen — wie der Anzeigeschalter das Feld „Sie geben den Preis an" im Anpassungsdialog beeinflusst
• Datenaktualisierung — wann eine neue Anpassung sich auswirkt, wenn Daten noch nicht eingeflossen sind