> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dreizack-medien.de/llms.txt
> Use this file to discover all available pages before exploring further.

# Einstellungen

> Gutschrift, Einmal-Boni, Einlösung, Teilnahme und Integrität konfigurieren

## Gutschrift

Legt fest, wie Bonuspunkte beim Kauf vergeben werden.

<Frame>
  <img src="https://mintcdn.com/dzm/4prk8b1bYKoyK7Zl/images/bpe1.jpg?fit=max&auto=format&n=4prk8b1bYKoyK7Zl&q=85&s=33ae544a8bfaf801485d2b670a1a2d88" alt="Gutschrift-Einstellungen" width="2052" height="826" data-path="images/bpe1.jpg" />
</Frame>

<ParamField path="Punkte je Euro" type="number">
  Punkte pro Euro Warenwert.
</ParamField>

<ParamField path="Berechnungsbasis" type="select">
  Ob Punkte auf den Brutto- oder Nettopreis gerechnet werden (gilt für Gutschrift und Anzeige).
</ParamField>

<ParamField path="Rundung" type="select">
  Wie Punktebeträge gerundet werden (gilt für Gutschrift und Anzeige): **Abrunden**, **Kaufmännisch runden** oder **Aufrunden**.
</ParamField>

<ParamField path="Euro-Gegenwert je Punkt" type="number">
  Fester Einlösewert eines Punktes.

  <Warning>
    Nur änderbar, solange keine Punkte im Umlauf sind (Restschuld = 0). Bereits ausgegebene Punkte würden sonst rückwirkend um- oder abgewertet. Wie großzügig das Programm ist, steuerst du über das Feld **Punkte je Euro**.
  </Warning>
</ParamField>

<ParamField path="Freigabezeitpunkt" type="select">
  Wann gutgeschriebene Punkte wirksam werden.

  <Info>
    **Sofort**: bei Bestelleingang. **Bei Zahlungseingang / Versand**: erst wenn bezahlt bzw. versandt. **Nach Widerrufsfrist**: bei Zahlung gutgeschrieben, aber erst nach der eingestellten Frist einlösbar (empfohlen, bilanzsicher).
  </Info>
</ParamField>

<ParamField path="Widerrufsfrist (Tage)" type="number">
  Pending-Fenster, bevor Punkte einlösbar werden.

  <Note>
    Diese Option ist nur sichtbar, wenn als Freigabezeitpunkt **Nach Widerrufsfrist** gewählt ist.
  </Note>
</ParamField>

<ParamField path="Rabattierte Artikel ausschließen" type="boolean">
  Für rabattierte Artikel (Sonderpreis) keine Punkte vergeben.
</ParamField>

<br />

## Einmal-Boni

Punkte für einmalige Aktionen (0 = deaktiviert).

<Frame>
  <img src="https://mintcdn.com/dzm/4prk8b1bYKoyK7Zl/images/bpe2.jpg?fit=max&auto=format&n=4prk8b1bYKoyK7Zl&q=85&s=4c509c86d448df4f244012e83d1d22d5" alt="Einmal-Boni" width="2070" height="460" data-path="images/bpe2.jpg" />
</Frame>

<ParamField path="Registrierung" type="number">
  Punkte-Bonus bei Registrierung eines neuen Kunden.
</ParamField>

<ParamField path="Erstbestellung" type="number">
  Punkte-Bonus bei der ersten Bestellung eines Kunden.
</ParamField>

<ParamField path="Newsletter-Anmeldung" type="number">
  Punkte-Bonus bei Double-Opt-in-Freischaltung des Newsletters.
</ParamField>

<br />

## Einlösung

Regeln für das Einlösen von Punkten im Checkout.

<Frame>
  <img src="https://mintcdn.com/dzm/4prk8b1bYKoyK7Zl/images/bpe4.jpg?fit=max&auto=format&n=4prk8b1bYKoyK7Zl&q=85&s=b3e306d717d793e0a13bf1e4a1236a5d" alt="Einlösung" width="2066" height="458" data-path="images/bpe4.jpg" />
</Frame>

<ParamField path="Obergrenze pro Einkauf" type="number">
  Maximaler Anteil des Bestellwerts, der per Punkten bezahlt werden darf.
</ParamField>

<ParamField path="Mindest-Einlöseschwelle" type="number">
  Punkte, ab denen eingelöst werden darf (0 = keine).
</ParamField>

<ParamField path="Einlöse-Schrittweite" type="number">
  Einzulösende Punkte müssen ein Vielfaches davon sein.
</ParamField>

<br />

## Teilnahme

Teilnahme am Bonusprogramm.

<Frame>
  <img src="https://mintcdn.com/dzm/4prk8b1bYKoyK7Zl/images/bpe5.jpg?fit=max&auto=format&n=4prk8b1bYKoyK7Zl&q=85&s=a8c19eaaa00d33a1ec3e46d2d1c2f805" alt="Teilnahme" width="2060" height="336" data-path="images/bpe5.jpg" />
</Frame>

<ParamField path="Opt-in-Pflicht (DSGVO)" type="boolean">
  Standard: aus. Alle registrierten Kunden nehmen automatisch teil (Programm in der Datenschutzerklärung abdecken). An: Kunden müssen bei der Registrierung über eine Checkbox zustimmen, bevor Punkte verarbeitet werden.

  <Info>
    Für ein rein shop-internes Punkteprogramm ist eine separate Einwilligung meist nicht zwingend, ein Hinweis in Datenschutzerklärung/AGB genügt. Nötig wird sie, wenn Daten an Dritte fließen oder du den dokumentierten Consent-Nachweis (mit Logging) willst. Bei aktiver Pflicht brauchst du die Teilnahme-Checkbox.
  </Info>
</ParamField>

<ParamField path="Teilnahme-Checkbox" type="boolean">
  Zustimmungs-Checkbox bei der Registrierung (Anzeigeort Registrierung, mit DSGVO-Logging). Nach dem Anlegen frei in der JTL-Checkboxverwaltung anpassbar (Text, Pflicht, Kundengruppen).

  <Tip>
    Sobald die Checkbox angelegt ist, zeigt das Feld **Angelegt** an.
  </Tip>
</ParamField>

<br />

## Integrität & Sicherheit

Der Integritätsschlüssel (HMAC) sichert die Revisionssicherheit der Punktebuchungen gegen nachträgliche Manipulation.

<Note>
  **Zero-Config aktiv:** Der Integritätsschlüssel wird standardmäßig aus dem `BLOWFISH_KEY` abgeleitet, kein Setup nötig.
</Note>

<Warning>
  Wird der `BLOWFISH_KEY` rotiert (z. B. über `dzm_blowfish_rekey`), ist die bestehende Hash-Kette nicht mehr verifizierbar, denn der alte Schlüssel lässt sich nicht reproduzieren. Für maximale Revisionssicherheit setze einen eigenen Schlüssel.
</Warning>

Empfehlung: einen eigenen HMAC-Schlüssel setzen (überlebt eine BLOWFISH-Rotation). Schlüssel generieren, die zwei Zeilen in `includes/config.JTL-Shop.ini.php` einfügen (in der Regel per FTP, da die Datei meist nicht beschreibbar ist), dann den Shop-Cache leeren.

<div style={{height: '1px', backgroundColor: 'silver', margin: '24px 0'}} />