Hermes Shipping Interface - Installations- und Konfigurationsanleitung für Shopware ab Version 5.2.x

Transkript

1 Hermes Shipping Interface Installations- und Konfigurationsanleitung für Shopware ab Version 5.2.x Autor: FATCHIP GmbH Stand: 10. Oktober 2017 Version: Hermes Shipping Interface - Installations- und Konfigurationsanleitung für Shopware ab Version 5.2.x

2 Inhaltsverzeichnis Inhaltsverzeichnis Funktionsübersicht Funktionsbeschreibung Systemvoraussetzungen und Hinweise Installation Plugin Manager öffnen Plugin suchen und laden Installation abschließen Shopware Caches leeren Hermes Shipping Interface aktivieren Shopware Caches leeren und Themes kompilieren Shopware Backend neu laden Verbindung zur Schnittstelle Verbindung mit Ihrem Geschäftskunden- Login herstellen Verbindung trennen (z.b. zum Wechseln des Benutzers) Konfiguration der Versandoption Grundsätzliches zur Funktionsweise des Plugins Verknüpfung der Versandkosten für den Versand mit Hermes Verknüpfung einer Zahlungsart für den Versand per Nachnahme Beispiel: Einrichtung von Bedingungen für den Ident- Service Verwendung der Sendungsaufträge Sendungsaufträge erzeugen Verwendung der Abholaufträge Abholaufträge erzeugen Kontaktdaten Hermes Shipping Interface - Installations- und Konfigurationsanleitung für Shopware ab Version 5.2.x Seite [ 2 von 18 ]

3 1. Funktionsübersicht 1.1 Funktionsbeschreibung Mit dem Plugin für das Hermes Shipping Interface können Sie Ihren Kunden die Versandarten und Optionen von Hermes bei der Kaufabwicklung in Ihrem Shopware Shop anbieten und profitieren von einer einfachen Abwicklung des Versands. Dazu gehören die Erzeugung der Versandaufträge und Etiketten, die Sendungsverfolgung als auch die Buchung von zu- sätzlichen Abholaufträgen direkt in ihrem Shop. 1.2 Systemvoraussetzungen und Hinweise Für die Nutzung des Shopware Plugins sind folgende Systemvoraussetzungen erforderlich: Installierter und laufähiger Shopware Shop ab Version 5.2.x Der Shop muss über ein gültiges SSL- Zertifikat betrieben werden Zugang zum Administrationsbereich des Shopware Shops Anmeldeinformationen als Geschäftskunde bei Hermes Cronjob für Shopware zum Abrufen der Sendungshistorie Um den Versand mit Hermes über das Plugin nutzen zu können, benötigen Sie einen Vertrag mit der Hermes Germany GmbH. Hierfür kontaktieren Sie bitte den Vertrieb unter vertrieb- oder Wenn Sie bereits von den Hermes- Leistungen profitieren und Hermes- Kunde sind, wenden Sie sich bitte an Ihren Ansprechpartner. Im Anschluss erhalten Sie Ihre Zugangsdaten, die Ihnen die Nutzung des Hermes- Plugins für Shopware ermöglichen. Sie können den Versand dann aus Ihrem Shopware- Backend steuern. Hermes Shipping Interface - Installations- und Konfigurationsanleitung für Shopware ab Version 5.2.x Seite [ 3 von 18 ]

4 2. Installation 2.1 Plugin Manager öffnen Öffnen Sie den Plugin Manager unter Einstellungen > Plugin Manager im Backend Ihres Shopware Shops. 2.2 Plugin suchen und laden Suchen Sie das Hermes Shipping Interface im Plugin Manager und laden Sie das Plugin per Klick auf Installieren. 2.3 Installation abschließen Nach dem vorherigen Schritt wird das Plugin unter Einstellungen > Plugin Manager > Verwaltung > Installiert in der Liste Deinstalliert angezeigt. Fahren Sie mit der Installation fort, indem Sie auf das grüne Icon (+) klicken. 2.4 Shopware Caches leeren Bestätigen Sie die Neu- Initialisierung der Caches per Klick auf Ja. 2.5 Hermes Shipping Interface aktivieren Aktivieren Sie das Plugin per Klick auf Aktivieren. Hermes Shipping Interface - Installations- und Konfigurationsanleitung für Shopware ab Version 5.2.x Seite [ 4 von 18 ]

5 2.6 Shopware Caches leeren und Themes kompilieren Bestätigen sie erneut die Neu- Initialisierung der Caches per Klick auf Ja und anschließend die Theme- Kompilierung per Klick auf Themes kompilieren. 2.7 Shopware Backend neu laden Laden Sie jetzt das Shopware Backend in Ihrem Browser neu, z.b. per Tastenkombination: Strg + F5. Hermes Shipping Interface - Installations- und Konfigurationsanleitung für Shopware ab Version 5.2.x Seite [ 5 von 18 ]

6 3. Verbindung zur Schnittstelle 3.1 Verbindung mit Ihrem Geschäftskunden- Login herstellen Tragen Sie unter Kunden > Hermes Versand > Konfiguration > Verbindung zur Schnittstelle Ihren Benutzernamen und das Passwort ein. Mit dem Betriebsmodus können Sie auswählen, ob das Plugin zu Testzwecken mit der Testumgebung verbunden sein soll, oder ob es sich im Live- Betrieb befindet. Klicken Sie anschließend auf Verbinden. Hermes Shipping Interface - Installations- und Konfigurationsanleitung für Shopware ab Version 5.2.x Seite [ 6 von 18 ]

7 3.2 Verbindung trennen (z.b. zum Wechseln des Benutzers) Die Verbindung zur Schnittstelle kann nun jederzeit per Klick auf Trennen wieder getrennt werden. Hermes Shipping Interface - Installations- und Konfigurationsanleitung für Shopware ab Version 5.2.x Seite [ 7 von 18 ]

8 4. Konfiguration der Versandoption 4.1 Grundsätzliches zur Funktionsweise des Plugins Damit Ihnen bei der Gestaltung Ihres Angebots von Versandoptionen möglichst alle Freiheiten, die Shopware bietet, erhalten bleiben, wird die Verknüpfung zwischen einer beliebigen Versandart (in Shopware) und dem Plugin durch sie konfiguriert. Daher sind nach der Installation des Plugins zunächst keine neuen Versandkosten im Shop hinterlegt. Dadurch ist es aber auch in Verbindung mit dem Plugin möglich, vielfältige Regeln für Versandkosten und Versandoptio- nen z.b. auf der Basis von Artikelmerkmalen oder Kundengruppen zu hinterlegen bzw. bestehende Versandkosten- Regeln in Ihrem Shop mit dem Plugin weiterzuverwenden. 4.2 Verknüpfung der Versandkosten für den Versand mit Hermes Ähnlich wie im vorherigen Schritt verknüpfen Sie nun weitere Versandoptionen mit dem Plugin. Rufen Sie dazu die Ver- sandkosten Verwaltung unter Einstellungen > Versandkosten auf. Wenn Sie hier bereits Versandkosten hinterlegt haben, können Sie diese ggf. weiterverwenden oder anpassen. Öffnen sie den Dialog zur Bearbeitung eines Eintrags per Klick auf den gelben Stift oder klicken Sie auf Hinzufügen um einen neuen Eintrag zu erstellen. Im Reiter Freitextfelder kön- nen Sie die zu verknüpfende Hermes- Versandart auswählen. Das Plugin unterscheidet hier grundsätzlich zwischen dem Standard- und dem Eilversand, sowie der jeweiligen Ver- sandart inklusive Ident- Service. Die Konfiguration für die Tracking- URL hat nach Verknüpfung einer Versandoption mit dem Plugin keine Auswirkungen mehr. Alle anderen Konfigurations- Felder (auch der Name) funktionieren wie gewohnt. Hermes Shipping Interface - Installations- und Konfigurationsanleitung für Shopware ab Version 5.2.x Seite [ 8 von 18 ]

9 Wiederholen Sie diese Schritte bis Sie alle Versandoptionen und Kosten, die Ihren Kunden zur Auswahl stehen sollen, mit dem Plugin verknüpft haben. Sie können beispielsweise den Standard- Versand mehrfach verknüpfen, unterschiedli- che Namen vergeben und andere Regeln für die Kosten festlegen. Mittels der Konfiguration in den anderen Reitern lässt sich bestimmen, wann bzw. unter welchen Bedingungen die jeweilige Option zur Verfügung steht. Tipp: Ausführliche Informationen zu individuellen Bedingungen und Berechnungen für Versandkosten finden Sie in der Online- Dokumentation von Shopware. Versandkosten- Bedingungen- und- Berechnungen_detail_1933.html 4.3 Verknüpfung einer Zahlungsart für den Versand per Nachnahme Um bei der Erzeugung von Sendungsaufträgen auch die Option für den Versand per Nachnahme buchen zu können, muss eine entsprechende Zahlungsart in Ihrem Shopware Shop ebenfalls mit dem Plugin verknüpft werden. Wählen Sie dazu die Zahlungsart unter Einstellungen > Zahlungsarten aus, oder legen Sie diese ggf. neu an und aktivieren Sie dann im Reiter Freitextfelder die Option Hermes- Versand per Nachnahme. Hermes Shipping Interface - Installations- und Konfigurationsanleitung für Shopware ab Version 5.2.x Seite [ 9 von 18 ]

10 4.4 Beispiel: Einrichtung von Bedingungen für den Ident- Service Um die Versandarten mit Ident- Service immer dann verpflichtend anzubieten, wenn mindestens ein Artikel im Waren- korb entsprechende Kriterien erfüllt, und sie anderenfalls immer auszublenden, können Sie beispielsweise so vorgehen: a) Legen Sie für ein Kriterium der entsprechenden Artikel ein neues Freitextfeld an unter Einstellungen > Freitext- feld- Verwaltung > Tabelle: Artikel (s_article_attributes) > Klick auf Hinzufügen. Wählen Sie als Spaltentyp Checkbox - INT(1). Der Spaltenname könnte z.b. hermes_ident_yesno lauten und wird im nächsten Schritt der Einrichtung benötigt. Tragen Sie unter Anzeige Einstellungen das gewünschte Label und die beschreibenden Texte für das Freitextfeld ihrer Artikel ein und klicken Sie dann auf Speichern. Hermes Shipping Interface - Installations- und Konfigurationsanleitung für Shopware ab Version 5.2.x Seite [ 10 von 18 ]

11 b) Das neue Freitextfeld muss nun in der SQL- Abfrage für den Warenkorb ausgewertet werden. Erweitern Sie die Abfrage unter Einstellungen > Grundeinstellungen > Storefront > Versandkosten- Modul durch den folgenden Code: MAX(IF(IFNULL(at.hermes_ident_yesno, 0) <> 0, '1', '0')) as require_ident Wenn hier bereits eine Abfrage hinterlegt ist, können Sie den Code mit einem Komma (,) getrennt an das Ende der Ab- frage anhängen. Klicken Sie anschließend auf Speichern. Hermes Shipping Interface - Installations- und Konfigurationsanleitung für Shopware ab Version 5.2.x Seite [ 11 von 18 ]

12 c) Der Schlüssel require_ident wird zukünftig ausschlaggebend dafür sein, ob ein Warenkorb die Nutzung des I- dent- Service erfordert oder nicht. Konfigurieren Sie dazu die jeweilige Regel unter Einstellungen > Versandkos- ten > Versandart bearbeiten > Erweiterte Einstellungen > Eigene Bedingungen. In unserem Beispiel tragen Sie hier bei allen Versandarten mit Ident- Service require_ident!= '0' ein und bei allen Versandarten ohne Ident- Service: require_ident!= '1'. Hermes Shipping Interface - Installations- und Konfigurationsanleitung für Shopware ab Version 5.2.x Seite [ 12 von 18 ]

13 d) Bei allen Artikeln, für die die Nutzung des Ident- Service verpflichtend sein soll, aktivieren Sie nun unter Artikel > Übersicht > Artikel bearbeiten > Stammdaten im Abschnitt Freitextfelder ganz unten Ihr neues Kriterium. Hermes Shipping Interface - Installations- und Konfigurationsanleitung für Shopware ab Version 5.2.x Seite [ 13 von 18 ]

14 5. Verwendung der Sendungsaufträge 5.1 Sendungsaufträge erzeugen Sie können Sendungsaufträge für alle Bestellungen erzeugen, die mit einer verknüpften Versandart getätigt wurden, wenn das Plugin zum Zeitpunkt der Bestellung aktiviert war. a) Öffnen Sie dazu den Dialog unter Kunden > Bestellungen > Details der Bestellung anzeigen > Hermes- Versand. Hier können Sie alle Artikel auswählen oder nur einige, um die Bestellung auf mehrere Sendungsaufträge zu verteilen. Klicken Sie dann auf Auftrag erstellen. Hermes Shipping Interface - Installations- und Konfigurationsanleitung für Shopware ab Version 5.2.x Seite [ 14 von 18 ]

15 b) Im folgenden Dialog bekommen Sie einen Überblick über den neuen Auftrag und Sie können die Paketklasse wählen, sowie Optionen hinzubuchen/abwählen. Klicken Sie auf Auftrag speichern um den Sendungsauftrag an Hermes zu übermitteln. Hermes Shipping Interface - Installations- und Konfigurationsanleitung für Shopware ab Version 5.2.x Seite [ 15 von 18 ]

16 c) Der neue Sendungsauftrag wird nun in der Übersicht unten angezeigt und hat den Status Angelegt. Um ein La- bel zu erzeugen, klicken Sie auf den Auftrag und dann auf Label erzeugen. Auf dieser Seite können Sie nun jederzeit das Label anzeigen bzw. ausdrucken und die Details des Sendungsauftrags ansehen. d) Klicken Sie oben im Dialog auf Bestellung verwalten um zur Übersicht zurückzukehren. Hermes Shipping Interface - Installations- und Konfigurationsanleitung für Shopware ab Version 5.2.x Seite [ 16 von 18 ]

17 6. Verwendung der Abholaufträge 6.1 Abholaufträge erzeugen Das Plugin gibt Ihnen die Möglichkeit, neben der regelmäßigen Abholung Ihrer Pakete außerordentliche Abholtermine zu vereinbaren, die optional auch an einer anderen Adresse ausgeführt werden können. a) Öffnen Sie dazu den Dialog unter Kunden > Hermes Versand > Abholaufträge. Hier finden Sie das Formular zur Erzeugung eines neuen Abholauftrags und, wenn vorhanden, eine Liste mit den Abholaufträgen, die in der Ver- gangenheit erteilt wurden. Hermes Shipping Interface - Installations- und Konfigurationsanleitung für Shopware ab Version 5.2.x Seite [ 17 von 18 ]

18 b) Füllen Sie das Formular aus. Die Angabe der Adresse ist dabei optional und wird nur bei einer Abweichung von der regelmäßigen Abholung benötigt. Klicken Sie dann auf Auftrag senden. c) Der Auftrag wird Ihnen nach erfolgreicher Übermittlung rechts im Dialog angezeigt. 7. Kontaktdaten Vertrieb: vertrieb Support: Hermes Shipping Interface - Installations- und Konfigurationsanleitung für Shopware ab Version 5.2.x Seite [ 18 von 18 ]