ESRlight Modulanleitung

Transkript

1 ESRlight Modulanleitung Datum 09. Juni 2017 Version 1.9

2 Inhaltsverzeichnis 1. Einleitung Anmeldung für ESRlight Konfiguration Standard Konfigurationsparameter: Advanced Konfigurationsparameter: Administration Transaktionsidentifikation: ESRlight Debitorenverwaltung Logging Log-Viewer Installation Bedienung Bestellung im Shop entgegen nehmen Verwaltung in ESRlight Back-Office Hinweis MwSt. Betragsrundung Kommunikation ansehen / Debugging Hinweis Fälligkeitsdatum Kontakt Kontakt leanux AG (ESRlight / SQL-Ledger) Kontakt Glarotech GmbH (PepperShop) Beispielrechnung mit ESR Einzahlungsschein Installation Erste Anmeldung in ESRlight Systemanforderungen Dateien kopieren und hochladen...11 ESRlight funktioniert nur zusammen mit einem PostFinance Konto. Der Betrieb mit einem Bankkonto ist vorerst nicht vorgesehen. PepperShop wird von Glarotech entwickelt und vertrieben. Seit 1998 ist das innovative Unternehmen im Internet tätig und auf E-Commerce spezialisiert. Sie als Kunde profitieren vom direkten Draht zu den Herstellern der Produkte. Glarotech GmbH Toggenburgerstrasse 156 CH-9500 Wil info@glarotech.ch Tel. +41 (0)

3 1. Einleitung Mit diesem externen PepperShop Modul können Sie Ihre Debitoren mit viel geringerem Aufwand als bisher bewirtschaften ganz einfach online mit ESRlight Version 1. Sie haben stets die Übersicht über die Zahlungseingänge und brauchen keine ESR-Referenznummern zu erfassen. ESRlight Debitorenverwaltung: PepperShop übermittelt Bestellungen (Rechnung, Vorauskasse) automatisch an ESRlight 1 Rechnungen schreiben mit dem jeweiligen Betrag und Rechnungstext Rechnungen mit einem Klick im PDF-Format erstellen und drucken Automatisches Verbuchen der Zahlungseingänge Allfällige Mahnungen per Knopfdruck als PDF-Datei erstellen Auf Wunsch ist das Angebot individuell erweiterbar (kostenpflichtig) Sicher dank verschlüsselter Verbindung 2. Anmeldung für ESRlight 1 Damit alle hier beschriebenen Schritte durchgeführt werden können, wird davon ausgegangen, dass Sie als Shopbetreiber bereits über einen Account für ESRlight verfügen. Falls das noch nicht der Fall sein sollte, können Sie sich wie folgt registrieren: Senden Sie ein mit folgendem Inhalt an folgende Adresse: esrlight@leanux.ch. Firma Vorname NamePepper Adresse ESR-Teilnehmer Nr. (erhalten Sie auf Anfrage von der Schweizerischen Post) MwSt Nr. oder UID (falls vorhanden) Sprache nur wenn eine andere Sprache als Deutsch gewünscht wird Nach der Übermittlung dieser Daten wird für Sie ein ESRlight 1 Account eröffnet. Sie werden via über die Eröffnung orientiert und können danach mit der Konfiguration beginnen. Info: Inzwischen hat Leanux AG zusammen mit PostFinance die Version 2 von ESRlight veröffentlicht. Der grosse Unterschied zu Version 1 liegt darin, dass die Artikel im ESRlight verwaltet werden und nicht im Shop, dies ist mit dieser Anbindung nicht verwendbar. Weitere Infos zur Anbindung von ESRlight Version 2 an den PepperShop erhalten Sie auf Anfrage direkt bei Leanux AG. Hinweis für Migration von PepperShop Kunden mit Aufschaltung von ESRlight 1 vor dem 17. Februar 2012: Siehe folgende URL: Seite 3/12

4 3. Konfiguration Abbildung 1: ESRlight Modul Verwaltung (Administration) In der ESRlight Modulverwaltung gibt es folgende Einstellungsmöglichkeiten: 3.1 Standard Konfigurationsparameter: Modul-Aktivierung: Hier ein Häkchen in die Checkbox setzen, wenn die Anbindung an ESRlight aktiviert sein soll. ESRlight für Rechnung verwenden: Wenn aktiviert, werden Bestell- und Kundendaten an ESRlight übermittelt, wenn alle Kriterien erfüllt sind und die Bezahlungsart Rechnung verwendet worden ist. ESRlight für Vorauskasse verwenden: Wenn aktiviert, werden Bestell- und Kundendaten an ESRlight übermittelt werden, wenn alle Kriterien erfüllt sind und die Bezahlungsart Vorauskasse verwendet worden ist. Adresse für Benachrichtigungen: Adresse, welche für allfällige ESRlight ModulBenachrichtigungen dieses Shopsystems verwendet werden. , wenn keine ESRlight Notification: ESRlight kann nur über eine Bestellung informiert werden, wenn folgende Kriterien erfüllt sind: Seite 4/12 Maximal ein MwSt. Satz pro Bestellung (oder keine MwSt.)

5 Währung ist CHF (Schweizer Franken) Es sind keine Kommunikationsfehler mit dem ESRlight Server aufgetreten...wenn dies nicht der Fall ist, wird eine abgesendet, falls hier so konfiguriert. ESRlight Hostname: Name des Rechners, wo Ihr ESRlight Mandant installiert ist. Der Standardwert ist hier Die Einstellung lässt sich auch testen. ESRlight Pfad: Name des Pfads für Ihren ESRlight Zugriff wo sich Ihr Mandant befindet. Der Standardwert ist hier: sql-ledger-peppershop. Dies lässt sich auch testen. ESRlight Login: Der Loginname, welcher für die Anmeldung zu ESRlight verwendet wird. ESRlight Passwort: Das ESRlight Passwort. ESRlight Teilnehmernummer: Diese Teilnehmernummer (Format: xx-xxxxxx-x) erhalten Sie nach der Registrierung von ESRlight zugeteilt. ESRlight Kommunikation loggen: Soll die Kommunikation zwischen diesem PepperShop und ESRlight geloggt werden? Dies dient vor allem Nachforschungszwecken. Es können schnell viel Daten anfallen! Mit Hilfe des Log-Viewer Moduls kann das Logfile esrlight_calls.log angeschaut werden. Bitte nur zwecks Debugging aktivieren, da auch Passwörter in den Logs gespeichert werden. Zahlungsfrist in Tagen: Welche Zahlungsfrist wird bei der Neuerstellung eines Kunden hinterlegt. Diese Frist wird initial beim Kunden hinterlegt und erst bei einem Update (erneuter Einkauf eines bestehenden Kunden) aktualisiert. MwSt. Einstellung im Shop: Direktlink zu Mehrwertsteuereinstellungen im PepperShop. Wenn die MwSt. deaktiviert ist, wird hier das Menü 'Allgemeine Shopeinstellungen' verlinkt. Wenn MwSt. bereits aktiviert worden ist, so wird hier das aktive MwSt. Menü verlinkt. 3.2 Advanced Konfigurationsparameter: (In einem Datei-Editor in der PHP-Datei via {shop_verzeichnis}/shop/admin/module/esrlight/show_esrlight_admin.php freischaltbar) Die Andvanced Konfigurationsparameter gelten nur für Anbindungen an SQL-Ledger. Aktivierung: Hier ein Häkchen in die Checkbox setzen, wenn die ESRlight als Kreditkarten Handler verwendet werden können soll (nicht implementiert!). Bestellungsidentifikation mit Zeitangabe: Soll die Bestellungsidentifikation (Bestellreferenznummer) um eine Zeitstempel erweitert werden? (Testing / Debugging / Listenübersicht) Interner Pfad: Pfad der aufgerufenen Dateien auf dem ESRlight Server. Wird an den ESRlight-Pfad angehängt. AR-Konto: Konto für offene Posten (z.b Debitoren) AR-Paid1-Konto: Konto für Zahlungseingang (z.b {konto_nr}). Hier bitte gut aufpassen. Das System ersetzt während eines Bestelleingangs in dieser Kontobezeichnung den Wert {konto_nr} mit der ESR-Teilnehmernummer. Hier nur etwas ändern, wenn man ganz genau weiss, was man tut. AR-Amount Konto (global): Globales Konto für Verbuchung der verkauften Ware (z.b Ertrag) AR-Amount Konto pro Artikel: Falls das Konto zur Verbuchung der gekauften Ware pro Artikel erfolgen soll, kann hier ein Artikelzusatzfeld gewählt werden, in welchem das Konto steht (Fallback: Globales Konto). Bitte beachten! 1. Vor dem Betrieb muss man sich auf mind. einmal angemeldet haben! Seite 5/12

6 2. ESRlight verarbeitet pro Bestellung maximal 10 Positionen. Sobald in einer Shopbestellung mehr Positionen oder Rabatte definiert sind, werden alle überzähligen Positionen in eine einzelne zusammengefasst. 3. Die PepperShop Anbindung an ESRlight prüft vor der Übergabe der Daten einer Bestellung viele Details der für ESRlight aufbereiteten Parameter. Sollte etwas nicht mit erwarteten Werten übereinstimmen wird die Bestellung NICHT an ESRlight übermittelt und es wird ein Fehler an die angegebene Adresse versendet. Diese Bestellung muss der Shopbetreiber dann gegebe nenfalls manuell eintragen. Somit ist weitestgehend sichergestellt, dass keine falschen Bestelldaten in Rechnung gestellt werden. Nachdem die Angaben entsprechend konfiguriert wurden, sollte man sicherstellen, dass diese gespeichert worden sind. 4. Administration 4.1 Transaktionsidentifikation: Bei einer via ESRlight bezahlten Bestellung wird im Kundenmanagement zu jeder ESRlight Bestellung eine Infoanzeige hinter der Bezahlungsart gehängt: Abbildung 2: Kundenmanagement Bestellungsdarstellung 4.2 ESRlight Debitorenverwaltung ESRlight bietet die Loginmöglichkeit direkt auf der ESRlight Webseite an: Logging Der PepperShop kann alle Aufrufe die er ans ESRlight System absetzt loggen. Das entsprechende Log file lautet esrlight_calls.log und kann via Log-Viewer (Modul) eingesehen werden (Shop-Administration Externe PepperShop Module Log-Viewer). Der Logging-Mechanismen kann über die Einstellung 'ESRlight Kommunikation loggen' gesteuert werden (ESRlight Verwaltung in Shop-Administration). 5. Log-Viewer Installation Bevor man die vom ESRlight Modul erzeugten Log-Dateien sehen kann, müssen wir noch das externe PepperShop Modul 'Log-Viewer' installieren, falls dieses Modul nicht schon installiert ist. Dies funktio niert analog wie die Modulinstallation des ESRlight Moduls. Wir klicken in der Shop-Administration auf den Punkt 'Module' > 'Modulverwaltung' und dort auf den Button, der mit PepperShop Modulverwaltung betitelt ist. Hier klicken wir im linken Fenster auf 'Log Viewer' und unten dran auf den Button 'Installieren'. Wir bestätigen den Verlauf der Installation mit Klick auf den Button 'Zurück zur Modulverwaltung'. Nach der Installation des Log-Viewers erscheint dieser nun im rechten Fenster, welches die installierten Module anzeigt. Wenn wir im rechten Fenster auf benutzen klicken, können wir die vorhandenen LogDateien sehen. Seite 6/12

7 6. Bedienung 6.1 Bestellung im Shop entgegen nehmen Kundenseitig ist die Bedienung relativ einfach. Der Kunde bestellt im Shop ganz normal und bemerkt von der ESRlight Anbindung gar nichts. Ablauf der Anbindung im Shop: 1. Der Kunde legt sich Artikel in den Warenkorb und geht zur Kasse im Shop 2. Er wählt eine mit ESRlight verknüpfte Bezahlungsart z.b. Rechnung und akzeptiert die AGB 3. Der Shop schliesst die Bestellung ab und sendet dem Kunden und Shopbetreiber ein Be stellbestätigungs Weiter werden die Kundendaten zu ESRlight übermittelt. (Falls der Kunde mit angegebener Kundennummer dort schon existiert, führt dies nicht zu einer Dublette) 5. Nun übermittelt der Shop die Bestellung in Form einzelner Artikel- und Zusatzpositionen und eröffnet in ESRlight eine neue, offene Rechnung. Ablauf im ESRlight Back-Office: 1. Offene Rechnungen durchschauen und Rechnungen (ESR-Einzahlungsscheine) drucken. 2. Periodisch über Import mit dem Postkonto abgleichen (eingegangene Zahlungen erfassen) 3. Gegebenenfalls Mahnungen versenden 6.2 Verwaltung in ESRlight Back-Office Die Verwaltung der offenen Posten in ESRlight kann man den Anleitungen auf folgender Webseite entnehmen: x Abbildung 3: Beispielansicht einer aus dem Shop übermittelten, offenen Rechnung Seite 7/12

8 30 Abbildung 4: Ansicht eines aus dem Shop übermittelten Kundendatensatzes 7. Hinweis MwSt. Betragsrundung Im PepperShop werden die Beträge intern mit maximaler Genauigkeit berechnet und erst das Gesamttotal mit dem pro Währung definierbaren Rundungsfaktor (CHF = 0.05) gerundet. ESRlight unterstützt nur einen MwSt. Betrag. Dieser MwSt. Betrag wird bei ESRlight auf 5 Rappen gerundet, das Gesamttotal hingegen nicht mehr. Damit keine einzubezahlenden Beträge entstehen, welche nicht auf CHF x.x0 oder CHF x.x5 Rappen enden, übermittelt der PepperShop deshalb bei Bedarf einen um die Differenz angepassten MwSt. Betrag an ESRlight, was zu einem maximalen Unterschied von CHF 0.02 gegenüber dem im Shop aufgeführten MwSt. Betrag führen kann. Der zu verrechnende To talbetrag wird übereinstimmen. Wenn Sie sich bei ESRlight in der 'Ausgangsbuchung bearbeiten'-maske befinden (Detailansicht einer Rechnung) und dort auf den Button 'Erneuern' klicken, so berechnet ESRlight die Bestellung anhand der eigenen Berechnungs- und Rundungsregeln (siehe Absatz weiter oben), was wiederum in einem anderen Total anstatt dem vom Shop an den Kunden kommunizierten Betrag resultieren kann (max. CHF 0.02 Differenz). Falls der 'Erneuern'-Button geklicket worden ist, einfach die Ansicht schliessen und nochmals öffnen, dann zeigt ESRlight wieder die vom Shop berechneten Werte an. 8. Kommunikation ansehen / Debugging Debugging der Kommunikation (erfordert PHP-Kenntnisse): Falls die Analyse des Kommunikationslogs nicht ausreicht, kann man in der Datei {shop_verzeichnis}/shop/config.inc.php beim Punkt 'DEBUG_ONLY_ON_HOST' die eigene IP-Adresse eintragen und in der Datei {shop_verzeichnis}/ shop/esrlight_api.def.php die public Membervariable 'show_http_requests' temporär auf true stellen. Jetzt sieht man vom angegebenen Rechner aus beim Bestellabschluss alle Kommunikationsdaten mit ESRlight (Anfrageparameter und Antwortseiten). Bitte beachten Sie, dass es bei Anpassungen am Sourcecode kein Support von Glarotech GmbH und leanux AG gibt und darauf resultierende Probleme in Rechnung gestellt werden müssen. Seite 8/12

9 9. Hinweis Fälligkeitsdatum Erste ESRlight Modulversionen berechnen das Fälligkeitsdatum erst nach Klick auf 'Erneuern'. 10. Kontakt 10.1 Kontakt leanux AG (ESRlight / SQL-Ledger) leanux.ch AG Industriestrasse 25 CH-8604 Volketswil Web: Tel: Fax: info@leanux.ch Kontakt Glarotech GmbH (PepperShop) Glarotech GmbH Toggenburgerstrasse 156 CH-9500 Wil Web: Tel: Fax: info@glarotech.ch Seite 9/12

10 11. Beispielrechnung mit ESR Einzahlungsschein Abbildung 5: Beispiel einer aus ESRlight generierten Rechnung mit ESR-Einzahlungsschein Die hier abgebildete Beispiel Rechnung wurde in ESRlight generiert. Diese wird einfach auf ein spezielles Papier mit perforiertem ESR-Einzahlungsschein Teil gedruckt und dem Kunden per Briefpost zugestellt. Beim Drucken bitte darauf achten, dass keine Auto-Grössenanpassung läuft. Seite 10/12

11 12. Installation 12.1 Erste Anmeldung in ESRlight Vor der Modulinstallation muss man sich bei ESRlight mindestens einmal angemeldet haben Systemanforderungen Um das ESRlight Modul einsetzen zu können, ist mindestens ein PepperShop v.3.0 Professional oder Enterprise erforderlich Dateien kopieren und hochladen Das ESRlight Modul besteht im Wesentlichen aus drei Dateien und einem Verzeichnis, welche man in sei nen installierten PepperShop kopieren muss. Dazu entpackt man zuerst das mitgelieferte ZIP-Archiv. Es sind folgende Dateien enthalten, hier mit den Zielverzeichnissen dargestellt: {shopdir}/shop/esrlight_def.php {shopdir}/shop/esrlight_payment.php {shopdir}/shop/admin/module/esrlight/* Datei Datei Verzeichnis Die Dateien und das Verzeichnis lassen sich einfach via FTP oder SCP zum Webserver hochladen. Der Platzhalter {shopdir} steht dabei für das Shopverzeichnis auf dem Webserver, wo unter anderem die Datei index.php zusammen mit README.txt zu finden ist. Modulinstallation. Nach dem Kopieren der Dateien kann man in die Shopadministration gehen und dort ins Menü 'Module' > 'Modulverwaltung' wechseln. Auf der linken Seite, bei den Abbildung 6: ESRlight Modul wird aufgelistet (angezeigte Module können vanoch nicht installierten Modulen, riieren) sieht man nun das ESRlight Modul aufgelistet. Nun muss das ESRlight Modul angewählt werden und auf den 'Installieren' Button geklickt werden. Wenn die Installationsroutine ohne Probleme durchläuft, wird dies auf der darauf folgenden Seite kom muniziert. Das Modul ist nun installiert. Wir klicken nun auf den Button 'Zurück zur Modulverwaltung' und dort 'Zurück zur Moduladministration'. Wir sehen jetzt einen Button für das ESRlight Modul. Wenn man auf diesen Button klickt, erscheint die ESRlight Modulverwaltung. Seite 11/12

12 Abbildung 7: ESRlight Modul Verwaltung Auswahlbutton PepperDie Installation des ESRlight Moduls ist nun abgeschlossen. Damit das Modul eingesetzt werden kann, muss das Modul nun noch an die spezifische Konfiguration des Shopbetreibers angepasst werden, siehe dazu Kapitel. Seite 12/12