JTL-Wawi
Aus ShopleiterWiki
4.2.1 Zusammenspiel JTL-Wawi mit Magento
Die Warenwirtschaftssoftware JTL-Wawi von JTL ist sehr beliebt und obendrein kostenlos (als Freeware erhältlich). Aus diesem Grund stellen wir Ihnen die Installation und das Zusammenspiel von JTL-Wawi mit Magento vor. Hierfür gibt es verschiedene Möglichkeiten, auf die an dieser Stelle eingegangen werden soll. Zum einen ist dies das Exportskript von Marc Isemann, das zum Export von Bestellungen aus Magento im XML-Format verwendet werden kann, die anschließend in JTL-Wawi importiert werden können. Zum anderen ist dies das frei verfügbare Tool "JTLmage", das in Abschnitt 4.2.1.2 beschrieben wird.
4.2.1.1 Exportskript von Marc Isemann
Mit der zumindest einseitig funktionierenden Schnittstelle exportieren Sie die Bestellungen in eine XML-Datei aus Magento. Diese Datei importieren Sie dann in die JTL-Warenwirtschaft. Dieses Exportskript stellt der Autor Marc Isemann auf seiner Homepage kostenlos zum Download zur Verfügung.
JTL-Wawi Schnittstelle für Magento
Die Warenwirtschaft JTL-Wawi läuft lokal mit MS SQL 2005 Express und wird zusammen mit der Software ausgeliefert. Nach dem Herunterladen der Vollversion entpacken Sie die Software lokal auf Ihren Rechner. Achten Sie auf eine neue Update-Version. Falls diese eine höhere Versionsnummer aufweist, müssen Sie auch diese herunterladen und nach der Erstinstallation aufspielen. Im ersten Schritt installieren Sie die Datenbank mit dem Start der Datei „SQLEXPR_DEU.exe“ im Verzeichnis /SQL-Server. Es kann einige Zeit in Anspruch nehmen. Nach der erfolgreichen Installation starten Sie setup.exe aus dem Verzeichnis /JTL-Wawi. Nach dem ersten Programmstart werden Sie gefragt, ob Sie eine Datenbank anlegen möchten - bestätigen Sie dies mit „Ja“ und legen diese mit den Daten aus dem Dialogfenster an. Dann ist Ihre Warenwirtschaftssoftware fast einsatzbereit.
JTL Wawi Download-URL für Vollversion und Upgrades
Des Weiteren ist für die Konfiguration der Mandant sehr wichtig, damit bezeichnet man eine abgeschlossene Organisationseinheit, z. B. Ihr eigenes Unternehmen in einem Finanzbuchhaltungs- oder Warenwirtschaftssystem. Die weiteren Konfigurationsschritte nach der Installation erklären wir Ihnen ausführlicher gleich im Anschluss. Die Installationsanleitung und das Handbuch für JTL-Wawi finden Sie im Download-Bereich.
- Starten Sie JTL-Wawi und legen Sie einen neuen Mandant an!
- Laden Sie alle Ihre Artikel aus Magento in die JTL-Wawi!
- Laden Sie die JTL-Skriptdatei aus dem Internet oder der Buch-CD herunter!
- Konfigurieren und installieren Sie das Script für Magento!
- Erstellen Sie die XML-Datei mit den Bestellungen aus Magento!
- Importieren Sie die XML-Datei mit den Bestellungen in JTL-Wawi!
Jetzt starten Sie über „Startmenü › JTL-Software › JTL-Wawi“ die Software. Dabei merkt JTL-Wawi automatisch, dass kein Mandant existiert, und fordert Sie auf, einen neuen Mandanten anzulegen. In einem Dialogfenster werden einige Angaben abgefragt: Der Mandant ist Ihr Firmenname (ohne Leerzeichen und Umlaute).
Falls Sie mehrere Mandanten benötigen, weil Sie verschiedene Shops betreiben, können Sie weitere erstellen. Nach erfolgreicher erster Anmeldung mit diesem Mandanten meldet sich das Programm mit „Benutzer anmelden“. Erst mit den Anmeldedaten des Administrators gelingt Ihnen der erste Zugriff auf einen neuen Mandanten. Die Zugangsdaten lauten für den Administrator: Benutzername „admin“ und Kennwort „pass“. Im Anmeldedialog wählen Sie den gewünschten Mandanten aus.
Danach füllen Sie die nun folgenden Dialogfenster nach Ihren persönlichen Vorgaben aus, wie Lieferstatus, Währung, Versand, E-Mail usw. Wichtig ist die Eingabe des API-Keys im Fenster „WebShop Details“. Den Key generieren Sie im nächsten Schritt mit der Installation des PHP-Skripts. Sie können diesen auch nachträglich eingeben. Auch weitere Shops legen Sie im Menü „Einstellungen › Webshop Einstellungen“ an oder ändern bestehende. Legen Sie unter „Einstellungen › Benutzerdaten/Rechte“ neue Benutzer an.
Zuerst muss Ihr gesamte Artikelbestand aus dem Online Shop auch in Ihrer JTL-Wawi vorhanden sein, damit die importierten Bestellungen auch die Artikel dazu finden. Anhand des Exportassistenten von Magento lesen Sie Ihre Artikel zunächst aus, um diese dann in der Warenwirtschaft mittels Import-Assistenten einzulesen. Standardmäßig erwartet JTL-Wawi eine CSV-Datei. Damit ist es leichter, da Magento dieses Dateiformat generieren kann und Sie mit Excel die Datei bearbeiten. Die JTL-Wawi erwartet zwingend die in Listing 4.1 aufgeführten Datenbankfelder. Die Felder können leer bleiben, müssen aber vorhanden sein und die folgenden Namen tragen:
ARTNR; BARCODE; BEZEICHNUNG; KURZBESCH; BESCHREIBUNG; VKBRUTTO; MWST; UVP; EINHEIT; GEWICHT; VKHBRUTTO; EKNETTO; LIEFNR; MINDESTAB; LAGERBEST; ANMERKUNG; PREISLISTE; TOPART; NEU; AKTIV; ATT1N; ATT1T; ATT1V; ATT1INET; BILD; LAGERAKTIV; KLEINERNULL; TEILBAR; HERSTELLER; ANZAHL-P1; PREIS-P1; ANZAHL-P2; PREIS-P2; ANZAHL-P3; PREIS-P3; ANZAHL-P4; PREIS-P4; ANZAHL-P5; PREIS-P5; ANZAHL-H1; PREIS-H1; ANZAHL-H2; PREIS-H2; ANZAHL-H3; PREIS-H3; ANZAHL-H4; PREIS-H4; ANZAHL-H5; PREIS-H5; EBAYPREIS; KATEGORIE
Listing 4.1: Zwingende erforderliche Datenbankfelder für JTL-Wawi
Diese Datenbankfeld-Namen tragen Sie in Ihr Magento Exportprofil unter „Feldzuordnung“ zum passenden Attribut Ihrer Shopartikel ein. Bestehende Unterkategorien nennen Sie bitte nach dem letzten Primärfeld „Kategorien“. Tipp: Generieren Sie aus Magento besser eine XML-Datei, die kann Excel auch öffnen. Es passieren mit diesem Datei-Format weniger Fehler, gerade mit leeren Datenbankfeldern. Später speichern Sie die Datei über Excel im CSV-Format ab. Abschließend importieren Sie die fertige CSV-Datei in der JTL-Wawi unter dem Menü „JTW-Wawi › Artikel Import“.
Das zusätzliche spezielle PHP-Skript von Marc Isemann benötigen Sie für den Export der Bestellungen in eine XML-Datei aus dem Shop. Da sich in Zukunft für Magento in Sachen Warenwirtschaft einiges tun wird, sollten Sie stets auf dem Laufenden bleiben. Besuchen Sie dazu das deutschsprachige MagentoCommerce-Forum oder überprüfen Sie Versionsanpassungen. Die Anpassungen sind an Ihrem Online-Shop vorzunehmen, nicht in der Warenwirtschaftssoftware. Das Skript „Amazon Seller Central 2 JTL Wawi Schnittstelle“ wurde um den Ordner „magentocommerce“ erweitert. Laden Sie diese Datei jtl-importer.zip von der Homepage www.iseman.de herunter, bzw. befindet es sich auf der Buch-CD. Das Skriptpaket besteht bisher aus mehreren Dateien und Ordnern: amazon.php, config.php, index.php, magento.php, amazon_vorlage.xml und magento_vorlage.xml.
Damit nicht jeder diesen Export vornehmen kann, legen Sie zunächst einen neuen API-Benutzer im Magento-Adminbereich über das Menü „System › Web Services › Benutzer“ (System › Web Services › Users) an. Vergeben Sie hier zum Absichern des Zuganges einen neuen eigenen API-Key, wie „2739919jtl11“. Jetzt ordnen Sie diesen Benutzer einer Gruppe zu. Klicken Sie dazu über die linke Navigation auf „Benutzer Gruppenberechtigung“. Ist hier noch keine Gruppe (Rolle) zu sehen, legen Sie eine neue Gruppe über das Menü „System › Web Services › Gruppenberechtigungen“ (System › Web Services › Roles) an, zum Beispiel „jtlwawi“. Teilen Sie der Rolle volle Rechte zu, indem Sie „Gruppenberechtigung Quellen“ anklicken und setzen Sie auf die oberste Ebene einen Haken. Gehen Sie zurück zum Menü „System › Web Services › Benutzer“ und wählen Sie den eben angelegten Benutzer aus und klicken Sie auf „Benutzer Gruppenberechtigung“. Wählen Sie die neue Gruppe per Klick auf den Radio-Button aus und speichern Sie die Eingabe. Notieren Sie Benutzername und den API-Key.
Konfigurieren Sie vor dem Upload noch kurz das Exportskript. Öffnen Sie mit einem Editor die „config.php“ aus dem entzippten Skript-Ordner und tragen Sie folgende Daten ein:
define("MAGE_URL","http://www.domain.tld/api/?wsdl");
define("MAGE_USER","der-soeben-vergebene-benutzername");
define("MAGE_PW","der-soeben-vergebene-api-key");
Listing 4.2: Daten des Skripts ändern in der config.php
Speichern Sie die Datei unter dem gleichen Namen und laden Sie den kompletten Ordner „jtl-importer“ per FTP in das Root-Verzeichnis Ihres Shops (www.domain.tld/jtl-importer). Verändern Sie dabei nicht den Ordnernamen! Das Skript erzeugt später eine XML-Datei, die im Ordner „amazon_export“ abgelegt wird. Passen Sie den Namen bei Bedarf an. Ändern Sie aber am Ende der Datei "magento.php" die Zuweisungen „amazon_export“ entsprechend um in „jtl_export“ und vergessen Sie nicht auch den Ordner umzubenennen - sonst läuft das Skript nicht.
Ist der API-User richtig angelegt und das Skript korrekt hochgeladen, treten beim Aufruf des Scripts keine Fehler auf. Starten Sie jetzt den Export mit dem Aufruf über Ihren Browser mit domain.tld/jtl-importer. Der Rest ist selbsterklärend.
Nachdem Sie die Datei lokal abgespeichert haben, importieren Sie die XML-Datei in die JTL-Wawi. Rufen Sie die Exportfunktion über das Menü „JTL-Wawi › Auftragsimport (*.xml)“ auf. Sollte im Menü dieser Eintrag fehlen, so ist die Warenwirtschaft nicht auf dem neuesten Stand. Installieren Sie das Update für JTL-Wawi, welches Sie über den Download-Bereich bei JTL erhalten.
4.2.1.2 Exportskript JTLmage
Gleichzeitig wird seit 2009 unter dem Namen JTLmage eine kostenlos verfügbare und frei anpassbare bidirektionale Schnittstelle zum Abgleich von Artikel-, Kunden- sowie Bestelldaten zwischen der Warenwirtschaftssoftware JTL-Wawi und dem Shopsystem Magento angeboten. JTLmage ist als Open Source-Software verfügbar und steht unter der GPL. Da die Schnittstelle die Magento-API verwendet, sind zur Installation keine Modifikationen an der Magento-Installation erforderlich. JTLmage wird als separates Tool auf dem gleichen Server installiert, auf dem sich auch Magento befindet. Zusätzlich verwendet JTLmage die Datenbank von Magento, um aus Geschwindigkeitsgründen Artikeldaten zwischenzuspeichern, bevor sie anschließend endgültig in den Artikelstamm von Magento übertragen werden. JTLmage unterstützt dabei auch Gruppenartikel sowie Variationen. Für weitere Informationen sei an dieser Stelle auf die JTLmage-Seite verwiesen.
