PhPepperShop Frankierlösung Modul. Datum: 13. September 2013 Version: 1.1. WebStamp. Die elektronische Briefmarke. Glarotech GmbH

Transkript

1 PhPepperShop Frankierlösung Modul Datum: 13. September 2013 Version: 1.1 WebStamp Die elektronische Briefmarke Glarotech GmbH

2 Inhaltsverzeichnis 1. Einleitung Installation Systemanforderungen Dateien kopieren und hochladen Installation des externen PhPepperShop Moduls für WebStamp Inbetriebnahme des WebStamp Moduls WebStamp Business-Account erstellen Business Anmeldung Voraussetzungen Konfiguration Benutzer-Modus (Standard) Entwickler-Modus Anwendung Etikettendruck Was wird nicht unterstützt Kontakt Anhang: Beispiel Webstamp...11 Glarotech GmbH Seite 2/11

3 1. Einleitung Der PhPepperShop kann mit dem WebStamp Modul erweitert werden, so dass man Shop-Bestellungen direkt online frankieren kann. Dieses Modul ist optional für den PhPepperShop erhältlich und muss separat bezogen werden. Dieses Modul unterstützt Dienstleistungen der Schweizer Post und unterstützt die Produkte Paket Inland, Brief Inland und Brief Ausland. Deshalb ist das Modul für alle Shopbetrieber interessant, welche Pakete mit der Schweizer Post innerhalb der Schweiz versenden. Wenn dieses Modul zusammen mit dem Pakettracking Modul eingesetzt wird, schreibt das Webstamp Modul die aktuelle Paketverfolgungsnummer (Tracking-Nr.) automatisch zur Bestellung. 2. Installation 2.1 Systemanforderungen Um das WebStamp Modul einsetzen zu können, ist ein PhPepperShop Professional v.3.0 oder Enterprise erforderlich. Weiter muss man über einen WebStamp Business-Account bei der Schweizer Post verfügen. 2.2 Dateien kopieren und hochladen Das Modul besteht im Wesentlichen aus einigen Dateien in einem Verzeichnis, die man in seinen installierten PhPepperShop kopieren muss. Dazu entpackt man zuerst das mitgelieferte ZIP-Archiv. Es ist folgendes Verzeichnis enthalten, hier mit den Zielverzeichnissen dargestellt: {shopdir}/shop/admin/module/webstamp/ Das Verzeichnis lässt sich einfach via FTP oder SCP zum Webserver hochladen. Der Platzhalter {shopdir} steht dabei für das Shopverzeichnis auf dem Webserver, wo die Datei index.php zusammen mit der Datei README.txt zu finden ist. Nun wird das Modul vom Shop erkannt und eingebunden. Es wird im Menü 'Shop Konfiguration' unten bei den internen Modulinfos aufgelistet. 2.3 Installation des externen PhPepperShop Moduls für WebStamp Nach dem Kopieren der Dateien wird das WebStamp Modul jetzt installiert. Dazu geht man in die Shop- Administration des eigenen PhPepperShops und wählt dort den Menüpunkt 'Module' > 'Modulverwaltung'. Hier sieht man auf der linken Seite (nicht installierte Module) den Eintrag 'WebStamp'. Diesen Eintrag nun anwählen und unten auf den Button 'Installieren' klicken. Wenn alle Tests positiv verlaufen sind, kann man die Folgeseite bestätigen und sieht das Modul nun installiert auf der rechten Seite ange - zeigt. Nun ist das WebStamp Modul technisch installiert. Weiter werden nun die Inbetriebnahme des Moduls und die Konfigurationsmöglichkeiten beschrieben. Glarotech GmbH Seite 3/11

4 3. Inbetriebnahme des WebStamp Moduls 3.1 WebStamp Business-Account erstellen Wenn Sie bereits einen Account für die WebServices besitzen, können Sie die Punkte überspringen und bei Punkt 6. Business Anmeldung beginnen. Die Anmeldung ist kostenlos. 1. Rufen Sie im Browser folgende URL auf Klicken Sie nun auf den Button Registrieren um den Registrierungsprozess zu starten. Später können Sie sich hier unter Login in Ihrem Account einloggen 2. Zuerst können Sie wählen, ob Sie den Webstamp-Dienst zu einem bestehenden Login-Post - Konto hinzufügen oder ob auch noch dieses erstellt werden soll. Klicken Sie hier rechts auf Registrieren. Sollten Sie bereits ein Login-Post -Konto besitzen, melden Sie sich links mit Ihren Zugangsdaten an. Glarotech GmbH Seite 4/11

5 3. Im oberen Teil können Sie Ihre Adresse und ein aus mindestens acht Zeichen bestehendes Passwort. Unten geben Sie eine Sicherheitsfrage und deren Antwort ein. Klicken Sie danach bitte auf Weiter. 4. In diesem Schritt geben Sie Ihre persönlichen Daten ein. Ganz wichtig ist hier, dass Sie die korrekte Adresse eingeben, da diese validiert wird. Ausserdem erhalten Sie per Post einen Aktivierungscode. Klicken Sie danach bitte wieder auf Weiter. 5. Hier erhalten Sie nochmals eine Zusammenfassung der von Ihnen eingegebenen Daten. Sind diese korrekt, markieren Sie das Kontroll- Kästchen Ich habe die AGB gelesen und akzeptiere diese. und klicken Sie auf Abschliessen. Sollten nicht alle Daten korrekt sein, können Sie diese mit einem Klick auf Zurück ändern. 6. Hiermit ist der Registrierungsprozess abgeschlossen. Ein Aktivierungscode wurde an Ihre Adresse versendet. Tragen Sie diesen nun hier ein. Glarotech GmbH Seite 5/11

6 3.1.1 Business Anmeldung Wenn Sie den Aktivierungscodes eingegeben haben und eingeloggt sind, können Sie aus Ihrem Account einen Business-Account machen. 7. Nachdem das Konto aktiviert wurde, müssen nochmals die AGB bestätigt werden. Ausserdem können Sie auswählen, ob Sie über neue Funktionen und Erweiterungen informiert werden möchten. 8. Nun sind Sie eingeloggt und können die WebServices nutzen und von dem Angebot profitieren, dass Ihnen beim Abschluss der Anmeldung versprochen wurde. Wenn Sie auf den Menüpunkt «WebStamp» klicken, können Sie Ihre Briefe und Pakete frankieren. Doch um den WebStamp Business Account zu erstellen bzw. abzuschliessen, müssen Sie noch rechts oben unter «Services» auf «Einstellungen» klicken. 9. Wählen Sie hier «Webstamp Business freischalten». Glarotech GmbH Seite 6/11

7 3.2 Voraussetzungen 10. Dies ist der letzte und wichtigste Schritt für die Business-Anmeldung. Sie sehen bereits ihre Kunden-ID und müssen nur noch das Passwort dazu eingeben. Bitte beachten Sie, dass dieses Passwort nicht dasselbe Passwort ist, welches Sie beim Einloggen verwendet haben. Diese Daten müssen Sie danach in die PhPepperShop WebStamp Modulkonfiguration eintragen. Das wird im Kapitel Konfiguration noch genauer beschrieben. Bevor wir mit der Konfiguration des WebStamp Moduls beginnen, müssen folgende Voraussetzungen erfüllt sein: 1. Sie besitzen einen PhPepperShop in der Version 2.6 Professional oder Enterprise 2. Sie haben einen fertig eingerichteten und aktivierten WebStamp Business-Account 3. Sie wissen Ihre Kunden-ID vom WebStamp Business-Account 4. Sie haben Ihr Business-Account Passwort vom WebStamp 4. Konfiguration Um nun Konfigurationen am WebStamp Modul vorzunehmen begeben wir uns in die Konfigurationsmaske des WebStamp Moduls. Dazu wählen wir im Hauptmenü der Shop-Administration bei Module den Punkt 'Externe PhPepperShop Module an': Hier sehen wir nun das Logo zum Betreten der WebStamp Konfigurationsmaske: Die WebStamp-Einstellungen werden hier im WebStamp Konfigurationsmodul durchgeführt. Bitte klicken Sie auf den WebStamp-Button, um mit der Konfiguration zu beginnen. 4.1 Benutzer-Modus (Standard) Wenn Sie WebStamp als Frankierlösung anwenden möchten, ist dieser Betriebsmodus richtig für Sie. Bitte tragen Sie Ihre Kunden-ID und Ihr Passwort, die Sie aus Ihrem WebStamp Business-Account hier ein. Sobald Sie alles eingetragen haben, speichern Sie bitte Ihre Eingaben indem Sie auf den Speichern - Button klicken. Glarotech GmbH Seite 7/11

8 4.2 Entwickler-Modus Achtung! Diesen Modus nur auswählen, wenn Sie dieses Modul anpassen wollen. Im Entwickler-Modus haben Sie die Möglichkeit zwischen den Betriebsarten und der API umzustellen. Dies wird nur von technischen Administratoren benötigt. Sie können zum Entwickler-Modus umschalten, wenn Sie in der Datei: {shopdir}shop/admin/module/webstamp/show_webstamp_admin.php mit einem Editor aufmachen und die Variable $developer_mode = false; welche standardmässig auf false ist, auf true umstellen. Bitte beachten Sie, dass das WebStamp-Modul bei einer Fehlkonfiguration nicht mehr läuft! Glarotech GmbH Seite 8/11

9 5. Anwendung Nachdem Sie das WebStamp-Modul installiert und konfiguriert haben, wechseln wir zur Anwendung des Moduls. In der Shop-Administration, können Sie auf den Link 'Kunden/Bestellungen' > 'Kundenmanagement' klicken. Nun ist für jede Bestellungszeile ein neuer Frankieren -Button erschienen. Der Frankieren -Button erscheint nur, wenn alles richtig konfiguriert wurde. Wenn Sie auf den Frankieren -Button einer Bestellung geklickt haben, geht ein PopUp-Fenster auf. Beim ersten Aufruf der WebStamp Maske kann es je nach Internetverbindung sein, dass der Aufruf ein paar Sekunden in Anspruch nimmt, um die Daten von WebStamp zu holen. Es wird ein Cache erstellt, so dass bei den weiteren Aufrufen die Zeitverzögerung entfällt. Bei jedem Aufruf wird versucht anhand der vorhandenen Daten eine Vorauswahl zu treffen. Das PopUp-Fenster ist in zwei Teilen gegliedert. Oben wird die Bestellung angezeigt und unten ist der WebStamp-Teil, siehe folgendes Screenshot. Im WebStamp-Teil sehen Sie am Anfang die Adresse des Absender welche der Shop-Adresse entspricht und diejenige des Empfängers die bei der Bestellung angegeben worden ist. Diese kann die abweichende Lieferadresse sein oder die Adresse des bestellenden Kunden. Weiter unten ist der Konfigurations-Teil der Bestellung und zuunterst sehen Sie in echtzeit welches Produkt Sie gerade ausgewählt haben,-dessen Namen, das Gewicht, die Masse und den Preis der Frankatur. Glarotech GmbH Seite 9/11

10 Mit Klick auf den Vorschau-Button sehen Sie ein Beispiel der Frankatur. Beim Klick auf dem Frankieren-Button wird die Frankatur erstellt (kostenpflichtig). Der Hilfe-Button zeigt die Online-Hilfe an. 6. Etikettendruck Standardmässig wird die Frankatur auf ein A4 gedurckt, es kann jedoch auch der Etikettendruck gewählt werden, welcher auch Programmierungsanpassungen erlaubt um diese zu optimieren. Beim Etikettendruck kann eine Startposition angegeben werden. Die Start-Position,welche angegeben werden kann, regelt die Positon der Ettikette, damit amn auch mehrere Ettiketten auf ein A4 Blatt plazieren kann. Glarotech GmbH Seite 10/11

11 7. Was wird nicht unterstützt Frankierlizenz basierte Dienste Additions, welche zusätzliche Datenstrukturen benötigen, wie z.b. Benachrichtigung via SMS oder , Bargeldloser Nachname und Brief Ausland werden nicht unterstützt WebStamps werden auf A4 gedruckt. Andere Formate würden eine Programmierung bedingen. Etikettendruck wird aber unterstützt (siehe 6. Etikettendruck). 8. Kontakt Bei Fragen zu WebStamp Business steht der Support der Post gerne zur Verfügung: Telefon: Schriftliche Anfragen sind an folgende Adresse zu richten: Die Schweizerische Post PostMail WebStamp Postfach Luzern 9. Anhang: Beispiel Webstamp Glarotech GmbH Seite 11/11