Returnless Connect

Das Returnless-Addon kann jederzeit einem bestehenden GREYHOUND-Vertrag hinzugebucht werden. Der GREYHOUND Server und die Clients installieren das Addon dann vollautomatisch.

Für die Verwendung des Returnless Connect-Addons ist eine GREYHOUND-Version 5.1.150 build 3272 oder höher notwendig.

Notwendige Vorbereitung

Für die Nutzung des Returnless-Addons wird ein API Key benötigt. Dieser muss zunächst im Backend von Returnless unter Einstellungen > Integrationen > API-Schlüssel durch Klick auf den Button “API-Schlüssel erstellen” generiert werden und ist anschließend in GREYHOUND zu hinterlegen.

Addon zum Vertrag hinzubuchen

Das Produkt Returnless Connect kann im GREYHOUND Control Center (GCC) jederzeit dem bestehenden Vertrag hinzugebucht werden.

  1. Nach dem Login unter Verträge den Vertrag auswählen und bearbeiten.
  2. Unter den Vertragsinhalten auf Produkte ändern klicken.
  3. Das gewünschte Addon “Returnless Connect (BETA)” anhaken.
  4. Die Änderungen sind zum Schluss noch mit Weiter zu bestätigen und nach einer Prüfung zu übernehmen.

Hinweis für Eigenbetriebler

  • Kunden im Individualbetrieb müssen die Verwendung des gebuchten Addons zusätzlich im GREYHOUND Admin aktivieren. Außerdem sind die Funktionen des neuen Addons erst nach einem Neustart des GREYHOUND Clients verfügbar.
  • Kunden im überwachten Eigenbetrieb müssen sicherstellen, dass Port 9443 in der Firewall wie hier beschrieben eingehend und ausgehend freigegeben ist.

Returnless Connect einrichten

Im Folgenden ist beschrieben, wie die Anbindung an Returnless in GREYHOUND eingerichtet wird.

Verbindung zu Returnless herstellen

Um Returnless und GREYHOUND zu verknüpfen, bitte zunächst zu Erweiterungen > Addon Manager navigieren.

  • Im Addon Manager kann man über das Plus-Icon unten links eine neue Verbindung hinzufügen und entsprechend “Returnless” auswählen.
  • In der neuen Verbindung muss dann der API-Schlüssel aus Returnless eingetragen werden. Hier ist beschrieben, wie/wo dieser zu generieren ist.
  • Über den Button “Verbindung testen” kann und sollte getestet werden, ob GREYHOUND mit den eingegebenen Daten eine Verbindung zu Returnless herstellen kann.
  • Wenn alles passt, den Haken bei “Aktiv” setzen und speichern.

Autorisierung & Ablehnung von returnless Anfragen

Retourenanfragen, die über returnless eingehen, lassen sich direkt aus GREYHOUND heraus genehmigen oder ablehnen – ein separater Login im returnless-Backend ist dafür nicht erforderlich.

Voraussetzung dafür ist die einmalige Einrichtung einer zugehörigen Workflow-Regel, welche via einem Rechtsklick > Link speichern unter herunterladen werden kann:

Nach dem Download ist die Regel “Workflow: returnless Autorisierungen & Ablehnungen” in GREYHOUND unter Einstellungen > Regeln durch einen Klick auf den Importieren-Button hochzuladen.

Damit sie funktioniert, bitte im Regelknoten “API KEY” auf “Quelltextfunktion bearbeiten” klicken und in der zweiten Zeile wie im folgenden Screenshot gezeigt den API-Key von returnless eingetragen:

Dabei bitte unbedingt auf die korrekte Formatierung achten:
API_KEY = '[hier API Key einfügen]';

Anschließend ist die Regel im Status “Aktiviert” zu speichern.

Hinweis: Hier ist beschrieben, wo der API-Key im returnless Backend zu finden ist.

Sobald die Regel inklusive gültigem API Key aktiviert ist, gilt:

  • Wird eine eingehende Retourenanfrage in GREYHOUND als erledigt markiert, wird sie automatisch im returnless-System autorisiert.
  • Klickt man stattdessen auf Ablehnen, dann wird die Anfrage entsprechend zurückgewiesen.
  • Der gesamte Prozess läuft im Hintergrund über die returnless-API ab – für den Bearbeiter ändert sich am gewohnten Workflow nichts.

Direktlinks zu Retourenformularen generieren

Um dem Kunden einen Direktlink für eine Retouren-Anfrage zur Verfügung stellen zu können, ist in der Addon-Seitenleiste oben neben der Suchleiste ein kleines Menü mit drei Strichen. Klickt man darauf und wählt anschließend “Retourenformlare” aus…

… erscheint ein kleines Popup-Fenster zum Kopieren von Links zu Retourenformularen für verschiedene Sprachen:

Optionale Konfiguration

Im Addon Manager gibt es neben dem Anlegen der Verbindungsdaten noch einige weitere, optionale Einstellungen. Beispielsweise lässt sich definieren, welche Daten die Vorschauzeile anzeigen soll sowie ob und welche Auftragsdaten aus einem Addon in benutzerdefinierte Felder in GREYHOUND geschrieben werden sollen. 

Die optionalen Einstellungen sind für alle Addons identisch, weshalb sie zentral an folgender Stelle im Handbuch beschrieben sind:

Optionale Addon-Einstellungen