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.

NEU – Anleitung: Nach Update auf Shopware 6

Ab Addon-Version 2.0.60 build 244 ist das Addon “GREYHOUND Connect für Shopware” kompatibel mit Shopware 6. Für alle, die auf Shopware 6 updaten bedeutet dies, dass sie entsprechend auch das Addon in GREYHOUND einmal updaten müssen, damit die Shopware-Anbindung weiterhin funktioniert. Dazu sind die folgenden vier Schritte nötig:

  1. “GREYHOUND Connect” Plugin im Shopware Store herunterladen.
    Im Shopware-Plugin-Store muss einmal das neue, mit Shopware 6 kompatible “GREYHOUND Connect” Plugin installiert und – wichtig – aktiviert werden. Dieses ist hier zu finden: GREYHOUND Connect für Shopware 6
    Mehr dazu hier.
  2. Vorbereitung in Shopware: Neue Integration anlegen.
    Nun ist im Shopware-Administrationsbereich eine neue Integration anzulegen. Dazu bitte in Shopware zu Einstellungen > System > Integrationen navigieren und eine neue Integration mit Administrator-Berechtigungen anlegen und ihr einen sinnvollen Namen geben, z. B. “GREYHOUND Connect”. Die angezeigte Zugangs-ID und der Sicherheitsschlüssel bitte einmal sicher ablegen, bzw. zwischenspeichern oder den Tab offen lassen – diese müssen gleich in GREYHOUND eingetragen werden.
    Mehr dazu hier.
  3. Das Connect Addon in GREYHOUND updaten.
    Im GREYHOUND Windows Client über Funktionen > Addons aktualisieren einmal die aktuellste Version des Addons herunterladen, indem man den Button “Alle Addons aktualisieren” wählt:



    Anschließend den Client bitte einmal schließen und neu starten. Mehr dazu hier.
  4. Die Addon-Einstellungen in GREYHOUND anpassen.
    Sobald Version 2.0.60 build 244 (oder neuer) des Shopware-Addons in GREYHOUND installiert ist, findet sich unter Erweiterungen > Shopware Connect – Einstellungen die neue Abfrage “Shopware-Version“. Hier ist nach dem Update auf Shopware 6 entsprechend “Shopware 6” auszuwählen:



    Der soeben beim Anlegen der Integration erzeugte Wert Zugangs-ID ist nun als Benutzername im GREYHOUND-Addon einzutragen. Der erzeugte Sicherheitsschlüssel ist im Feld API Schlüssel einzutragen:



    Anschließend einmal mit “OK” speichern, fertig.

Vorbereitung in Shopware

Plugin installieren

1. Um GREYHOUND und Shopware zu verbinden, braucht es von Seiten Shopware ein zusätzliches Plugin. Dieses Plugin steht im Shopware-Store unter der Bezeichnung “GREYHOUND Connect” kostenlos zur Verfügung. Mit dem Suchbegriff “greyhound” lässt es sich jederzeit schnell finden.

Achtung: Das Plugin steht in zwei Versionen zur Verfügung – einmal für Shopware 5 und einmal für Shopware 6. Die Direkt-Links zu den beiden Versionen sind:

Hinweis für alle, die nicht die obigen Links nutzen, sondern manuell im Plugin-Store suchen: Bitte im Bereich “Kompatibilität” auf die richtige Version (Shopware 5 / Shopware 6) achten.

2. Zum Installieren die gewünschte Version des “GREYHOUND Connect” auswählen und auf Plugin installieren klicken.

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

Damit das Addon Daten vom Shopware-Shop abrufen und in GREYHOUND anzeigen kann, müssen Berechtigungen erteilt werden. Dazu muss unter Verwendung von Shopware 5 ein API-Zugang eingerichtet werden. Für Nutzer von Shopware 6 ist ein Integration erforderlich. Beim folgenden Schritt also entsprechend das Kapitel verfolgen für die jeweils eingesetzte Shopware-Version und das andere überspringen:

Für Shopware 6: Integration anlegen

Im Administrationsbereich des Shops kann unter Einstellungen > System > Integrationen eine neue Integration angelegt werden. Diese sollte einen sinnvollen Namen erhalten, damit man später noch zuordnen kann, wozu diese Integration dient – z.B. “GREYHOUND Connect”. Die Integration benötigt Administrator-Berechtigungen, damit das GREYHOUND Connect für Shopware Addon nicht nur Auftrags- und Kundendaten anzeigen, sondern z.B. auch Kunden synchronisieren kann. Beim Anlegen der Integration wird eine Zugangs-ID und ein Sicherheitsschlüssel angezeigt. Die Zugangs-ID wird später in GREYHOUND in den Einstellungen des Addons als Benutzername eingetragen und der Sicherheitsschlüssel als API Key. Vor dem Speichern der Integration müssen also diese beiden Werte kopiert werden, insbesondere, da der Sicherheitsschlüssel später nur neu generiert, aber nicht mehr angezeigt werden kann. Sollte es später erforderlich sein, den Sicherheitsschlüssel neu zu generieren, so kann der neue Schlüssel jederzeit wieder in den Addon-Einstellungen in GREYHOUND eingetragen werden.

Für Shopware 5: API-Benutzer anlegen

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.

“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:

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

Verbindungseinstellungen

Neben einer optionalen Bezeichnung ist hier die Shopware Version (5 oder 6) auszuwählen und die Zugangsdaten und die API URL des Shopware Shops einzutragen. Für Shopware 6 wird die Zugangs-ID der zuvor angelegten Integration als Benutzername eingetragen und der Sicherheitsschlüssel als API Key. Für Shopware 5 wird der Benutzername und der API Key des zuvor angelegten API Benutzers eingetragen. Die API URL ist üblicherweise die URL des Shops mit angehängtem /api, also beispielsweise https://www.meinshop.de/api.

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.

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.

Globale Einstellungen

  • 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.
  • Vorgangsnummern automatisch zuordnen
    Wenn diese Funktion aktiviert ist, werden die Vorgangsnummern von Nachrichten, zu denen ein Shopware-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 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 Shopware-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 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.

Variablen 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”)

[$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,”
[$Order.Item1.ID] Artikel-ID von Artikel 1 des Auftrags

Hinweis: Diese und die folgenden Variablen gehen von Artikel 1 bis Artikel 10 des Auftrags, also z. B. [$Order.Item3.ID] für die Artikel-ID des 3. Artikels der Bestellung und [$Order.Item10.ID] für die Artikel-ID des 10. Artikels der Bestellung
[$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

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

Shopware arbeitet mit Artikelnummern bzw. Artikel-IDs. Um mit diesen auch in GREYHOUND “weiterarbeiten” zu können, stehen diese ab Version 2.0.59 build 243 des Shopware 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].