GREYHOUND Connect für Magento

Die Installation des Addons ist mit wenigen Handgriffen erledigt. Nach einigen Vorbereitungen im Magento Backend, kann das Addon dem bestehenden GREYHOUND-Vertrag hinzugebucht werden. Der GREYHOUND Server und die Clients installieren das Addon dann vollautomatisch.

Achtung! 
Für die Verwendung des GREYHOUND Connect für Magento-Addons ist eine GREYHOUND-Version 4.2.7 build 1642 oder höher notwendig. Eine gegebenenfalls installierte frühere Erweiterung sollte über den Client unter Einstellungen > Erweiterungen entfernt oder deaktiviert werden, damit es beim Anwender nicht zu Verwechslungen kommt.

Vorbereitung im Magento Backend

Damit das Addon Daten aus dem Magento-Shop abrufen kann, ist es wichtig, dass …

Dazu die folgenden Schritte durchführen:

  1. Das Magento-Plugin installieren und den Cache leeren.
  2. Im Backend unter System/Web Services/SOAP-XML-RPC Gruppenberechtigungen eine neue Gruppe anlegen (z. B. “GREYHOUND Connect”).
  3. Dieser Gruppe die Berechtigungen GREYHOUND Connect sowie die beiden Unterberechtigungen Bestelldaten abrufen und Informationen über das Modul abrufen zuweisen.
  4. Unter System/Web Services/SOAP-XML-RPC Benutzer einen neuen Benutzer anlegen (z. B. “greyhound”).
  5. Für diesen Benutzer einen API-Schlüssel festlegen und den API-Schlüssel sowie den Benutzernamen notieren (dies wird später in den Einstellungen des Addons im GREYHOUND Client benötigt). Das Benutzerkonto muss Aktiv sein.
  6. In den Gruppenberechtigungen des Benutzers dann die zuvor angelegte Gruppe auswählen (“GREYHOUND Connect”).

GREYHOUND Connect für Magento dem Vertrag hinzubuchen

Das Produkt GREYHOUND Connect für Magento im GREYHOUND Control Center (GCC) dem bestehenden Vertrag hinzubuchen:

  • Nach dem Login unter Verträge den Vertrag auswählen und bearbeiten

  • Unter den Vertragsinhalten auf Produkte ändern klicken

  • Das gewünschte Addon hinzubuchen

  • Änderungen mit Weiter bestätigen

  • Änderungen überprüfen und übernehmen

Wichtig: Kunden im Eigenbetrieb müssen die Verwendung des gebuchten Addons zusätzlich im GREYHOUND Admin aktivieren (-> Anleitung siehe hier). Außerdem sind die Funktionen des neuen Addons erst nach einem Neustart des GREYHOUND Clients verfügbar.

GREYHOUND Connect für Magento im GREYHOUND Client einrichten

Standardmäßig ist ein neues Addon immer für alle in GREYHOUND angelegten Benutzergruppen sichtbar. Wir empfehlen, nach der Installation die Sichtbarkeit des Einstellungsdialogs als auch das des Addons selber zu konfigurieren. Informationen über Benutzergruppen gibt es an dieser Stelle im GREYHOUND Handbuch.

Wichtiger Hinweis
Nutzer von Magento 2 lesen bitte unten an der entsprechenden Stelle weiter.

  1. Nachdem das Addon dem Vertrag hinzugebucht wurde, erscheint im GREYHOUND Client ein neuer Menüeintrag Erweiterungen/GREYHOUND Connect für Magento – Einstellungen.
  2. Hier wird die URL der Magento API angegeben (wenn möglich die sichere Verbindung, also mit https://…).
  3. Ebenso wird hier der Benutzername und der API-Schlüssel angegeben, der in Magento Connect eingerichtet wurde.
  4. Mit der Schaltfläche Verbindung testen kann überprüft werden, ob die Verbindung zur API des Shops aufgebaut werden kann.

Es ist sinnvoll, bei den Empfängern nur die E-Mail-Adressen einzutragen, an die Shopware-Kunden auch Nachrichten schreiben. Beispielsweise “kundenservice@meinefirma.de”. So vermeidet man, dass das Addon auch bei eingehenden Lieferanten-E-Mails an einkauf@meinefirma.de unnötig nach Kundendaten bei Shopware sucht.

Mehrere Mandanten / Shops anbinden

Selbstverständlich lassen sich auch mehrere Mandaten / Shops mit dem Addon anbinden. Dazu legt man einfach im Reiter „Verbindung“ über das grüne Plus-Icon unten links eine neue, weitere Verbindung an und trägt die Daten des zusätzlichen Shops entsprechend ein:

Tipp
Vor allem bei der Anbindung mehrere Mandaten bzw. Shops ist es sinnvoll, dem Addon zu sagen, bei welchen Empfänger-Mail-Adressen er überhaupt nach Auftragsdaten suchen soll. Denn wenn der Kunde bei Mustershop A gekauft hat, braucht das Addon nicht unnötig bei Mustershop B nach Auftragsdaten zu suchen.
Bei welchen Mail-Adressen das Addon im Drittsystem suchen soll, das steuert man über das Feld „Empfänger“: Hier sollte man die die E-Mail-Adresse(n) einzutragen, an die Shop- und Verkaufsplattform-Kunden auch Nachrichten schreiben. Beispielsweise „kundenservice@mustershop-A.de“. So sucht das Addon nur bei eingehenden Nachrichten, die an diese Adresse gingen nach Daten, nicht aber bei eingehenden Nachrichten an den zweiten Mandanten (Mustershop B) oder bei Lieferanten-E-Mails, die an „einkauf@ mustershop-A.de“ gesendet wurden. Das wirkt sich positiv auf die Performance aus.

Besonderheiten bei Magento 2

Bei Nutzung von Magento 2 bitte nur die Base-URL des Shops unter API-Url angeben, der vollständige Pfad ist in diesem Fall nicht notwendig. Nutzer von Magento 2 nehmen die Einrichtung wie folgt vor: Zunächst ist im Admin “System” > “Integrations” auszuwählen.

Dort findet man rechts oben einen Button “Add New Integration”. Dieser ist anzuklicken.

In der neuen Integration ist als Name z. B. “GREYHOUND Connect” anzugeben.

Wichtig: Nachdem alle notwendigen Daten eingetragen sind, ist links im Kasten mit der Überschrift “Basic Settings” der Punkt “API” anzuklicken. Hier müssen nun ganz unten beide Berechtigungen für das GREYHOUND Connect Modul gewährt werden.

Danach kann man die Eingaben speichern. Ganz fertig ist man allerdings noch nicht: Nun muss man nochmal auf “Bearbeiten” klicken und in der Integration unten bei “Integration Details” den “Access Token” rauskopieren und im Addon bei GREYHOUND als Passwort eintragen. Der Benutzername muss bei Magento 2 nicht eingetragen werden, dort wird dann nur mit dem Access Token als Passwort gearbeitet.

Zudem gilt für die Variablen (siehe unten) bei Magento 2 eine Besonderheit: Die Kundennummer kann mit der Variable [$Order.CustomerNumber] leider derzeit nicht ausgelesen werden, da Magento 2 dies leider technisch (noch?) nicht? unterstützt. Alle anderen Variablen können aber wie unten angegeben genutzt werden.

Globale Einstellungen

  • Präfix für Vorgangsnummern
    Um eingehende Nachrichten zum gleichen Magento-Auftrag automatisch zu einem Vorgang zusammen zu fassen, kann diese Funktion hier aktiviert und das gewünschte Präfix ausgewählt werden.
  • Vorgangsnummern automatisch zuordnen
  • Wenn diese Option aktiviert ist, werden die Vorgangsnummern von Nachrichten, zu denen ein Magento-Auftrag gefunden wird, automatisch dem Auftrag zugeordnet. Ist die Option deaktiviert, so kann diese Zuordnung nur manuell erfolgen.
  • Feld für Kunden-ID
    Sofern bereits ein Benutzerdefiniertes Feld in GREYHOUND angelegt wurde, kann dieses Feld hier ausgewählt werden. Alternativ kann dieses hier angelegt werden. Sofern keine automatische Kontaktsynchronisierung in GREYHOUND eingerichtet wurde, sind hier keine Angaben notwendig.
  • Schnellzugriff für Textbausteine
    Hier kann der Basistextbaustein ausgewählt werden, welcher direkt über das Addon erreichbar sein soll. Damit entfällt das Wechseln des Karteireiters zwischen Addon und Textbausteinen.
  • CC an Auftrags-E-Mail
    Ist diese Option aktiviert, wird beim Antworten eine Kopie (CC) der Nachricht an die E-Mailadresse des Kunden gesendet, welche im Auftrag steht.

Erweiterte Einstellungen

  • Administration
    Normalerweise ist der Einstellungsdialog des Addons nur für Administratoren sichtbar und bearbeitbar. Dies hängt von der Berechtigung “Erweiterungen bearbeiten” im Profil ab. Wenn die Option “Einstellung für alle Benutzer bearbeitbar machen” im Magento-Addon aktiviert wird, dann können alle Benutzer, also auch solche, die dieses Profilrecht nicht besitzen, die Einstellungen des Addons sehen und bearbeiten. Die Option sollte unter normalen Umständen nicht aktiviert werden, weil sie die normale Berechtigungsstruktur aushebelt.
  • Timeout
    Bei besonders großen Magento-Systemen kann es notwendig sein den Timeout-Wert anzuheben, damit Verbindungsdaten angezeigt werden.
  • Debug-Modus
    Zu besseren Fehleranalyse kann der Debug-Modus aktiviert werden. Damit werden dann detailliertere Informationen bei Problemen angezeigt. Zusätzlich wird damit eine Option aktiv mit der Informationen direkt an den GREYHOUND Kundenservice gesendet werden können.

Variablen für Textbausteine

Beim Beantworten oder Verfassen einer Nachricht über die Buttons in der Seitenleiste stellt das Magento-Addon einige Variablen bereit, die im Text der Nachricht oder in eingefügten Textbausteinen ersetzt werden. Der Inhalt der Variablen hängt von den Auftrags- und Kundendaten ab, die das Addon ermittelt hat. Welche Addon-Variablen für Textbausteine zur Verfügung stehen, variiert je nach Addon. Eine Liste aller aus Magento zur Verfügung stehenden Werte ist im GREYHOUND Client zu finden:

  1. Über Erweiterungen den Eintrag des Addons mit der Ergänzung – Hilfe auswählen.
  2. Der damit geöffnete Dialog zeigt – neben kurzen Hinweisen und Links – im Wesentlichen eine umfassende Liste aller vom Addon bereitgestellten Werte an. Links findet sich jeweils die genaue Bezeichnung der Variable, wie sie auch in Textbausteinen verwendet werden kann. Recht steht zu jeder Variable eine kurze Beschreibung.

Tipp
Wenn man einen Variablennamen einfach anklickt, wird automatisch der gesamte Name ausgewählt. Man kann ihn nun mit STRG + C in die Zwischenablage kopieren und mit STRG + V von dort in einer Nachricht oder einem Textbaustein direkt wieder einfügen.

NEU: Artikel-IDs & Artikeldetails als Addon-Variable bereitstellen

Magento arbeitet mit Artikelnummern bzw. Artikel-IDs. Um mit diesen auch in GREYHOUND “weiterarbeiten” zu können, stehen diese ab Version 2.0.46 build 223 des Magento Connect Addons ebenfalls als Variablen bereit. Neu hinzugekommen sind damit folgende Addon-Variablen:

[$Order.ItemIDs] – Artikel-ID(s) der Bestellung
[$Order.ItemIDsSearch] – Artikel-ID-Suchindex. Dies ist eine dediziert für die Suche in GREYHOUND angelegte Variable. Sie ermöglicht es, in GREYHOUND nach Artikel-IDs suchen und alle Elemente finden zu können, in denen es um den entsprechenden Artikel geht. Eine Eingabe von “,A4711,” in das Suchfeld bei GREYHOUND zeigt beispielsweise alle Elemente an, in denen es um den Artikel mit der ID A4711 geht. Die Kommas direkt vor und hinter einer Artikel-ID (ohne Leerzeichen!), dienen dazu, dass man bei der Suche nach “,A1001,” nur Elemente findet, wo es um den Artikel A1001 geht – nicht aber um Artikel A100123. Möchte man nach mehreren Artikel-IDs gleichzeitig suchen, ist die Syntax wie folgt: “,A123,A234,A456,”
[$Order.ItemNumbers] – Artikelnummer(n) der Bestellung
[$Order.ItemNumbersSearch] – Artikelnummern-Suchindex. Dies ist eine dediziert für die Suche in GREYHOUND angelegte Variable. Sie ermöglicht es, in GREYHOUND nach Artikelnummern suchen und alle Elemente finden zu können, in denen es um den entsprechenden Artikel geht. Eine Eingabe von “,A4711,” in das Suchfeld bei GREYHOUND zeigt beispielsweise alle Elemente an, in denen es um den Artikel mit der Artikelnummer A4711 geht. Die Kommas direkt vor und hinter einer Artikelnummer (ohne Leerzeichen!), dienen dazu, dass man bei der Suche nach “,A1001,” nur Elemente findet, wo es um den Artikel A1001 geht – nicht aber um Artikel A100123. Möchte man nach mehreren Artikelnummern gleichzeitig suchen, ist die Syntax wie folgt: “,A123,A234,A456,”

Diese Werte können in GREYHOUND in Textbausteinen verwendet werden oder in benutzerdefinierte Felder übernommen werden.

Zusätzlich werden die wesentlichen Daten aus den einzelnen Auftragspositionen, also z. B. Artikelnummer und -name, bereitgestellt. Diese Möglichkeit ist limitiert auf die ersten 10 Artikel des Auftrags. Für diese stehen zudem folgende Variablen zur Verwendung in Textbausteinen oder an anderer Stelle zur Verfügung:

[$Order.Item1.ID] – Artikel-ID von Artikel 1 des Auftrags
[$Order.Item1.Number] – Artikelnummer von Artikel 1 des Auftrags
[$Order.Item1.Name] – Artikelname von Artikel 1 des Auftrags
[$Order.Item1.Quantity]– Artikelanzahl von Artikel 1 des Auftrags
[$Order.Item1.Price] – Einzelpreis von Artikel 1 des Auftrags
[$Order.Item1.PriceInfo.Value] – Preisinformation – Wert von Artikel 1 des Auftrags
[$Order.Item1.PriceInfo.Currency] – Preisinformation – Währung von Artikel 1 des Auftrags
[$Order.Item1.TotalPrice] – Gesamtpreis von Artikel 1 des Auftrags
[$Order.Item1.TotalPriceInfo.Value] – Preisinformation – Gesamtwert von Artikel 1 des Auftrags
[$Order.Item1.TotalPriceInfo.Currency] – Preisinformation- Währung des Gesamtpreises von Artikel 1 des Auftrags

All die oben stehenden Variablen beziehen sich auf Order.Item1 der Bestellung, also das technisch gesehen erste Produkt des Auftrags. Tauscht man die 1 durch eine 2 aus, werden die Werte für Produkt 2 ausgegeben usw. – das geht bis Artikel 10 des Auftrags, also: [$Order.Item10.ID].