Shopware shipcloud Connector

Shopware shipcloud Connector
Version: 1.4.0
Stand:
01.08.2016
________________________________________________________________________________________________________________________
Inhaber
Pascal Wiedow
Hustenfeld 21a
D-41379 Brüggen
Kontakt
T +49 (0) 2163 / 949 60 41
F +49 (0) 2163 / 949 60 42
[email protected]
ShopwareshipcloudConnector...........................................................................................................1
1
Beschreibung.....................................................................................................................................3
2
Voraussetzungen/Anforderungen...........................................................................................3
3
Features/Funktionalitäten.........................................................................................................4
4
Installation.........................................................................................................................................5
5
Konfiguration....................................................................................................................................6
5.1
PlugIn-Einstellungen...........................................................................................................................6
5.2
KonfigurationderShopwareVersandarten/-kosten...............................................................8
5.3
KonfigurationdesSendungsstatus/Webhook........................................................................10
6
Benutzung........................................................................................................................................11
Stapelverarbeitung............................................................................................................................11
ManuelleEtiketten-Erstellung.......................................................................................................13
6.1
6.2
________________________________________________________________________________________________________________________
Inhaber
Pascal Wiedow
Hustenfeld 21a
D-41379 Brüggen
Kontakt
T +49 (0) 2163 / 949 60 41
F +49 (0) 2163 / 949 60 42
[email protected]
1 Beschreibung
Mit dem Shopware-PlugIn „shipcloud“ können Sie aus dem Shopware-Backend
heraus Versandetiketten erzeugen. Es werden alle relevanten Paketdienste
unterstützt: DHL, UPS, DPD, Hermes, GLS, ILOXX, Fedex und Liefery.
Sie brauchen nur einen shipcloud-Account, es sind keine weiteren Verträge mit
den einzelnen Paketdiensten notwendig.
Es können Versandetiketten für alle Länder erstellt werden (National, Europa
und International). In der aktuellen Version können Nachnahmen nur für DHL
erstellt werden. Ein Express-Versand ist ebenfalls möglich.
Dank der shipcloud REST-API können Sie Ihre Versandetiketten direkt im
Shopware-Backend erstellen (Kein hantieren mit Export-Files). Erstellen Sie
die Etiketten manuell für jede Bestellung oder beliebig viele in der
Stapelverarbeitung. In der manuellen Erstellung können Sie für jede
Bestellung den optimalen Paketdienst, mit den günstigsten Konditionen
wählen. In der Stapelverarbeitung wird der Paketdienst verwendet, den Sie in
den Shopware-Versandeinstellungen definiert haben, so haben Sie die
Möglichkeit viele Bestellungen gleichzeitig zu verarbeiten, das PlugIn ändert
auf Wunsch automatisch den Bestellstatus und schickt dem Kunden eine EMail mit Tracking-Informationen.
In einem separaten Reiter in den Bestelldetails erhalten Sie stets den
Überblick über Ihre Sendungen. Dort finden Sie alle erstellten Etiketten zu
einer Bestellung, mit Erstellungsdatum, Trackingcode,
Sendungsverfolgung und Versandkosten.
2 Voraussetzungen / Anforderungen
•
•
Shopware 4.x oder 5.x + Shopware Lizenz Manager
shipcloud Account –> www.shipcloud.io
________________________________________________________________________________________________________________________
Inhaber
Pascal Wiedow
Hustenfeld 21a
D-41379 Brüggen
Kontakt
T +49 (0) 2163 / 949 60 41
F +49 (0) 2163 / 949 60 42
[email protected]
3 Features / Funktionalitäten
•
•
•
•
•
•
•
Einheitliches Erstellen Ihrer Versandetiketten direkt aus dem ShopwareBackend
o Erstellen Sie Versandmarken für alle gängigen Versanddienstleister
wie z.B. DHL, Deutsche Post, UPS, DPD, Hermes, GLS, MyDPD
Business (iloxx), FedEx und Liefery
o Den passenden Retourenschein direkt mit generieren.
o Per Stapelverarbeitung beliebig viele Etiketten gleichzeitig
erstellen.
o Automatische Berechnung des Versandgewichts (pauschales
Versandgewicht ebenfalls möglich).
Immer den günstigsten Vertrag
o Bringen Sie Ihren eigenen Versanddienstleister-Vertrag mit und
nutzen ihn unkompliziert weiter.
o Nutzen Sie die shipcloud Konditionen, bei Versanddienstleistern für
die Sie keinen Vertrag haben.
Sendungsverfolgung integriert
o Verfolgen Sie Ihre Sendungen im Shopware Backend
§ Automatische Hinterlegung der Trackingcodes in den
Bestelldetails.
§ Übersichtliche Darstellung für alle Versanddienstleister.
§ Filter- und Sortierungsmöglichkeiten nach Sendestatus.
§ Identifizieren Sie so schnell Problemfälle und behalten Sie
Ihre Kosten im Blick.
Sendungsverfolgung auch im MyAccount-Bereich
o So wissen Ihre Kunden immer, wo ihre Bestellung ist.
o Weniger Supportanfragen
Immer auf dem Laufenden dank Status-E-Mails
o shipcloud benachrichtigt Sie bzw. Ihre Kunden per E-Mail, wenn es
ein Update zu einer Sendung gibt.
Eigenes Logo und Versandmarken-Größe einstellen
o Integrieren Sie Ihr Logo auf den Versandetiketten und
konfigurieren Sie die Größe dieser individuell, je nach Ihrem
Bedarf.
o Vereinheitlichen Sie so Ihre Prozesse über alle Versanddienstleister
hinweg und hinterlassen Sie einen individuellen und
professionellen Eindruck bei Ihren Kunden
Nutzen Sie die Multi- / Subshop-Fähigkeit
o Je Shop können Sie dabei abweichende Daten hinterlegen
________________________________________________________________________________________________________________________
Inhaber
Pascal Wiedow
Hustenfeld 21a
D-41379 Brüggen
Kontakt
T +49 (0) 2163 / 949 60 41
F +49 (0) 2163 / 949 60 42
[email protected]
4 Installation
Das PlugIn kann wie gewöhnlich über den PlugIn-Manager installiert werden.
Sollten Sie das PlugIn manuell auf Ihrem Webspace transferieren wollen,
müssen die PlugIn-Dateien in folgendes Verzeichnis abgelegt werden:
„/engine/Shopware/Plugins/Community/Backend“.
Achtung: Bitte hinterlegen Sie vor der Installation die Lizenz im Shopware
Lizenz Manager. Die Lizenz-Informationen finden Sie in Ihrem ShopwareAccount. Melden Sie sich nach der Installation neu im Shopware-Backend an.
________________________________________________________________________________________________________________________
Inhaber
Pascal Wiedow
Hustenfeld 21a
D-41379 Brüggen
Kontakt
T +49 (0) 2163 / 949 60 41
F +49 (0) 2163 / 949 60 42
[email protected]
5 Konfiguration
5.1 PlugIn-Einstellungen
Konfigurationseintrag
Pflichtfeld
shipcloud
API-Schlüssel
Ja
shipcloud
Sandbox API-Schlüssel
Ja
shipcloud
Sandbox
Ja
Debug
Logging
Ja
Absender
Anschrift- + Kontakt-Daten
Ja
Aut. Bestell-StatusÄnderung
Wenn die Versandetiketten
erzeugt wurden:
Nein
Höherversicherung
Sollen die Sendungen für
einen höheren Wert als 500
EUR versichert werden?
(Stapelverarbeitung)
Versenden Sie Sperrgut?
(Stapelverarbeitung / nur
DHL)
Benachrichtigungs-E-Mail
Soll dem Kunden eine
Benachrichtigungs-E-Mail
über den Versandanbieter
geschickt werden?
Aut. Trennung der Straße
Hausnummer.
Soll die Empfängeradresse
automatisch aufbereitet
werden?
Nein
Nein
Bedeutung
Der Zugriffs-Schlüssel von shipcloud, um
Etiketten für den realen Versand zu
erstellen (Live-Key).
Der Zugriffs-Schlüssel von shipcloud, um
Muster- / Test-Etiketten zu erstellen
(Sandbox-Key).
EIN = Es werden Muster-Etiketten erstellt
AUS = Es werden kostenpflichtige
Versandetiketten erstellt
EIN = Es wird ein Log-File im PlugInVerzeichnis geschrieben.
AUS = Es werden keine Ereignisse und
Fehler geloggt.
Es sollten alle Absender-Informationen
angegeben werden. Diese Angaben
erscheinen auf dem gedruckten Label.
Wenn hier ein Bestellstatus definiert wurde,
ändert das PlugIn den Bestellstatus, sobald
das/die Versandetikett(en) erzeugt wurden.
Ist zu dem Status zusätzlich ein E-MailText hinterlegt, wird automatisch eine EMail versendet.
Mit dieser Option kann bestimmt werden,
ob Pakete mit einem Bestellwert höher 500
EUR versichert werden sollen. Der Betrag
wird automatisch ausgelesen und
übergeben.
Pakete über 120cm können als Sperrgut
deklariert werden. Diese Angabe ist nur für
DHL relevant.
Nein
Ist diese Option ausgewählt, erhält der
Kunde von dem Versandanbieter eine
Paketankündigung per E-Mail.
Nein
Seit shopware 5 sind Straße und
Hausnummer nicht mehr getrennt. Bei „Ja“
trennt das PlugIn die Hausnummer
automatisch von der Straße, zur
Optimierung der Leitcodierung.
________________________________________________________________________________________________________________________
Inhaber
Pascal Wiedow
Hustenfeld 21a
D-41379 Brüggen
Kontakt
T +49 (0) 2163 / 949 60 41
F +49 (0) 2163 / 949 60 42
[email protected]
Zahlungsart "Nachnahme"
Nachnahme-Konto
Name der Bank
Nachnahme-Konto
Konto-Inhaber
Nachnahme-Konto
BIC
Nachnahme-Konto
IBAN
Ja
Nein
Bankname für Nachnahme-Zahlungen
Nein
Kontoinhaber für Nachnahme-Zahlungen
Nein
BIC für Nachnahme-Zahlungen
Nein
IBAN für Nachnahme-Zahlungen
Paket-Abmessungen
Breite + Höhe + Länge
Ja
Versand-Gewicht
Artikel ohne Angaben
Ja
Versand-Gewicht
Verpackung
Ja
Versand-Gewicht
Packstück maximal
Ja
Versand-Gewicht
Pauschale pro Bestellung
Ja
Keine Berechnung
Artikelnummern die für die
Gewichtsberechnung
ignoriert werden sollen
In diesem DropDown-Menü muss die
relevante Zahlungsart für „NachnahmeBestellungen“ ausgewählt werden.
Nein
Hier können Sie die Maße Ihres StandardPakets definieren. In den Bestelldetails
können die Maße für jedes Paket individuell
angegeben werden. Hermes berechnet die
Versandkosten nach Größe des Pakets,
nicht nach Gewicht.
Hier kann ein Standard-Gewicht für Artikel
hinterlegt werden, gilt für alle Artikel ohne
Angaben in den Stammdaten.
Hier kann für die Verpackung ein
pauschales Gewicht angegeben werden,
wird zu den Artikel-Gewichten addiert.
Hier kann das Maximal-Gewicht für ein
Packstück definiert werden. Anhand dieser
Angabe wird die Anzahl der Packstücke /
Versandetiketten pro Bestellung ermittelt.
Keine individuelle Berechnung des
Versandgewichts. Pauschales Gewicht für
alle Bestellungen, überschreibt alle
Angaben egal was in den Stammdaten
hinterlegt wurde (0 = deaktiviert).
Ist bei „Versand-Gewicht Artikel ohne
Angaben“ ein Gewicht hinterlegt? So wird
für jede Bestell-Position das StandardGewicht verwendet, auch für Rabatte,
Zuschläge und Gutscheine. Das ist
natürlich nur bedingt sinnvoll, daher
können hier Artikelnummern
kommasepariert hinterlegt werden, die bei
der Berechnung einfach ignoriert werden
sollen.
________________________________________________________________________________________________________________________
Inhaber
Pascal Wiedow
Hustenfeld 21a
D-41379 Brüggen
Kontakt
T +49 (0) 2163 / 949 60 41
F +49 (0) 2163 / 949 60 42
[email protected]
5.2 Konfiguration der Shopware Versandarten/-kosten
1. Öffnen Sie die Shopware Versandkosten-Einstellungen
2. und editieren Sie die gewünschte Versandart.
________________________________________________________________________________________________________________________
Inhaber
Pascal Wiedow
Hustenfeld 21a
D-41379 Brüggen
Kontakt
T +49 (0) 2163 / 949 60 41
F +49 (0) 2163 / 949 60 42
[email protected]
1. Klicken Sie anschließend auf den Reiter „shipcloud“
2. und wählen Sie den gewünschten Paketdienst für diese Versandart.
3. Speichern Sie die Einstellungen ab.
Hinweis: Der hier definierte Versanddienstleister wird für die
Stapelverarbeitung verwendet. In den Bestelldetails können Sie den
Versanddienstleister für jede Bestellung ändern.
________________________________________________________________________________________________________________________
Inhaber
Pascal Wiedow
Hustenfeld 21a
D-41379 Brüggen
Kontakt
T +49 (0) 2163 / 949 60 41
F +49 (0) 2163 / 949 60 42
[email protected]
5.3 Konfiguration des Sendungsstatus / Webhook
Mit dem aktuellen Status der Sendungen bleiben Sie stets informiert.
Erkennen Sie frühzeitig verspätete Lieferungen oder liegen gebliebene
Pakete.
Konfigurieren Sie in Ihrem shipcloud Account einen Webhook zu Ihrem
Online shop. Jede Bestellung/Sendung wird anschließend automatisch
aktualisiert.
1. shipcloud Account aufrufen
2. „Einstellungen“ -> „Webhooks“
3. URL einfügen
„http://www.shopurl.de/ScsShipcloudConnector/hookRefresh“
(shopurl.de durch die shop URL ersetzen)
4. Alle Events auswählen
5. Webhook erstellen
________________________________________________________________________________________________________________________
Inhaber
Pascal Wiedow
Hustenfeld 21a
D-41379 Brüggen
Kontakt
T +49 (0) 2163 / 949 60 41
F +49 (0) 2163 / 949 60 42
[email protected]
6 Benutzung
6.1 Stapelverarbeitung
In der Bestellübersicht finden Sie eine neue Schaltfläche, die
1. aktiv wird, wenn Sie die betroffenen Bestellungen markieren.
2. Beim Klick auf diese Schaltfläche werden die Versandetiketten erzeugt.
1. Anschließend können Sie die Versandetiketten ausdrucken.
________________________________________________________________________________________________________________________
Inhaber
Pascal Wiedow
Hustenfeld 21a
D-41379 Brüggen
Kontakt
T +49 (0) 2163 / 949 60 41
F +49 (0) 2163 / 949 60 42
[email protected]
In Ihrem shipcloud-Account können Sie Ihr Shop-Logo hinterlegen, das auf
den erstellten Etiketten eingefügt wird.
________________________________________________________________________________________________________________________
Inhaber
Pascal Wiedow
Hustenfeld 21a
D-41379 Brüggen
Kontakt
T +49 (0) 2163 / 949 60 41
F +49 (0) 2163 / 949 60 42
[email protected]
6.2 Manuelle Etiketten-Erstellung
1. In den Bestelldetails finden Sie einen neuen Reiter „shipcloud“.
Dort werden alle Etiketten zu der jeweiligen Bestellung aufgeführt.
Sie können hier das Etikett erneut ausdrucken, eine Sendungsverfolgung
starten oder Daten wie Sendungsnummer, Versandkosten oder
Erstellungsdatum ablesen.
2. Mit einem Klick auf „Versandetikett erstellen“ können weitere Etiketten
angelegt werden.
________________________________________________________________________________________________________________________
Inhaber
Pascal Wiedow
Hustenfeld 21a
D-41379 Brüggen
Kontakt
T +49 (0) 2163 / 949 60 41
F +49 (0) 2163 / 949 60 42
[email protected]
Es öffnet sich ein neues Fenster, dort ist die Lieferadresse der Bestellung
bereits vorausgefüllt. Die Empfänger-Adresse sowie die Paket-Daten können
noch einmal geprüft bzw. angepasst werden. Mit dem Klick auf „Etikett
erstellen“ wird ein neues Versandetikett erzeugt und kann in der EtikettenÜbersicht ausgedruckt werden.
Hinweis: Nicht alle Paketdienstleister berechnen die Gebühren nach Gewicht,
daher können hier auch die Paket-Maße angegeben werden. Beim Aufruf
werden zunächst die Daten aus der PlugIn-Konfiguration verwendet.
________________________________________________________________________________________________________________________
Inhaber
Pascal Wiedow
Hustenfeld 21a
D-41379 Brüggen
Kontakt
T +49 (0) 2163 / 949 60 41
F +49 (0) 2163 / 949 60 42
[email protected]