Inhaltsverzeichnis

    Video

    Von JTL-Wawi zu Gambio

    In diesem Video erklären wir Ihnen, wie Sie Daten von JTL-Wawi zu Gambio übertragen.

    Daten von JTL-Wawi zu Gambio übertragen

    Ihre Aufgabe/Ausgangslage

    Sie arbeiten bereits mit JTL-Wawi und haben dort einen Datenbestand aufgebaut. Jetzt möchten Sie einen leeren Gambio-Shop aufsetzen und diesen Shop über den JTL-Connector mit Ihrer JTL-Wawi verbinden. Im Anschluss möchten Sie einen Teilbereich Ihres Produktportfolios automatisiert aus JTL-Wawi heraus im Gambio-Shop anlegen lassen. Aus diesem Vorgehen lassen sich drei Teilschritte ableiten:

    Schritt 1: Connector an Gambio anbinden

    Hinweis: Je nachdem, welche Edition Sie gebucht haben, ist die Anzahl der Shops, die Sie über JTL-Connector anbinden können, möglicherweise beschränkt. Die JTL-Editionen im Überblick
    1. Installieren Sie sich einen neuen, leeren Gambio-Shop und ergänzen Sie alle für Ihre Zwecke notwendigen Funktionalitäten.
    2. Laden Sie sich einen aktuellen JTL-Connector für Gambio herunter (zum JTL-Kundencenter) und besorgen Sie sich einen gültigen Lizenzschlüssel für Ihre Shop-Domain (siehe Lizenzen).
    3. Öffnen Sie ein FTP-Programm.

      Steuern Sie denjenigen Ort an, an dem Sie Ihr Gambio-Instanz installiert haben. Übertragen Sie den entpackten JTL-Connector ins Startverzeichnis dieser Installation. Bitte achten Sie beim FTP-Upload darauf, die Connector-Dateien binär zu übertragen und nicht etwa im ASCII oder Text-Modus!

      Setzen Sie im Anschluss Schreibrechte für die Ordner config, db, logs.

    Zum Hintergrund:
    Das binäre Format sollte zur Übertragung von Dateien immer dann verwendet werden, wenn es sich nicht um reine Textdateien handelt (z. B. .txt, .html, .htm, .cgi). Ausführbare Programme, Textverarbeitungsdokumente, Datenbanken, Grafik- und Audio-Dateien (.bmp, .jpg, .exe, .zip etc.) sind Beispiele für Dateien, die im binären Modus übertragen werden sollten. Das Format sollte auch dann verwendet werden, wenn der Dateityp unbekannt ist oder nicht in z.B. Windows registriert wurde.

    Berechtigungen: Die im Screenshot markierten Ordner müssen eine Berechtigung von 755 bekommen.

    1. Geben Sie in Ihren Browser die URL Ihrer Connector-Installation ein, z.B. mein-online-shop.de/jtlconnector/install/. Die Seite JTL-Connector Konfiguration wird aufgerufen.
    1. Folgen Sie dem Hyperlink, der in der Fehlermeldung angezeigt wird. Sie gelangen in das Backend Ihres Gambio-Shops. Ändern Sie die Angaben wie unten beschrieben.

    Kundengruppencheck: von „nein“ auf „ja“ setzen

    1. Wenn Sie alle Fehler behoben haben erhalten Sie Zugang auf die vollständige Konfiguration-Anzeige und können weitere Einstellungen vornehmen. Wechseln Sie auf die Registerkarte Connector Konfiguration. Notieren Sie sich den Autorisierungstoken.

    JTL-Connector Konfiguration - Registerkarte: Connector Konfiguration

    Connector URL: Server-Pfad zu Ihrem Gambio-Shop. Wird evtl. selbst erkannt.


    Auth Token / Passwort: Sie benötigen ein „Erkennungsmerkmal“, durch das der JTL-Connector beide Systeme (JTL-Wawi und Shop-System) identifizieren und miteinander verbinden kann. Im Shop-System wird hierfür ein Autorisierungstoken generiert, welchen Sie später in JTL-Wawi als Passwort eintragen müssen. Notieren Sie sich sowohl die Connector-URL als auch das Passwort, Sie benötigen diese zur späteren Anbindung an JTL-Wawi.


    UTF-8 Konvertierung: Oftmals werden in xt-basierten Shops UTF8 Hacks und Themes verwendet, welche den serienmäßigen Zustand des Systems zugunsten einer zeitgemäßeren Zeichensatz-Kodierung aushebeln. Sollte der Connector nicht funktionieren oder sollten Probleme bei der Darstellung von Umlauten und Sonderzeichen auftreten, aktivieren Sie diese Option bitte.


    Datums-Grenze: Legen Sie hier bei Bedarf eine Datums-Grenze für Bestellungen fest. Wenn diese Einstellung gesetzt ist, werden nur Bestellungen abgeglichen die nach diesem Datum erfolgten. Wenn Sie diese Option verwenden, sollten Sie sicherstellen dass in Ihrer Datenbank-Tabelle „orders“ ein Index auf der Spalte „date_purchased“ gesetzt ist.

    1. Wechseln Sie auf die Registerkarte Standard Steuer-Rate. Wählen Sie denjenigen Steuersatz aus, welcher bei Ihnen die Standard-Steuerrate repräsentiert.
    1. Wechseln Sie auf die Registerkarte Status Zuordnung. Hier müssen Sie jedem Status in JTL-Wawi einen eindeutigen Status in Ihrem Gambio-Shop zuordnen.

      Haben Sie in Ihrem Shop-System noch keine vergleichbar differenzierte Status-Struktur angelegt, wechseln Sie bitte in den Administrationsbereich Ihres Shops und legen eine entsprechende Status-Struktur an. Lesen Sie dazu bitte auch den Exkurs zu den Lagerbeständen (siehe unten).ie auf die Registerkarte Standard Steuer-Rate. Wählen Sie denjenigen Steuersatz aus, welcher bei Ihnen die Standard-Steuerrate repräsentiert.

    Status aus JTL-Wawi in Gambio anlegen und zuordnen

    offen: Standard-Status von Gambio, entspricht dem Status „neue Bestellung eingegangen“ in JTL-Wawi


    in Bearbeitung: Bestellung wird verarbeitet


    versendet: Ware wurde versandt


    bezahlt: Bestellung gilt als bezahlt


    bezahlt und versendet: Bestellung gilt als bezahlt und Ware wurde versendet (abgeschlossen)


    storniert: Bestellung wurde zurückgezogen bzw. Auftrag wurde storniert

    1. Klicken Sie auf Speichern. Der Gambio-Shop ist jetzt an den JTL-Connector angeschlossen.
      Wichtig: Löschen Sie bitte unmittelbar anschließend den Ordner „Install“ per FTP aus Ihrem Connector-Verzeichnis, um Zugriffe von außen auf Ihr System zu verhindern!
    Klicken Sie auf Speichern. Der Gambio-Shop ist jetzt an den JTL-Connector angeschlossen.
    Wichtig: Löschen Sie bitte unmittelbar anschließend den Ordner „Install“ per FTP aus Ihrem Connector-Verzeichnis, um Zugriffe von außen auf Ihr System zu verhindern! Oder setzen Sie alternativ die Schreibrechte der folgenden Dateien zurück auf 664: Ordner install, Ordner jtlconnector > Datei: config.json

    Schritt 2: Connector an JTL-Wawi anbinden

    1. Installieren Sie JTL-Wawi neu oder legen Sie einen neuen leeren Mandanten an. Rufen Sie im Anschluss JTL-Wawi auf und melden Sie sich an.
    2. Das Shop-System Gambio pflegt standardmäßig einige besondere Kundengruppen. Stellen Sie sicher, auch in JTL-Wawi vergleichbare Kundengruppen anzulegen. Die Kundengruppen der beiden System werden später miteinander verknüpft.

    Kundengruppen aufeinander abstimmen: Kundengruppen anlegen in JTL-Wawi


    Gambio: Administrator (system-intern) | Gast | Neuer Kunde | Händler


    JTL-Wawi: Legen Sie ggf. vergleichbare Gruppen in der Kundenverwaltung an, z.B. Admin in Gambio | Gastbestellungen | Endkunden (standardmäßig vorhanden) | Händler (standardmäßig vorhanden)

    1. Klicken Sie auf Plattformen > Verkaufskanäle. Das Dialogfenster Verkaufskanalverwaltung öffnet sich. Tragen Sie hier die zuvor notierte Onlineshop-URL aus Schritt 1, Punkt 6 in das Feld Onlineshop-URL ein, sowie das zuvor notierte Passwort aus Schritt 1, Punkt 6 in das dafür vorgesehene Feld Passwort.

    Kontoname: Geben Sie den Namen Ihres Shops an, so wie er in JTL-Wawi geführt werden soll.


    Onlineshop-URL: Geben Sie hier die URL Ihres Onlineshops ein, gefolgt von „/jtlconnector/“. Beispiel: http://mein-online-shop.de/jtlconnector/


    JTL-Connector Token: Sie benötigen ein „Erkennungsmerkmal“, durch das der JTL-Connector beiden Systeme (JTL-Wawi und Shop-System) identifizieren und miteinander verbinden kann. Im Shop-System wird hierfür ein Autorisierungstoken generiert, welchen Sie in JTL-Wawi als Passwort eintragen müssen. Geben Sie also hier dasselbe Passwort ein, welches Sie auch in Ihrem Web-Shop zur Autorisierung angelegt haben, i.d.R. also den generierten Autorisierungstoken des Shop-Systems.


    Verbindung testen: Nachdem Sie alle Webserver-Angaben getätigt haben, müssen Sie die Verbindungs- und Lizenzfähigkeit Ihres JTL-Connectors testen (klicken Sie hierzu auf die Schaltfläche). Erst wenn der Test fehlerfrei verläuft, können Sie über die nachfolgende Schaltfläche den JTL-Connector konfigurieren.


    Auftragsnummern aus dem Shop verwenden: Aktivieren Sie diese Checkbox, um JTL-Wawi anzuweisen, die vom Shop generierte Bestellnummer als Auftragsnummer zu verwenden. Wenn Sie diese Funktion nicht aktivieren, erstellt JTL-Wawi für jede übernommen Bestellung eine neue Auftragsnummer. Bitte beachten Sie, dass Auftragsnummern immer einzigartig sein müssen.

    1. Es öffnet sich das Dialogfenster Shopkonfiguration. Nehmen Sie alle notwendigen Einstellungen vor: Zum Dialogfenster Shopkonfiguration.
    2. Bestätigen Sie Ihre Änderungen im Fenster Shopkonfiguration durch Klick auf Speichern.
    3. Wenn Sie alle Schritte bis hierhin erfolgreich durchführen konnten, wird jetzt der Button Testen wählen bzw. OK (rechts oben) freigegeben. Klicken Sie auf den Button, um die Connector-Anbindung in JTL-Wawi abzuschließen. Sie gelangen zurück zum Fenster Onlineshop-Anbindung. Hier finden Sie jetzt Ihren neuen Gambio-Shop aufgelistet. Schließen Sie auch dieses Fenster.

    Ihr Ergebnis:Sie haben jetzt Ihren Gambio-Shop mit Ihrer JTL-Wawi verbunden und die Schnittstelle sorgfältig eingerichtet. Sie sind jetzt bereit für den initialen Datenabgleich.

    Schritt 3: Der erste Datentransfer

    Ihre Aufgabe/Ausgangslage

    Sie möchten jetzt ausgewählte Kategorien (mitsamt aller zugeordneten Produkte) aus Ihrer JTL-Wawi in Ihren Gambio-Shop hochladen. Es sollen alle Artikelstammdaten sowie angelegte Bilddateien an den Gambio-Shop übermittelt werden.
    1. Entscheiden Sie, welche Kategorien Sie automatisiert in Ihren leeren Gambio-Shop hochladen möchten. Wählen Sie dazu die entsprechenden Kategorien aus und klicken Sie auf den Button Bearbeiten (unterhalb des Fensterbereichs Kategorie). Das Fenster Kategorie verwalten öffnet sich.
    1. Setzen Sie innerhalb der Registerkarte Allgemein im Fensterbreich Onlineshop Aktiv den Haken Aktiv für Ihren Gambio-Shop. Speichern Sie die Einstellung.
    WICHTIG: Nehmen Sie diese Einstellung für jede Kategorie vor, die Sie jetzt in Ihren Gambio-Shop hochladen möchten!
    1. Klicken Sie in der Menüleiste auf Onlineshop > Onlineshop-Abgleich. Das Fenster Onlineshop-Abgleich öffnet sich.
    2. Klicken Sie auf den Button Starten. Der Onlineshop-Abgleich für Ihren Gambio-Shop wird gestartet. Sie können den Fortschritt des Vorgangs mitverfolgen:
    1. Prüfen Sie nach Abschluss an den Abgleich Ihre Datenübermittlung! Gehen Sie Ihre Warnungen und Fehlermeldungen durch. Anschließend können Sie das Abgleichsfenster schließen.

    Ihr Ergebnis: Sie haben jetzt ausgewählte Kategorien (inklusive aller zugeordneten Produkte) aus JTL-Wawi voll automatisiert über einen Webshop-Abgleich in Ihren Gambio-Webshop hochgeladen. Ihr Gambio-Shop ist nun befüllt:

    Video

    Von JTL-Wawi zu Gambio

    In diesem Video erklären wir Ihnen, wie Sie Daten von JTL-Wawi zu Gambio übertragen.