Zum der Installations- & Bedienungsanleitung

Bedienungsanleitung
POSTPAY Modul für osCommerce
DHL PAKET
POSTPAY.de
Stand: 11. Juli 2013; v1.01
Erstellt von POSTPAY.de
Seite 1 von 15
DHL PAKET
Inhaltsverzeichnis
1
Einführung............................................................................................................ 3
1.1
Technischer Überblick ................................................................................... 3
1.2
Benötigter Zugang ......................................................................................... 3
1.3
Pflege Shoplogo & AGB / Widerrufsbelehrung .............................................. 4
1.4
Fachlicher Hintergrund zu POSTPAY............................................................ 5
2
Installation ............................................................................................................ 6
3
Konfiguration der Schnittstelle zu POSTPAY ....................................................... 9
3.1
Zugangsdaten ............................................................................................... 9
3.2
Darstellung POSTPAY im Warenkorb ......................................................... 10
4
5
Bestellbearbeitung .......................................................................................... 11
4.1
Import der Bestellungen .............................................................................. 11
4.2
Versenden der Bestellung ........................................................................... 13
4.3
Stornieren einer Bestellung ......................................................................... 14
4.4
Retoure melden ........................................................................................... 14
Kontakt ............................................................................................................... 15
Erstellt von POSTPAY.de
Seite 2 von 15
DHL PAKET
1
Einführung
1.1 Technischer Überblick
Diese Bedienungsanleitung dient Ihnen als Starthilfe bei dem Einsatz von POSTPAY
Moduls für osCommerce, welches Ihnen die Nutzung von POSTPAY als Bestell- und
Zahlungsabwicklungsfunktion in Ihrem osCommerce Shop erlaubt.
Die Kommunikation zwischen osCommerce und POSTPAY funktioniert auf der
Grundlage der Allyouneed API.
1.2
Benötigter Zugang
Für die Nutzung der Schnittstelle müssen Sie sich gegenüber Allyouneed
authentifizieren. Dazu benötigen Sie
•
•
‘Username’ (Emailadresse)
‘Passwort’
Bei jedem Aufruf der API müssen sowohl Username als auch das Passwort
übergeben werden. Die Zugangsdaten zu Allyouneed erhalten Sie nach der
Registrierung.
Wenn Sie einen Account besitzen, müssen Sie sich lediglich noch in Ihrem
Händleraccount unter http://verkaufen.allyouneed.com einloggen.
Für die erste Einrichtung empfehlen wir Ihnen dringend einen Testaccount zu
benutzen. So können Sie problemlos alle Funktionen des Moduls und der Zahlungsund Bestellabwicklung über POSTPAY ausprobieren.
Erfahren Sie mehr über die Anlage eines Testaccounts im Händlerportal unter
http://portal.allyouneed.com
Erstellt von POSTPAY.de
Seite 3 von 15
DHL PAKET
1.3
Pflege Shoplogo & AGB / Widerrufsbelehrung
Die Personalisierung Ihres POSTPAY Accounts können Sie in Ihrem Händleraccount
vornehmen: Loggen Sie sich mit denselben Daten wie für Ihre Schnittstelle unter
http://verkaufen.allyouneed.com ein, und gehen Sie auf den Punkt Verwaltung
-> POSTPAY
An dieser Stelle können Sie ein Shoplogo und AGB & Widerrufsbelehrungen
einrichten, die der Kunde im Rahmen des Bezahlprozesses in POSTPAY angezeigt
bekommt. Durch das Logo erhält der Kunde während des ganzen Prozesses die
Information, dass er im Bezahlprozess Ihres Shops ist. Durch Angabe der AGB und
Widerrufsbelehrung kann er diese auch während dieses Prozesses einsehen. Daher
empfiehlt es sich dringend, diese Daten zu pflegen.
Erstellt von POSTPAY.de
Seite 4 von 15
DHL PAKET
1.4
Fachlicher Hintergrund zu POSTPAY
POSTPAY ist eine Kaufabwicklungsfunktion für Onlineshops und Marktplätze wie
Allyouneed. Er bietet dem Kunden eine Vielzahl von Zahlungsmitteln und einen
umfassenden Käuferschutz, hinter dem DHL als starker Partner steht. Die
Handhabung für den Kunden ist einfach und übersichtlich.
Eingebunden wird POSTPAY auf derselben Seite, wo sich auch der normale „zur
Kasse“ Button bei Ihnen im Shop befindet. Dadurch muss sich der Kunde nicht bei
Ihnen im Shop einloggen, sondern lediglich in POSTPAY, mit dem Ziel einer höheren
Conversionrate.
Erstellt von POSTPAY.de
Seite 5 von 15
DHL PAKET
2 Installation
Um die Extension manuell installieren zu können, müssen Sie Zugriff auf die
Ordnerstruktur Ihres Onlineshops haben. Wir empfehlen Ihnen die Anpassungen nur
selbst vorzunehmen, wenn Sie Erfahrung mit der Backend-Struktur Ihres Shops
haben. Vor der Installation des Moduls sollten Sie unbedingt eine Sicherheitskopie
anfertigen.
Systemvoraussetzung:
osCommerce 2.3.x
1.) Laden Sie alle Dateien aus dem Verzeichnis "neu" unter Beibehaltung der
Verzeichnisstruktur ins Stammverzeichnis Ihres Shops hoch.
2.) Führen Sie folgende manuelle Anpassungen durch:
Datei: admin/includes/column_left.php
Fügen Sie nach
include(DIR_WS_BOXES . 'tools.php');
folgendes ein:
include(DIR_WS_BOXES . 'dhlcheckout.php');
Erstellt von POSTPAY.de
Seite 6 von 15
DHL PAKET
Datei: shopping_cart.php
Fügen Sie nach
<?php
reset($initialize_checkout_methods);
while (list(, $value) = each($initialize_checkout_methods)) {
?>
<p align="right"><?php echo $value; ?></p>
<?php
}
folgendes ein:
// BEGIN DHL CheckOut
$DHL_CHECKOUT_BUTTON = HTTP_SERVER.DIR_WS_CATALOG.'images/icons/100825_CheckoutButton_asset.jpg';
$DHL_CHECKOUT_LINK = HTTP_SERVER.DIR_WS_CATALOG.'dhl_checkout.php';
if(isset($_SESSION['checkout_error'])) {
$CHECKOUT_ERROR = $_SESSION['checkout_error'];
unset($_SESSION['checkout_error']);
}
?>
<p style="text-align: center;">
<a href="<?php echo $DHL_CHECKOUT_LINK ?>"><img src="<?php echo $DHL_CHECKOUT_BUTTON ?>"
alt="DHL Checkout"></a>
</p>
<?php if(!empty($CHECKOUT_ERROR)): ?>
<p style="margin: 2em auto; border: 1px solid red; padding: 1ex 1em; color: #000; background: #ffffbe;"><?php echo
$CHECKOUT_ERROR ?></p>
<?php endif;
// END DHL CheckOut
Erstellt von POSTPAY.de
Seite 7 von 15
DHL PAKET
3.) Rufen Sie die Installationsroutine auf:
http://www.ihr-shop.de/dhlco_installer.php
(Ersetzen Sie dabei "http://www.ihr-shop.de/" durch die Adresse Ihres Shops.)
4.) Konfigurieren Sie POSTPAY unter „Postpay“
„Postpay-Konfiguration“
5.) Konfigurieren Sie den Import von Allyouneed Bestellungen unter „Postpay“
„Bestellimport“
Bitte beachten Sie, dass für den manuellen Import durch den Button "Import starten"
die zuletzt gespeicherten Einstellungen verwendet werden, nach Änderungen ist also
unbedingt der Button "speichern" anzuklicken.
Für den regelmäßigen Import von Bestellungen richten Sie bitte einen Cronjob mit
der unter „Kunden“
„Bestellimport“ angegebenen URL ein. Für Details zur
Konfiguration von Cronjobs wenden Sie sich bitte an Ihren Webhoster.
Das Modul ist nun installiert. Bestellungen erscheinen in der Liste der Bestellungen
(„Kunden“
„Bestellungen“ bzw. „Customers“
„Orders“), für Sonderfunktionen
(Meldung von Versand, Storno, Retouren, Tracking-IDs) von Postpay/ Allyouneed
verwenden Sie bitte die Übersicht unter „Postpay“
„Postpay-Bestellungen“.
Erstellt von POSTPAY.de
Seite 8 von 15
DHL PAKET
3 Konfiguration der Schnittstelle zu POSTPAY
Nach dem Einloggen im Adminbereich Ihres Onlineshops finden Sie den Menüpunkt
„Postpay“. Hier können Sie die Schnittstelle konfigurieren.
3.1 Zugangsdaten
Unter „Postpay“ hinterlegen Sie die Daten, welche Sie von Allyouneed erhalten
haben. Entweder Sie nutzen die Zugangsdaten zum Livesystem (Normalbetrieb)
oder zum Testsystem (Testbetrieb). Für die erste Inbetriebnahme der Extension
empfehlen wir die Nutzung eines Testaccounts.
Weiterhin legen Sie hier die Methode zur Versandkostenermittlung für Bestellungen
über POSTPAY an. Sie haben entweder die Möglichkeit, einen Pauschalbetrag für
die Versandkosten einzugeben oder die Versandkosten automatisch berechnen zu
„Shipping“ festgelegten
lassen. Dies bedeutet, dass die von Ihnen unter „Modules“
Parameter zur Berechnung der Versandkosten über POSTPAY herangezogen
werden.
Erstellt von POSTPAY.de
Seite 9 von 15
DHL PAKET
3.2
Darstellung POSTPAY im Warenkorb
Hier befindet sich der POSTPAY-Button, über den die Kunden per POSTPAY
bezahlen können.
Erstellt von POSTPAY.de
Seite 10 von 15
DHL PAKET
4 Bestellbearbeitung
Sie können Bestellungen über POSTPAY jederzeit importieren und bearbeiten. Bitte
beachten Sie, dass es zu Verzögerungen bei der Übergabe der Bestellungen
kommen kann. Insbesondere wenn Kunden per Vorkasse bezahlen, können
Bestellungen erst nach dem Zahlungseingang importiert werden.
4.1
Import der Bestellungen
Für den Import der Bestellungen gehen Sie bitte zum Menüpunkt „Postpay“
„Bestellimport“ und wählen Sie den Punkt „Bestellungen importieren“ aus. Nun haben
Sie die Möglichkeit den Zeitraum einzustellen, aus dem die offenen Bestellungen
importiert werden sollen.
Erstellt von POSTPAY.de
Seite 11 von 15
DHL PAKET
Unter „Postpay“
„Postpay-Bestellungen“ finden Sie eine Übersicht über alle
Bestellungen, die per POSTPAY getätigt wurden und Sie können diese hier
bearbeiten.
Erstellt von POSTPAY.de
Seite 12 von 15
DHL PAKET
4.2 Versenden der Bestellung
Nach dem Import der Bestellungen können Sie diese versenden. Gehen Sie hierzu
unter „Postpay“
„Postpay-Bestellungen“ zur Bestellung. Hier legen Sie das
Versanddatum fest und können die TrackingID des Paketes einstellen. Anschließend
klicken Sie auf „Versand melden“. Die Versandmeldung wird automatisch an
Allyouneed weitergeleitet.
Erstellt von POSTPAY.de
Seite 13 von 15
DHL PAKET
4.3
Stornieren einer Bestellung
Zum Stornieren einer Bestellung wählen Sie zunächst einen Grund aus dem DropDown Menü aus. Überprüfen Sie dann die Anzahl der zu stornierenden Positionen.
Bitte fügen Sie noch eine zusätzliche Anmerkung zur Stornierung hinzu, die dem
Endkunden automatisch per Email zugeschickt wird, und klicken anschließend auf
„stornieren“.
4.4
Retoure melden
Wählen Sie zunächst die Anzahl der retournierten Artikel aus. Sie können, falls nötig,
einen Abschlag unter „reduzierter Erstattungsbetrag“ eintragen. Nun wählen Sie aus
dem Drop-Down Menü einen Grund für die Reduzierung aus und fügen dann, je nach
Grund, noch eine eigene Anmerkung zu der Retoure hinzu. Falls Sie dem Kunden
die Rückversandkosten erstatten wollen, können Sie das unter „erstattete
Versandkosten“ eintragen. Bitte beachten Sie, dass dadurch nur die Kosten für den
Rückversand erstattet werden.
Klicken Sie nun auf „Retoure melden“, um die Retoure abzuschließen.
Erstellt von POSTPAY.de
Seite 14 von 15
DHL PAKET
5 Kontakt
Sie haben Fragen, die in diesem Dokument nicht beantwortet wurden oder
Anregungen und Hinweise für uns? Weitere Informationen und Hilfestellungen finden
Sie in unserem Händlerportal unter:
http://portal.allyouneed.com
Weiterhin steht Ihnen unser Händler-Service Montag bis Freitag von 8 bis 18 Uhr zur
Verfügung.
Sie erreichen den Händler-Service via:
E-Mail: [email protected]
Telefon: 0228 286 098 10
Kontaktformular: http://portal.allyouneed.com/service-support/kontaktformular.html
Erstellt von POSTPAY.de
Seite 15 von 15
DHL PAKET