Bedienungsanleitung Shopware Plugin Österreichische Post Adapter Version 1.0.0 VIISON GmbH Goebelstr. 21 64293 Darmstadt +49 (0) 6151 / 629 30 0 support@viison.com www.viison.com
Inhaltsverzeichnis Voraussetzungen Allgemeine Hinweise Plugin für den produktiven Einsatz konfigurieren Einer Versandkostenart ein Österreichische Post Produkt zuordnen Die Zuordnung eines Österreichische Post Produktes von einer Versandkostenart entfernen Nachnahme konfigurieren Ein Österreichische Post Versandetikett erstellen Österreichische Post Versandetiketten für mehrere Bestellungen gleichzeitig erstellen Ein Versandetikett löschen Ein Österreichische Post Retourenetikett erstellen Manuell eine E-Mail zur Versandbestätigung über Shopware versenden FAQ Voraussetzungen Das Plugin wird über den Shopware Community Store vertrieben. Shopware Lizenz-Manager. Beim Österreichische Post Adapter handelt es sich um ein lizenzp ichtiges Plugin. Daher ist es notwendig zunächst den Shopware Lizenz- Manager zu installieren. Weitere Informationen hierzu finden Sie unter Lizenzierung und Installation von lizenzpflichtigen Plugins. PHP mcrypt Erweiterung ( http://php.net/manual/de/book.mcrypt.php ), bei den meisten Hostern bereits aktiv, ansonsten in der php.ini: extension=php_mcrypt.dll (Windows) extension=mcrypt.so (Linux) Zugangsdaten für den PLC Webservice der Österreichischen Post. Zugangsdaten zum PLC Webservice der Österreichische Post erhalten Sie auf Anfrage bei der Österreichischen Post (entweder über Ihren Kundenbetreuer oder per Mail an plc@post.at). Bedienungsanleitung Österreichische Post Adapter - Seite 2
Allgemeine Hinweise Der Österreichische Post Adapter enthält eine optionale Funktion zur automatischen Berechnung von Paketgewichten. Dies geschieht anhand der Gewichte der einzelnen Produkte, die in einer Bestellung enthalten sind. Aus diesem Grund sollte möglichst bei jedem Artikel, sowie jeder Artikelvariante ein Gewicht de niert sein. Ist für einen Artikel kein Gewicht de niert, wird ein Standardwert von 0.1 kg angenommen. Bedienungsanleitung Österreichische Post Adapter - Seite 3
Plugin für den produktiven Einsatz konfigurieren WICHTIG: Stellen Sie sicher, dass Sie alle benötigten Zugangsdaten haben, bevor Sie das Plugin kon gurieren. Dazu gehören Zugangsdaten zum PLC Webservice der Österreichischen Post. Zugangsdaten zum PLC Webservice der Österreichische Post erhalten Sie auf Anfrage bei der Österreichischen Post (entweder über Ihren Kundenbetreuer oder per Mail an plc@post.at). Um den Österreichische Post Adapter zu konfigurieren, wechseln Sie nun ins Shopware Backend und führen folgende Schritte durch: 1. Im Menü unter Kunden > Österreichische Post den Eintrag Konfiguration wählen 2. In dem sich nun öffnenden Konfigurationsfenster kann der Österreichische Post Adapter für die verschiedenen Subshops eingerichtet werden. Die folgenden Felder sollten ausgefüllt werden: Absendername 1 Der Name des Absenders (z.b. der Name des Subshops/ Name Ihrer Firma) Absendername 2 Zweiter Teil des Absendernames (z.b. der Ansprechpartner oder die Abteilung innerhalb Ihrer Firma) Straße Die Straße der Absenderadresse inkl. Hausnummer Postfach Ihr Postfach, z.b. Postfach 4021 (optional) PLZ Die Postleitzahl der Absenderadresse Ort Die Stadt der Absenderadresse Client-ID Die Client-ID ist Ihre Debitorennummer bei der Österreichischen Post. Sie erhalten diese auf Anfrage von der Österreichischen Post. OrgUnit-ID Sie erhalten die OrgUnit-ID, teils auch Abteilungs-ID genannt, auf Anfrage von der Österreichischen Post. Bedienungsanleitung Österreichische Post Adapter - Seite 4
Organisation-Unique-ID Die Organisation-Unique-ID ist die für den jeweiligen Kunden eindeutige GUID. Sie erhalten die Organisation-Unique-ID, teils auch OrgUnitGUID genannt, auf Anfrage von der Österreichischen Post. Standardgewicht in Kilogramm Das Standardgewicht, das für Österreichische Post Paket Sendungen verwendet wird, falls die automatische Gewichtsberechnung deaktiviert ist oder (bei aktivierter Gewichtsberechnung) für keinen Artikel einer Sendung ein Gewicht definiert ist. Paketgewicht automatisch berechnen Ist dieses Feld aktiviert, werden die Gewichte der Sendungen automatisch auf Basis der Gewichte der enthaltenen Artikel sowie der prozentualen und xen Aufschläge berechnet. Prozentualer Gewichtsaufschlag für Füllmaterial Gewichtsaufschlag für die automatische Gewichtsberechnung als prozentualer Anteil der Summe der Artikelgewichte. Dieser dient beispielsweise zur Berücksichtigung von Füllmaterial. Gewichtsaufschlag für Verpackungsmaterial in Kilogramm Fester Gewichtsaufschlag für die automatische Gewichtsberechnung in Kilogramm. Dieser dient beispielsweise zur Berücksichtigung von Verpackungsmaterial. 3. Auf Speichern klicken, um die Änderungen zu übernehmen Hinweis: Um möglichst einfach Versandetiketten erstellen zu können, empfehlen wir Ihnen, Zuordnungen von Versandarten zu Österreichische Post Produkten anzulegen. Für Bestellungen, deren Versandart einem Österreichische Post Produkt zugeordnet ist, wird ein Versandetikett hinzufügen Icon direkt in der Liste mit den Bestellungen angezeigt. Das einer Bestellung zugeordnete Österreichische Post Produkt wird im Versandetikett erstellen Dialog vorausgewählt. Führen Sie dazu den im folgenden Kapitel Einer Versandkostenart ein Österreichische Post Produkt zuordnen beschriebenen Prozess für jede genutzte Versandart durch. Bedienungsanleitung Österreichische Post Adapter - Seite 5
Einer Versandkostenart ein Österreichische Post Produkt zuordnen 1. Über den Menüpunkt Einstellungen die Versandkosten ö nen 2. In der Zeile der gewünschten Versandkostenart auf das Bearbeiten Sie diese Versandkosten Icon (Stift) klicken 3. Den Österreichische Post Versand -Tab auswählen 4. Im Feld Österreichische Post Produk t das gewünschte Produkt auswählen, oder Keine Zuordnung wählen, um keine Produkt zuzuordnen 5. Auf Speichern klicken, um die Änderungen zu übernehmen Hinweis: Erst wenn der Versandkostenart einer Bestellung ein Österreichische Post Produkt zugeordnet ist, erscheinen die Buttons zum schnellen Erstellen eines Versandetiketts bzw. zur Paketverfolgung. Bedienungsanleitung Österreichische Post Adapter - Seite 6
Die Zuordnung eines Österreichische Post Produktes von einer Versandkostenart entfernen 1. Über den Menüpunkt Einstellungen die Versandkosten ö nen 2. In der Zeile der gewünschten Versandkostenart auf das Bearbeiten Sie diese Versandkosten Icon (Stift) klicken 3. Den Österreichische Post Versand -Tab auswählen 4. Im Feld Österreichische Post Produkt den Wert Keine Zuordnung auswählen 5. Auf Speichern klicken, um die Änderungen zu übernehmen Nachnahme konfigurieren Bestellungen, die per Nachnahme bezahlt werden, können automatisch als Nachnahmesendung versendet werden. Passen Sie dazu die Namen der Zahlungsarten, die für Nachnahme verwendet werden sollen, im Dialog unter Einstellungen > Zahlungsarten ), so an, dass Sie das Wort cash enthalten. Das heißt, sowohl bspw. cash als auch bspw. nachnahme-cash-2 würden als automatisch als Nachnahmezahlung für den Österreichische Post Versand erkannt werden. Ob eine bestimmte Sendung als Nachnahmesendung erstellt wird, können Sie im Versandetikett erstellen Dialog im Feld Nachnahme sehen. Dieses Feld kann auch manuell angepasst werden, falls Sie zum Beispiel wegen einer Nachlieferung ein Versandetikett ohne Nachnahme erstellen möchten oder falls Sie eine Bestellung mit anderer Zahlungsart trotzdem als Nachnahme versenden möchten. Der Verwendungszweck der Überweisung, die die Österreichische Post an Sie tätigt, wird automatisch anhand der in der Bestellung enthaltenen Informationen bestimmt. Der Verwendungszweck lautet i.d.r. Bestellung NUMMER_DER_BESTELLUNG. Bedienungsanleitung Österreichische Post Adapter - Seite 7
WICHTIG: Als Rechnungsbetrag wird der Gesamtbetrag (Bestellung + Versandkosten) aus Shopware übernommen. Um die Nachnahme zu ermöglichen, muss Ihre Bankverbindung zusammen mit den anderen Österreichische Post Adapter Einstellungen in den Einstellungen jedes Shops hinterlegt sein. Wechseln Sie dazu ins Shopware Backend und führen folgende Schritte durch: 1. Im Menü unter Kunden > Österreichische Post den Eintrag Konfiguration wählen 2. In dem sich nun öffnenden Konfigurationsfenster kann der Österreichische Post Adapter für die verschiedenen Subshops eingerichtet werden. Die folgenden Felder sollten ausgefüllt werden: Kontoinhaber Der Name des Kontoinhabers (z.b. Ihr Name/der Name des Subshops/der Name Ihrer Firma) IBAN Die IBAN (International Bank Account Number) des angegebenen Kontos. Für weitere Informationen hierzu wenden Sie sich bitte an Ihre Bank. BIC - Der BIC (Bank Identi er Code) Ihrer Bank. Für weitere Informationen hierzu wenden Sie sich bitte an Ihre Bank. 3. Auf Speichern klicken, um die Änderungen zu übernehmen Bedienungsanleitung Österreichische Post Adapter - Seite 8
Ein Österreichische Post Versandetikett erstellen Um ein Versandetikett zu erstellen, führen Sie folgende Schritte durch: 1. Über den Menüpunkt Kunden die Bestellungen ö nen 2. In der Zeile der gewünschten Bestellung a. Auf das Versandetikett hinzufügen Icon (Box Plus) klicken b. Auf das Zeige Details Icon (Stift) klicken i. Den Österreichische Post Versand -Tab auswählen ii. Auf Versandetikett hinzufügen klicken 3. In der Bestätigungsansicht die Versanddaten überprüfen und auf Wunsch anpassen: Das Gewicht ist standardmäßig auf 20.0kg gesetzt, kann jedoch ebenfalls angepasst werden Die Checkbox Versanddaten in Bestellung speichern aktivieren, um die geänderten Versanddaten dauerhaft zu übernehmen Die Anzahl der zu erstellenden Etiketten kann auf bis zu 12 erhöht werden (dies hängt von der Anzahl der bereits erstellen Etiketten ab) 4. Auf Bestätigen klicken, um die gewählte Anzahl an Etiketten zu generieren sowie je nach Auswahl die Bestellinformationen zu speichern Österreichische Post Versandetiketten für mehrere Bestellungen gleichzeitig erstellen 1. Über den Menüpunkt Kunden die Bestellungen ö nen Bedienungsanleitung Österreichische Post Adapter - Seite 9
2. Über die Auswahlboxen in jeder Zeile die Bestellungen auswählen, für die ein Versandetikett erstellt werden soll 3. In der Toolbar über der Bestellliste auf Versandetiketten erstellen klicken. Es öffnet sich ein neues Fenster 4. Optional einen Bestellstatus im Feld Neuer Bestellstatus wählen, in den alle Bestellungen, für die erfolgreich ein Versandetikett erstellt werden konnte, nach der Erstellung überführt werden 5. Auf Versandetiketten erstellen klicken, um den Prozess zu starten 6. Nachdem die Etiketten erstellt wurden, auf Versandetiketten anzeigen klicken, um alle gerade erstellten Etiketten in einer PDF-Datei zusammenzuführen und anzuzeigen Ein Versandetikett löschen 1. Über den Menüpunkt Kunden die Bestellungen ö nen 2. In der Zeile der gewünschten Bestellung auf das Zeige Details Icon (Stift) klicken 3. Den Österreichische Post Versand -Tab auswählen 4. In der Zeile des zu stornierenden Versandetiketts auf das Versandetikett löschen Icon klicken Ein Österreichische Post Retourenetikett erstellen Um ein Retourenetikett zu erstellen, führen Sie folgende Schritte durch: 1. Über den Menüpunkt Kunden die Bestellungen ö nen 2. In der Zeile der gewünschten Bestellung auf das Zeige Details Icon (Stift) klicken und en Österreichische Post Versand -Tab auswählen Bedienungsanleitung Österreichische Post Adapter - Seite 10
3. Mit einem Klick auf Rücksendeetikett hinzufügen (Bild 11) wird ein Retourenetikett mit der Lieferadresse der Bestellung als Absenderadresse und dem Shop als Empfänger erstellt 4. Danach öffnet sich eine Maske zum optionalen Versand einer E-Mail an den Kunden (Bild 8) mit den Retourenetikett im Anhang. Dieser Schritt ist optional und kann über Abbrechen übersprungen werden, sie können das Retourenetikett dann wie normale Versandetiketten herunterladen und dem Kunden auf anderem Wege zur Verfügung stellen. Hinweis: Die Vorlage dazu können Sie in unter Grundeinstellungen -> email-vorlagen -> User emails -> ViisonSwissPostReturnLabelEmail anpassen. Bedienungsanleitung Österreichische Post Adapter - Seite 11
Bild 11 Österreichische Post Retourenetikett erstellen und an den Kunden senden Manuell eine E-Mail zur Versandbestätigung über Shopware versenden Hinweis: Wenn Sie Pickware Mobile nutzen überspringen Sie bitte diesen Abschnitt. Bei der Installation von Pickware Mobile wurde Ihre E-Mail Vorlage schon automatisch angepasst und um den entsprechenden Tracking -Link erweitert. Da der Österreichische Post Adapter die Identcodes der erstellten Versandetiketten in Shopware speichert, können diese automatisch in eine Versandbestätigungs-E-Mail Bedienungsanleitung Österreichische Post Adapter - Seite 12
integriert werden. Dazu muss zunächst die E-Mail Vorlage des gewünschten Bestellstatus, z.b. Komplett ausgeliefert, vorbereitet werden: 1. Über den Menüpunkt Einstellungen die email-vorlagen ö nen 2. In der linken Liste unter Status emails > Order status die gewünschte Vorlage, z.b. Komplett ausgeliefert, auswählen 3. Im Reiter Plaintext bzw. HTML-Text der Vorlage-Details den gewünschten Text einfügen. Der Plaintext zur Generierung eines Versandverfolgungs-Links lautet: de} https://www.post.at/sendungsverfolgung.php?pnum1={$sorder.trackingco 4. Der HTML-Text lautet: <a href=" https://www.post.at/sendungsverfolgung.php?pnum1={$sorder.trackingcod e } ">" https://www.post.at/sendungsverfolgung.php?pnum1={$sorder.trackingcode </a> 5. Über Vorlage speichern die E-Mail-Vorlage speichern Nachdem Sie ein Versandetikett für eine Bestellung erzeugt haben, können Sie nun eine Versandbestätigung inklusive Link zur Sendungsverfolgung erstellen. Setzten Sie dazu den Status der Bestellung auf den zuvor gewählten Status, z.b. Komplett ausgeliefert. Daraufhin ö net sich ein Fenster zum E-Mail-Versand, der durch einen Klick auf Mail senden bestätigt werden muss. Hinweis: Die in den Versandkosten konfigurierte Tracking-URL einer Versandart wird nicht für die oben beschriebene E-Mail-Vorlage verwendet. Sie wird lediglich z.b. im Frontend des Shops angezeigt. Bedienungsanleitung Österreichische Post Adapter - Seite 13
Paralleler Einsatz mehrerer Versanddienstleister (z.b. Österreichische Post Adapter und DPD) Wenn Sie z.b. sowohl die Österreichische Post als ach DPD zum Versenden von Paketen nutzen möchten, ist dies mit dem Österreichische Post Adapter + DPD Adapter problemlos möglich. Wir empfehlen es, bei Nutzung mehrerer Versanddienstleister eine eindeutige Zuordnung von Versandkostenarten zu genau einem Produkt eines Versanddienstleisters vorzunehmen. Beispiel: Wenn sie eine Versandkostenart DPD Standardversand in Ihrem Shopware angelegt haben, sollte diese nur im DPD Adapter Tab einem DPD Produkt zugeordnet sein. Im Österreichische Post Adapter Tab sollte hingegen Keine Zuordnung gewählt werden. Durch diese eindeutige Zuordnung ist es unseren Plugins dann möglich, automatisch für jede Bestellung Versandetiketten des jeweils gewünschten Versanddienstleisters zu erstellen. Dies funktioniert sowohl bei Nutzung des Versandetikett hinzufügen Icons in der Bestellliste als auch im Stapelverarbeitungsmodus. Welcher Versanddienstleister einer konkreten Bestellung derzeit zugeordnet ist, können Sie leicht testen, indem Sie auf das Versandetikett hinzufügen Icon in der Bestellliste klicken und prüfen, zu welchem Versanddienstleister das sich öffnende Bestätigungs-Fenster gehört. FAQ Bedienungsanleitung Österreichische Post Adapter - Seite 14