JTL: AGB-Schnittstelle rechtssicher einrichten

Dieser Leitfaden erklärt Ihnen Schritt für Schritt, wie Sie Ihre Rechtstexte über unsere Schnittstelle automatisch in Ihren JTL-Shop integrieren und stets aktuell halten.

I. Notwendige Vorbereitungen bei JTL treffen

1. Anmelden im JTL-Shop

Loggen Sie sich zunächst mit Ihren Zugangsdaten in Ihren JTL-Shop ein:

2. Installation des AGB-Schnittstellen-Moduls der IT-Recht Kanzlei

Bevor die Rechtstexte in den JTL-Shop übertragen und die Aktualisierungs-Automatik eingerichtet werden kann, muss zunächst das AGB-Modul unserer Kanzlei bei JTL installiert werden.

Loggen Sie sich hierzu bei JTL ein.

Wechseln Sie dann im JTL-Shop links in den Menüpunkt "Plugins" zu "Meine Käufe":

Falls noch nicht geschehen, verknüpfen Sie Ihr JTL-Konto mit Ihrem Online-Shop. Klicken Sie hierzu auf den Button "Konto verknüpfen":

Sie gelangen dann auf die folgende Seite:

Bitte melden Sie sich an bzw. geben Ihre Zugangsdaten ein und klicken auf den orangenen Button "Anmelden".

Sie gelangen auf eine neue Seite. Klicken Sie oben auf die Verlinkung "JTL-Extension Store".

Sie befinden sich nun im "JTL Extension Store". Geben Sie oben rechts in der Suchleiste "it-recht Kanzlei" ein. Das Plugin der IT-Recht Kanzlei wird angezeigt - bitte klicken Sie auf unser Plugin:

Sie gelangen auf eine neue Seite. Klicken Sie hier bitte rechts auf den orangenen Button "Jetzt auschecken".

Sie gelangen nun auf die Seite "JTL Checkout". Klicken Sie auf den Button "Anmelden" und geben Sie auf der nachfolgen Seite Ihre Zugangsdaten ein und klicken anschließend auf den orangenen Button "anmelden".

Klicken Sie nun rechts unten auf den Button "Jetzt bestellen".

Sie werden nun auf eine Seite mit der Überschrift "Vielen Dank für Ihre Bestellung im JTL-ExtensionStore!" geführt.

Verlassen Sie bitte die Seite und klicken auf diesen Link https://itrk-shop5.lilfoot.software/admin/licenses.php.

Sie sehen nun unten unter "Ungebundene Lizenzen" den Eintrag unserer Schnittstelle. Klicken Sie auf den Button "An diesen Online-Shop binden".

Installieren Sie anschließend beim "Plugin-Manager" unsere Schnittstelle.

Sie erscheint dann wie folgt links abgebildet unter "Installierte Plugins".

Klicken Sie auf "AGB-Schnittstelle der IT-Recht Kanzlei".

Nun öffnet sich die Seite: "Plugin: AGB-Schnittstelle der IT-Recht Kanzlei".

Klicken Sie auf "Einstellungen".

Es wird nun der API-Token angezeigt. Bitte notieren Sie sich den API-Token. Dieser wird für die Übertragung der Rechtstexte aus dem Mandantenportal in Ihren JTL Shop benötigt.

3. Rechtstexte-Seiten im JTL-Shop

Die Seiten für die Rechtstexte sind im Shop bei JTL üblicherweise "ab Werk" vorhanden/angelegt.

Ob dies bei Ihrer Shop-Version der Fall ist, können Sie über die Menüfolge "Inhalte" und dann "Eigene Seiten" prüfen:

Sie finden dann die Seiten im Bereich "Gesetzliche Informationen (Templatename: Fuss)".

Sind die Seiten noch nicht verfügbar, legen Sie im Folgenden unter "Gesetzliche Informationen (Templatename: Fuss)", folgende vier Seiten an:

• AGB
• Widerrufsbelehrung
• Datenschutzerklärung
• Impressum

und speichern Sie diese.

II. Übertragung der Rechtstexte aus dem Mandantenportal in den JTL-Shop

Melden Sie sich nun mit Ihren Zugangsdaten im Mandantenportal der IT-Recht Kanzlei an.

1. Einrichtung der Schnittstellenverbindung

Nach dem Login geht es an die Einrichtung der Datenschnittstelle.

Wählen Sie hierfür im rechten Seitenmenü unter der Überschrift „Schnittstelle“ den Punkt „Schnittstelle einrichten“ aus.

Sie gelangen nun auf die zentrale Benutzeroberfläche für die Schnittstellenverwaltung.

Wählen Sie aus dem Systemkatalog per Klick auf die Auswahl-Schaltfläche unter "ODER WÄHLEN SIE IHR SYSTEM" Ihr Zielsystem aus.

Klicken Sie auf „Weiter“.

Im nächsten Schritt werden Sie gebeten, die maßgeblichen technischen Schnittstellendaten einzugeben, mit denen die Schnittstellenverbindung hergestellt wird.

• Unter „Shop-Name“ können Sie der Schnittstelle einen beliebigen Namen geben, unter der sie sodann in Ihrer Schnittstellenverwaltung geführt wird.
• Unter „API-Token" tragen Sie den Ihrerseits zuvor bei JTL generierten "API-Token" ein (s. obige Ausführungen).
• Unter „API-URL“ tragen Sie Ihre Shop-URL (Startseite Ihrer Präsenz, z.B. „https://www…..“) ein

Klicken Sie nach Eingabe der Daten auf den „Speichern“-Button.

2. Konfiguration der zu übertragenden Rechtstexte

Nach Einrichtung der Schnittstellenverbindung werden Sie automatisch auf die Rechtstexte-Übertragungsseite weitergeleitet.

Sie finden hier eine Übersicht der für die Schnittstellenübertragung verfügbaren Rechtstexte:

Haben Sie Ihre Rechtstexte bisher nicht konfiguriert, sehen Sie unter „Anmerkung“ den Hinweis, dass vor der Übertragung zunächst eine Konfiguration des Rechtstextes erforderlich ist.

Wichtig: Sie müssen einen Rechtstext erst konfigurieren, bevor er per Schnittstelle übertragen werden kann.

Klicken Sie dafür auf das rote „Bitte konfigurieren“ (s. roter Pfeil im obigen Bild).

Sie werden nun in den Online-Konfigurator weitergeführt.

Nehmen Sie die Konfiguration vor, indem Sie den virtuellen Fragenkatalog durchgehen. Klicken Sie abschließend auf „Weiter“.

Nach der Konfiguration werden Sie auf die Rechtstexte-Übertragungsseite zurückgeleitet, für den Rechtstext ist die Anmerkung "Bitte konfigurieren" nun entfallen.

Wiederholen Sie den Vorgang, bis alle zu übertragenden Rechtstexte konfiguriert sind und die Anmerkung „Bitte konfigurieren“ bei keinem zu übertragenden Rechtstext mehr angezeigt wird:

3. Übertragen der Rechtstexte in den JTL-Shop

Nach der Konfiguration der Rechtstexte können Sie diese nun über die eingerichtete Schnittstellenverbindung übertragen.

Aktivieren Sie hierfür durch Klick den „Übertragen“-Regler rechts für jeden Rechtstext:

Nach Betätigung eines Übertragungs-Reglers erhalten Sie jeweils oberhalb die Mitteilung, ob die Übertragung erfolgreich war:

Haben Sie alle Regler betätigt und sind diese auf „grün“ gestellt, haben Sie die Schnittstelleneinrichtung erfolgreich abgeschlossen.

FERTIG: Die Aktualisierungs-Automatik überprüft und aktualisiert bei Bedarf die Rechtstexte in Ihrem JTL-Shop und Sie können sich nun auf das Verkaufen und den Kundenservice konzentrieren.

4. Schnittstellenstatus prüfen und Einstellungen ändern

Nach der Einrichtung der Schnittstelle und der Übertragung der Rechtstexte können Sie den Schnittstellenstatus jederzeit im rechten Seitenmenü unter „Schnittstellen verwalten“ (Nach Einrichtung der Schnittstelle wird der Menüpunkt in "Schnittstelle verwalten" umbenannt und dahinter ein grüner Haken angezeigt) prüfen und die Schnittstellenverbindung verwalten.

Wählen Sie hierfür nach Klick auf „Schnittstelle verwalten“ durch Klick auf die Sparte „Shop“ (Ihr frei gewählter Name für die Schnittstellenverbindung) die betroffene Schnittstelle aus:

Sie gelangen nun wieder in die Ansicht der aktiv übertragenen Dokumente und haben unterhalb der Übersicht unter „Einstellungen der Schnittstelle ändern“ die Möglichkeit, die Verbindungsdaten für die Schnittstelle (frei vergebener Shop-Name, API-Token, URL) bei Bedarf anzupassen:

Die Vergabe eines eigenen Namens für die Schnittstelle empfiehlt sich insbesondere wenn mehr als ein JTL Shop betrieben wird.
Dadurch ist direkt in der Schnittstellenverwaltung sichtbar welche Schnittstelle zu welchem JTL Shop gehört.