Zum der Installations- & Bedienungsanleitung

Bedienungsanleitung
POSTPAY Modul für xtCommerce
DHL PAKET
POSTPAY.de
Stand: 24. August 2012; v1.0
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 ........................................................................... 12
4.3
Stornieren einer Bestellung ......................................................................... 13
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 xtCommerce, welches Ihnen die Nutzung von POSTPAY als Bestell- und
Zahlungsabwicklungsfunktion in Ihrem xtCommerce Shop erlaubt.
Die Kommunikation zwischen xtCommerce und POSTPAY funktioniert auf der
Grundlage der Allyouneed.com 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:
xtCommerce 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
if (($_SESSION['customers_status']['customers_status_id'] == '0') && ($admin_access['orders'] == '1')) echo '<a href="' .
xtc_href_link(FILENAME_ORDERS, '', 'NONSSL') . '" class="menuBoxContentLink"> -' . BOX_ORDERS . '</a> ';
folgendes ein:
// BEGIN DHL CheckOut
if (($_SESSION['customers_status']['customers_status_id'] == '0') && ($admin_access['gm_order_import'] == '1')) echo '<a
href="' . xtc_href_link('gm_order_import.php', '', 'NONSSL') . '" class="menuBoxContentLink1"> -Bestellimport</a> ';
if (($_SESSION['customers_status']['customers_status_id'] == '0') && ($admin_access['gm_dhl_orders'] == '1')) echo '<a
href="' . xtc_href_link('gm_dhl_orders.php', '', 'NONSSL') . '" class="menuBoxContentLink1"> -DHL Bestellungen</a> ';
// END DHL CheckOut
Erstellt von POSTPAY.de
Seite 6 von 15
DHL PAKET
Fügen Sie nach
if (($_SESSION['customers_status']['customers_status_id'] == '0') && ($admin_access['cross_sell_groups'] == '1')) echo '<a
href="' . xtc_href_link(FILENAME_XSELL_GROUPS, '', 'NONSSL') . '" class="menuBoxContentLink"> -' .
BOX_ORDERS_XSELL_GROUP . '</a> ';
folgendes ein:
// BEGIN DHL CheckOut
if (($_SESSION['customers_status']['customers_status_id'] == '0') && ($admin_access['gm_dhl_checkout'] == '1')) echo '<a
href="' . xtc_href_link('gm_dhl_checkout.php', '', 'NONSSL') . '" class="menuBoxContentLink"> -DHL Checkout</a> ';
// END DHL CheckOut
Datei: templates/xtc4/module/shopping_cart.html
Fügen Sie nach
{$FORM_END}
folgendes ein:
{if $DHL_CHECKOUT_BUTTON}

<a href="{$DHL_CHECKOUT_LINK}"><img src="{$DHL_CHECKOUT_BUTTON}" alt="DHL Checkout"></a>

{/if}
{if $CHECKOUT_ERROR}
{$CHECKOUT_ERROR}
1px
solid
red;
padding:
1ex
1em;
color:
#000;
background:
{/if}
{/if}
Erstellt von POSTPAY.de
Seite 7 von 15
DHL PAKET
Datei: shopping_cart.php (root)
Fügen Sie VOR
$smarty->assign('language', $_SESSION['language']);
folgendes ein:
// BEGIN DHL CheckOut
$smarty->assign('DHL_CHECKOUT_BUTTON',
HTTP_SERVER.DIR_WS_CATALOG.'images/icons/100825_CheckoutButton_asset.jpg');
$smarty->assign('DHL_CHECKOUT_LINK', HTTP_SERVER.DIR_WS_CATALOG.'dhl_checkout.php');
if(isset($_SESSION['checkout_error'])) {
$smarty->assign('CHECKOUT_ERROR', $_SESSION['checkout_error']);
unset($_SESSION['checkout_error']);
}
// END DHL CheckOut
3.) Melden Sie sich als Administrator in Ihrem Shop an. 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 „Konfiguration“
„Postpay“.
5.) Konfigurieren Sie den Import von Allyouneed Bestellungen unter „Kunden“
„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“), für Sonderfunktionen (Meldung von Versand, Storno,
Retouren, Tracking-IDs) von POSTPAY/Allyouneed verwenden Sie bitte die
„Postpay“.
Übersicht unter „Kunden“
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 unter dem
Menüpunkt „Konfiguration“ den Navigationspunkt „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
„Versandart“
lassen. Dies bedeutet, dass die von Ihnen unter „Module“
festgelegten 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 „Kunden“
„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.
Unter „Kunden“
„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 11 von 15
DHL PAKET
4.2 Versenden der Bestellung
Nach dem Import der Bestellungen können Sie diese versenden. Gehen Sie hierzu
„Postpay-Bestellungen“ zur Bestellung. Hier legen Sie das
unter „Kunden“
Versanddatum fest und stellen die TrackingID des Paketes ein. Anschließend klicken
Sie auf „Versand melden“. Die Versandmeldung wird automatisch an Allyouneed
weitergeleitet.
Erstellt von POSTPAY.de
Seite 12 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“.
Erstellt von POSTPAY.de
Seite 13 von 15
DHL PAKET
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 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

Download Report