Anleitung: Rechtstexte-Schnittstelle zu Gambio einrichten

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

Anmeldung und Vorbereitungen im Gambio-Shop

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

Zusätzliche Vorbereitungen für mehrsprachige Gambio Shops

Sollen im Gambio-Shop mehrere Sprachversionen der Rechtstexte verwendet werden, ist vor der Datenübertragung zunächst die Kennung der Mehrsprachigkeit im Gambio Shop zu aktivieren.

Dazu gehen Sie wie folgt vor:

Wechseln Sie über den Menüpunkt "Einstellungen" zum Menüpunkt "Suchmaschinenoptimierung".

Dort muss dann die Funktion "Sprachcode in URLs integrieren" aktiviert werden.

Wichtiger Hinweis: Nach dem Aktiveren dieser Funktion ist die bisherige URL-Struktur in Ihrem Gambio-Shop verändert.
Daher sollten Sie nach/bei der Aktivierung der Funktion folgendes bedenken und beachten:

• ALLE deutschsprachigen Seiten im Shop sind nun mit dem Zusatz "/de" versehen
• evtl. manuell angelegte Links auf deutsche Seiten funktionieren nun nicht mehr und müssen entsprechend angepasst werden
• gleiches gilt für jede weitere Sprache (z.B. englisch)

Installation des Rechtstexte-Moduls der IT-Recht Kanzlei

Bevor die Rechtstexte in den Gambio Shop übertragen und die Aktualisierungs-Automatik eingerichtet werden kann muss zunächst das Rechtstexte-Modul der IT-Recht Kanzlei installiert werden.

Zur Installation/Aktivierung des AGB-Moduls wählen Sie in der Navigation links im Shop den Menüpunkt "Module" und dann "Modul-Center".

Danach gelangen Sie zur Übersichtsseite der verfügbaren Module.

Klicken Sie in der Übersicht auf "IT-Recht Kanzlei" und anschließend rechts unten auf den Button "Installieren".

Nach erfolgter Installation wählen Sie rechts unten "Bearbeiten"

Im folgenden Fenster finden Sie weitere Informationen zum AGB-Service der IT-Recht Kanzlei und können diesen bei Bedarf mit einem Klick auf den blauen Button bestellen.

Haben Sie den Rechtstexte-Service bereits gebucht klicken Sie oben auf Konfiguration.

Nach Auswahl der "Konfiguration" gelangen Sie zu folgender Übersicht:

Mit einem Klick auf den Button "Token generieren" erzeugt das System den für die Übertragung notwendigen Schlüssel.

Darunter befindet sich die Shop-URL, die ebenfalls für das Mandantenportal benötigt wird.

Übertragung der Rechtstexte aus dem Mandantenportal in den Gambio-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 "Weitere Systeme" Ihr Zielsystem "Gambio" 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 Gambio 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 Gambio-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 im Mandantenportal abgeschlossen.

Letzter wichtiger Schritt: Rechtstexte bei Gambio dem Content-Manager zuweisen!

Sie müssen nun noch die oben aktivieren Rechtstexte im Gambio-Backend dem Content-Manager zuweisen.

Wechseln Sie dazu in Ihrem Gambio-Shop über die Auswahl "Module", "dann "Modul-Center" zur Modulseite der IT-Recht Kanzlei (vgl. oben).

Dort wählen Sie wieder oben den Reiter Konfiguration:

Sie bekommen nun unter "Empfangene Texte" angezeigt, welche Rechtstexte übertragen worden sind.

Beispiel:

Geben Sie die jeweiligen Rechtstexte durch einen Klick auf "Im Content-Manager verwenden" (siehe Bild oben) zur Verwendung im Gambio-Shop frei.

Anschließend erhalten Sie bspw. folgende Anzeige:

FERTIG: Die Aktualisierungs-Automatik überprüft und aktualisiert bei Bedarf die Rechtstexte in Ihrem Gambio-Shop.

Typische Szenarien bei der Integration

Nachfolgend haben wir einige typische Szenarien, die sich bei der Einrichtung der AGB-Schnittstelle ergeben für Sie zusammengestellt.

Muss ich im Gambio-Shop vor der Übertragung der Rechtstexte dafür entsprechende Seiten anlegen?

Nein, das brauchen Sie nicht. Die benötigten Seiten sind im Gambio-Shop bereits vorhanden. Sie können sich diese über die Menüpunkte „Darstellung“ und dann „Content-Manager“ im Bereich „Infoseiten“ anzeigen lassen.

Ich habe bereits Seiten für die Rechtstexte angelegt, ist das schlimm?

Grundsätzlich nicht. Es empfiehlt sich aber diese vor der Übertragung zu deaktivieren, um Irritationen und Falschzuweisungen im Content-Manager zu vermeiden.

Ich habe das API-Token und die Shop-URL im Mandantenportal korrekt eingegeben, bekomme aber bei der Übertragung einen Fehler angezeigt.

Ursache hierfür ist in den meisten Fällen eine oder mehrere manuell angelegte Rechtstexte-Seite(n) im Content-Manager. Deaktivieren Sie diese und stellen Sie sicher, dass im Content-Manager Ihres Shops die Infoseiten

- Widerrufsbelehrung & Widerrufsformular
- AGB
-Privatsphäre und Datenschutz

aktiviert sind und den Status „sichtbar“ haben.