Skip to content

JTL Vouchers verbinden

Das Plugin kommuniziert über eine API mit dem JTL Vouchers Service. Bevor Sie Gutscheine verwalten können, müssen Sie die Verbindung einrichten.

Verbindungs-PIN erhalten

  1. Melden Sie sich in Ihrem JTL Vouchers Konto an
  2. Navigieren Sie zu Einstellungen > API-Zugang
  3. Erstellen Sie einen neuen API-Zugang und notieren Sie sich die Verbindungs-PIN

Verbindung in Shopware herstellen

  1. Öffnen Sie die Shopware-Administration
  2. Navigieren Sie zu Erweiterungen > JTL Gutscheine
  3. Öffnen Sie den Reiter Einstellungen oder Verbindung
  4. Geben Sie die Verbindungs-PIN ein
  5. Klicken Sie auf Verbinden

Nach erfolgreicher Verbindung wird der Status als Verbunden angezeigt. Das Plugin tauscht die PIN automatisch gegen API-Zugangsdaten (Client-ID und Secret) aus und verwaltet die OAuth2-Authentifizierung im Hintergrund.

Verbindungsstatus prüfen

Der aktuelle Verbindungsstatus wird in der Plugin-Verwaltung angezeigt:

  • Verbunden — Die API-Kommunikation funktioniert
  • Nicht verbunden — Es sind keine gültigen Zugangsdaten hinterlegt

Verbindung trennen

  1. Navigieren Sie zu Erweiterungen > JTL Gutscheine > Einstellungen
  2. Klicken Sie auf Verbindung trennen

Hinweis

Das Trennen der Verbindung entfernt die gespeicherten API-Zugangsdaten. Bestehende Gutschein-Reservierungen im Warenkorb können danach nicht mehr abgerechnet werden. Stellen Sie sicher, dass keine offenen Bestellungen mit Gutscheinen vorhanden sind.

Sicherheit

  • Die API-Zugangsdaten werden verschlüsselt in der Shopware-Datenbank gespeichert
  • OAuth2-Tokens werden automatisch erneuert, bevor sie ablaufen
  • Die Kommunikation mit der JTL Vouchers API erfolgt ausschließlich über HTTPS

JTL Gutscheine Plugin für Shopware 6