Benutzerhandbuch. Bürgel ConsumerCheck für OXID eshop

Transkript

1 Bürgel ConsumerCheck für OXID eshop Benutzerhandbuch 2014 derksen mediaopt GmbH. Alle Rechte vorbehalten. Es wurden alle Anstrengungen unternommen, um sicherzustellen, dass die in diesem Benutzerhandbuch aufgeführten Informationen richtig sind. Die derksen mediaopt GmbH übernimmt jedoch keine Gewähr und Haftung für die Richtigkeit des Inhalts dieses Benutzerhandbuches. derksen mediaopt gmbh elbestrasse 28/ berlin +49 (30) fax-66 ust.-id DE HRB B Amtsgericht Charlottenburg geschäftsführer dipl.-ing. philipp derksen

2 Inhalt 1 Das Modul Modul Installation und Konfiguration Dateien kopieren und importieren Template - Azure Theme und andere Themes Modul Aktivierung Logdatei Cache Modul Konfiguration Bürgel Scoring Service Modul Support Modul Bewertung Bürgel ConsumerCheck für OXID eshop Modul Version: derksen mediaopt GmbH Seite 2

3 1 Das Modul Der Bürgel ConsumerCheck Services ist eine Bonitätsprüfung in Echtzeit von Privatpersonen in Ihrem Online Shop. Das Modul bietet Ihnen zum einen die Adressvalidierung Ihrer Online Kunden und zum anderen steuert es die Auswahl Ihrer installierten Zahlarten, in Abhängigkeit vom Scoring-Wert des Kunden. Das Modul unterstützt beim Layout der Bezahlseite sowohl statische, als auch dynamische Vorlagen. Steuerung der möglichen Zahlarten, anhand folgender Parameter: 1. Ober- und Untergrenze des Scoring-Wertes. 2. Angabe einer abweichenden Lieferanschrift 3. Rückgabetext der Bürgel ConsumerCheck Schnittstelle OXID eshop Versionen: Modul Sprache: ab 4.7.x 4.8.x CE ab 5.0.x 5.1.x PE / EE deutsch Mehr Informationen zum ConsumerCheck bei Bürgel finden Sie hier: concheck-realtime Bürgel ConsumerCheck für OXID eshop Modul Version: derksen mediaopt GmbH Seite 3

4 2 Modul Installation und Konfiguration Bevor Sie mit der Installation beginnen, erstellen Sie ein Backup Ihrer Datenbank, sowie Ihres Online- Shops. Sollte Sie Bedenken bezüglich der Installation des Moduls haben, lassen Sie diese von fachkundigem Personal vornehmen, gerne unterstützen wir Sie dabei. Folgen Sie dieser Anleitung für einen problemlosen Betrieb. 2.1 Dateien kopieren und importieren Stellen Sie eine Verbindung z. B. via FTP zu Ihrem Webserver her. Kopieren Sie den Inhalt des Verzeichnisses copy_this in Ihr Shop Stammverzeichnis. Die Datenbankänderungen werden automatisch bei Aktivierung des Moduls vorgenommen. Sollte es dabei zu Fehlern kommen, können Sie die Datenbankänderungen auch manuell einspielen. Im OXID Shop Backend zu Service > Tools gehen die Datei Install.sql importieren Im Anschluss die VIEWS updaten. 2.2 Template - Azure Theme und andere Themes Das Modul enthält die notwendigen Template-Dateien, die beim Kopieren in das Verzeichnis modules/mo/buergel/views/blocks/azure kopiert wurden, um mit dem Azure Theme betrieben zu werden. Das Modul erweitert bestehende Templates auf der Basis von Blöcken. Für einen fehlerfreien Einsatz müssen in angepassten Themes die gleichen Blöcke wie im Azure-Theme zur Verfügung stehen. 2.3 Modul Aktivierung Loggen Sie sich im Adminstrations-Bereich ein und aktivieren Sie das Modul unter Erweiterungen > Module > Bürgel ConsumerCheck den Reiter Stamm auswählen und aktivieren Bürgel ConsumerCheck für OXID eshop Modul Version: derksen mediaopt GmbH Seite 4

5 2.4 Logdatei Die Logdatei wird bei der Modulaktivierung automatisch erstellt. Sollte nach der Modulaktivierung kein Eintrag in der Logdatei zu sehen sein, erstellen Sie die Datei mo_buergel.log im Stammverzeichnis /log und stellen Sie sicher, dass die Datei Schreibrechte hat (Status 777). Die Dateiberechtigungen können u.a. mit einem FTP-Tool verwaltet werden. 2.5 Cache Löschen Sie alle Dateien, bis auf die Datei.htaccess, aus den Verzeichnissen /tmp/ und /tmp/smarty. Bürgel ConsumerCheck für OXID eshop Modul Version: derksen mediaopt GmbH Seite 5

6 2.6 Modul Konfiguration Erweiterungen > Module > Bürgel ConsumerCheck, den Reiter Einstell. auswählen. 1. Zugangsdaten, tragen Sie hier die Ihnen von Bürgel mitgeteilte API URL, den Usernamen und das Passwort ein. 2. Prüfungen, aktivieren Sie die Adressvalidierung und / oder das Scoring. a. Tage für wiederholtes Scoring von Bestandskunden festlegen. Beachten Sie: zulässig sind nur ganze Tage von 0 bis 365. Bürgel ConsumerCheck für OXID eshop Modul Version: derksen mediaopt GmbH Seite 6

7 3. Entwicklung- und Testumgebung, aktivieren Sie das Log. Alle Zugriffe auf die API, die Adressprüfung und das Scoring werden mitgeloggt. In Ihrer Live Umgebung sollte diese Funktion aus datenschutzrechtlichen Gründen deaktiviert sein. 4. Logdaten, dort sehen Sie den Inhalt Ihrer Logdatei. Die Logfiles sind im OXID Log-Verzeichnis gespeichert (IhrShop/log/) 5. Speichern Sie Ihre Einstellungen. Bürgel ConsumerCheck für OXID eshop Modul Version: derksen mediaopt GmbH Seite 7

8 2.7 Bürgel Scoring Shopeinstellungen > Zahlungsarten > Zahlart z.b. Rechnung, den Reiter Bürgel Scoring auswählen. Weisen Sie das Bürgel Scoring den Zahlarten zu. Sie können die Bedingungen einstellen, die für die Freischaltung der Zahlungsart erfüllt sein müssen. Falls angegeben, können sowohl der Score- Bereich (z.b. von 1.0 bis 2.9), als auch die Zusatzbedingung geprüft werden. 1. Scorewert von, tragen Sie hier den Scorewert ein. Der untere Scorewert: (0.0 = nicht prüfen) Die Zahlungsart nur dann anbieten, wenn der Scorewert gleich oder höher ist. 2. Scorewert bis, tragen Sie hier den Scorewert ein. Der obere Scorewert: (0.0 = nicht prüfen) Die Zahlungsart nur dann anbieten, wenn der Scorewert gleich oder niedriger ist. 3. Keine abweichende Lieferadresse aktivieren. Die Zahlungsart nur dann anbieten, wenn keine abweichende Lieferadresse angegeben wurde. Bürgel ConsumerCheck für OXID eshop Modul Version: derksen mediaopt GmbH Seite 8

9 4. Zusatzbedingung, stellen Sie eine der folgenden Optionen ein. Zur Auswahl steht Ihnen: a. Keine Zusatzbedingung b. Person unbekannt c. Person unbekannt, Anschrift unbekannt d. Person und Anschrift bekannt e. Person / Anschrift abweichend f. Mehrere Personen bekannt Die Zahlungsart nur dann anbieten, wenn die eingestellte Bedingung erfüllt wurde. 5. Speichern Sie Ihre Einstellungen. Bürgel ConsumerCheck für OXID eshop Modul Version: derksen mediaopt GmbH Seite 9

10 3 Service 3.1 Modul Support Bei allen Support Anfragen bitten wir Sie Ihre Bürgel User ID zu nennen. Der 1st-Level-Support wird von Bürgel übernommen, der 2nd-Level-Support von mediaopt. Bei Support Anfragen bitten wir Sie sich folglich zuerst an Bürgel zu wenden. Bürgel entscheidet, ob die Anfrage an mediaopt weitergeleitet oder selbst durch Bürgel bearbeitet wird. Werden Support Anfragen direkt an mediaopt gestellt, bitten wir Sie zuvor die Kostenübernahme mit Bürgel zu klären, alternativ kann mediaopt den Support leider nur kostenpflichtig übernehmen. Eine kurze Information dazu erhalten Sie als Antwort auf Ihre Anfrage. 1st-Level-Support 2nd-Level-Support 3.2 Modul Bewertung Sollte es Unklarheiten in dem Benutzerhandbuch geben, freuen wir uns über Ihr Feedback. Schreibe Sie uns einfach eine an mit dem Betreff Benutzerhandbuch. Über eine Bewertung unseres OXID eshop Moduls im OXID exchange unter würden wir uns freuen. Bürgel ConsumerCheck für OXID eshop Modul Version: derksen mediaopt GmbH Seite 10