Inhaber Pascal Wiedow Alter Markt 11 D Viersen. Kontakt T +49 (0) 2162 / F +49 (0) 2162 /

Transkript

1 1 Kurzbeschreibung Voraussetzungen / Anforderungen Features / Funktionalitäten Installation PlugIn- Konfiguration Ausführliche Beschreibung Markierung der zu exportierenden Bestellungen Export- Templates / Zuordnung DHL- Produkte Erstellung des Intraship- Exports in Shopware Import der Lieferadressen in Intraship / Erzeugung der Versandlabels Export der Trackingcodes aus Intraship Import der Trackingcodes in Shopware... 12

2 1 Kurzbeschreibung Das Shopware-PlugIn DHL-IntrashipControl dient zur vereinfachten Erzeugung von Versandlabeln mit der Webbasierten Software Intraship von DHL. Mit diesem PlugIn können die Lieferadressen der Shopware-Bestellungen an Intraship übergeben werden. Die in Intraship erzeugten Trackingcodes können zurück an Shopware transferiert werden. Eine automatische Änderung des Bestellstatus sowie der Versand der Trackingcodes per sind optional möglich. 2 Voraussetzungen / Anforderungen Shopware 3.5.x oder Shopware 4.x DHL-Intraship Konto Aktivierung der Import-Funktion in Intraship Import von Aufträgen (kostenlose Freischaltung durch den Intraship-Support) Unterstützte Intraship-CSV-Version 5.3 und Features / Funktionalitäten Shopware -> Intraship Export einer CSV-Datei mit den Lieferadressen der Shopware- Bestellungen. Intraship -> Shopware Import der Trackincodes aus Intraship in Shopware (via Sendungsdaten exportieren / Shipments.txt) Automatische Änderung des Bestellstatus Versand der Trackingcodes per (optional) Automatische Berechnung des Versandgewichts (pauschales Versandgewicht ebenfalls möglich) Automatische Ermittlung der Packstücke Zuordnung mehrerer DHL-Produkte je nach Lieferland möglich (max. 4 Stück - z. B. National, Europa, Regio AT und International) Automatische Unterscheidung von Nachnahme- und Standard- Bestellungen (Übergabe des Zahlbetrags und der Bank-Verbindung an DHL). Multi- / Subshop-Fähigkeit Je Shop können abweichende Daten hinterlegt werden (z. B. sichtbarer Shopname auf dem Label). Hinterlegung des Versanddatums als interner Kommentar möglich. Einschränkungen auf Lieferländer und Versandarten möglich.

3 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. 5 PlugIn-Konfiguration Konfigurationseintrag Pflichtfeld Bedeutung Shop aktivieren? Absender Intraship Kunden-Nr. Sendungsimport Format Soll das PlugIn für diesen Shop aktiv sein? Ihre Intraship-Kundennummer (10-stellig) Wählen Sie hier Ihre eingesetzte Version. Verfahren / Produktcode Je DHL-Produkt Geben Sie hier die Teilnahmenummer / den Produktcode ein (01,02,03,...). Informationen dazu finden Sie z. B. unter Versandabwicklung->Neuer Auftrag-> Absender Absender Anschrift + Nachnahme-Konto Konto-Verbindung Bis auf die -Adresse müssen alle Absender-Informationen angegeben werden. Diese Angaben erscheinen auf dem gedruckten Label. Auf dieses Konto werden die Nachnahme-Beträge eingezahlt, als Verwendungszweck wird die Bestellnummer verwendet, z. B. NN

4 Beschränkung Nur aktiv für die Länder Beschränkung Nur aktiv für die Versandarten Produkt-Zuordnung Ländercode(s) nationaler Versand Produkt-Zuordnung Ländercode(s) europäischer Versand Produkt-Zuordnung Ländercode(s) Sonstiges Produkt Zuordnung Zahlungsart "Nachnahme" Bestell-Status Bereit zum Export Bestell-Status Erfolgreich exportiert In diesem Eintrag kann das PlugIn auf bestimmte Länder beschränkt werden (2-stelliger ISO-Code - kommasepariert), z. B. DE,AT. Dann werden nur Bestellungen mit einer Lieferadresse aus Deutschland und Österreich berücksichtigt. Hier können IDs von Versandarten kommasepariert angegeben werden. Beim Export werden dann nur noch Bestellungen berücksichtigt, die diese Versandart beinhalten. Hier können Ländercodes kommasepariert angegeben werden (2-stelliger ISO-Code). Länder die hier angegeben sind, werden mit dem Export-Template national.txt exportiert. Bei Ländern ohne Zuordnung wird das Template international.txt verwendet. Siehe Zuordnung National -> Template europa.txt Siehe Zuordnung National -> Template zusatzprodukt.txt In diesem DropDown-Menü muss die relevante Zahlungsart für Nachnahme-Bestellungen ausgewählt werden. In diesem DropDown-Menü soll ein Bestell-Status ausgewählt werden, der dem PlugIn angibt, welche Bestellungen exportiert werden sollen. In diesem DropDown-Menü soll der Bestell-Status ausgewählt werden, den die Bestellung nach dem Export erhalten soll.

5 Bestell-Status Tracking-Codes erfolgreich importiert Option Soll eine versendet werden, wenn zum Status eine hinterlegt ist? Option Soll ein interner Kommentar mit dem Versand-Datum hinterlegt werden? -Versand- Ausnahme Versand-Gewicht Artikel ohne Angaben Versand-Gewicht Verpackung Nach dem Import der Shipments.txt und der dort enthaltenen Trackingcodes, erhalten die Bestellungen den hier hinterlegten Bestellstatus. Mit dieser Option kann definiert werden, ob eine bei der Status-Änderung versendet werden soll. Das PlugIn prüft, ob zu dem Bestell-Status ein -Template hinterlegt wurde. Ist diese Option deaktiviert, wird keine versendet, auch wenn ein Mail- Template hinterlegt ist (Diese Option bezieht sich auf alle drei oben genannten Status-Angaben). Ist diese Option aktiviert, wird beim importieren der Trackingcodes das Datum als interner Kommentar hinterlegt (In den Bestelldetails). Wenn hier eine Zahlungsart ausgewählt wurde, wird bei dieser in Intraship keine -Adresse importiert sowie keine Tracking- verschickt, z.b. für Amazon Hier kann ein Standard-Gewicht für Artikel hinterlegt werden, gilt für alle Artikel ohne Angaben in den Stammdaten. (Angabe in Kilogramm 0 -> deaktiviert) Hier kann für die Verpackung ein pauschales Gewicht angegeben werden, wird am Ende addiert. (Angabe in Kilogramm 0 -> deaktiviert).

6 Versand-Gewicht Packstück maximal Versand-Gewicht Pauschale pro Bestellung Keine Berechnung Artikelnummern die für die Gewichtsberechnung ignoriert werden sollen Hier kann das Maximal-Gewicht für ein Packstück definiert werden. Anhand dieser Angabe wird die Anzahl der Packstücke ermittelt (Angabe in Kilogramm 0 -> deaktiviert, immer 1 Packstück). Keine individuelle Berechnung des Versandgewichts. Pauschales Gewicht für alle Bestellungen, überschreibt alle Angaben egal was in den Stammdaten hinterlegt wurde (Angabe in Kilogramm 0 -> deaktiviert). Ist bei Versand-Gewicht Artikel ohne Angaben ein Gewicht hinterlegt? So wird für jede Bestell-Position das Standard-Gewicht 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. 6 Ausführliche Beschreibung Mit dem Shopware-PlugIn DHL-IntrashipControl ist es möglich Lieferadressen beliebiger Bestellungen zu exportieren. Das PlugIn erzeugt eine kumulierte CSV-Datei, die heruntergeladen und anschließend in Intraship importiert werden kann. Die Versandlabels werden nicht in Shopware erzeugt und gespeichert, die Label-Verwaltung bleibt in der webbasierten Intraship- Software bestehen. 6.1 Markierung der zu exportierenden Bestellungen Welche Adress-Daten exportiert werden sollen, wird durch den Bestellstatus angegeben. Das PlugIn exportiert alle Lieferadressen mit dem hinterlegten Status. Nach dem erfolgreichen Export wird der Bestellstatus automatisch geändert, damit Bestelldaten nicht versehentlich doppelt exportiert werden. Status-Zuordnungen, Einschränkungen uvm. können in der PlugIn- Konfiguration hinterlegt werden, siehe PlugIn-Konfiguration.

7 6.2 Export-Templates / Zuordnung DHL-Produkte Im PlugIn-Verzeichnis existiert ein Unterordner mit dem Namen CSV. In diesem Ordner sind die Templates hinterlegt, die für den Intraship-Export relevant sind. Mit diesen Vorlagen kann so gesteuert werden, zu welchem Lieferland welches DHL-Produkt verwendet werden soll. Die Dateien sind unverschlüsselt und können individuell angepasst werden. Folgende Produkt-Zuordnungen sind nach der Installation voreingestellt: Land (ISO-Code) Template-Datei DHL-Intraship - Produkt DE national.txt EPN DHL Paket DE nachnahme.txt EPN DHL Paket (Bei Zahlungsart Nachnahme) BE, NL europa.txt EPI - DHL Europaket AT zusatzprodukt.txt RPN - Regiopaket AT Alle anderen Länder international.txt BPI Weltpaket - packstueck.txt Daten und Anzahl der Packstücke werden an jedes Produkt angefügt. Die oben aufgeführte Zuordnung gilt als Vorschlag und soll den Standard-Fall abdecken. In der PlugIn-Konfiguration kann diese Zuordnung individuell angepasst. Auch der Inhalt der Template-Dateien kann bei Bedarf angepasst werden, um zum Beispiel das Produkt-Kürzel anzupassen. Folgende Platzhalter stehen innerhalb der Text-Dateien zur Verfügung: Platzhalter {%indent_number%} {%shopware_ordernumber%} {%intraship_date%} {%config_send_method_xxx%} {%config_customer_number%} {%config_company%} {%config_street%} {%config_street_number%} {%config_zip_code%} {%config_city%} {%config_country_code%} {%config_ %} Bedeutung Fortlaufende Nummer je Bestellung Bestellnummer aus Shopware Versand-Datum Teilnahmenummer für das jew. Produkt Intraship-Kundennummer Absender: Firma Absender: Straße Absender: Hausnummer Absender: PLZ Absender: Stadt Absender: Ländercode (ISO 2-stellig) Absender: -Adresse

8 {%config_phone_number%} Absender: Telefonnummer {%customer_firstname%} Empfänger: Vorname {%customer_lastname%} Empfänger: Nachname {%customer_company1%} Empfänger: Firma 1 {%customer_company2%} Empfänger: Firma 2 {%customer_street%} Empfänger: Straße {%customer_street_number%} Empfänger: Hausnummer {%customer_zip_code%} Empfänger: PLZ {%customer_city%} Empfänger: Stadt {%customer_country_code%} Empfänger: Ländercode (ISO 2-stellig) {%customer_ %} Empfänger: -Adresse {%customer_phone_number%} Empfänger: Telefonnummer {%customer_number%} Empfänger: Kundennummer {%shopware_invoice_amount%} Gesamter Rechnungsbetrag {%config_bank_blz%} Absender: Bankleitzahl {%config_bank_kto%} Absender: Kontonummer {%config_bank_bic%} Absender: BIC {%config_bank_iban%} Absender: IBAN {%config_bank_name%} Absender: Name der Bank {%config_bank_owner%} Absender: des Bankkontos {%intraship_weight%} Gewicht des Packstücks 6.3 Erstellung des Intraship-Exports in Shopware Nachdem die für den Versand relevanten Bestellungen den entsprechenden Bestellstatus erhalten haben, kann die Export-Datei erzeugt werden. Hierzu wird der Menüpunkt Inhalte->DHL-IntrashipControl geöffnet.

9 In dem neu geöffneten Fenster kann mit der Schaltfläche Download CSV die Export- Datei generiert werden. Nach der Fertigstellung wird der Speichern-Dialog des Browsers angezeigt. Die Export-Datei kann an beliebiger Stelle auf der Festplatte abgespeichert werden. 6.4 Import der Lieferadressen in Intraship / Erzeugung der Versandlabels Die generierte und abgespeicherte CSV-Datei kann nun in Intraship importiert werden. Melden Sie sich dazu mit Ihren Zugangsdaten unter an und navigieren Sie zu dem Punkt Versandabwicklung -> Import von Aufträgen. Hinweis: Sollten sie diesen Navigationspunkt in Ihrem Hauptmenü nicht finden, können Sie diesen kostenlos beim Intraship-Support freischalten lassen. Wählen Sie unter Datei auswählen die zuvor abgespeicherte CSV-Datei aus. Es müssen keine weiteren Einstellungen vorgenommen werden. Lassen Sie das Importschema auf Standard Sendungsimport eingestellt. Mit dem Klick

10 auf die Schaltfläche Datei importieren werden die Versandadressen importiert und die Versand-Labels erzeugt. Ihr Intraship-Adressbuch bleibt dabei unberührt. Nach dem Import wird Ihnen angezeigt wie viele Sendungen importiert wurden und ob Fehler aufgetreten sind, wenn nötig können die Adressdaten anschließend in der Übersicht korrigiert werden.

11 6.5 Export der Trackingcodes aus Intraship In Intraship kann ein Export mit Sendungsdaten und Trackingcodes erzeugt und via zugestellt werden. Gehen Sie dazu im Hauptmenü zu dem Punkt Auftragsarchiv -> Statistik -> Sendungsdaten exportieren. Tragen Sie in das Formular Ihre - Adresse ein und wählen Sie unter Status, welche Sendungen Sie exportieren möchten. Nachdem Sie auf die Schaltfläche Sendungsarchiv erzeugen geklickt haben, erhalten Sie umgehend von DHL-Intraship eine mit zwei Dateianhängen. Speichern Sie die Datei Shipments.txt ebenfalls auf Ihrer Festplatte ab. Mit dieser Datei können Sie die Trackingcodes in Shopware importieren.

12 6.6 Import der Trackingcodes in Shopware Rufen Sie erneut das PlugIn-Fenster in Shopware auf. In dem unteren Kasten finden Sie die Möglichkeit Ihre Intraship-Export-Datei in Shopware zu importieren. Die Trackingcodes werden in das Feld Trackingcode der jeweiligen Bestellung eingetragen. Wenn gewünscht, wird der Bestellstatus aktualisiert und eine E- Mail inkl. Trackingcode an den Kunden versendet. Es ist außerdem möglich das Versanddatum als internen Kommentar zu hinterlegen.