VimirLab Belohnungspunkte

VimirLab Belohnungspunkte - Konfigurationshandbuch

1. Plugin-Übersicht

VimirLab Belohnungspunkte ist ein umfassendes Kundenbindungssystem, das Händlern folgendes ermöglicht:

• Belohnungspunkte an Kunden basierend auf Kaufbeträgen vergeben
• Kunden erlauben, Punkte gegen Rabatte einzulösen
• Shop-Guthaben aus Rückerstattungen oder Promotionen verwalten
• Sowohl Punkte als auch Guthaben für die Zahlung kombinieren
• Flexible Zahlungsbeschränkungen konfigurieren
• Rückerstattungen mit Kundenpräferenzen handhaben

2. Installation

1. Gehen Sie zu Erweiterungen → Meine Erweiterungen in der Shopware Administration
2. Finden Sie "VimirLab Reward Points" und klicken Sie auf Installieren
3. Klicken Sie nach Abschluss der Installation auf Aktivieren
4. Cache leeren: Einstellungen → System → Caches & Indizes → Cache leeren
5. Zugriff auf Konfiguration: Erweiterungen → Meine Erweiterungen → VimirLab Reward Points → Konfiguration

3. Konfigurationseinstellungen

3.1 Maximale Einlösepunktgrenze

• Standard: 1000 Punkte
• Beschreibung: Maximale Punkte, die in einer einzelnen Bestellung eingelöst werden können
• Beispiel: Bei 5000 eingestellt, können Kunden bis zu 5000 Punkte pro Bestellung einlösen

3.2 Prozentsatz der Punkte pro Bestellung

• Standard: 5%
• Beschreibung: Prozentsatz des Bestellwerts, der in Belohnungspunkte umgewandelt wird
• Formel: Verdiente Punkte = (Bestellwert × Prozentsatz) ÷ 100
• Beispiel: 5% bedeutet, dass eine 100 $ Bestellung 5 Punkte einbringt (wenn 100 Punkte = 1 $)

3.3 Währungs-Punkte-Zuordnung

• Format: WÄHRUNGSCODE:PUNKTE_PRO_EINHEIT (eine pro Zeile)
• Beispiel:
  USD:100 (100 Punkte = 1 $)
  EUR:150 (150 Punkte = 1 €)
  GBP:120 (120 Punkte = 1 £)

3.4 Punkte verdienen aktivieren

• Standard: Aktiviert
• Beschreibung: Kunden erlauben, Punkte bei Käufen zu verdienen

3.5 Guthaben verdienen aktivieren

• Standard: Aktiviert
• Beschreibung: Kunden erlauben, produktspezifisches Guthaben zu verdienen

3.6 Maximales Bestellguthaben pro Bestellung

• Standard: 100,00
• Beschreibung: Maximales Guthaben, das in einer einzelnen Bestellung verwendet werden kann (0 = unbegrenzt)
• Beispiel: Bei 500 eingestellt, ist maximal 500 $ Guthaben pro Bestellung möglich

3.7 Maximaler Bestellguthaben-Prozentsatz

• Standard: 50%
• Bereich: 0-100
• Beschreibung: Maximaler Prozentsatz des Warenkorbs, der mit Guthaben bezahlt werden kann
• Beispiel: 50% bei einer 100 $ Bestellung = max. 50 $ mit Guthaben

3.8 Mindestbestellwert zur Verwendung von Guthaben

• Standard: 0,00
• Beschreibung: Mindestwarenkorbsumme, die erforderlich ist, um Guthaben zu verwenden (0 = kein Minimum)

3.9 Vollständige Zahlung mit Guthaben erlauben

• Standard: Aktiviert
• Beschreibung: 100% Zahlung mit Guthaben/Punkten erlauben
• Wenn deaktiviert: Kunden müssen zumindest einen Betrag mit einer Zahlungsmethode bezahlen

3.10 Erforderlicher Mindestzahlungsprozentsatz

• Standard: 0%
• Bereich: 0-100
• Beschreibung: Mindestprozentsatz, der mit regulären Zahlungsmethoden bezahlt werden muss
• Priorität: Überschreibt die Einstellung "Vollständige Zahlung erlauben"
• Beispiele:
  • 0% + Vollständige Zahlung aktiviert = 100% Zahlung mit Guthaben erlaubt
  • 10% = Kunde muss mindestens 10% mit Zahlungsmethode bezahlen
  • 25% = Kunde muss mindestens 25% mit Zahlungsmethode bezahlen

4. Kundeneinrichtung

4.1 Belohnungsstufen erstellen (Optional)

1. Gehen Sie zu Kataloge → Belohnungsstufen
2. Klicken Sie auf Belohnungsstufe hinzufügen
3. Eingeben: Name (z.B. "Silber"), Erforderliche Punkte (z.B. 1000)
4. Aktivieren und Speichern

4.2 Produktguthaben hinzufügen

1. Gehen Sie zu Kataloge → Produkte
2. Produkt auswählen → Tab Benutzerdefinierte Felder
3. Produktguthaben (Festbetrag) einstellen (z.B. 5,00)
4. Speichern - Kunden verdienen dieses Guthaben beim Kauf dieses Produkts

4.3 Manuelle Punkte-/Guthabenanpassung

1. Gehen Sie zu Kunden → Übersicht
2. Kunde auswählen → Tab Benutzerdefinierte Felder
3. Belohnungspunkte oder Bestellguthaben bearbeiten
4. Speichern

5. Wie Kunden das System nutzen

5.1 Punkte verdienen

Punkte werden automatisch verdient, wenn:

• Kunde eine Bestellung abschließt
• Punkte werden nur auf den Bargeldanteil berechnet (schließt verwendetes Guthaben/Punkte aus)
• Formel: Gezahltes Bargeld × Prozentsatz ÷ Währungskurs

5.2 Belohnungspunkte beim Checkout verwenden

1. Kunde sieht den Bereich "Belohnungspunkte" beim Checkout
2. Zeigt verfügbare Punkte und Umrechnungskurs an
3. Gibt einzulösende Punkte ein
4. Klickt auf Anwenden - Rabatt wird sofort angewendet
5. Kann auf Entfernen klicken, um rückgängig zu machen

5.3 Bestellguthaben beim Checkout verwenden

1. Kunde sieht den Bereich "Bestellguthaben"
2. Zeigt verfügbares Guthaben und maximal verwendbares Guthaben an
3. Gibt Guthabenbetrag ein
4. Klickt auf Guthaben anwenden
5. Kann auf Entfernen klicken, um rückgängig zu machen

5.4 Punkte und Guthaben kombinieren

Beispielbestellung: 1.170,85 $

• 5000 Punkte anwenden (50 $ Rabatt) → Verbleibend: 1.120,85 $
• 1.120,85 $ Guthaben anwenden → Verbleibend: 0,00 $ (wenn vollständige Zahlung erlaubt)
• Bestellung wird ohne Zahlungsmethode abgeschlossen

5.5 Kundenrückerstattungspräferenzen

1. Kunde geht zu Konto → Zahlungsmethoden
2. Wählt Rückerstattungspräferenz:
   • Ursprüngliche Zahlungsmethode: Rückerstattung auf Karte/Zahlung
   • Shop-Guthaben: Rückerstattung als Shop-Guthaben
3. Speichert Präferenz

6. Rückerstattungsverwaltung

6.1 Rückerstattungen verarbeiten

1. Gehen Sie zu Bestellungen → Übersicht
2. Bestellung auswählen
3. Rückerstattung normal über Shopware verarbeiten
4. Plugin automatisch:
   • Stellt verwendete Belohnungspunkte dem Kunden wieder her
   • Stellt verwendetes Bestellguthaben dem Kunden wieder her
   • Zieht verdiente Punkte ab (basierend auf Bargeldanteil)
   • Wendet Kundenrückerstattungspräferenz an

6.2 Handhabung der Rückerstattungspräferenz

Ursprüngliche Zahlungsmethode:

• Bargeldanteil wird auf Zahlungsmethode zurückerstattet
• Verwendetes Guthaben wird auf Kundenkonto wiederhergestellt
• Verwendete Punkte werden auf Kundenkonto wiederhergestellt
• Verdiente Punkte werden abgezogen (nur Bargeldanteil)

Shop-Guthaben:

• Bargeldanteil wird in neues Shop-Guthaben umgewandelt
• Verwendetes Guthaben wird separat wiederhergestellt
• Verwendete Punkte werden auf Kundenkonto wiederhergestellt
• Verdiente Punkte werden abgezogen (nur Bargeldanteil)

7. Testleitfaden

Testszenario 1: Grundlegendes Punkte verdienen

1. Konfigurieren: 5% Punkte, USD:100
2. Testbestellung erstellen: 100 $
3. Bestellung abschließen
4. Erwartet: Kunde verdient 500 Punkte (5% von 100 $)
5. In benutzerdefinierten Kundenfeldern überprüfen

Testszenario 2: Punkteeinlösung

1. Kunden manuell 5000 Punkte geben
2. Warenkorb im Wert von 100 $ erstellen
3. Kunde wendet 5000 Punkte beim Checkout an
4. Erwartet: 50 $ Rabatt angewendet (5000 ÷ 100 = 50 $)
5. Bestellsumme: 50 $

Testszenario 3: Kombinierte Zahlung

1. Kunden 5000 Punkte und 100 $ Guthaben geben
2. Warenkorb im Wert von 150 $ erstellen
3. 5000 Punkte anwenden (50 $ Rabatt) → 100 $ verbleibend
4. 100 $ Guthaben anwenden → 0 $ verbleibend
5. Erwartet: Bestellung wird mit 0 $ Zahlung abgeschlossen

Testszenario 4: Mindestzahlungsanforderung

1. Mindestzahlungsprozentsatz einstellen: 10%
2. Warenkorb im Wert von 100 $ erstellen
3. Versuchen, 100 $ Guthaben anzuwenden
4. Erwartet: Fehler - mindestens 10 $ müssen mit Zahlungsmethode bezahlt werden
5. Maximal erlaubtes Guthaben: 90 $

Testszenario 5: Rückerstattungshandhabung

1. Kunde platziert 100 $ Bestellung unter Verwendung von 50 $ Guthaben
2. Kunde verdient ~250 Punkte (5% von 50 $ Bargeld)
3. Vollständige Rückerstattung verarbeiten
4. Erwartet:
   • 50 $ Guthaben wiederhergestellt
   • ~250 Punkte abgezogen
   • 50 $ auf Zahlungsmethode zurückerstattet (oder Shop-Guthaben basierend auf Präferenz)

8. Fehlerbehebung

Problem: Punkte werden nicht verdient

• Prüfen: Punkte verdienen aktivieren ist AN
• Prüfen: Prozentsatz ist eingestellt (z.B. 5)
• Prüfen: Währungszuordnung existiert für Bestellwährung
• Überprüfen: Bestellstatus ist abgeschlossen/bezahlt

Problem: Guthaben kann nicht verwendet werden

• Prüfen: Guthaben verdienen aktivieren ist AN
• Prüfen: Warenkorbsumme erfüllt Mindestbestellwert
• Prüfen: Maximales Guthaben pro Bestellung wird nicht überschritten
• Prüfen: Prozentgrenze wird nicht überschritten
• Überprüfen: Kunde hat verfügbares Guthaben

Problem: Vollbetrag kann nicht mit Guthaben bezahlt werden

• Prüfen: Vollständige Zahlung mit Guthaben erlauben ist AKTIVIERT
• Prüfen: Mindestzahlungsprozentsatz ist 0%
• Prüfen: Kunde hat ausreichend Guthaben/Punkte
• Prüfen: Maximaler Prozentsatz erlaubt es

Problem: Falscher Rückerstattungsbetrag

• Überprüfen: Benutzerdefinierte Bestellfelder zeigen korrekt verwendetes Guthaben/Punkte
• Prüfen: Kundenrückerstattungspräferenz ist richtig eingestellt
• Überprüfen: Bestelldetails in der Administration für Transaktionsverlauf

9. Wichtige Hinweise

• Punkte werden nur auf Bargeldanteil verdient: Anteile, die mit Guthaben/Punkten bezahlt werden, verdienen keine Punkte
• Rückerstattungen sind intelligent: System verfolgt, was verwendet wurde, und stellt genau wieder her
• Währung ist wichtig: Stellen Sie sicher, dass Währungszuordnungen für alle Shop-Währungen konfiguriert sind
• Cache leeren: Cache nach Konfigurationsänderungen leeren
• Kundenstufen: Optionale Funktion - funktioniert ohne Erstellung von Stufen
• Produktguthaben: Optional - nur bei Produkten einstellen, bei denen Sie Bonusguthaben anbieten möchten

10. Support & Dokumentation

Für zusätzlichen Support:

• Benutzerdefinierte Bestellfelder für detaillierte Transaktionsdaten überprüfen
• Benutzerdefinierte Kundenfelder für aktuelle Guthaben prüfen
• Konfigurationseinstellungen überprüfen, ob sie dem beabsichtigten Verhalten entsprechen
• Shopware-Cache nach Konfigurationsänderungen leeren
• In Staging-Umgebung testen, bevor Sie in Produktion gehen

Kurzreferenz

Standardkonfiguration zum Testen:

• Punkte-Prozentsatz: 5%
• USD-Währung: 100 Punkte = 1 $
• Max. Punkte: 1000 pro Bestellung
• Max. Guthaben: 100,00 pro Bestellung
• Max. Guthaben %: 50% des Warenkorbs
• Min. Bestellwert: 0,00
• Vollständige Zahlung: Aktiviert
• Min. Zahlung %: 0%

Konfiguration für strenge Kontrolle:

• Punkte-Prozentsatz: 3%
• Max. Punkte: 500 pro Bestellung
• Max. Guthaben: 50,00 pro Bestellung
• Max. Guthaben %: 25% des Warenkorbs
• Min. Bestellwert: 25,00
• Vollständige Zahlung: Deaktiviert
• Min. Zahlung %: 20%

Konfiguration für maximale Flexibilität:

• Punkte-Prozentsatz: 10%
• Max. Punkte: 10000 pro Bestellung
• Max. Guthaben: 0 (unbegrenzt)
• Max. Guthaben %: 0 (keine Grenze)
• Min. Bestellwert: 0,00
• Vollständige Zahlung: Aktiviert
• Min. Zahlung %: 0%