4.1.18. GREYHOUND Connect für Shopware

Die Installation des Shopware Connect Addons ist mit wenigen Handgriffen erledigt. Das Addon kann bequem dem bestehenden GREYHOUND-Vertrag hinzugebucht werden. Der GREYHOUND Server und die Clients installieren das Addon dann vollautomatisch.

Achtung! Für die Verwendung des Shopware Connect-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 Funktionen > Erweiterungen entfernt werden, damit es beim Anwender nicht zu Verwechslungen kommt.

1. Das Addon GREYHOUND Connect für Shopware benötigt ein zusätzliches Plugin, um die Shopware API so zu erweitern, dass sie alle vom Addon benötigten Daten an GREYHOUND ausliefern kann. Dieses Plugin steht im Shopware-Store unter der Bezeichnung GREYHOUND CRM Connect kostenlos zur Verfügung. Mit dem Suchbegriff "greyhound" lässt es sich jederzeit schnell finden.
2. Zum Installieren GREYHOUND CRM Connect auswählen und dann einfach auf Plugin installieren klicken.
3. Das installierte Plugin wird dann im Bereich Shopware-Erweiterungen angezeigt.
4. Eine Konfiguration des Plugins ist nicht erforderlich, allerdings muss es aktiviert werden. Dazu die Einstellungen des Plugins öffnen und dort die Option Plugin aktivieren anwählen. Anschließend auf Plugin-Einstellungen speichern klicken.
Hat alles geklappt, sollte der Eintrag im Shopware Plugin-Manager schließlich wie in der folgenden Abbildung aussehen:
Damit das Addon Daten vom Shopware Shop abrufen und in GREYHOUND anzeigen kann, muss ein API Benutzer eingerichtet werden. Sofern nicht bereits ein API Benutzer existiert kann im Shopware Backend unter Einstellungen > Benutzerverwaltung über den Button Benutzer hinzufügen ein neuer Benutzer erstellt werden. Der Benutzer muss aktiviert sein und im Bereich API-Zugang muss ebenfalls der API-Zugang aktiviert werden. Der Benutzername und der API-Schlüssel werden später im Shopware-Addon hinterlegt.

Perma Link2. "GREYHOUND Connect für Shopware" dem GREYHOUND Vertrag hinzubuchen

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

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.

Perma Link3. GREYHOUND Connect für Shopware in GREYHOUND einrichten

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

Nachdem das Addon dem Vertrag hinzugebucht wurde, erscheint im GREYHOUND Client ein neuer Menüeintrag Erweiterungen > Shopware Connect - Einstellungen. Darin werden einmalig die individuellen Verbindungsdaten zu Shopware, sowie einige globale Einstellungen konfiguriert.

Perma LinkVerbindungseinstellungen

Neben einer optionalen Bezeichnung sind hier die Benutzerdaten des zuvor angelegten API-Benutzers einzutragen. Weiterhin muss an dieser Stelle die API URL des Shopware Shops eingetragen werden. Üblicherweise ist das die URL des Shops mit angehängtem /api, also beispielsweise https://www.meinshop.de/api. Außerdem müssen der Benutzername und der API-Schlüssel des API Benutzers im Shopware Shop eingetragen werden (siehe Punkt 3). In dem Feld Empfänger können die E-Mailadressen eingetragen werden, bei denen das Addon in Shopware nach Auftragsdaten suchen soll. Sollen alle Mails durchsucht werden, ist der Platzhalter "*" einzugeben. Das Feld darf nicht leer bleiben!

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.

  • Präfix für Vorgangsnummern
    Um eingehende Nachrichten zum gleichen Shopware-Auftrag automatisch zu einem Vorgang zusammen zu fassen, kann diese Funktion hier aktiviert und das gewünschte Präfix ausgewählt werden.

  • 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 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.

Perma LinkErweiterte Einstellungen

  • Timeout
    Bei besonders großen Shopware-Systemen kann es notwendig sein den Timeout-Wert anzuheben, damit Verbindungsdaten angezeigt werden.

  • Debug-Modus
    Zu besseren Fehleranalyse kann der Debugmodus 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.

Sind alle Daten korrekt hinterlegt, kann man das Addon GREYHOUND Connect für Shopware nutzen.

Perma LinkVariablen für Textbausteine

Beim Antworten oder Verfassen einer Nachricht über die Buttons in der Seitenleiste des Addons stellt das 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. So können z.B. Variablen wie die Lieferanschrift leer sein, wenn in den Auftragsdaten keine separate Lieferanschrift übermittelt wurde. Wie üblich kann die Vorschaufunktion beim Verfassen der Nachricht genutzt werden, um zu überprüfen, durch welche Daten die Variablen ersetzt werden.
Es folgt eine Auflistung der Variablen und ihres Inhalts:
Variable
Beschreibung
[$Order.OrderNumber] Bestellnummer
[$Order.InvoiceNumber] Rechnungsnummer
[$Order.CustomerNumber] Kundennummer
[$Order.Date] Bestelldatum (Tag.Monat.Jahr)
[$Order.DateInfo.D] Bestelldatum (Tag, z.B. "01")
[$Order.DateInfo.M] Bestelldatum (Monat, z.B. "02")
[$Order.DateInfo.Y] Bestelldatum (Jahr, z.B. "2013")
[$Order.DateInfo.Day.DE] Bestelldatum (Tag auf deutsch, z.B. "Montag")
[$Order.DateInfo.Day.EN] Bestelldatum (Tag auf englisch, z.B. "Monday")
[$Order.DateInfo.Day.ES] Bestelldatum (Tag auf spanisch, z.B. "Lunes")
[$Order.DateInfo.Day.FR] Bestelldatum (Tag auf französisch, z.B. "Lundi")
[$Order.DateInfo.Month.DE] Bestelldatum (Monat auf deutsch, z.B. "Januar")
[$Order.DateInfo.Month.EN] Bestelldatum (Monat auf englisch, z.B. "January")
[$Order.DateInfo.Month.ES] Bestelldatum (Monat auf spanisch, z.B. "Enero")
[$Order.DateInfo.Month.FR] Bestelldatum (Monat auf französisch, z.B. "Janvier")
[$Order.DateInfo.Timestamp] Bestelldatum (Unix-Zeitstempel, Sekunden seit 01.01.1970)
[$Order.TotalAmount] Gesamtbetrag des Auftrags inkl. Währung
[$Order.TotalAmountInfo.Value] Gesamtbetrag des Auftrags (Zahl mit Dezimalpunkt)
[$Order.TotalAmountInfo.Currency] Währung des Gesamtbetrags (drei Buchstaben)


[$BillingAddress.Company] Rechnungsanschrift: Firma
[$BillingAddress.Salutation] Rechnungsanschrift: Anrede
[$BillingAddress.Sex.Number] Rechnungsanschrift: Geschlecht ("0" = unbekannt, "1" = männlich, "2" = weiblich)
[$BillingAddress.Sex.Name] Rechnungsanschrift: Geschlecht ("Unbekannt", "Männlich", "Weiblich")
[$BillingAddress.Name] Rechnungsanschrift: Vorname und Nachname
[$BillingAddress.Firstname] Rechnungsanschrift: Vorname
[$BillingAddress.Lastname] Rechnungsanschrift: Nachname
[$BillingAddress.Letter.Identifier] Rechnungsanschrift: Straße, Postleitzahl, Stadt, Land in einer Zeile (komma-getrennt)
[$BillingAddress.Letter.Street] Rechnungsanschrift: Straße und Hausnummer
[$BillingAddress.Letter.AdditionalInfo] Rechnungsanschrift: Zusatzinfo (z.B. Appartment, Etage)
[$BillingAddress.Letter.ZipCode] Rechnungsanschrift: Postleitzahl
[$BillingAddress.Letter.City] Rechnungsanschrift: Stadt
[$BillingAddress.Letter.Country] Rechnungsanschrift: Land
[$BillingAddress.Letter.CountryInfo.ISO2] Rechnungsanschrift: ISO3166 Länderkürzel (zwei Buchstaben)
[$BillingAddress.Letter.CountryInfo.ISO3] Rechnungsanschrift: ISO3166 Länderkürzel (drei Buchstaben)
[$BillingAddress.Letter.CountryInfo.DE] Rechnungsanschrift: Land (deutsche Schreibweise)
[$BillingAddress.Letter.CountryInfo.DE_UC] Rechnungsanschrift: Land (deutsche Schreibweise, Blockbuchstaben)
[$BillingAddress.Letter.CountryInfo.EN] Rechnungsanschrift: Land (englische Schreibweise)
[$BillingAddress.Letter.CountryInfo.EN_UC] Rechnungsanschrift: Land (englische Schreibweise, Blockbuchstaben)
[$BillingAddress.Letter.CountryInfo.ES] Rechnungsanschrift: Land (spanische Schreibweise)
[$BillingAddress.Letter.CountryInfo.ES_UC] Rechnungsanschrift: Land (spanische Schreibweise, Blockbuchstaben)
[$BillingAddress.Letter.CountryInfo.FR] Rechnungsanschrift: Land (französische Schreibweise)
[$BillingAddress.Letter.CountryInfo.FR_UC] Rechnungsanschrift: Land (französische Schreibweise, Blockbuchstaben)
[$BillingAddress.Email] Rechnungsanschrift: E-Mail Adresse
[$BillingAddress.Phone] Rechnungsanschrift: Telefonnummer
[$BillingAddress.Fax] Rechnungsanschrift: Faxnummer
[$BillingAddress.Birthday] Rechnungsanschrift: Geburtsdatum (Tag.Monat.Jahr)
[$BillingAddress.BirthdayInfo.D] Rechnungsanschrift: Geburtsdatum (Tag, z.B. "01")
[$BillingAddress.BirthdayInfo.M] Rechnungsanschrift: Geburtsdatum (Monat, z.B. "02")
[$BillingAddress.BirthdayInfo.Y] Rechnungsanschrift: Geburtsdatum (Jahr, z.B. "2013")
[$BillingAddress.BirthdayInfo.Day.DE] Rechnungsanschrift: Geburtsdatum (Tag auf deutsch, z.B. "Montag")
[$BillingAddress.BirthdayInfo.Day.EN] Rechnungsanschrift: Geburtsdatum (Tag auf englisch, z.B. "Monday")
[$BillingAddress.BirthdayInfo.Day.ES] Rechnungsanschrift: Geburtsdatum (Tag auf spanisch, z.B. "Lunes")
[$BillingAddress.BirthdayInfo.Day.FR] Rechnungsanschrift: Geburtsdatum (Tag auf französisch, z.B. "Lundi")
[$BillingAddress.BirthdayInfo.Month.DE] Rechnungsanschrift: Geburtsdatum (Monat auf deutsch, z.B. "Januar")
[$BillingAddress.BirthdayInfo.Month.EN] Rechnungsanschrift: Geburtsdatum (Monat auf englisch, z.B. "January")
[$BillingAddress.BirthdayInfo.Month.ES] Rechnungsanschrift: Geburtsdatum (Monat auf spanisch, z.B. "Enero")
[$BillingAddress.BirthdayInfo.Month.FR] Rechnungsanschrift: Geburtsdatum (Monat auf französisch, z.B. "Janvier")
[$BillingAddress.BirthdayInfo.Timestamp] Rechnungsanschrift: Geburtsdatum (Unix-Zeitstempel, Sekunden seit 01.01.1970)


[$ShippingAddress.Company] Lieferanschrift: Firma
[$ShippingAddress.Salutation] Lieferanschrift: Anrede
[$ShippingAddress.Sex.Number] Lieferanschrift: Geschlecht ("0" = unbekannt, "1" = männlich, "2" = weiblich)
[$ShippingAddress.Sex.Name] Lieferanschrift: Geschlecht ("Unbekannt", "Männlich", "Weiblich")
[$ShippingAddress.Name] Lieferanschrift: Vorname und Nachname
[$ShippingAddress.Firstname] Lieferanschrift: Vorname
[$ShippingAddress.Lastname] Lieferanschrift: Nachname
[$ShippingAddress.Letter.Identifier] Lieferanschrift: Straße, Postleitzahl, Stadt, Land in einer Zeile (komma-getrennt)
[$ShippingAddress.Letter.Street] Lieferanschrift: Straße und Hausnummer
[$ShippingAddress.Letter.AdditionalInfo] Lieferanschrift: Zusatzinfo (z.B. Appartment, Etage)
[$ShippingAddress.Letter.ZipCode] Lieferanschrift: Postleitzahl
[$ShippingAddress.Letter.City] Lieferanschrift: Stadt
[$ShippingAddress.Letter.Country] Lieferanschrift: Land
[$ShippingAddress.Letter.CountryInfo.ISO2] Lieferanschrift: ISO3166 Länderkürzel (zwei Buchstaben)
[$ShippingAddress.Letter.CountryInfo.ISO3] Lieferanschrift: ISO3166 Länderkürzel (drei Buchstaben)
[$ShippingAddress.Letter.CountryInfo.DE] Lieferanschrift: Land (deutsche Schreibweise)
[$ShippingAddress.Letter.CountryInfo.DE_UC] Lieferanschrift: Land (deutsche Schreibweise, Blockbuchstaben)
[$ShippingAddress.Letter.CountryInfo.EN] Lieferanschrift: Land (englische Schreibweise)
[$ShippingAddress.Letter.CountryInfo.EN_UC] Lieferanschrift: Land (englische Schreibweise, Blockbuchstaben)
[$ShippingAddress.Letter.CountryInfo.ES] Lieferanschrift: Land (spanische Schreibweise)
[$ShippingAddress.Letter.CountryInfo.ES_UC] Lieferanschrift: Land (spanische Schreibweise, Blockbuchstaben)
[$ShippingAddress.Letter.CountryInfo.FR] Lieferanschrift: Land (französische Schreibweise)
[$ShippingAddress.Letter.CountryInfo.FR_UC] Lieferanschrift: Land (französische Schreibweise, Blockbuchstaben)


[$Payment.Method] Zahlungsart
[$Payment.TransactionID] Transaktions-ID des Zahlungsanbieters


[$Shipping.Provider] Versanddienstleister
[$Shipping.Costs] Versandkosten inkl. Währung
[$Shipping.CostsInfo.Value] Versandkosten (Zahl mit Dezimalpunkt)
[$Shipping.CostsInfo.Currency] Währung der Versandkosten (drei Buchstaben)
[$Shipping.Date] Lieferdatum (Tag.Monat.Jahr)
[$Shipping.DateInfo.D] Lieferdatum (Tag, z.B. "01")
[$Shipping.DateInfo.M] Lieferdatum (Monat, z.B. "02")
[$Shipping.DateInfo.Y] Lieferdatum (Jahr, z.B. "2013")
[$Shipping.DateInfo.Day.DE] Lieferdatum (Tag auf deutsch, z.B. "Montag")
[$Shipping.DateInfo.Day.EN] Lieferdatum (Tag auf englisch, z.B. "Monday")
[$Shipping.DateInfo.Day.ES] Lieferdatum (Tag auf spanisch, z.B. "Lunes")
[$Shipping.DateInfo.Day.FR] Lieferdatum (Tag auf französisch, z.B. "Lundi")
[$Shipping.DateInfo.Month.DE] Lieferdatum (Monat auf deutsch, z.B. "Januar")
[$Shipping.DateInfo.Month.EN] Lieferdatum (Monat auf englisch, z.B. "January")
[$Shipping.DateInfo.Month.ES] Lieferdatum (Monat auf spanisch, z.B. "Enero")
[$Shipping.DateInfo.Month.FR] Lieferdatum (Monat auf französisch, z.B. "Janvier")
[$Shipping.DateInfo.Timestamp] Lieferdatum (Unix-Zeitstempel, Sekunden seit 01.01.1970)
[$Shipping.Tracking.Code] Sendungsnummer / Tracking-Code


[$Addon.Name] Name des Addons
[$Addon.Version] Version des Addons (z.B. "1.2.3 build 456")
[$Addon.VersionInfo.Number] Versionsnummer des Addons (z.B. "1.2.3")
[$Addon.VersionInfo.Build] Build-Nummer des Addons (z.B. "456")
Datei
Dateigröße
Breite
Höhe
3_fertiginstalliert.png 99,41 KB 800px 554px