📖 Bedienungsanleitung

🧮 Überblick

Die Artikelkalkulation-App ermöglicht die zentrale Verwaltung von EK-Preisen, Kalkulationsfaktoren und Verkaufspreisen für alle Produkte im Shopify-Store. Die App besteht aus vier Bereichen, die über das Seitenmenü oder die Tabs am oberen Rand erreichbar sind.

Erststart-Assistent

Beim ersten Start der App erscheint ein Einrichtungsassistent, der in 6 Schritten durch die wichtigsten Einstellungen führt: Datensicherung, Autosave (inkl. Verzögerung), Mehrwertsteuer, Preisrundung und Haftungsausschluss. Der Assistent kann über 'Überspringen' direkt zum Haftungsausschluss-Schritt springen – dieser muss mit einem Haken bestätigt werden, bevor die App genutzt werden kann.

💶 Einkaufspreise

Zeigt alle Produkte und deren Varianten mit dem aktuellen Einkaufspreis (Unit Cost) aus Shopify. Der EK-Preis wird im Inventar jeder Variante gespeichert (inventoryItem.unitCost).

Daten laden

Beim ersten Öffnen des Tabs werden automatisch die ersten 25 Produkte geladen (Standard). Das Lade-Limit ist im Filterbereich direkt einstellbar. Ein Fortschrittsbalken zeigt den Ladestand an. Der Tab merkt sich geladene Daten – ein erneutes Laden erfolgt nur wenn sich Daten in einem anderen Tab geändert haben.

Lade-Limit

Das Dropdown 'Lade-Limit' rechts im Filterbereich legt fest, wie viele Produkte initial geladen werden: 25 / 50 / 100 / 250 / Alle. Standard: 25 – gut für schnelles Laden bei großen Sortimenten. Bei aktivem Kollektions- oder Tag-Filter werden stets alle Treffer aus Shopify geladen, unabhängig vom Limit. Ein Hinweistext unter den Filtern zeigt an ob das Limit greift, ein Filter aktiv ist oder alle Produkte geladen wurden.

Sortierung

Rechts neben dem Lade-Limit steht ein Dropdown 'Sortieren' mit den Optionen Name, Hersteller, EK-Status und Variantenanzahl. Sobald eine Option gewählt ist, erscheinen zwei Buttons ↑ (aufsteigend) und ↓ (absteigend). Die Sortierung wird nach dem aktiven Filter angewendet.

Filter & Suche

• Suchfeld – filtert Produkte nach Name (lokal, nur auf geladene Produkte)
• Alle / Mit EK / Ohne EK – Schnellfilter für Datenvollständigkeit
• Kollektion – lädt alle Produkte der Kollektion direkt von Shopify (ignoriert Lade-Limit)
• Hersteller – lädt alle Produkte des gewählten Herstellers direkt von Shopify (ignoriert Lade-Limit)
• Tag – lädt alle Produkte mit dem gewählten Tag direkt von Shopify (ignoriert Lade-Limit)

Die Buttons ⊞ (Alle ausklappen) und ⊟ (Alle einklappen) rechts im Filterbereich öffnen bzw. schließen alle sichtbaren Produkte auf einmal.

Preise bearbeiten

Produkt aufklappen, dann EK-Preis direkt im Eingabefeld ändern. Geänderte Felder werden farbig hervorgehoben (orange Umrandung).

Status-Badges

Jedes Produkt zeigt im Titel-Balken Badges, die den Status der Varianten auf einen Blick anzeigen – auch im zugeklappten Zustand.

• Rot – Ohne Preis: Mindestens eine Variante hat keinen EK-Preis. Zahl = Anzahl betroffener Varianten.
• Orange – Geändert: Mindestens eine Variante wurde bearbeitet, aber noch nicht gespeichert.
• Kein Badge = alle Varianten haben einen gespeicherten EK-Preis und keine offenen Änderungen.

Speichern

Alle speichern (Leiste unten, ab dem Basic-Plan) speichert alle geänderten EK-Preise in einem Batch. Vorher erscheint eine Sicherheitsabfrage, die bestätigt oder abgebrochen werden kann. Alternativ kann pro Produkt einzeln gespeichert werden (Free-Plan und höher). Der Button Abbrechen neben Alle speichern verwirft alle offenen Änderungen sofort und stellt den zuletzt gespeicherten Stand wieder her – in allen Plänen verfügbar. Jedes gespeicherte Produkt zählt als ein Verbrauch auf das Monatskontingent.

Null-Preis-Warnung

Automatische Vorablage

Der Browser kann vor Speichervorgängen automatisch eine JSON-Datei mit den Originalwerten herunterladen. Dieses Verhalten ist in den Einstellungen unter "Automatische Datensicherung" konfigurierbar (Nie / Nur bei Batch-Speichern / Immer). Gesicherte Dateien können über die Sicherung wiederhergestellt werden.

Automatisches Speichern (Autosave)

Wenn Autosave aktiv ist, werden geänderte EK-Preise nach der konfigurierten Verzögerung automatisch gespeichert – ohne manuellen Klick auf Speichern. Ob Autosave eingeschaltet ist und welche Verzögerung gilt, lässt sich direkt in der Statusleiste ablesen und ändern. Jedes automatisch gespeicherte Produkt zählt als ein Verbrauch auf das Monatskontingent.

Statusleiste

Im sticky Filterbereich, links neben der Session-Zeile, befindet sich eine kompakte Statusleiste. Sie zeigt, ob Autosave aktiv ist, die gewählte Verzögerung und den aktuellen Status (ausstehend / wird gespeichert / zuletzt gespeichert um HH:MM:SS). Toggle und Verzögerung lassen sich direkt in der Leiste ändern, ohne die Einstellungen zu öffnen.

Kalkulationsfaktor im Überblick

Im zugeklappten Produktkopf wird der gespeicherte Kalkulationsfaktor oder die erweiterten Prozentwerte einzeilig angezeigt – z. B. Faktor: 2.50 oder BK: 5% · GZ: 20%. So ist der Kalkulations-Stand auf einen Blick sichtbar, ohne das Produkt aufzuklappen.

Arbeitssessions

Arbeitssessions ermöglichen es, den Bearbeitungsfortschritt über mehrere Sitzungen hinweg zu verfolgen. Sobald ein Produkt gespeichert wird, markiert die App es in der aktiven Session als bearbeitet. Sessions werden im Browser gespeichert und bleiben nach dem Schließen des Fensters erhalten.

Session erstellen und verwenden

1. Filter oder Kollektion setzen, dann 'Neue Session' klicken und einen Namen eingeben. Der Name wird automatisch mit dem Prefix EK_ (Einkaufspreise) oder VK_ (Artikelkalkulation) gespeichert.
2. Beim Speichern eines Produkts wird es automatisch als bearbeitet markiert.
3. Über die Pills-Buttons (Alle / Bearbeitet / Unbearbeitet) lassen sich Produkte nach Bearbeitungsstand filtern – nur Produkte aus dem Session-Scope werden gezählt.
4. Beenden deaktiviert die Session für diesen Tab – die Session selbst und andere Tabs bleiben unberührt.
5. Löschen entfernt die Session dauerhaft aus dem Browser. Eine Sicherheitsabfrage verhindert versehentliches Löschen.

Mehrere Sessions können gleichzeitig existieren. Über das Dropdown lässt sich zwischen ihnen wechseln. Eine EK-Session aktiviert sich automatisch auch im Kalk-Tab, wenn dort noch keine Session läuft.

Session-Scope

Beim Erstellen einer Session speichert die App den aktuell aktiven Filter (Kollektion, Tag) und die Produkt-IDs der sichtbaren Artikel als Scope. Der Fortschrittszähler zeigt 'bearbeitet / Scope-Größe' statt 'bearbeitet / alle geladenen Produkte'.

Scope-Banner

Wechselt man in einen Tab, in dem die aktive Session einen anderen Filter hat als aktuell geladen ist, erscheint ein blauer Hinweisbalken mit dem Scope-Filter und der Scope-Größe. Ein Klick auf 'Jetzt laden' stellt den passenden Filter automatisch wieder her. Das × schließt den Hinweis ohne Reload.

Excel Export / Import

Im Einkaufspreise-Tab stehen zwei Buttons bereit: Excel Export erstellt eine .xlsx-Datei mit allen aktuell sichtbaren Varianten. Spalten A–D (Varianten-ID, Produkt, Variante, SKU) sind gesperrt und grau hinterlegt; Spalte E (EK-Preis) ist editierbar und grün markiert.

Bearbeitete Datei wieder importieren: Die App liest Spalte E aus, vergleicht jeden Wert mit dem aktuell angezeigten EK-Preis und übernimmt nur Zeilen mit tatsächlichen Änderungen. Ergebnis: X übernommen · X ohne Änderung übersprungen · X Fehler. Zeilen mit Fehlern werden im Fehler-Modal aufgelistet und in der Variantenliste mit einem roten X markiert; betroffene Produkte klappen automatisch auf.

🏷 Artikelkalkulation

Berechnet aus EK-Preis und Faktor den neuen Verkaufspreis und schreibt ihn direkt in Shopify. Zusätzlich werden der Faktor und ein gesicherter Referenzpreis als Metafelder gespeichert.

Faktor eingeben

• Produkt aufklappen – Faktor direkt im Zahlenfeld eingeben
• − / + Buttons ändern den Wert in 0,01-Schritten

Abgeleiteter Faktor

Wenn für eine Variante kein Faktor gespeichert ist, aber EK-Preis und Verkaufspreis vorhanden sind, wird der Faktor automatisch berechnet (Verkaufspreis ÷ EK). Ein gelber Banner bietet an, diesen abgeleiteten Faktor zu übernehmen.

EK-Änderungs-Erkennung

Preisberechnung

Neuer Preis = EK × Faktor, gerundet auf den in den Einstellungen konfigurierten Schritt (Standard: 0,05 €). Beispiel: EK 12,00 € × Faktor 2,30 = 27,60 € → gerundet auf 27,60 €. Der Faktor kann direkt per Eingabe oder mit den −/+ Schaltflächen angepasst werden.

Produkt-Status

Status-Filter

Über die Filter-Buttons lassen sich Produkte nach Status eingrenzen:

Zusätzlich zum Status-Filter stehen Dropdowns für Kollektion, Hersteller und Tag zur Verfügung. Alle drei lösen einen serverseitigen Reload aus und laden alle Treffer des gewählten Filters direkt von Shopify – unabhängig vom konfigurierten Lade-Limit.

Die Buttons ⊞ (Alle ausklappen) und ⊟ (Alle einklappen) rechts im Filterbereich öffnen bzw. schließen alle sichtbaren Produkte auf einmal.

Lade-Limit

Das Dropdown rechts im Filterbereich begrenzt die Anzahl initial geladener Produkte (25 / 50 / 100 / 250 / Alle). Bei aktivem Kollektions- oder Tag-Filter wird das Limit ignoriert.

Sortierung

Rechts neben dem Lade-Limit steht ein Dropdown 'Sortieren' mit den Optionen Name, Hersteller, Status und Kalkulationsfaktor. Sobald eine Option gewählt ist, erscheinen zwei Buttons ↑ (aufsteigend) und ↓ (absteigend). Die Sortierung wird nach dem aktiven Filter angewendet.

Faktor-Anzeige im Produktkopf

Der aktuell gespeicherte Faktor (Einfachmodus: Faktor: 2.50, Erweiterter Modus: BK: 5% · HK: 3% · GZ: 20%) wird direkt im zugeklappten Produktkopf einzeilig angezeigt.

Erweiterte Kalkulation

Im erweiterten Modus (ab dem Premium-Plan) wird der einfache Faktor durch eine Formelkette ersetzt: EK → Einstand (+ Bezugskosten %) → Barpreis (+ Handlungskosten %) → + Gewinnzuschlag % → Nettopreis (÷ Skonto-Puffer %) → Bruttopreis (+ MwSt %). Jeder Prozentwert wird direkt in der Formelzeile der aufgeklappten Produkttabelle eingegeben. Die MwSt-Einstellung (Normal / Ermäßigt) wird pro Produkt gespeichert.

Arbeitssessions

Arbeitssessions ermöglichen es, den Bearbeitungsfortschritt über mehrere Sitzungen hinweg zu verfolgen. Sobald ein Produkt gespeichert wird, markiert die App es in der aktiven Session als bearbeitet. Sessions werden im Browser gespeichert und bleiben nach dem Schließen des Fensters erhalten.

Session erstellen und verwenden

1. Filter oder Kollektion setzen, dann 'Neue Session' klicken und einen Namen eingeben. Der Name wird automatisch mit dem Prefix EK_ (Einkaufspreise) oder VK_ (Artikelkalkulation) gespeichert.
2. Beim Speichern eines Produkts wird es automatisch als bearbeitet markiert.
3. Über die Pills-Buttons (Alle / Bearbeitet / Unbearbeitet) lassen sich Produkte nach Bearbeitungsstand filtern – nur Produkte aus dem Session-Scope werden gezählt.
4. Beenden deaktiviert die Session für diesen Tab – die Session selbst und andere Tabs bleiben unberührt.
5. Löschen entfernt die Session dauerhaft aus dem Browser. Eine Sicherheitsabfrage verhindert versehentliches Löschen.

Mehrere Sessions können gleichzeitig existieren. Über das Dropdown lässt sich zwischen ihnen wechseln. Eine EK-Session aktiviert sich automatisch auch im Kalk-Tab, wenn dort noch keine Session läuft.

Session-Scope

Beim Erstellen einer Session speichert die App den aktuell aktiven Filter (Kollektion, Tag) und die Produkt-IDs der sichtbaren Artikel als Scope. Der Fortschrittszähler zeigt 'bearbeitet / Scope-Größe' statt 'bearbeitet / alle geladenen Produkte'.

Scope-Banner

Wechselt man in einen Tab, in dem die aktive Session einen anderen Filter hat als aktuell geladen ist, erscheint ein blauer Hinweisbalken mit dem Scope-Filter und der Scope-Größe. Ein Klick auf 'Jetzt laden' stellt den passenden Filter automatisch wieder her. Das × schließt den Hinweis ohne Reload.

Speichern

Drei Ebenen stehen zur Verfügung: Pro Variante – Speichern-Button in der Variantenzeile (alle Pläne). Pro Produkt – Speichern-Button im Produktkopf (alle Pläne). Speichert Faktor, Referenzpreis und Verkaufspreis. Alle speichern – über die Leiste unten (ab dem Basic-Plan).

Massenbearbeitung

Oberhalb der Produktliste steht eine Massenbearbeitung zur Verfügung. Wähle ein Feld aus dem Dropdown (Kalkulationsfaktor, MwSt; im erweiterten Modus zusätzlich Bezugskosten, Handlungskosten, Gewinnzuschlag und Puffer), gib einen Wert ein und klicke 'Auf sichtbare anwenden'. Der Wert wird sofort für alle aktuell gefilterten Produkte gesetzt und als geändert markiert.

Alle speichern

Alle speichern in der Leiste unten speichert alle Produkte mit offenen Änderungen auf einmal. Ab dem Basic-Plan verfügbar; die Nutzung wird pro gespeichertem Produkt gezählt. Der Button Abbrechen daneben verwirft alle lokalen Änderungen und stellt den zuletzt gespeicherten Stand wieder her – ohne Serveraufruf, in allen Plänen verfügbar.

Autosave

Ist Autosave aktiv, werden Änderungen an Kalkulationsfaktoren und erweiterten Feldern automatisch nach der gewählten Verzögerung gespeichert – ohne manuellen Speicher-Klick. Jedes automatisch gespeicherte Produkt zählt als ein Verbrauch auf das Monatskontingent.

Statusleiste

Im sticky Filterbereich, links neben der Session-Zeile, befindet sich eine kompakte Statusleiste. Sie zeigt den Autosave-Status und erlaubt das schnelle Ein-/Ausschalten sowie die Wahl der Verzögerung (2 Sek. / 10 Sek. / Tab-Wechsel) direkt im Tab.

💾 Sicherung

Ermöglicht Export und Import aller relevanten Preisdaten als JSON-Datei. Vor jeder größeren Änderung sollte eine Gesamtsicherung erstellt werden.

Exportieren

Vier Exportarten stehen zur Verfügung:

• Gesamtsicherung – EK-Preis, Verkaufspreis und Faktor aller Varianten (empfohlen)
• Einkaufspreise – nur Unit Cost
• Verkaufspreise – nur Shopify-Preise
• Kalkulationsfaktoren – nur Faktoren

Gesamtsicherung ist ab dem Basic-Plan verfügbar. Einzelsicherungen (EK-Preise, Verkaufspreise, Faktoren) erfordern den Premium-Plan. Rücksicherung ab dem Basic-Plan.

Rücksicherung

1. Sicherungsdatei auswählen (JSON)
2. App vergleicht Datei mit aktuellen Shopify-Daten
3. Alle Unterschiede werden in einer Tabelle angezeigt
4. Einzelne Änderungen können per Checkbox ab- oder angewählt werden
5. „OK – Änderungen übernehmen“ schreibt nur die ausgewählten Werte zurück

Rücksicherung ist ab dem Basic-Plan verfügbar. Ohne passenden Plan erscheint beim Klick ein Upgrade-Hinweis. Eine Rücksicherung wird nicht auf das Monatskontingent angerechnet und läuft immer vollständig durch – unabhängig davon, wie viele Produkte betroffen sind.

⚙ Einstellungen

Im Tab Einstellungen & Abonnement werden globale Optionen konfiguriert und das aktive Abonnement verwaltet. Die Einstellungen gelten für alle Tabs und werden im Browser gespeichert (localStorage).

Autosave

Zwei separate Schalter aktivieren den Autosave je für den Einkaufspreise- und den Artikelkalkulations-Tab. Darunter wählt man die Verzögerung: 2 Sek. und 10 Sek. starten einen Timer nach der letzten Eingabe; 'Tab-Wechsel' speichert alle ausstehenden Änderungen beim Verlassen des Tabs. Toggle und Verzögerung sind auch direkt in der Statusleiste des jeweiligen Tabs zugänglich.

Automatische Datensicherung

Vor Speichervorgängen kann der Browser automatisch eine JSON-Sicherungsdatei herunterladen. Separat für Einkaufspreise und Artikelkalkulation konfigurierbar: 'Keine automatische Sicherung', 'Nur bei Batch-Speichern' oder 'Immer'. Standard: Immer. Beim Wechsel auf 'Keine automatische Sicherung' erscheint ein Hinweisfenster, das auf die Risiken aufmerksam macht.

Mehrwertsteuer

Legt die Steuersätze für Normalsatz und Ermäßigten Satz fest. Die Werte werden bei der Bruttopreisberechnung in der Artikelkalkulation verwendet und können pro Produkt individuell gewählt werden.

Preisrundung

Legt fest, auf welchen Schritt der berechnete Verkaufspreis gerundet wird. Verfügbare Schritte: 1,00 € · 0,50 € · 0,10 € · 0,05 € · Keine Rundung.

Die Rundung wird in der Artikelkalkulation bei jedem Speichern angewendet: Neuer Preis = EK × Faktor, gerundet auf den gewählten Schritt. Eine Livevorschau zeigt das Ergebnis für jeden Rundungsschritt direkt bei der Auswahl.

Lade-Limit für Produkte

Die Anzahl der initial geladenen Produkte wird direkt im Filterbereich der Einkaufspreise- und Artikelkalkulations-Tabs eingestellt (25 / 50 / 100 / 250 / Alle). Die gewählte Einstellung wird gespeichert und gilt für beide Tabs.

Sprache

Die App-Sprache kann auf Deutsch oder Englisch umgestellt werden. Die Einstellung wird pro Shop gespeichert und gilt für alle Benutzer desselben Shops.

💳 Abonnement

Der Abonnement-Bereich ist im Tab Einstellungen & Abonnement zugänglich (unterhalb der Einstellungen). Dort werden der aktive Plan, der monatliche Verbrauch und alle verfügbaren Pläne angezeigt.

Plan wählen

Wähle über den Toggle-Schalter zwischen monatlicher und jährlicher Abrechnung. Der Jahrestarif ist günstiger -- die Ersparnis wird direkt auf der Plan-Karte angezeigt. Ein Klick auf den gewünschten Plan leitet zur Shopify-Zahlungsseite weiter. Nach Abschluss wird der Plan automatisch aktualisiert.

Verbrauch & Status

Der aktuelle Plan, der monatliche Verbrauch und das Reset-Datum werden im Status-Bereich angezeigt. Ein Fortschrittsbalken zeigt den prozentualen Verbrauch. Ab 80 % erscheint eine Warnung. Als ein Verbrauch zählt jedes gespeicherte Produkt – ob Einkaufspreis, Artikelkalkulation oder Autosave, einzeln oder per „Alle speichern“. Das Verwerfen von Änderungen und die Rücksicherung zählen nicht.

Kündigung

Das Abo kann direkt in der App ohne Umweg über Shopify gekündigt werden. Klicke auf Abonnement kündigen, bestätige den Dialog -- die Kündigung wird sofort ausgeführt. Der Zugriff auf alle gebuchten Funktionen bleibt bis zum Ende des bezahlten Zeitraums erhalten. Danach wechselt die App automatisch auf den Free-Plan.

💡 Tipps & Hinweise

Empfohlener Arbeitsablauf

1. Sicherung erstellen (Gesamtsicherung)
2. Einkaufspreise aktualisieren
3. Kalkulationsfaktoren prüfen / anpassen
4. Artikelkalkulation aufrufen – EK-geänderte Produkte prüfen
5. Neue Preise speichern

Pläne & Aktionslimits

Die App verwendet ein Aktionssystem. Im Tab Einkaufspreise entspricht eine Aktion einem Klick auf Speichern. Im Tab Artikelkalkulation zählt "Alle speichern" eine Aktion pro gespeichertem Produkt.

Den aktuellen Plan und Verbrauch findest du unter Abonnement im Seitenmenü.

Häufige Fragen