BillSAFE Modul für OXID 4.4.x Herzlich willkommen, Sie haben sich für BillSAFE, den beliebtesten Rechnungskauf-Anbieter bei Deutschlands Online-Shoppern entschieden. (TNS Emnid Studie 01/2011) Stand: 30. November 2011 Alle verwendeten Markenzeichen sind urheberrechtlich geschützt. Die Abbildungen dienen der beispielhaften Darstellung und können von den bei Ihnen angezeigten abweichen. © 2011 BillSAFE GmbH. Alle Rechte vorbehalten. Alle Angaben ohne Gewähr. 1 Inhaltsverzeichnis Inhaltsverzeichnis .......................................................................................................................................................................................................................................... 2 Kapitel I - BillSAFE Rechnungskauf auf einen Blick ................................................................................................................................................................................. 3 Kapitel II - Installation des BillSAFE Moduls .............................................................................................................................................................................................. 4 Kapitel III - Konfiguration des BillSAFE Moduls ........................................................................................................................................................................................ 5 Kapitel IV - Arbeiten mit BillSAFE .............................................................................................................................................................................................................. 10 a) BillSAFE Bestelldetails.................................................................................................................................................................................................................... 10 b) Versandmeldung .............................................................................................................................................................................................................................. 11 c) Stornierung / Retoure ..................................................................................................................................................................................................................... 11 d) Erstellung der Rechnung ................................................................................................................................................................................................................ 11 e) Transaktion pausieren / Stundung ............................................................................................................................................................................................... 12 f) Direktüberweisung melden ............................................................................................................................................................................................................ 12 Kapitel V - Testkauf BillSAFE Modul ......................................................................................................................................................................................................... 13 2 Kapitel I - BillSAFE Rechnungskauf auf einen Blick Anhand der dargestellten Grafik sehen Sie, wie einfach der Rechnungskauf mit BillSAFE in Ihrem Online-Shop funktioniert 3 Kapitel II - Installation des BillSAFE Moduls Hinweis! Bevor Sie mit der Installation beginnen, erstellen Sie bitte von Ihrer Datenbank sowie den zu ändernden Dateien ein Backup! Achten Sie zudem bitte darauf, als Transfermethode „binär“, bzw. „binary“ auszuwählen Voraussetzung: OXID eShop ab Version 4.4.x, PHP 5.2, SQL 5.1 1. Stellen Sie via FTP-Client eine Verbindung zu Ihrem Webserver her. 2. Entpacken Sie das Modul und kopieren Sie alle Dateien aus dem Ordner „Copy_this“ in das Rootverzeichnis des Shops. Bitte stellen Sie sicher, dass hierbei die komplette Ordnerstruktur inklusive aller Unterordner kopiert wird. 3. Fügen Sie am unteren Ende der Datei /modules/functions.php bitte folgende Zeile ein: include dirname( __FILE__ ) . "/mo_billsafe/bootstrap.php"; 4. Wählen Sie im OXID Administrationsbereich Service / Tools. Klicken Sie auf „Durchsuchen“ und wählen aus dem Modulverzeichnis die Datei „Install_4.4.sql“ aus, und klicken auf „Update starten“ 5. Abschließend löschen Sie auf dem FTP Server im Ordner „/tmp“ bitte alle Dateien mit Ausnahme der .htaccess. 4 Kapitel III - Konfiguration des BillSAFE Moduls Erweitern Sie Ihre Moduleinträge unter Stammdaten / Grundeinstellungen / System / Module Tragen Sie hier bitte folgende Zeilen ein: payment => mo_billsafe/views/mo_billsafe__payment oxpayment => mo_billsafe/core/mo_billsafe__oxpayment order => mo_billsafe/views/mo_billsafe__order oxorder => mo_billsafe/core/mo_billsafe__oxorder order_article => mo_billsafe/admin/mo_billsafe__oxadminview_44&mo_billsafe/admin/mo_billsafe__order_article oxorderarticle => mo_billsafe/core/mo_billsafe__oxorderarticle_44&mo_billsafe/core/mo_billsafe__oxorderarticle order_overview => mo_billsafe/admin/mo_billsafe__oxadminview_44&mo_billsafe/admin/mo_billsafe__order_overview order_list => mo_billsafe/admin/mo_billsafe__oxadminview_44&mo_billsafe/admin/mo_billsafe__order_list order_main => mo_billsafe/admin/mo_billsafe__oxadminview_44&mo_billsafe/admin/mo_billsafe__order_main thankyou => mo_billsafe/views/mo_billsafe__thankyou Klicken Sie dann auf “Speichern”. Hinweis! Bitte überprüfen Sie, ob bereits andere Module die in dieser Liste aufgeführten Klassen bereits erweitern. Hängen Sie in diesem Fall die beschriebenen Einträge mit einem „&“ Zeichen an. Weitere Informationen hierzu erhalten Sie in Ihrem OXID-Handbuch. Bsp.: oxorder => invoicepdf/myorder&mo_billsafe/core/mo_billsafe__oxorder 5 Das Oxid Standard Modul invoicepdf wird zur Ausführung des BillSAFE Invoice Tools benötigt! Hinweis: Dieses Modul wurde auf Basis des Standard Templates entwickelt. Ihr individuelles Template muss ggf. angepasst werden. Die betroffenen Templates mit den notwendigen Anpassungen finden Sie im Ordner /src/admin/basic/tpl (Die entsprechenden Änderungen sind jeweils mit Smarty-Kommentaren [{* mo_billsafe START *}] … [{* mo_billsafe END *}] umschlossen.) 6 Als nächstes müssen die Benutzergruppen und das Land der Zahlart BillSAFE zugeordnet werden. Hierzu wählen Sie bitte Shopeinstellungen / Zahlungsarten / Rechnungskauf via BillSAFE / Stamm und dort „Benutzergruppen zuordnen“. Wählen Sie hier die Gruppen, die BillSAFE verwenden dürfen. Die Zuordnung des Landes erfolgt unter dem Punkt „Länder“. Bitte beachten Sie, dass BillSAFE derzeit nur Kunden aus Deutschland angeboten werden kann. 7 Weisen Sie die Zahlungsart BillSAFE über Shopeinstellungen / Versandarten / Standard / Zahlungsarten Ihren Versandoptionen zu, indem Sie auf den Button „Zahlungsarten zuordnen“ klicken. Sollten Sie weitere Versandarten nutzen, verfahren Sie hierbei genauso. 8 Nach erfolgreicher Installation sollte nun der Punkt „BillSAFE“ auf der linken Seite erscheinen (eventuell müssen Sie die Seite neu laden). Wenn Sie nun auf „Konfiguration“ klicken, können Sie Ihre BillSAFE Zugangsdaten hinterlegen. Des Weiteren können Sie an dieser Stelle zwischen Sandbox und Livesystem wählen („Produktivmodus“). Zudem befindet sich an dieser Stelle die Auswahlmöglichkeit, ob Ihre Kunden während des Bestellprozesses auf das BillSAFE Payment Gateway geleitet werden sollen, oder ob sich diese Maske über den Shop „legt“. Hinweis: Sollte Ihr Shop einen anderen Zeichensatz als UTF-8 verwenden, aktivieren Sie bitte die Tickbox UTF-8 encode. 9 Kapitel IV - Arbeiten mit BillSAFE a) BillSAFE Bestelldetails Über den Menüpunkt Bestellungen verwalten / Bestellungen gelangen Sie zur Bestellübersicht. Wurde bei einer Bestellung „BillSAFE“ als Zahlart gewählt, erscheint hier zusätzlich der Reiter „BillSAFE“ Abbildung 1 OXID Bestellübersicht 10 b) Versandmeldung Wählen Sie „Teillieferung“ und markieren Sie alle Artikel, die Sie versenden möchten. Bestätigen Sie die Auswahl mit dem Button „Versenden“ Wenn Sie nicht alle Artikel einer Bestellung auf einmal versenden, wählen Sie bitte mithilfe der Checkbox die Artikel aus, die versendet werden sollen und klicken auf „Versenden“ c) Stornierung / Retoure Um Artikel einer Bestellung zu stornieren, bzw. zu retournieren, wählen Sie bitte in der Bestellübersicht den Reiter „Artikel“ aus. In dem Feld „Anzahl“ können Sie die Menge der Artikel einpflegen. Tragen Sie bei den zu stornierenden (retournierenden) Artikeln den Wert „0“ ein und klicken bitte auf „Aktualisieren“ d) Erstellung der Rechnung Die Rechnung erstellen Sie in OXID wie gewohnt aus der Bestellübersicht. Hier finden Sie auf der rechten Seite den Button „PDF ausgeben“. Beim betätigen dieses Buttons öffnet sich das Rechnungsformular. Wurde bei der Bestellung BillSAFE als Zahlart gewählt, erscheinen auf der Rechnung automatisch die BillSAFE Details (Hinweistext, Kontoverbindung, Verwendungszweck, etc.). Hinweis! Das Erstellen der Rechnung als PDF ist ein Feature, welches von OXID durch das Standard-Modul invoicepdf bereitgestellt wird. Unser Modul baut auf diesem auf. Demnach ist die Einbindung des invoicepdf Moduls zur Zeit Voraussetzung zur korrekten BillSAFE Rechnungserstellung. 11 Abbildung 2 Beispielrechnung OXID e) Transaktion pausieren / Stundung Über den Reiter „BillSAFE“ in der Bestellübersicht, haben Sie die Möglichkeit die Bestellung bis zu 10 Tagen zu pausieren, bzw. zu stunden. f) Direktüberweisung melden Hat ein Kunde den ausstehenden Betrag der Bestellung fälschlicherweise an den Händler anstatt an BillSAFE gezahlt, kann über den Reiter „BillSAFE“ in der Bestellübersicht, diese Direktzahlung BillSAFE mitgeteilt werden. Eingegangene Direktzahlungen werden mit der Auszahlung verrechnet und müssen nicht extra an BillSAFE überwiesen werden 12 Kapitel V - Testkauf BillSAFE Modul Hinweis! Bitte überprüfen Sie ob der Sandbox-Modus eingeschaltet ist 1. Legen Sie bitte einen beliebigen Artikel in Ihren Warenkorb und gehen zur Kasse 2. Verwenden Sie bitte folgende Käuferdaten: Paul Positiv Märchenstraße 15a 49084 Osnabrück [email protected] 20.12.1987 Tel.: 0123456789 Hinweis! In der Sandbox werden alle Anfragen, die nicht den Testkäuferdaten entsprechen, abgelehnt! 3. 4. 5. 6. Wählen Sie bitte „BillSAFE“ als Zahlart aus und schließen die Bestellung ab. Gehen Sie nun bitte in den Administrationsbereich Ihres Shops und rufen die Bestellung auf Generieren Sie bitte eine Rechnung aus Ihrem Shop und überprüfen Sie ob die BillSAFE Details dort zu sehen sind. Wenn alle Details angezeigt werden, schicken Sie bitte die Rechnung an [email protected] mit dem Betreff „Freischaltung + Ihre VID“. Wir prüfen die Rechnung und, sofern alles ordnungsgemäß angezeigt wird, schalten wir Sie direkt für den Live-Modus frei. 7. Sie können nun die Sandbox ausschalten und Ihren Kunden den Kauf auf Rechnung mit BillSAFE anbieten. Wir wünschen Ihnen einen guten Umsatz! 13