plentymarkets Connect

Die Installation des Addons ist mit wenigen Handgriffen erledigt. Nach einigen Vorbereitungen in plentymarkets 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 plentymarkets 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 Einstellungen > Erweiterungenentfernt oder deaktiviert werden, damit es beim Anwender nicht zu Verwechslungen kommt.

Vorbereitung in plentymarkets

Der Zugriff auf die Daten von plentymarkets ist prinzipiell über jeden beliebigen bestehenden Benutzer mit der plentymarkets Benutzerklasse Admin möglich. Aus Sicherheitsgründen empfehlen wir jedoch wie folgt einen eigenen Benutzer mit eingeschränkten Rechten anzulegen:

Vorgehen bei Verwendung der REST-API

Im plentymarkets Adminbereich unter System > Systemeinstellungen > Einstellungen > Benutzer > Konten einen neuen Benutzer greyhound erstellen und für diesen Benutzer die Einstellung “Zugang: REST API” auswählen:

In plentymarkets können für das Benutzerkonto im Karteireiter Berechtigungen unter Sichtbarkeiten die sichtbaren Auftragsstati ausgewählt werden (im Zweifelsfall alle auswählen), sowie die Mandanten/Shops, auf die der Benutzer Zugriff bekommt (im Zweifelsfall alle) und die plentymarkets Shipping Einträge (im Zweifelsfall alle). Die setzbaren Auftragsstati müssen nicht ausgewählt werden, da das Addon nur lesend auf plentymarkets zugreift.

Schnittstellen-Berechtigungen

In den Systemeinstellungen können dann unter Einstellungen > Benutzer > Rechte > Benutzer für diesen Benutzer die folgenden Berechtigungen erteilt werden:

Aufträge
- Aufträge anzeigen
- Auftragsadressen
-- Auftragsadressen anzeigen

- Auftragseigenschaften
-- Eigenschaft anzeigen

-Auftragspositionen
-- Datumsangaben für Auftragspositionen
--- Datumsangabe anzeigen
-- Eigenschaften von Auftragspositionen
--- Eigenschaft anzeigen
-- Transaktionen
--- Transaktionen anzeigen

- Auftragsstatus
-- Auftragsstatus anzeigen

- Bestellungen
-- Bestellungen anzeigen

- Dokumente
-- Dokument anzeigen

- Referenzen für Auftragsrelationen
-- Referenz anzeigen

- Sammelauftrag
-- Sammelauftrag anzeigen

- Versand
-- Versandpaket
--- Artikel im Versandpaket
---- Artikel im Versandpaket anzeigen
--- Versandpaket anzeigen

- Kommentare
-- Kommentare anzeigen

- POS
-- Kasse anzeigen

- System
-- Eigenschaft
--- Eigenschaft anzeigen

- Warenbestände
-- Bestände anzeigen

plentymarkets Connect dem GREYHOUND Vertrag hinzubuchen

Das Produkt Addon plentymarkets Connect 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.

plentymarkets Connect 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 plentymarkets Einstellungsdialogs als auch des Addons selber zu konfigurieren. Informationen über Benutzergruppen gibt es an dieser Stelle GREYHOUND Handbuch.

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

Verbindungseinstellungen

  • Zunächst ist optional eine Bezeichnung für die Verbindung einzutragen.
  • Bei Aktiv ist ein Haken zu setzen.
  • plenty-ID: Die Plenty-ID wird benötigt, um Auftrags- und Kundennummern mit einem Link zu versehen, der zum entsprechenden Datensatz im plentymarkets-Backend führt. Sie kann im plentymarkets Adminbereich eingesehen werden.
  • API URL: Hier ist der sogenannte REST API-Pfad einzutragen, welcher im plentymarkets Adminbereich unter Einstellungen > plentymarkets API-Daten eingesehen und kopiert werden kann.
  • Unter plentymarkets API ist im Dropdown Menü die entsprechende Version auszuwählen.
  • Backend URL
  • Die individuellen Benutzerdaten des zuvor angelegten API-Benutzers sind in den Feldern Benutzer und Passwort einzutragen.
  • In dem Feld Empfänger können die E-Mailadressen eingetragen werden, bei denen das Addon in plentymarkets 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 plenty-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 plentymarkets sucht.

Globale Einstellungen

  • Präfix für Vorgangsnummern
    Um eingehende Nachrichten zum gleichen plentymarkets-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 Kundennummer
    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.

Erweiterte Einstellungen

  • Timeout
    Bei besonders großen plentymarkets-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.

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.Title]Rechnungsanschrift: Titel
[$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


[$ShippingAddress.Company]Lieferanschrift: Firma
[$ShippingAddress.Title]Lieferanschrift: Titel
[$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)
[$ShippingAddress.Email]Lieferanschrift: E-Mail Adresse
[$ShippingAddress.Phone]Lieferanschrift: Telefonnummer
[$ShippingAddress.Fax]Lieferanschrift: Faxnummer


[$Payment.Method]Zahlungsart
[$Payment.Date]Zahlungsdatum (Tag.Monat.Jahr)
[$Payment.DateInfo.D]Zahlungsdatum (Tag, z.B. “01”)
[$Payment.DateInfo.M]Zahlungsdatum (Monat, z.B. “02”)
[$Payment.DateInfo.Y]Zahlungsdatum (Jahr, z.B. “2013”)
[$Payment.DateInfo.Day.DE]Zahlungsdatum (Tag auf deutsch, z.B. “Montag”)
[$Payment.DateInfo.Day.EN]Zahlungsdatum (Tag auf englisch, z.B. “Monday”)
[$Payment.DateInfo.Day.ES]Zahlungsdatum (Tag auf spanisch, z.B. “Lunes”)
[$Payment.DateInfo.Day.FR]Zahlungsdatum (Tag auf französisch, z.B. “Lundi”)
[$Payment.DateInfo.Month.DE]Zahlungsdatum (Monat auf deutsch, z.B. “Januar”)
[$Payment.DateInfo.Month.EN]Zahlungsdatum (Monat auf englisch, z.B. “January”)
[$Payment.DateInfo.Month.ES]Zahlungsdatum (Monat auf spanisch, z.B. “Enero”)
[$Payment.DateInfo.Month.FR]Zahlungsdatum (Monat auf französisch, z.B. “Janvier”)
[$Payment.DateInfo.Timestamp]Zahlungsdatum (Unix-Zeitstempel, Sekunden seit 01.01.1970)


[$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
[$Shipping.Tracking.URL]Sendungsverfolgungs-Link / Tracking-URL


[$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”)