1 EINLEITUNG FUNKTIONSWEISE VORAUSSETZUNGEN MAGENTO GDI INSTALLATION MAGENTO Magento WebService

Transkript

1 1 EINLEITUNG FUNKTIONSWEISE VORAUSSETZUNGEN MAGENTO GDI INSTALLATION MAGENTO Magento WebService aktivieren Magento Shopverwaltung GDI-SCHNITTSTELLE Magento Einstellungen Firebird GDI-Mandant Zusatz Lizenzcode GDI Reorganisation Zusatzfelder über Nummernkreise Maskeneinbindung / Menüerweiterung GDI KONFIGURATION GLOBALE EINSTELLUNGEN GDI SHOPKATEGORIEN ARTIKELMERKMALE ZUSATZEINSTELLUNGEN KATALOGABGLEICH ABGLEICH PER SCHNITTSTELLE (DIREKT) ABGLEICH AUS GDI ARTIKELABGLEICH KUNDENABGLEICH EINLESEN VON BESTELLUNGEN FAQ...25

2 1 Einleitung Mit der Realisierung dieser Schnittstelle haben wir nun auch die Anbindung an ein weiteres Shopsystem geschaffen, den Magento Shop. In der aktuellen Fassung wurde die freie Version des Magento angebunden und getestet. Die im Beta- Stadium befindliche Version 1.5.x wird nicht unterstützt und wurde auch nicht getestet, hier wird es ein kostenpflichtiges Update geben wenn diese als stable erhältlich ist. Diese Schnittstelle baut auf die jeweiligen Standard Versionen von GDI 3.x und Magento auf, das heißt Anpassungen an irgendeinem System lassen sich nur bedingt oder gar nicht abbilden. Hierfür bieten wir Ihnen Unterstützung und / oder Sonderprogrammierungen an. Der Transfer erfolgt über die im Standard vorhandenen SOAP Schnittstelle des Magento hat den Vorteil, dass es für die Übertragung / Verbindung keine zusätzlichen Portfreigaben am System oder an vorhandenen Firewalls bedarf. 1.1 Funktionsweise Die Schnittstelle selbst in ein eigenständiges Programm welches den Datenaustausch zwischen der GDI und dem Magento Shop realisiert. Dabei baut das Programm einerseits auf die GDI, im Speziellen auf das Shopmodul, und andererseits auf die SOAP Schnittstelle des Magento auf. Über die Schnittstelle werden Stammdaten aus der GDI Datenbank gelesen und an den Shop übergeben und Bestellungen aus dem Shop abgeholt und in die GDI importiert.

3 2 Voraussetzungen Beide Systeme sollten die Mindestvoraussetzungen erfüllen, um eine reibungslose Funktion zu gewährleisten. 2.1 Magento Eine ausführliche Übersicht über die Systemvoraussetzungen finden Sie auf Wichtig ist, dass die SOAP Erweiterung installiert und funktionsfähig ist. 2.2 GDI Die GDI Auftrag- und Warenwirtschaft sollte in der Version 3.1.x vorliegen, auch Vorgängerversionen der 3.x werden unterstützt. Zusätzlich benötigen Sie das GDI Shopmodul in der aktuellen Version.

4 3 Installation Die Installation erfolgt in mehreren Schritten, als Standard sollten Sie im jeweiligen Mandantenverzeichnis einen Unterordner Shop anlegen. Extrahieren Sie nun das zip-archiv in diesen Ordner. 3.1 Magento Soweit Sie noch keinen Magento Shop besitzen, installieren Sie diesen wie hier beschrieben Nach dem Entpacken des zip-archives kopieren Sie bitte den Inhalt des Ordners API-Anpassungen in das Hauptverzeichnis Ihrer Magento Installation. Hierdurch werden Teile der Magento SOAP Schnittstelle erweitert Magento WebService aktivieren Melden Sie sich zunächst mit einem Admin-Benutzerkonto im Shop Administrations- Bereich an. Rufen Sie per Navigation den Punkt System Web Services Roles auf: Erstellen Sie eine neue Rolle, geben Sie ihr einen Namen und legen Sie deren Rechte fest. Es werden alle Rechte benötigt! Bsp: Rollenname: gdigroup Rechte: All Speichern Sie die Gruppe.

5 Im Anschluss öffnen Sie den Punkt System Web Services Users und legen einen neuen Benutzer an. Füllen Sie bitte alle Felder aus und vergeben Sie ein sicheres Passwort (API Key). Vor dem Speichern des Benutzers ordnen Sie ihm noch die zuvor angelegte Rolle zu.! Notieren Sie sich bitte Name und API Key des Benutzers! Magento Shopverwaltung Der Magento kann mehrere Webseiten und Shopsichten verwalten, daher muss auch die Schnittstelle mit mehreren Seiten und Sichten kommunizieren können. Damit die Stammdatendaten auch dort ankommen wo sie hin gehören müssen Grundeinstellungen des Magento der Schnittstelle bekannt gemacht werden. Gegen Sie dazu bitte in die Shopverwaltung des Magento.

6 In der Ansicht, fahren Sie bitte mit der Maus über den Namen der Webseite, und können dann in der Statusleiste des Webbrowser die Webseiten-ID ablesen. Hier die Nummer 1, bitte notieren Sie diese ebenfalls! 3.2 GDI-Schnittstelle Wurde das Archiv erfolgreich im Shop Verzeichnis Ihres Mandanten extrahiert, sollte der Pfad nun so lauten: LW:\\GDI\GDIBusinessLine\Mandanten\Mandantname\Shop\magento. Damit ist die Installation fertig gestellt und Sie können die Schnittstelle konfigurieren. Öffnen Sie dazu die magento.exe direkt aus dem Verzeichnis (doppelklick). Über Datei Einstellungen gelangen Sie in die Konfiguration der Schnittstelle.

7 3.2.1 Magento Einstellungen In diesem Register stellen Sie die zur Kommunikation mit dem Magento wichtigen Daten ein. Tabelle: Shop URL Webseiten URL des Magentoshops RPC User / RPC Pass Benutzername und passwort des angelegten Webservice Users (siehe Punkt Proxyeinstellungen.htaccess Verzeichnisschutz Magento Viewname 3.1.1) Nur nötig wenn Proxy genutzt wird Nur nötig wenn Verzeichnisschutz genutzt wird (i.d.r. nicht) Zuordnung der Sprachen in GDI mit den angelegten Shop Views im Magento (siehe Webseiten ID Punkt 3.1.2) Siehe Punkt letzter Abschnitt

8 Nachdem Sie die URL und die RPC Zugangsdaten eingetragen haben, können mit dem Button Verbindungstest versuchen sich mit dem SOAP Dienst zu verbinden. Im Erfolgsfall sollten Sie diese Meldung erhalten: Gegebenenfalls müssen Sie nach der Änderung der Zugangsdaten die Schnittstelle neu starten und den Verbindungstest erneut ausführen.

9 3.2.2 Firebird Im nächsten Register Firebird müssen Sie die Daten des Servers eingeben, auf dem der Firebird ausgeführt wird. Wählen Sie zuerst die Firebird-Version und geben Sie anschließend den Servernamen, sowie die weiteren Zugangsdaten ein. Der Verbindungstest wird im folgenden Register GDI Mandant ausgeführt.!hinweis: Beim Einsatz des Firebird 2.5 wählen Sie bitte ebenfalls firebird-2.1 als Serverversion aus. Bei unseren Tests konnte erfolgreich auf den FB 2.5 zugegriffen werden.

10 3.2.3 GDI-Mandant Das Register GDI Mandant enthält alle Angaben zum benutzten Mandanten, und muss ebenfalls angepasst werden.!hinweis Der Datenpfad muss absolute zum Server angegeben werden und darf kein UNC-Pfad sein. Für das Bildverzeichnis empfiehlt es sich unter jeder Shop-Schnittstelle ein eigenes Bilder Verzeichnis anzulegen. Ebenso können Sie bei dem Dokumentenverzeichnis verfahren. Bitte führen Sie einen Verbindungstest zur Datenbank aus, dieser sollte mit dieser Meldung quittiert werden: In allen anderen Fällen prüfen Sie bitte die Firebirdeinstellungen und den Pfad zur Mandantendatenbank.

11 Nach dem erfolgreichen Verbindungstest, werden alle verfügbaren Preislisten gelesen und in der Auswahlbox Shop Preisliste zur Auswahl angeboten. Wählen Sie hier nun die Preisliste, die für den Shop genutzt werden soll. Weiter unten finden Sie auf der linken Seite die Shopnummer, diese entspricht der Shopnummer aus der GDI Shopverwaltungsmaske und muss mit dieser identisch sein Kundengruppenpreise Sie können für definierte Kundengruppen separate Preislisten hinterlegen. Dazu müssen Sie im ersten Schritt eine Kundengruppe im Magento anlegen und sich deren ID Nummer notieren. Anschließend ordnen Sie einer vorhandenen Preisliste (GDI) die ID der Kundengruppe zu. Die Zuordnung im Artikel sehe dann etwa so aus:

12 Einstellungen für Bestellabfrage Diese Einstellungen sind für die Abholung der Bestellungen wichtig, hier können Sie Voreinstellen welche Belegart für eine Bestellung genutzt werden soll und wo die XML Dateien für die weitere Verarbeitung abgelegt werden. Des Weiteren müssen Sie hier angeben, welche Artikel (GDI Artikelstamm) für Rabatt, Porto und Nachname verwendet werden sollen. Soweit Sie noch keine derartigen Artikel im Artikelstamm haben, legen Sie bitte diese zuvor an.

13 3.2.4 Zusatz SEO Optimierung für Bildnamen Für die Anlage der Artikelbilder werden diese aus der GDI Datenbank gelesen und per SOAP Schnittstelle an den Magento übertragen, dieser speichert die Bilder physisch auf dem Webserver. Zur Vermeidung doppelter Bildnamen und verbotener Zeichen werden diese mit MD5 verschlüsselt (Artikelnr + laufende Nummer). Da dies zwar technisch eine gute Lösung ist aber für Suchmaschinen keinerlei Nutzen in Bezug auf Optimierung hat, können Sie statt einer MD5 Verschlüsselung die Artikelnummer als Bildnamen verwenden. GDI beschränkt die möglichen Zeichen, welche innerhalb der Artikelnummer genutzt werden können nicht, um zu Verhindern dass geschützte Zeichen im Bildnamen verwendet werden gibt es die Möglichkeit der Ersetzung. Bsp: GDI Artikelnummer: weißwein Wird: weisswein Lagerbestände Magento kann den Lagerbestand verwalten, also Artikel als verfügbar oder nicht auf Lager anzeigen. Welcher Lagerbestand aus der GDI dafür genutzt werden soll kann hier eingestellt werden. Die Auswahl besteht zwischen dem tatsächlichen Bestand (Bestand) oder dem verfügbaren Bestand (VBestand).

14 Zuordnung der Steuerschlüssel Für die exakte Zuordnung der Steuerschlüssel hinterlegen Sie hier bitte alle für Sie benötigen Steuerschlüssel aus der GDI und dem Magento. Dabei steht auf der linken Seite die Nummer aus der GDI und rechts die ID aus dem Magento. Die ID des Steuersatzes finden Sie beim Überfahren mit der Maus auf den jeweiligen Eintrag und in der URL, wenn Sie im Bearbeitungsmodus sind.

15 3.2.5 Lizenzcode In diesem Register finden Sie die aktuelle Lizenz, können von hier eine neue Testlizenz online erhalten oder Ihre Lizenzdaten eingeben.

16 3.3 GDI Für die Einbindung der Schnittstelle in die GDI müssen nun noch geänderte Masken, Metadaten installiert werden. Dazu extrahieren Sie die Dateien des GDI Shop Archivs in das Mandantenverzeichnis. Das Archiv beinhaltet: Masken Griddefinitionen Metadaten Reorganisation Im ersten Schritt müssen Sie eine Reorganisation der Datenbank durchführen, um die neue Struktur zu übernehmen. Dazu führen Sie die GDI Reorg. aus.

17 3.3.2 Zusatzfelder über Nummernkreise Speziell für den Magento müssen über die GDI Nummernkreise Zusatzfelder im Kundenstamm angelegt werden. Die Übertragung per SOAP verlangt zwingend die Übergabe der 3stelligen Abkürzung für das Bundesland (Deutschland), für andere Länder müssen ggf. andere Eintragungen gemacht werden.

18 3.3.3 Maskeneinbindung / Menüerweiterung Für die Einbindung der Shopeinstellungsmaske erstellen Sie bitte einen neuen Menüpunkt. Um einen gewissen Standard beizubehalten empfehlen wir die Anlage unter Zusatzprogramme, mit dem Namen Shopeinstellungen. Als externe Maske nutzen Sie hier die Datei zusatz_shoptransfer.msk. Weiterhin müssen Sie die Standard-Kundenmaske mit der neuen Maske stammdaten_kunden.msk ersetzen.

19 Schließlich ersetzen Sie bitte noch die Standard-Webshopmaske im Register Artikel Webshop mit der Datei stammdaten_shop.msk.

20 4 GDI Konfiguration Die aktuelle Version ist seitens GDI Mehrshopfähig, das heißt mit den Shopdaten der GDI können Sie mehrere Shopsysteme (gleiche oder auch unterschiedliche) betreiben. Damit ein reibungsloser Ablauf gewährleistet werden kann, müssen in der GDI ein oder mehrere Shops angelegt und für jeden eigene Einstellungen getätigt werden. An dieser Stelle verweisen wir auf die Dokumentation welche sich im o.g. Archiv befindet.

21 5 Globale Einstellungen GDI Zu diesen Einstellungen zählen alle Konfigurationen welche für alle Shop gleichermaßen gelten und die Grundlage für den Abgleich bilden. Die benötigte Maske finden Sie unter Stammdaten Basisdaten Webshop-Einstellungen. 5.1 Shopkategorien Die Shopkategorien bilden die Grundstruktur für den Aufbau der Menüeinträge im Webshop und gelten derzeit noch für alle Shops. Die Struktur können Sie mit einem Klick der rechten Maustaste erweitern. Aktuell wichtige Felder sind: Beschreibung (auch Fremdsprachen wenn genutzt) Kurz- und Langtext Status (muss hier immer auf 1 = freigegeben stehen) Bitte bauen Sie zunächst Ihre Baumstruktur auf und vergeben bitte alle nötigen Einträge. Damit können Sie theoretisch schon die Shopwarengruppen an den Shop übertragen (siehe Punkt 6).

22 5.2 Artikelmerkmale 5.3 Zusatzeinstellungen 6 Katalogabgleich Der Datenaustausch kann direkt per Schnittstelle (magento.exe) oder über die Shoptransfermaske erfolgen. Für den ersten Test sollten Sie direkt die Schnittstelle nutzen, da evtl. auftretende Fehler hier schneller erkannt und behoben werden können. 6.1 Abgleich per Schnittstelle (direkt) Öffnen Sie die Schnittstelle magento.exe im Shop Magento Order des Mandanten und senden Sie die Kataloge per Senden Kataloge. Je nach Geschwindigkeit des Webservers und Ihres Internetanschlusses dauert der Vorgang einige Minuten. Nach dem Abschluss sollten Sie die neue Menüstruktur im Webshop finden. Wenn Sie einen Mehrsprachigen Shop nutzen und nun z.b. die Sprache auf englisch umschalten wird auch das Menü in der eingestellten Sprache angezeigt.

23 6.2 Abgleich aus GDI Rufen Sie die Shoptransfer-Maske auf, gehen Sie in das Register Daten senden und klicken Sie auf den Button Kategorien senden. Jetzt wird die Schnittstelle geöffnet und der Übertragung gestartet. Nach Fertigstellung der Übertragung schließt die Schnittstelle automatisch.

24 7 Artikelabgleich

25 8 Kundenabgleich Für eine erfolgreiche Übertragung der Kundendaten, müssen folgende Felder bei der Stammadresse und auch bei den Lieferadressen Werte enthalten: Vorname Nachname PLZ Ort Telefon Straße Land Eine generelle Freischaltung eines Kunden als Shopkunde erfolgt über die Kundenstammmaske im Register Webshop. 9 Einlesen von Bestellungen 10 FAQ