BillSAFE Modul

BillSAFE Modul
für OXID 4.6 - 4.7.x
Rechnungskauf
Herzlich willkommen,
Sie haben sich für BillSAFE, den beliebtesten Rechnungskauf-Anbieter bei Deutschlands
Online-Shoppern entschieden. (TNS Emnid Studie 01/2011)
Stand: 4. März 2014
Alle verwendeten Markenzeichen sind urheberrechtlich geschützt.
Die Abbildungen dienen der beispielhaften Darstellung und können von den bei Ihnen angezeigten abweichen.
© 2014 BillSAFE / PayPal. 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 ........................................................................................................................................................................................ 6
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 ............................................................................................................................................................................................... 11
f)
Direktüberweisung melden ............................................................................................................................................................................................................ 11
Kapitel V - Testkauf BillSAFE Modul ......................................................................................................................................................................................................... 12
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 4.7.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. Aktivieren Sie das Modul unter: Admin  Erweiterungen  Module  BillSAFE  Aktivieren
4
4. Wählen Sie im OXID Administrationsbereich Service / Tools. Klicken Sie auf „Durchsuchen“ und wählen aus dem Modulverzeichnis die Datei
„Install.sql“ aus, und klicken auf „Update starten“.
5. Nachdem der Import erfolgreich abgeschlossen wurde, klicken Sie bitte auf „VIEWS jetzt updaten“.
6. Abschließend löschen Sie auf dem FTP Server im Ordner „/tmp“ bitte alle Dateien mit Ausnahme der .htaccess.
Hinweis: Dieses Modul wurde auf Basis des Azure Themes entwickelt. Wenn Sie dieses Theme verwenden, werden die Template Blöcke automatisch
installiert. Wenn Sie ein anderes Theme verwenden, migrieren Sie bitte den Code aus modules/mo_billsafe/out/blocks in Ihr Template.
5
Kapitel III - Konfiguration des BillSAFE Moduls
Der Rechnungskauf von BillSAFE taucht nun als Zahlart unter Shopeinstellungen / Zahlarten auf und kann hier individuell aktiviert und konfiguriert
werden. Bitte beachten Sie, dass es auch ein Rechnungsmodul als Teil des Oxid Core gibt. Um Verwechslungen zu vermeiden, empfehlen wir, diese
Zahlart umzubenennen. Als Bezeichner für BillSAFE empfehlen wir „Rechnung“.
Als Beschreibung können Sie folgenden Textbaustein verwenden:
Kaufen Sie jetzt auf Rechnung und begutachten Sie Ihre Einkäufe in Ruhe bevor Sie bezahlen.
6
Als nächstes muss der Zahlart Benutzergruppen und Land zugeordnet werden.
Hierzu wählen Sie die Zahlart bitte unter Shopeinstellungen / Zahlungsarten aus
und wählen dort dann jeweils „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 und Österreich angeboten
werden kann.
7
Weisen Sie BillSAFE Rechnungskauf ü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 können Sie hier die Art des Checkouts wählen.
BillSAFE bietet aktuell den Checkout via Gateway, Payment Layer und den Onsite Checkout an. BillSAFE empfiehlt den Onsite Checkout, Bei dieser
Variante bleibt der Käufer auf der Shopseite und bestätigt die AGB direkt im Checkout. Dieses Feature muss durch den BillSAFE Support
freigeschalten werden. Dazu reicht eine einfache E-Mail an [email protected]. Sollten Sie Onsite Checkout nicht verwenden wollen, empfehlen wir
das Gateway.
Hinweis: Sollte Ihr Shop einen anderen Zeichensatz als UTF-8 verwenden, aktivieren Sie bitte die Tickbox UTF-8 encode.
Hinweis: Sollten Sie einen Zahlartenaufschlag hinterlegen wollen, beachten Sie bitte, dass dieser vorab mit BillSAFE vereinbart werden muss. Ob ein
solcher Aufschlag hinterlegt wurde, sehen Sie unter BillSAFE  Konfiguration. (Stichwort Charge)
9
Kapitel IV - Arbeiten mit BillSAFE
a) BillSAFE Bestelldetails
BillSAFE Bestellungen verwalten Sie wie gewohnt die Bestellübersicht. Wenn Sie eine Bestellung auswählen, die per BillSAFE bezahlt wurde,
erscheint hier zusätzlich der Reiter „BillSAFE“.
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 zurzeit Voraussetzung zur korrekten BillSAFE Rechnungserstellung.
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. Dabei wird
der komplette Mahnlauf für den entsprechenden Zeitraum angehalten.
f) Direktüberweisung melden
Hat ein Kunde den ausstehenden Betrag der Bestellung fälschlicherweise an Sie den Händler gezahlt anstatt an BillSAFE, 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. Diese Feature gibt es nur für den Rechnungskauf.
11
Kapitel V - Testkauf BillSAFE Modul
Zur Freischaltung Ihres Kontos für den Live Betrieb, benötigen wir einmalig eine Test Rechnung. Folgen Sie diesen einfachen Schritten, um die
erfolgreiche Integration und Aktivierung des Moduls zu testen und eine solche Testrechnung zu generieren..
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!
12