Wechseln zu: Navigation, Suche
(Weitergeleitet von Fall 1: Daten von Shopware nach JTL-Wawi übertragen)

Shopware-Connector - Fall 1: Aktiver Shop


Verwandte Themen


Ihr Aufgabe / Ausgangslage

Sie arbeiten mit einem Shopware-Shop und haben dort bereits einen Datenbestand aufgebaut. Jetzt möchten Sie unser Warenwirtschaftssystem JTL-Wawi an Ihren Shopware-Shop anschließen. Dazu setzen Sie eine leere JTL-Wawi auf und verbinden diese Wawi über den JTL-Connector mit Ihrem Shopware-Shop. Im Anschluss möchten Sie den gesamten Datenbestand Ihres Shopware-Shops automatisiert in Ihre JTL-Wawi übertragen.

Systemvoraussetzungen

Um einen JTL-Connector einzusetzen stellen Sie bitte sicher, dass Ihre Arbeitsumgebung (Ihr Webserver) folgende Systemvoraussetzungen erfüllt:


PHP: 5.4
Damit Ihr Webserver mit unserem JTL-Connector korrekt kommunizieren kann, muss auf Ihrem Webserver mindestens PHP 5.4 zur Verfügung stehen. Bei der Installation des JTL-Connectors werden diese Mindestvoraussetzungen auch geprüft. Fällt die Prüfung negativ aus, wenden Sie sich bitte an Ihren Serveradministrator.


SQLite: sqlite3-Extension
Hierbei handelt es sich um eine PHP-Erweiterung. Die Erweiterung wird benötigt um mit SQLite3-Datenbanken zu arbeiten.


php5-json
Hierbei handelt es sich ebenfalls um eine PHP-Erweiterung. Sie ermöglicht dem JTL-Connector die Nutzung des JSON-Datenformats.


ZipArchive PECL zip: 1.1.0
Hierbei handelt es sich ebenfalls um eine PHP-Erweiterung. Sie wird benötigt zum Arbeiten mit ZIP-Archiven im JTL-Connector-Umfeld.

Schritt 1: Connector an Shopware anbinden

Sichern Sie die Datenbank Ihres aktiven Shopware-Shops, bevor Sie mit den folgenden Schritten fortfahren. Zur Einführung: Abschnitt Datenbanksicherung.
Laden Sie sich einen aktuellen JTL-Connector für Shopware herunter (siehe Downloads) und besorgen Sie sich eine gültigen Lizenzschlüssel für Ihre Shop-Domain (siehe Lizenzen).
Öffnen Sie ein FTP-Programm. Steuern Sie den Ort an, an dem Sie Ihr Shopware-Instanz installiert haben. Übertragen Sie den entpackten JTL-Connector in den Unterordner /engine/Shopware/Plugins/Local/Frontend. 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.

Jtl-connector-shopware-02-Z-connector-upload.jpg

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.

Jtl-connector-shopware-02b-Z-connector-schreibrechte.jpg

Wechseln Sie in das Backend Ihres Shopware-Shops. Über den Menüpunkt Einstellungen > Plugin Manager (Kurzbehfehl: Strg+Alt+P) erreichen Sie den Plugin Manager. Bei erfolgreichem Upload des Connectors wird Ihnen jetzt der Connector innerhalb des Plugin Managers > Fensterbereich: Deinstalliert unter dem Namen JTL Shopware Connector aufgelistet.

Jtl-connector-shopware-03-Z-connector-upload-erfolgreich.jpg

Klicken Sie auf das Pluszeichen (Icon), um den Connector zu installieren. Es öffnet sich die Plugin-Verwaltung für den JTL Shopware Connector.

Jtl-connector-shopware-04-Z-connector-plugin-installieren-aktivieren.png

Aktivieren: Über diesen Button müssen Sie das Plugin aktivieren.

HINWEIS: Die Installation und Aktivierung des Plugins erfordert eine Neu-Initialisierung einiger Caches. Bestätigen Sie entsprechende Aufforderungen während des Dialogs.

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 den Token.

Klicken Sie auf Speichern. Der Shopware-Shop ist jetzt an den JTL-Connector angeschlossen.

 

Bereiten Sie die Bestellungen in Ihrem Shopware-Shop für den initialen Datentransfer vor, um die korrekte Verbuchung von Lagerbeständen sicherzustellen.

Sie können diesen Schritt auch später durchführen, spätestens aber, bevor Sie den ersten Onlineshop-Abgleich mit echten Daten durchführen (vgl. Initialer Datentransfer).

Exkurs: Lagerbestandsbuchungen

Lagerbestände in Shop & JTL-Wawi

Wenn Sie einen Webshop-Abgleich starten, überträgt der JTL-Connector zuerst die Artikeldaten aus Ihrem Shop-System, inklusive der dort hinterlegten Lagerbestände. In JTL-Wawi werden diese als "Realbestände" in den Artikel eingebucht.

Über vorhandene und verfügbare Lagerbestände in JTL-Wawi:
Der vorhandene Lagerbestand (in JTL-Wawi nur "Lagerbestand" genannt) ist der reale Bestand in Ihrem Lager. Verfügbarer Lagerbestand hingegen bedeutet: Vorhandener Lagerbestand minus durch Bestellungen reservierter Lagerbestand. Der verfügbare Lagerbestand ist derjenige Lagerbestand, den JTL-Wawi an angeschlossene Verkaufsplattformen übermittelt.

Im zweiten Schritt werden die Bestellungen aus Ihrem Shop-System übertragen.

Über Bestellungen & Aufträge in JTL-Wawi:
In JTL-Wawi heißen Bestellungen Aufträge und lösen je nach Bearbeitungsstand bestimmte Prozesse aus. Beispielsweise lösen offene Aufträge erst einmal nur eine Reservierung von Lagerbeständen aus, während Aufträge, die in den Auslieferungsprozess übergehen, die Reservierung in eine reale Lagerbestandbuchung umwandeln.

Demnach werden bei einem Webshop-Abgleich Ihre eingehenden Shop-Bestellungen zuerst in Aufträge umgewandelt und im Anschluss entsprechend Ihres Bearbeitungsstandes verbucht:

Bestellstatus: offen / nicht versandt:
Bestellungen aus Ihrem Shop-System, die einen Status wie offen oder nicht versandt haben, werden übertragen und der Lagerbestand in diesen Bestellungen wird dem zuvor übertragenden Beständen (also denen aus den Artikeln) wieder hinzugebucht (zurückgebucht). Im Anschluss wird für die bestellten Mengen eine Reservierung vorgenommen, weil dies den internen Verbuchungsvorgängen von JTL-Wawi entspricht. Damit wären wir beim eingangs erwähnten Verfügbaren Lagerbestand. Und erst wenn Ihre Aufträge nun in den Auslieferungsprozess übergehen, werden diese Reservierungen in tatsächliche Lagerbestandsbuchungen umgewandelt.


Bestellstatus: abgeschlossen / versandt
Bestellungen aus Ihrem Shop-System, die einen Status wie versandt oder abgeschlossen haben, werden zwar übertragen, aber als komplett ausgelieferte Aufträge behandelt und verbucht. Für abgeschlossene Aufträge wird selbstverständlich kein Lagerbestand erneut reserviert oder gebucht, da die Ware ja bereits aus dem Lager entnommen und versendet wurde.


Beispiel
In Ihrem Shop-System hat der Artikel A den Bestand 5. Es existieren außerdem 2 offene Bestellungen, die den Artikel insgesamt 3x anfragen. Führen Sie jetzt einen Webshop-Abgleich durch, so wird in JTL-Wawi für den Artikel A ein tatsächlicher Lagerbestand von 8 eingebucht - 5x aus den Artikeldaten und 3x aus Bestellungen. Im Anschluss nimmt JTL-Wawi für die 2 offenen Bestellungen 3 Reservierungen des Artikel vor. Der verfügbare Lagerbestand ist damit 8 - 3 = 5. Beim nächsten Webshop-Abgleich wird für den Artikel A ein korrekter Bestand von 5 an Ihr Shop-System übermittelt.

Wir empfehlen: Status vor dem Abgleich korrekt setzen!
Idealerweise prüfen Sie vor dem ersten Webshop-Abgleich die Status Ihrer Bestellungen: Haben alle Bestellungen (offene und abgeschlossene) einen aussagekräftigen und korrekten Status zugewiesen bekommen, der mit den Status in JTL-Wawi verknüpft werden kann?

Wenn Ihr Shop-System es darüber hinaus ermöglicht, beliebig viele Status anzulegen und die Benennung der Status an die von JTL-Wawi anzupassen, so empfehlen wir Ihnen dieses Vorgehen. Wenn Sie Ihre Status VOR dem initialen Datentransfer korrekt einpflegen, werden Sie keine fehlgebuchten Aufträge und Lagerbestände haben, die Sie sonst im Nachhinein mit mehr Aufwand korrigieren müssen.


Weitere Hilfeseiten zum Thema Lagerbestände:
Über die vielfältigen Möglichkeiten, Lagerbestände nachzuhalten sowie Ihren Versand zu organisieren, können Sie sich hier informieren:

Sofern erforderlich, deaktivieren Sie jetzt den Wartungsmodus Ihres Shopware-Shops. Hintergrund: Der Produktivbetrieb des Connectors funktioniert nicht im Wartungsmodus!

Schritt 2: Connector an JTL-Wawi anbinden

Installieren Sie sich JTL-Wawi neu oder legen Sie einen neuen leeren Mandanten an (Wie installiere ich JTL-Wawi?).
Öffnen Sie im Anschluss JTL-Wawi und loggen Sie sich ein.
Das Shop-System Shopware pflegt standardmaßig zwei Kundengruppen. Legen Sie in JTL-Wawi vergleichbare Kundengruppen an. Die Kundengruppen der beiden System werden später miteinander verknüpft.

Kundengruppen aufeinander abstimmen


Shopware: Händler | Shopkunden


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


Klicken Sie auf Onlineshop > Onlineshop-Anbindung > Anlegen. Es öffnet sich das Fenster Onlineshop-Anbindung. Nehmen Sie hier sorgfältig alle notwendigen Einstellungen vor (vgl. Dokumentation in der Tabelle unten):

Das Dialogfenster „Onlineshop-Anbindung“

Jtl-Shop-Anbindung-001-D-Onlineshop-Anbindung.png

Bereich A: Allgemeine Einstellungen

Lizenzschlüssel: Dieses Feld wird nur für JTL-Shop benötigt. Den Lizenzschlüssel erhalten Sie in einer E-Mail von JTL. Falls Sie einen JTL-Connector verwenden, ist es nicht nötig. Die Lizenzierung nehmen Sie wie unter Lizenz erwerben beschrieben vor.


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


Firma: In JTL-Wawi können Sie mehr als eine Firma führen. Geben Sie hier an, für welche Firma Ihr Shop Umsätze erwirtschaften soll.


Wurzelkategorie: Anhand einer Wurzelkategorie können Sie festlegen, welche Kategorien und Produkte aus JTL-Wawi zum angebundenen Onlineshop übertragen bzw. abgeglichen werden sollen. Dabei werden alle unterhalb der Wurzelkategorie liegenden Kategorien berücksichtigt.

HINWEIS: Alle Kategorien und Produkte außerhalb dieser Wurzelkategorie werden nicht an den Onlineshop übertragen. ABER: Wenn Sie Kategorien oder Produkte im Nachhinein nach außerhalb verschieben, dann werden diese beim nächsten Onlineshop-Abgleich aus Ihrem Onlineshop entfernt!

Sofern Sie über den Onlineshop ausschließlich Kategorien/Produkte bedienen, die sonst in keinem anderen Onlineshop, den Sie mit der JTL-Wawi pflegen, geführt werden, müssen Sie hier keine Angaben machen. Die Sichtbarkeiten regeln Sie dann wie gewohnt über die entsprechenden Checkboxen „Onlineshop Aktiv“ in den Artikel- bzw. Kategoriedetails von JTL-Wawi.

Anders verhält es sich, wenn Sie bestimmte Kategorien/Produkte nicht nur über einen Onlineshop, sondern in mehreren anzeigen möchten. Insbesondere, wenn Sie einen Onlineshop per JTL-Connector und einen JTL-Shop an JTL-Wawi anbinden, müssen die Unterschiede der Kategoriestruktur und des -aufbaus der jeweiligen Shopsysteme unbedingt berücksichtigt werden!


Übertragung zum Onlineshop sperren: Aktivieren Sie dieses Kästchen, wenn Sie bei einem Onlineshop-Abgleich keine Daten für diesen Shop übertragen möchten.


Onlineshop-Auftragsnr. in Aufträgen benutzen: Ihr Shop-System legt beim Kauf eines Kunden eine Auftragsnummer an. Diese shop-spezifische Nummer können Sie in JTL-Wawi weiterverwenden.


Onlineshop-Bestellungen in Angebote wandeln: Bestellungen aus Ihren Onlineshops werden, wenn Sie aus dem Shopsystem übernommen wurden, automatisch zu Aufträgen. Falls Sie ohne Lagerbestand arbeiten, können Sie diese Bestellungen auch zuerst zu Angeboten werden lassen.

Bereich B: Webserver-Angaben

Onlineshop-URL: Geben Sie hier die URL Ihres Onlineshops ein. Falls Sie einen Onlineshop per JTL-Connector anbinden, fügen Sie anschließend "/jtlconnector/" hinzu.
Beispiel: http://mein-online-shop.de/jtlconnector/


Benutzername: Dieses Feld ist nur relevant, wenn Sie JTL-Shop anbinden. Geben Sie hier den Benutzernamen an, der Ihnen von JTL per E-Mail mitgeteilt wurde. Für die Verknüpfung mit Shop-Systemen von Drittanbietern kann das Feld freigelassen werden.


Passwort: Geben Sie für JTL-Shop hier das Passwort ein, das Ihnen von JTL mitgeteilt wurde bzw. – falls Sie es geändert haben – das geänderte Passwort. Für per JTL-Connector verbundene Onlineshops benötigen Sie 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 in JTL-Wawi als Passwort eintragen müssen. Geben Sie also hier dasselbe Passwort ein, welches Sie auch in Ihrem Onlineshop zur Autorisierung angelegt haben, i. d. R. also den generierten Autorisierungstoken des Shop-Systems.


Verbindung testen / Lizenz aktivieren: Nachdem Sie alle Webserver-Angaben getätigt haben, müssen Sie die Verbindungs- und Lizenzfähigkeit testen (klicken Sie hierzu auf die Schaltfläche). Falls Sie einen JTL-Connector verwenden, kann die nachfolgende Schaltfläche erst nach einem erfolgreichen Test aktiviert werden.


Connector konfigurieren: Diese Schaltfläche ist nur relevant, wenn Sie einen JTL-Connector verwenden. Die Schaltfläche öffnet das Dialogfenster Shop-Konfiguration.

Bereich C:JTL-Shop Module aktivieren

Die Schaltfläche öffnet das Dialogfenster JTL-Shop Modul aktivieren. Hier können Sie über die Schaltfläche Neues Modul aktivieren einen Lizenzschlüssel für Module von JTL-Shop eingeben. Diesen müssen Sie ggf. erst über den JTL-Store kostenpflichtig erwerben.

Bereich D: Währung / Sprachen / Kundengruppen

Währung: In JTL-Wawi wird eine Währung als "Standard-Währung" geführt. Geben Sie hier an, welche Währung in Ihrem Shop-System diesem Standard entspricht, z. B. Euro. Führen Sie ohnehin nur eine Währung pro Shop-System, verwendet JTL-Wawi diese Währung automatisch als Standard-Währung.


Sprachen: Hier finden Sie alle Sprachen, die Sie in JTL-Wawi angelegt haben. Aktivieren Sie die Sprachen, die Sie in Ihrem Onlineshop anbieten möchten. Eine der Sprachen muss dabei als Standardsprache markiert werden. Diese wird beim ersten Aufruf des Onlineshops angezeigt.


Kundengruppen: In JTL-Wawi wird eine Kundengruppe als "Standard-Kundengruppe" geführt. Wählen Sie diejenige Kundengruppe, deren Preise in Ihrem Shop angezeigt werden sollen, wenn ein Besucher Ihre Website besucht, ohne sich anzumelden.

Bereich E: Verknüpfungen löschen

Onlineshopdaten zurücksetzen: Achtung - nutzen Sie anstelle dieser Funktion für JTL-Connectoren bitte die vergleichbare Funktion im Dialogfenster: Shopkonfiguration > Registerkarte: Zurücksetzen!

Während der Verwendung eines Shop-Systems zusammen mit JTL-Wawi wird eine Mapping-Tabelle angelegt, die es den Systemen ermöglicht, effizient (d. h. "daten-sparsam") zu kommunizieren. In besonderen Fällen kann es erforderlich werden, diese Mapping-Tabelle zurückzusetzen und von neuem aufzubauen. Erwägen Sie diese Möglichkeit immer dann, wenn Sie vermuten, dass die Integrität Ihrer Daten gefährdet wurde.

Beispiel: Sie möchten im laufenden Betrieb ein Sicherungskopie vom gestrigen Tage einspielen. Wenn während dieser Zeit Kunden in Shop-System und JTL-Wawi angelegt und gelöscht wurden, könnte dieselbe ID für zwei unabhängige Datensätze verwendet worden sein, die nun fälschlicherweise durch die Mapping-Tabelle miteinander verbunden werden. Setzen Sie in diesem Fall die Mapping-Tabelle zurück, bevor Sie eine Sicherheitskopie einspielen.

Wichtig: Besonderheiten beim Parallelbetrieb von Shopware-Connector und JTL-Shop mit identischer Kategoriestruktur

Der Shopware-Shop benötigt eine (nicht sichtbare) übergeordnete Wurzelkategorie, um die von uns gewünschten (sichtbaren) Hauptkategorien im Shop anzuzeigen. Der JTL-Shop hingegen benötigt eine solche übergeordnete Wurzelkategorie nicht. Für ihn sind quasi alle in JTL-Wawi angelegten Oberkategorien der 1. Ebene entsprechende Wurzelkategorien, die im JTL-Shop angezeigt werden.

Das bedeutet, dass Sie bei einem Parallelbetrieb identischer Kategorien auf beiden Systemen wie folgt vorgehen müssen:

1. Vor jeder Änderung: Datensicherung von JTL-Wawi und Shopsystem.
2. Einrichtung einer zusätzlichen „Shopware-Root-Kategorie“ in JTL-Wawi.
3. Hinterlegung dieser „Shopware-Root-Kategorie“ im Admin Ihres Shopware-Shops. Für den Shopware-Shop hinterlegen Sie KEINE Wurzelkategorie in JTL-Wawi.

4. Festlegung der „Shopware-Root-Kategorie“ als Wurzelkategorie in den Onlineshopeinstellungen in JTL-Wawi für Ihren JTL-Shop.

Name Onlineshop: 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 Webshops ein, gefolgt von "/jtlconnector/". Beispiel: http://mein-online-shop.de/jtlconnector/


Passwort: 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 / Lizenz aktivieren: Nachdem Sie alle Webserver-Angaben getätigt haben, müssen Sie die Verbindungs- und Lizenzfähigkeit Ihres JTL-Connectors testen (klicken Sie hierzu auf den Button). Erst wenn der Test fehlerfrei verläuft, können Sie über den nachfolgenden Button den JTL-Connector konfigurieren.

Klicken Sie im aktuellen Dialogfenster auf den Button Konfiguration. Es öffnet sich das Dialogfenster Shop-Konfiguration. Nehmen Sie alle notwendigen Einstellungen vor:

Jtl-connector-shopware-shopkonfiguration-registerkarte-konfiguration.png

Registerkarte: Konfiguration

A: Kundengruppenzuordnung

Onlineshop - Wawi - Standard: Verknüpfen Sie die Kundengruppen Ihres Shop-Systems mit denen, die Sie zuvor in JTL-Wawi angelegt haben. Jede Kundengruppe kann nur genau einmal zugeordnet werden (1:1-Verknüpfung). Als Standard wird diejenige Gruppe angezeigt, welche Sie bei der Einrichtung des Connectors in Ihrem Shop-System angegeben hatten.

B: Synchronisation

Hier werden beide Wege des Datentransfers konfiguriert: Der Download von Daten aus Ihrem Shop-System in die JTL-Wawi sowie der Upload von Daten aus der JTL-Wawi in Ihr Shop-System. Diese Einstellungen richten sich nach Ihren aktuellen Bedürfnissen, d.h. ob Sie gerade ein neues Shop-System aufsetzen möchten (vgl. Abschnitt: Initaler Datentransfer) oder den alltäglichen Abwicklungsprozess (vgl. Abschnitt: Laufender Betrieb) steuern möchten:


Daten aus dem Onlineshop importieren: Aktivieren Sie diese Option, wenn Sie bei Ihrem nächsten Onlineshop-Abgleich Daten aus Ihrem Shop-System in Ihre JTL-Wawi übertragen möchten. Sie können den Import genauer differenzieren (s.u.).


Artikel / Kategorien / Bilder: Artikel mit Bildern und Kategorien importieren Sie idealerweise nur einmalig beim initialen Datentransfer (Fall B: Shop-System aktiv).


Vorhandene Artikel aktualisieren: Regelt den Umgang mit Artikel, die unter derselben Artikelnummer in Shop-System und JTL-Wawi vorkommen. Aktiviert: Shop-Artikel überschreiben JTL-Wawi-Artikel. Deaktiviert: Shop-Artikel werden mit JTL-Wawi-Artikel verknüpft und die Shop-Artikel beim nächsten Abgleich überschrieben.


Aufträge / Kunden: Aufträge und Kunden importieren Sie initial sowie regelmäßig im laufenden Betrieb, auch nachdem JTL-Wawi zum führenden System geworden ist.


Daten zum Onlineshop senden: Aktivieren Sie diese Option, wenn Sie bei Ihrem nächsten Onlineshop-Abgleich Daten aus Ihrer JTL-Wawi in Ihr Shop-System übertragen möchten. Sie können den Sendungsumfang genauer festlegen (s.u.).


Artikel komplett / Artikel eingeschränkt (Preise, Bestände): Produkte/Artikel pflegen Sie in JTL-Wawi und senden diese Änderungen regelmäßig und i.d.R. komplett an Ihr Shop-System.

HINWEIS: In Ausnahmefällen, wenn Sie z.B. aufwändig ausgestaltete Produktbeschreibungen entworfen haben, sollten Sie den Re-Import solcher Datenfelder vorab gut testen. Nicht immer kann JTL-Wawi ein solches Layout ebefalls abbilden. Wählen Sie für derlei Fälle eine eingeschränkte Übermittlung nur der zentralen, warenwirtschaftlichen Daten wie Preise und/oder Lagerbestände.


Bilder: Bilddateien sollen zwar sowohl initial (Fall B) als auch regelmäßig an Ihr Shop-System übertragen werden, können jedoch die Übertragung deutlich beanspruchen.


In der Wawi gelöschte Bilder auch im Shop löschen: Wenn Sie im Dialogfenster Artikeldetails > Registerkarte: Bilder ein Bild löschen oder deaktivieren, dann wird mit dieser Option das Shop-System entsprechend nachgezogen.

C: Steuereinstellungen


Prüfen Sie die Steuereinstellungen auf Vollständigkeit. Jedem Steuersatz in Ihrem Web-Shop muss auch ein Steuersatz in JTL-Wawi entsprechen!


Steuersatz: Steuersätze, die für Ihr Shop-System bzw. in JTL-Wawi gepflegt werden sollen.


Priorität: [interne Kennzahl; hier nicht relevant]


Jtl-connector-shopware-shopkonfiguration-registerkarte-synchronisierungsoption.png


Registerkarte: Synchronisationsoptionen


Objekte: Objekte sind funktionale Einheiten, mit denen sowohl Ihr Shop-System als auch Ihre JTL-Wawi arbeiten, i.d.R. sind das Artikel/Produkte, Aufträge, Bilder, Kategorien und Kunden. In manchen Systemen auch Hersteller, Lieferscheine oder Merkmale. Auf dieser Registerkarte finden Sie, abhängig von Ihrem Shop-System, eine vollständige und aktuelle Übersicht zur Übertragbarkeit einzelner Objekte (d. h. deren "Synchronisierbarkeit"). Ein Haken bedeutet, dass der Datentransfer in angegebener Richtung und Weise möglich ist:

Empfangen: Objekt (z. B. Artikel) kann aus dem Shop-System in JTL-Wawi importiert werden.
Senden: Objekt (z. B. Artikel) kann aus JTL-Wawi in Ihr Shop-System hochgeladen werden.
Löschen: Objekt (z. B. Artikel) kann von JTL-Wawi aus in Ihrem Shop-System gelöscht werden.


Jtl-connector-shopware-shopkonfiguration-registerkarte-funktionen.png


Registerkarte: Funktion


Shop-Funktionen und Stammeinstellungen: Neben der Synchronisierbarkeit (s.o.) gibt es weitere, zentrale Funktionen und Einstellungen. Auf dieser Registerkarte können Sie den aktuellen Leistungsumfang für Ihr Shop-System nachschlagen. Ein Haken bedeutet, dass eine aufgeführte Funktion umgesetzt werden konnte.

Beispiel Variationskombinationen: Ist ein Haken vorhanden, unterstützen sowohl JTL-Wawi als auch Ihr Shop-System das Anlegen und Pflegen von Variationskombinationen. Der JTL-Connector, der diese beiden Systeme verbindet, kann entsprechend Variationskombinationen übertragen.


Jtl-connector-shopware-shopkonfiguration-registerkarte-zuruecksetzen-hilfe.png

Zurücksetzen: Durch Klick auf diese Schaltfläche werden alle aktuellen Daten (d.h. alle Kategorien, Artikeldaten, aktuelle wie abgeschlossene Bestellungen, Kundendaten und Bilder) - so wie sie aktuell in Ihrem Shop-System vorliegen - erneut nach JTL-Wawi übertragen. Bei Unterschieden zu Datensätzen, die bereits zu einem früheren Zeitpunkt in JTL-Wawi importierten wurden, überschreiben die aktuellen Shop-Daten die Daten in JTL-Wawi. Eine Ausnahme bilden Bestellungen: Existiert eine Bestellung bereits in JTL-Wawi, dann wird diese Bestellung nicht erneut importiert.

Verwenden Sie diese Funktionalität beispielsweise, nachdem Sie eine Sicherungskopie Ihrer Datenbank eingespielt haben und JTL-Wawi wieder auf den gleichen Stand mit Ihrem Shop-System bringen möchten.

Jtl-connector-shopware-shopkonfiguration-registerkarte-uebertragungsparameter.png

Auf der Registerkarte Übertragungsparameter können Sie den Transfer Ihrer Daten optimieren. Dies ist insbesondere beim initialen Datentransfer von Bedeutung, aber auch im Alltag, wenn Sie häufiger große Datenmengen (z.B. große, hochauflösende Bilder) in Ihr Shop-System zu übertragen haben. Je nach Serverkonfiguration eignen sich andere Paketgrößen, um einen möglichst reibungslosen Datenaustausch zwischen den Systemen zu erreichen.


Artikel / Paketgröße: Geben Sie hier an, wie viele Artikel pro Upload-Paket übertragen bzw. aktualisiert werden sollen (ohne Bilder).


Bilder / Paketgröße / Max. MB: Geben Sie hier an, wie viele Bilder bzw. Megabyte pro Upload-Paket maximal übertragen werden sollen.


Shop-Serverinfo: Hier werden Ihnen die aktuellen Server-Einstellungen Ihres Shop-Systems angezeigt. Anhand dieser Kennzahlen können Sie ganz gut einschätzen, ob die Server-Limits evtl. zu niedrig eingestellt sind, um einen weitestgehend reibungslosen Datenaustausch im Alltag zu gewährleisten.

Bestätigen Sie Ihre Änderungen im Fenster Shopkonfiguration durch Klick auf Speichern. Sie gelangen zurück zum Fenster Onlineshop-Anbindung.
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 Übersicht Ihrer Onlineshops. Hier finden Sie jetzt Ihren neuen Shopware-Shop aufgelistet.

Sie haben jetzt Ihren Shopware-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 Ausgangslage / Aufgabe:
Sie haben den JTL-Connector installiert und konfiguriert. Jetzt möchten Sie den gesamten Datenbestand aus Ihrem Shopware-Shop in JTL-Wawi importieren. Sofern vorhanden, wird der JTL-Connector Ihr Kategorienverzeichnis, Ihre Produktdaten wie z.B. Beschreibungen und Bilder, Ihre Kunden-, Hersteller- und Lieferantendaten sowie Bestellungen und Lagerbestände übertragen.

Und so gehen Sie vor: Teilschritt 3

Machen Sie sich klar, dass Sie die Führung Ihrer Systeme wechseln! Damit sind Veränderungen in Ihren täglichen Arbeistroutinen zu erwarten.

Zum Hintergrund:


JTL-Wawi als führendes System
Sie nutzen derzeit Ihren Shopware-Shop, um viele zentrale Daten zu pflegen. Nachdem Sie den Datenbestand in JTL-Wawi übertragen haben, sollten Sie Änderungen am Datenbestand nicht mehr aus Ihrem Shopware-Backend heraus vornehmen. Stattdessen wird von nun an Ihre JTL-Wawi führen (vgl. auch Abschnitt Der laufender Betrieb)!

Wir empfehlen Ihnen deshalb, dass Sie sich bereits vor der Übertragung Ihrer Daten mit den zentralen Funktionen von JTL-Wawi auseinandergesetzt haben und dass Sie insbesondere diejenigen Arbeitsabläufe in JTL-Wawi durchführen können, welche Sie erwartungsgemäß während Ihrer nächsten Arbeitstage brauchen werden. Denken Sie auch daran, ggf. Mitarbeiter über die neuen Abläufe zu informieren und einzuarbeiten.


Probetransfer und Produktiv-Betrieb
Bei größeren Datenmengen kann die Übertragung der Daten selbst sowie deren anschließende Überprüfung einige Zeit in Anspruch nehmen (vgl. Abschnitt Datenbanksicherung). Beispielsweise wird der JTL-Connector alle Bestellungen, die auch in Ihrem Shopware-Shop vorliegen - d.h. auch die archivierten, abgeschlossenen Bestellungen (!) - in Ihre JTL-Wawi übertragen. Betreiben Sie Ihren Shop schon viele Jahre, kann dieser Archivbestand entsprechend umfangreich sein.

Wir empfehlen Ihnen deshalb, sich eine für Ihre Gegebenheiten angemessene Übertragungs-, Prüfungs- und Einarbeitungszeit zu reservieren und auf jeden Fall eine Datenbanksicherung beider Systeme durchzuführen. Idealerweise testen Sie den initialen Datentransfer in einem Probedurchlauf und prüfen Ihre Daten sorgfältig auf Vollständigkeit. Erst wenn der Probetransfer zufriedenstellend vollzogen werden konnte, können Sie im Anschluss den Produktiv-Betrieb mit einem erneuten initialen Datenabgleich (in eine neue, leere JTL-Wawi) aufnehmen. Auf diese Weise kann der Wechsel für Sie reibungslos stattfinden.


Hinweis: Nehmen Sie ggf. die Hilfe von einem unserer Servicepartner in Anspruch, wenn Sie sich bezüglich der technischen Umsetzung Unterstützung wünschen.


Öffnen Sie Ihre JTL-Wawi, um mit dem initialen Datentransfer zu beginnen. Klicken Sie in der Menüleiste auf Onlineshop > Onlineshop-Abgleich. Das Fenster Onlineshop-Abgleich öffnet sich.

Jtl-connector-shopware-jtl-wawi-webshopabgleich-starten.png


Erläuterungen zum Bild:


Zusammenfassungen anzeigen: Markieren Sie die Checkbox, wenn Sie am Ende des Webshop-Abgleichs eine Zusammenfassung der übertragenen Daten angezeigt bekommen möchten.


Klicken Sie auf den Button Starten. Der Onlineshop-Abgleich für Ihren Shopware-Shop wird gestartet. Sie können den Fortschritt des Vorgangs mitverfolgen:

Jtl-connector-shopware-jtl-wawi-onlineshopabgleich-registerkarte-abgleich.png


Erläuterungen zum Bild:


Fensterbereich Kategorien (links oben): Sie sehen den noch leeren Kategorienbaum Ihrer JTL-Wawi. Nach erfolgreichen Abgleich werden Sie hier die Kategorienstruktur Ihres Shopware-Shops gespiegelt finden.


Dialogfenster Onlineshop-Abgleich: In diesem Fenster können Sie den Übertragungsfortschritt live verfolgen. Sie sehen, wie zahlreiche Bestandsdaten empfangen werden konnten.


Prüfen Sie nach Abschluss der Übertragung den Erfolg Ihres Datentransfers.

Vergleichen Sie z.B. die Kennzahlen (=Mengen) der übertragenen Kategorien, Produkte, Bilder usw. mit den Kennzahlen aus Ihrem Shopware-Shop.

Gehen Sie ggf. auch die Warnungen und Fehlermeldungen durch, die im Abgleichsdialog aufgeführt werden. Anschließend können Sie das Abgleichsfenster schließen.

Zum Hintergrund:


Community Edition (Standard-Auslieferung)
Ihr JTL-Connector ist so konzipiert worden, dass jegliche Datenfelder und -strukturen des Shopware-Shops (d.h. der Standard-Auslieferung der Community Edition) vollständig übertragen und in JTL-Wawi angelegt werden können. In der Regel wird JTL-Wawi das leistungsstärkere der beiden System sein, sofern es die Datenhaltung und Weiterverarbeitung der Daten betrifft. Das heißt, Sie werden die allermeisten Prozesse, die Sie mit Ihrem Shopware-System bisher durchführen konnten, auch in Ihrer JTL-Wawi durchführen können. Ausnahmen bilden z.B. die Einkaufswelten, die Sie auch weiterhin im Shopware-Backend administrieren müssen.


Shop-Erweiterungen
Datenfelder aus Shop-Erweiterungen (sog. Extensions) und implementierte, strukturelle Besonderheiten, die über den Standardumfang Ihres Shop-Systems hinausgehen, können jedoch nicht ohne Weiteres in JTL-Wawi übertragen werden (vgl. Abschnitt Einschränkungen).

Beachten Sie:
Daten aus Shop-Erweiterungen werden nicht übertragen und Sie erhalten darüber auch keine Fehlermeldungen, denn Ihr JTL-Connector hat von diesen Erweiterungen keine Kenntnis!

Wenn Sie aber die Datenfelder Ihrer Shop-Erweiterungen kennen, können Sie viele dieser Daten dennoch importieren und pflegen, indem Sie das Event-Systems des Connectors einsetzen (vgl. hierzu auch den Abschnitt Erweiterbarkeit). Nehmen Sie hierfür ggf. die Unterstützung eines JTL-Servicepartners in Anspruch.


Überprüfen Sie jetzt den erfolgreichen Import Ihrer Daten im Detail.

Wechseln Sie zunächst in die Produktverwaltung: Ist der Kategorienbaum korrekt angelegt worden? Konnten alle Produktdaten und Variationskombinationen vollständig und ohne Fehler übertragen werden?

Jtl-connector-shopware-jtl-wawi-onlineshopabgleich-erfolgreich-uebertragen.png


Erläuterungen zum Bild:


Sie können in unserem Beispiel erkennen, dass sowohl der Kategorienbaum, die zugehörigen Artikel als auch Variationskombinationen fehlerfrei aus Ihrem Shopware-Shop übertragen wurden.


Doppelklicken Sie auf einen Ihrer Artikel. Es öffnet das Fenster Artikeldetails.

Schauen Sie sich nun an, auf welchen Registerkarten welche Informationen aus Ihrem Shopware-Shop abgelegt wurden, z.B. Artikelnummern, Produktbezeichnungen oder auch Lagerbestände und Reservierungen.

Jtl-connector-shopware-jtl-wawi-onlineshopabgleich-erfolgreich-uebertragen-artikeldetails.png


Erläuterungen zum Bild:


Registerkarte: Allgemein (oben)


Sie sehen einige der Produktinformationen aus Ihrem Shop-System, die in JTL-Wawi als sogenannte "Stammdaten" abgelegt werden, z.B. die Artikelnummer, EAN oder die Produktbezeichnung (=Name).

Wie Sie Ihre Produktinformationen (=Artikeldetails) pflegen können sowie Angebote für Kunden und Shop erstellen erfahren Sie hier:
Zur Artikelverwaltung: Neue Produkte anlegen, kategorisieren, gruppieren
Zur Angebotsverwaltung: Angebote erstellen, zusammenfassen, umwandeln


Registerkarte: Lager (unten)


An dieser Stelle können Sie sowohl den übertragenen Lagerbestand einsehen als auch einen Lagerbestand "In Aufträgen". Letzerer wird automatisch durch eingegangene Bestellungen reserviert. Wie Sie sehen, beginnt Ihre JTL-Wawi hier mit Ihrer Kernarbeit - der Warenwirtschaft.

Mit einem Klick auf Kunden wechseln Sie in den Bereich der Kundenverwaltung. Alle Kunden aus Ihrem Shopware-Shop sollten hierhin übertragen worden sein.

Jtl-connector-shopware-jtl-wawi-onlineshopabgleich-kunden-uebertragen.png


Erläuterungen zum Bild:


Kunden mit Bestellungen: Kunden, die aktuell oder in der Vergangenheit Produkte in Ihrem Shop bestellt haben, finden Sie hier aufgelistet. Nutzen Sie auch die Filterfunktion Gruppe (oberhalb der Kundenübersicht) , wenn Sie Ihre Daten getrennt nach Kundengruppen prüfen möchten.

Wie Sie generell Kundendaten in JTL-Wawi pflegen, können Sie hier nachlesen:
Zur Kundenverwaltung: Kundendaten anlegen, übernehmen, zusammenführen


Kunden ohne Bestellungen: Kunden, die sich lediglich registriert, aber keine Bestellung aufgegeben haben, finden Sie an anderer Stelle: Menü Onlineshop > Onlineshop-Kunden aktivieren.


Mit einem Klick auf den Menüpunkt Verkauf öffnet sich die Verkaufsveraltung. Um Ihre Aufträge einzusehen, klicken Sie auf die Kategorie Aufträge. Über die Filterfunktion können Sie gezielt nach Aufträgen aus Ihrem Shopware-Shopsystem suchen. Hier sollten Sie alle Ihre übertragenen Bestellungen vorfinden - sowohl offene als auch abgeschlossene.

Jtl-connector-shopware-bestellungen-zu-jtl-wawi-importieren-und-anzeigen-lassen.png


Erläuterungen zum Bild:


Fensterbereich Auftragsübersicht: In der Auftragsverwaltung ist eine "Monatsansicht" voreingestellt (Datum oben rechts, z.B. 05.2015). Wenn Sie alle Bestellungen einsehen wollen, deaktivieren Sie die dazugehörige Checkbox "Datum".

Zur Auftragsverwaltung: Aufträge anlegen, teilen, stornieren, ausliefern


Ihr Ergebnis:

Sie haben jetzt alle Kategorien (inklusive aller zugeordneten Produkte) aus Ihrem Shopware-Shop voll automatisiert über einen Webshop-Abgleich in Ihre JTL-Wawi importiert. Ihr Shopware-Shop wird im Kategorienbaum von JTL-Wawi abgebildet. Von jetzt an sollten Sie Änderungen an Ihren Bestandsdaten ausschließlich über Ihre JTL-Wawi pflegen!

Jtl-connector-shopware-shop-zu-jtl-wawi-uebertragen-kategorien-artikel.png


So geht es weiter: