Klarna pixi* App Installations-Anleitung Version 4.23 Stand 13.09.2013 Anbieter: Klarna AB integration.klarna.com integration@klarna.de Technische Realisierung: top concepts GmbH www.topconcepts.com
Inhaltsverzeichnis Einleitung... 3 Über dieses Handbuch... 3 Prozess-Überblick... 3 Nutzungs-Voraussetzungen... 4 Installation der Klarna pixi* App...5 Übertragung der Bestellungen aus dem Web-Shop an pixi*... 5 Installation eines Klarna-Moduls in Ihrem Web-Shop...5 Anpassung des pixi* Shop-Connectors... 5 Mehr-Währungs-Betrieb... 6 Rechnungsgebühren... 7 Übertragung der Telefonnummer vom Shop an pixi*... 7 Übertragung der Anschrift vom Shop an pixi*... 7 Anpassungen des pixi* Shop-Konnektors für einen OXID eshop... 8 Anpassungen des pixi* Shop-Konnektors für einen Shopware Shop... 9 Anpassungen des pixi* Shop-Konnektors für einen Magento Shop...10 Anpassungen des pixi* Shop-Konnektors für andere Shop-Systeme... 11 Konfiguration von pixi* zur Verwendung mit Klarna... 12 Buchung der pixi* App im pixi* appstore... 12 Einrichtung eines App-Access-Keys... 13 Einrichtung des erweiterten pixi* Druck-Moduls...14 Event-IDs in pixi* anlegen...16 Konfiguration der Klarna pixi* App... 18 Einstellungen... 19 Klarna Shops... 21 Nächste Schritte... 22 Abnahme durch Klarna...22 Support für die Klarna pixi* App... 23 Anhang... 24 Checkliste für den pixi* Support... 24 Checkliste für den Händler...24 2
Einleitung Über dieses Handbuch Dieses Handbuch informiert über die Installation und erste Inbetriebnahme der Klarna pixi* App. Für eine Anleitung zum täglichen Betrieb lesen Sie bitte das Dokument: Handbuch: klarna-handbuch-v4_23.pdf Das aktuellste Handbuch und weitere Informationen zur Klarna pixi* App finden Sie stets im pixi* App Store unter: https://www.pixi.eu/apps-marketplace/store/display/zahlungsanbieter-klarna_2146870644.html Bitte kontaktieren Sie VOR der Nutzung der pixi* Klarna App unbedingt die Integrationsabteilung von Klarna. Die Kollegen dort geben Ihnen unkompliziert und schnell alle relevanten Informationen für eine reibungslose Integration der Klarna Zahlungsarten, damit einem zeitnahem Start nichts im Wege steht. Prozess-Überblick In der folgenden Skizze sehen Sie die Wirkungsweise der Klarna pixi* App schematisch dargestellt. Die Klarna pixi* App regelt die Kommunikation zwischen der Versandhandelssoftware pixi* und Klarna. 3
Nutzungs-Voraussetzungen Folgende Voraussetzungen müssen erfüllt sein, damit Sie die Klarna pixi* App nutzen können: Ein gültiger Vertrag zwischen dem Händler und Klarna ist erforderlich. Gültige Zugangsdaten zur Klarna API (Shop-ID und Secret) des Händlers liegen vor. Der Händler muss das Erweiterte pixi* Druck-Modul von pixi* erworben haben Der Händler muss die pixi* API gebucht haben. Der Händler muss die Klarna pixi* App im pixi* App-Store aktiviert haben Das Shop-Modul des Händlers muss auf der erweiterten Integration von Klarna basieren. Das heißt, es darf nicht mit passiven Klarna Rechnungen gearbeitet werden, sondern es müssen im Shop Reservierungen durchgeführt werden mit reserve_amount. Unterstützt das Modul dieses nicht, ist eine Nutzung der pixi* App für Klarna leider nicht möglich Der pixi* Shop-Connector, der den Shop des Händlers mit der pixi* Versandhandelssoftware verbindet muss angepasst werden, so dass einige zusätzliche Informationen an pixi* übertragen werden. Details finden Sie etwas weiter unten. In pixi* muss die Zahlart Klarna angelegt werden. Wenden Sie sich dafür bitte an den pixi* Support. Wir empfehlen Ihnen die Verwendung des internen Zahlarten-Kürzels X. Sollte der Buchstabe X in Ihrem System bereits für eine andere Zahlungsart in Verwendung sein, können Sie selbstverständlich auch einen anderen Buchstaben wählen. Wichtig ist jedoch, dass das in pixi* für die Zahlart Klarna eingestellte Kürzel auch in den Einstellungen in der Web-Oberfläche der Klarna pixi* App unter Kürzel für die Zahlungsart Klarna in pixi* eingetragen wird. Bei der Einrichtung der Zahlart ist darauf zu achten, dass folgende Einstellungen in pixi* gesetzt werden: Bestellstatus = HAL XML-Tag = ;KLARNA; Bestellungen nicht automatisch zusammenfassen = anschalten Adresse von Bankzeile aktualisieren = ausschalten 4
Installation der Klarna pixi* App Übertragung der Bestellungen aus dem Web-Shop an pixi* Installation eines Klarna-Moduls in Ihrem Web-Shop In Ihrem Web-Shop müssen Sie ein Klarna-Modul installieren und konfigurieren, damit Ihr Web-Shop Bestellungen mit Klarna verarbeiten kann. Für die gängigen Shop-Systeme stellt Klarna Standard-Module zur Verfügung. Die Installation und Konfiguration des Webshop-Moduls ist nicht Inhalt dieses Handbuchs. Ein funktionstüchtig eingerichtetes Klarna- Modul in Ihrem Web-Shop ist Voraussetzung für die weiteren Schritte der Installation der Klarna pixi* App. Wenden Sie sich für Fragen bzgl. der Installation eines Web-Shop Moduls bitte an Ihren persönlichen Klarna Integrationsmanager. Bitte führen Sie die Integration des Klarna Web-Shop Moduls zunächst so durch, dass Sie selbst testen können führen Sie keinesfalls direkt eine Liveschaltung durch. Falls Sie schon in der Vergangenheit Klarna Bestellungen in Ihrem Shop abgewickelt haben ohne Verwendung der Klarna pixi* App, wenden Sie sich für eine reibungslose Integration der pixi* App bitte unbedingt an Ihren persönlichen Klarna Integrationsmanager. Anpassung des pixi* Shop-Connectors Bestellungen aus dem Web-Shop werden üblicherweise mit Hilfe des pixi* Shop-Connectors an pixi* übertragen. Für die gängigen Shop-Systeme stellt pixi* hierfür einen Standard-Connector zur Verfügung. Bitte informieren Sie sich bei dem zuständigen Klarna Integrationsmanager, wer den Shop-Connector betreut. Zur Inbetriebnahme der Klarna pixi* App ist es erforderlich, dass einige zusätzliche Daten aus dem Web-Shop an pixi* übertragen werden. Im Nachfolgenden ist beschrieben, welche Daten erforderlich sind und in welche Felder diese Daten in pixi* übermittelt werden müssen. Aus diesem Grunde muss der Shop-Connector angepasst werden. Sollten Sie die Anbindung Ihres Web-Shops an pixi* selbständig realisiert haben, so brauchen Sie lediglich die nachfolgenden Felder ergänzen. Verwenden Sie einen Standard-Connector von pixi*, so hilft Ihnen der pixi* Support gern bei der notwendigen Anpassung zu Verwendung der Klarna pixi* App weiter. Der pixi* Shop-Connector muss angepasst werden, so dass folgende Daten aus dem Shop an pixi* übermittelt werden: Klarna "Pclass" XML-Tag: <TC_KLARNA_PCLASSID> Personennummer Pno des Käufers XML-Tag: <TC_KLARNA_PNO> Klarna Shop-ID XML-Tag: <TC_KLARNA_SHOP_ID> Klarna Reservierungsnummer XML-Tag: <TC_KLARNA_RESERVATION_NO> Klarna Order Status XML-Tag: <TC_KLARNA_ORDER_STATUS> Geschlecht des Käufers XML-Tag: <TC_KLARNA_GENDER> Währung der Bestellung XML-Tag: <TC_KLARNA_CURRENCY> Wechselkurs Fremdwährung zu EURO XML-Tag: <TC_KLARNA_CURRENCY_RATE> Im XML-Dokument, das der pixi* Shop-Connector erzeugt, wird dafür im Bereich <ORDER_HEADER>...</ORDER_HEADER> ein zusätzlicher Bereich <TC_KLARNA>...</TC_KLARNA> eingefügt, der die Felder aufgelisteten Felder enthalten muss. Die Personennummer Pno kann je nach Land ein unterschiedliches Format sein. In Deutschland entspricht sie zum Beispiel dem Geburtsdatum im Format TTMMJJJJ, also z.b. 06031978 während sie Schweden der Sozialversicherungsnummer im Format JJJJMMTT-PPPP, also z.b. 19780306-3416 entspricht. Als Geschlecht übergeben Sie bitte 1 = männlich oder 0 = weiblich. 5
Als Währungs-Kennzeichen übermitteln Sie bitte die Kombination aus drei Buchstaben wie z.b. EUR für EURO oder SEK für schwedische Kronen. Als Wechselkurs geben Sie den Wert an, mit dem man den Fremdwährungsbetrag multiplizieren muss, um den Betrag in EURO umzurechnen. Bitte hinterlegen Sie den Wechselkurs mit 4 Dezimalstellen Genauigkeit. Das Format des Klarna Order Status ist: 1 = OK, 2 = Pending, 3 = Abgelehnt. Hinweis: Gängige Klarna Module für Standard Shop-Systeme erlauben ein Anlegen einer Bestellung mit Status 3 = Abgelehnt gar nicht. Im Shop-Konnektor muss dieser Status daher in der Regel nicht berücksichtigt werden, da abgelehnte Bestellungen schon im Shop verworfen werden, es dadurch also nie zu einer Bestellung kommt, die an pixi* übertragen werden müsste. So sieht ein beispielhaftes XML aus für eine Bestellung in einem deutschen Shop aus: <ORDER_HEADER> <TC_KLARNA> <TC_KLARNA_RESERVATION_NO>794860</TC_KLARNA_RESERVATION_NO> <TC_KLARNA_PNO>07071960</TC_KLARNA_PNO> <TC_KLARNA_GENDER>1</TC_KLARNA_GENDER> <TC_KLARNA_PCLASSID>3113</TC_KLARNA_PCLASSID> <TC_KLARNA_CURRENCY>EUR</TC_KLARNA_CURRENCY> <TC_KLARNA_CURRENCY_RATE>1.0000</TC_KLARNA_CURRENCY_RATE> <TC_KLARNA_SHOP_ID>390</TC_KLARNA_SHOP_ID> <TC_KLARNA_ORDER_STATUS>1</TC_KLARNA_ORDER_STATUS> </TC_KLARNA> </ORDER_HEADER> Mehr-Währungs-Betrieb Betreiben Sie einen Shop mit verschiedenen Währungen, so müssen Sie im pixi* Shop-Konnektor einige zusätzliche Felder im XML ergänzen: Währung der Bestellung XML-Tag: <PRICE_CURRENCY_ORIGINAL> (Hinweis: Ergänzen Sie dieses Feld im XML einfach direkt hinter dem vorhandenen Tag <PRICE_CURRENCY>) Für Rabatte, Gutscheine und Skonto: <REMARK type=\"discount\"></remark> Dieses Feld ist standardmäßig im Konnektor vorhanden, muss aber angepasst werden, so dass hier der EURO-Betrag übertragen wird. Den Bestellwert also mit dem Wechselkurs multiplizieren. <REMARK type=\"discount_original\"></remark> Dieses Feld muss hinzugefügt werden. Es muss den Originalwert der Bestellung in Fremdwährung enthalten. Für Versandkosten und Zahlungsarten-Aufschläge: 6
<REMARK type=\"shipping\"> Dieses Feld ist standardmäßig im Konnektor vorhanden, muss aber angepasst werden, so dass hier der EURO-Betrag übertragen wird. Den vorhandenen Wert also mit dem Wechselkurs multiplizieren. <REMARK type=\"shipping_original\"></remark> Dieses Feld muss hinzugefügt werden. Es muss den Wert von Versandkosten + Zahlungsarten-Aufschlag in der der jeweiligen Fremdwährung enthalten. Außerdem muss in der <ORDER_ITEM_LIST> Sektion für jeden Artikel zusätzlich zum standardmäßig vorhandenen Feld <PRICE_AMOUNT> das neue Feld <PRICE_AMOUNT_ORIGINAL> ergänzt werden. Dabei muss der Wert von <PRICE_AMOUNT> mit dem Wechselkurs multipliziert werden, so dass das Feld stets den EURO-Betrag enthält, während das zusätzliche Feld <PRICE_AMOUNT_ORIGINAL> den entsprechenden Produkt-Preis in der jeweiligen Fremdwährung enthält. Rechnungsgebühren Sollten Sie Klarna Rechnungsgebühren aktivieren, so müssen Sie sicherstellen, dass diese auf die Versandkosten aufgeschlagen werden und gemeinsam in einem Feld an pixi* übertragen werden. Übertragung der Telefonnummer vom Shop an pixi* Bitte achten Sie darauf, dass im pixi* Feld "Telefon" immer die gleiche Telefonnummer steht, die auch bei der Reservierung (reserve_amount) im Shop an Klarna übermittelt wurde. Sprich: Wurde die Mobilnummer übermittelt, muss auch in pixi* die Mobilnummer stehen, wurde die Festnetznummer übermittelt, muss diese in pixi* übernommen werden. Bitte beachten Sie, dass IMMER valide Telefonnummern in pixi* ankommen müssen, denn falsche Telefonnummern können von der Klarna API nicht überprüft werden und verursachen Fehler bei der Klarna Aktivierung. Es wird zudem empfohlen, dass bei der Bestellung per Rechnungskauf im Shop generell nur eine Art von Telefonnummer zugelassen wird, also entweder immer nur die Mobilnummer oder nur die Festnetznummer, niemals beides, um dies von vornherein als mögliche Fehlerquelle bei der Übertragung an pixi* auszuschließen. Übertragung der Anschrift vom Shop an pixi* Bitte beachten Sie, dass die Felder Vorname und Nachname getrennt von einander in die beiden dafür in pixi* vorgesehenen Felder übertragen werden. In einzelnen pixi* Installationen wird beides in ein Feld zusammengeführt, was zu Problemen bei der Klarna Aktivierung führen kann. Sollte der Nachname in pixi* leer sein, so wird bei der Aktivierung automatisch der Vorname am ersten Leerzeichen gesplittet und auf Nachname und Vorname verteilt. Vorname und Nachname müssen bei der Aktivierung der Rechnung jedoch exakt mit der Reservierung im Shop übereinstimmen, so dass bei der zusammengefügten Speicherung in einem Feld später Fehler auftreten können. Das gleiche Problem kann auch bei der Übertragung von Straße und Hausnummer aus dem Shop an pixi* auftreten. Im Shop sollten Sie sicherstellen, dass als Hausnummer lediglich Zahlen und Buchstaben erlaubt sind, keine Leerzeichen oder Sonderzeichen. Wird im Shop beispielsweise ausgefüllt: Straße: Mustergasse Hausnummer: 123A Dann wird dies bei der Übertragung zu pixi* in das Feld Anschrift zusammengefügt zu: Mustergasse 123A Zur Aktivierung muss die Klarna pixi* App die Anschrift wieder in Straße und Hausnummer aufsplitten, was zu Problemen führt, wenn die Hausnummer mehrere Bestandteile enthält. 7
Negativ-Beispiel: Straße: Negativer Musterweg Hausnummer: 12 (im Hinterhof) Wird zusammen geführt in Negativer Musterweg 12 (im Hinterhof) - eine korrekte Aufsplittung ist nicht möglich. Anpassungen des pixi* Shop-Konnektors für einen OXID eshop Für den OXID eshop existieren zur Zeit drei grundlegend unterschiedliche Klarna Modul-Versionen. Bitte prüfen Sie zunächst, ob Sie ein Modul der 1.X, 2.X oder 3.X Serie verwenden. Nachfolgend finden Sie die Datenbank Tabellen- Felder, die bei Verwendung des jeweiligen Modul-Typs an pixi* übertragen werden müssen. pixi* verfügt über entsprechende Standard-Anpassungen, die in Ihrem Shop vom pixi* Support vorgenommen werden können: Modul 1.X Klarna Feldbezeichnung OXID Tabellen-Feld pixi* Konnektor XML-Tag Pclass klarnaorderstatus.klarnapclass <TC_KLARNA_PCLASSID> PNO oxuserpayments.oxvalue* <TC_KLARNA_PNO> Shop-ID klarnasettings.eid <TC_KLARNA_SHOP_ID> Reservierungsnummer oxorder.oxtransid <TC_KLARNA_RESERVATION_NO> Order Status klarnaorderstatus.klarnastatus <TC_KLARNA_ORDER_STATUS> Geschlecht oxorder.oxbillsal** <TC_KLARNA_GENDER> Währung oxorder.oxcurrency <TC_KLARNA_CURRENCY> Wechselkurs oxorder.oxcurrate <TC_KLARNA_CURRENCY_RATE> *) Die Werte in oxuserpayments.oxvalue sind im OXID eshop verschlüsselt. Mit der Methode getdynvalues() werden diese geladen. Die PNO erhalten Sie aus dem DynValue Feld mit dem Namen kibirth (Kauf auf Rechnung) bzw. kppbirth (Ratenkauf). **) Für das Geschlecht MR bzw. Herr müssen Sie an Klarna eine 1 senden, für eine Frau dagegen eine 0. Modul 2.X Klarna Feldbezeichnung OXID Tabellen-Feld pixi* Konnektor XML-Tag Pclass klarnaorderstatus.klarnapclass <TC_KLARNA_PCLASSID> PNO klarnaorderinfo.klarnavalue / klarnakey='personalnumber' <TC_KLARNA_PNO> Shop-ID klarnasettings.merchantid <TC_KLARNA_SHOP_ID> Reservierungsnummer klarnaorderinfo.klarnavalue / klarnakey='transactionid' Order Status klarnaorderinfo.klarnavalue / klarnakey='status' Geschlecht klarnaorderinfo.klarnavalue / klarnakey='gender' <TC_KLARNA_RESERVATION_NO> <TC_KLARNA_ORDER_STATUS> <TC_KLARNA_GENDER> Währung oxorder.oxcurrency <TC_KLARNA_CURRENCY> Wechselkurs oxorder.oxcurrate <TC_KLARNA_CURRENCY_RATE> 8
Modul 3.X Klarna Feldbezeichnung OXID Tabellen-Feld pixi* Konnektor XML-Tag Pclass oxorder.klpclassid <TC_KLARNA_PCLASSID> PNO oxorder.klpno <TC_KLARNA_PNO> Shop-ID oxorder.kleid <TC_KLARNA_SHOP_ID> Reservierungsnummer oxorder.klinvoiceno <TC_KLARNA_RESERVATION_NO> Order Status oxorder.klstatus <TC_KLARNA_ORDER_STATUS> Geschlecht oxorder.oxbillsal* <TC_KLARNA_GENDER> Währung oxorder.oxcurrency <TC_KLARNA_CURRENCY> Wechselkurs oxorder.oxcurrate <TC_KLARNA_CURRENCY_RATE> *) Für das Geschlecht MR bzw. Herr müssen Sie an Klarna eine 1 senden, für eine Frau dagegen eine 0. Anpassungen des pixi* Shop-Konnektors für einen Shopware Shop Nachfolgend finden Sie die Datenbank Tabellen-Felder, die bei Verwendung von Shopware an pixi* übertragen werden müssen. pixi* verfügt über entsprechende Standard-Anpassungen, die in Ihrem Shop vom pixi* Support vorgenommen werden können: Klarna Feldbezeichnung Shopware Tabellen-Feld pixi* Konnektor XML-Tag Pclass Pi_klarna_payment_pclass.pclassid <TC_KLARNA_PCLASSID> PNO Pi_klarna_payment_user_data.birthday <TC_KLARNA_PNO> Shop-ID Pi_klarna_payment_multistore.shop_id <TC_KLARNA_SHOP_ID> Reservierungsnummer Pi_klarna_payment_order_data.transaction id <TC_KLARNA_RESERVATION_NO> Order Status s_core_states.description* <TC_KLARNA_ORDER_STATUS> Geschlecht Pi_klarna_payment_user_data.gender <TC_KLARNA_GENDER> Währung s_order.currency <TC_KLARNA_CURRENCY> Wechselkurs s_order.currencyfactor <TC_KLARNA_CURRENCY_RATE> *) nutzen Sie folgende SQL CASE Anweisung, um den korrekten Status abzufragen: CASE WHEN description LIKE '%geprüft%' THEN 2 WHEN description LIKE '%nicht akzeptiert%' THEN 3 ELSE 1 END gültige Klarna Status Werte sind: klarna_status: 1 = OK, 2 = Pending, 3 = Denied 9
Anpassungen des pixi* Shop-Konnektors für einen Magento Shop Für Magento existieren zur Zeit unterschiedliche Klarna Modul-Versionen. Bitte prüfen Sie zunächst, welche Modul- Version Sie genau verwenden. Nachfolgend finden Sie die Datenbank Tabellen-Felder, die bei Verwendung des jeweiligen Modul-Typs an pixi* übertragen werden müssen. pixi* verfügt über entsprechende Standard-Anpassungen, die in Ihrem Shop vom pixi* Support vorgenommen werden können: Die meisten der benötigten Informationen finden Sie in der Tabelle sales_flat_order_payment im Feld additional_information. Die Daten sind serialisiert und müssen zunächst mit einem unserialize() Befehl konvertiert werden. Modul 4.2.4 Klarna Feldbezeichnung Magento Tabellen-Feld pixi* Konnektor XML-Tag Pclass sales_flat_order_payment / additional_information (paymentplan) PNO sales_flat_order_payment / additional_information (Zusammensetzen aus "birth_day","birth_month" und "birth_year" ) <TC_KLARNA_PCLASSID> <TC_KLARNA_PNO> Shop-ID core_config_data / klarna/de/merchant_id (Beispiel ist für Deutschland) Reservierungsnummer sales_flat_order_payment / additional_information (klarna_transaction_id) Order Status sales_flat_order_payment / additional_information (klarna_status) Geschlecht sales_flat_order_payment / additional_information (gender) <TC_KLARNA_SHOP_ID> <TC_KLARNA_RESERVATION_NO> <TC_KLARNA_ORDER_STATUS> <TC_KLARNA_GENDER> Währung FIX ME: Währung der Bestellung <TC_KLARNA_CURRENCY> Wechselkurs FIX ME: Wechselkurs der Bestellung <TC_KLARNA_CURRENCY_RATE> Frühere Module Klarna Feldbezeichnung Magento Tabellen-Feld pixi* Konnektor XML-Tag Pclass sales_flat_order_payment / additional_information (klarna_pclass) PNO sales_flat_order_payment / additional_information (klarna_personalnumber) <TC_KLARNA_PCLASSID> <TC_KLARNA_PNO> Shop-ID core_config_data / klarna/de/merchant_id (Beispiel ist für Deutschland) Reservierungsnummer sales_flat_order_payment / additional_information (klarna_reservation_id) Order Status sales_flat_order_payment / additional_information (klarna_orderstatus) <TC_KLARNA_SHOP_ID> <TC_KLARNA_RESERVATION_NO> <TC_KLARNA_ORDER_STATUS> Geschlecht FIX ME: Geschlecht des Käufers <TC_KLARNA_GENDER> Währung FIX ME: Währung der Bestellung <TC_KLARNA_CURRENCY> Wechselkurs FIX ME: Wechselkurs der Bestellung <TC_KLARNA_CURRENCY_RATE> 10
Anpassungen des pixi* Shop-Konnektors für andere Shop-Systeme Wenden Sie sich an pixi* falls Sie eine Standard-Integration für ein anderes Shop-System benötigen. Sollte es noch keine Standard-Integration geben, so ist anhand der oben dargestellten Übersicht und Feldzuordnungen sowie nach Vorlage durch die Beispiele für OXID und Shopware auch die Erstellung eines individuellen Konnektors für Ihren Shop problemlos möglich. 11
Konfiguration von pixi* zur Verwendung mit Klarna Buchung der pixi* App im pixi* appstore Die Klarna pixi* App wird im pixi* App Store bereitgestellt und kann mit wenigen Klicks gebucht werden. Gehen Sie bitte, um die Installation vorzunehmen in den pixi* App Store unter https://www.pixi.eu/app-store/ Loggen Sie mit Hilfe Ihrer pixi* Datenbank-Kennung und den pixi* Zugangsdaten in den Appstore ein. Beachten Sie, dass wenn Sie nicht mit dem Haupt-User arbeiten, Ihr User im App-Store für die Verwendung der pixi* App freigeschaltet sein muss. In der Kategorie Zahlungswesen finden Sie die Klarna pixi* App. Wählen Sie diese aus und betätigen Sie die Schaltfläche: Lesen Sie anschließend die Nutzungsbedingungen durch und stimmen Sie diesen zu. Erlauben Sie im nächsten Schritt die notwendigen Daten-Zugriffe durch die Klarna pixi* App. Anschließend können Sie sofort in Ihre neue App einloggen. 12
Einrichtung eines App-Access-Keys Legen Sie bitte das Kennwort für ungeschützten Zugriff auf die Klarna pixi* App fest. Diesen sogenannten App-Access-Key legen Sie im pixi* App-Store fest unter der URL: http://www.pixi.eu/app-store/store/my/31e6de9b190c85f10ce4422f8d4195f3.html 13
Einrichtung des erweiterten pixi* Druck-Moduls Achtung, bei der Einrichtung des Druck-Moduls geschehen die meisten Anwender-Fehler. Bitte arbeiten Sie diesen Abschnitt besonders gewissenhaft durch! Bitte hinterlegen Sie im erweiterten pixi* Druck-Modul eine Druckregel für die Zahlungsart Klarna. Gehen Sie dazu folgendermaßen vor: 1. Im pixi* Rechnungsmodul wählen Sie das Menü "Extras", dort den Punkt "Einstellungen". Der erste geöffnete Zweig sollte "Rechnungen Drucken" sein. Dort können Sie mit dem Button "Druckregeln.." neue Regeln hinterlegen. 2. Fügen Sie eine neue Druckregel hinzu. 3. Die Einstellung für die Druckregel muss den Zahltyp "Klarna" beinhalten, sowie den "Template Type" "Externer PDF-Rechnungen von URL". 4. Im Feld "Url" müssen Sie dann folgende URL vollständig hinterlegen: http://apps.pixi.eu/app/31e6de9b190c85f10ce4422f8d4195f3/index.php/klarnainvoices/?invoicenr=%%invoicenr%%&appaccess= ACCESSKEY Den Text ACCESSKEY ersetzen Sie bitte mit Ihrem persönlichen App-Access-Key, den Sie im App-Store für die Verwendung mit der Klarna pixi* App vergeben haben. 5. Im Feld Template-Name hinterlegen Sie den Dateinamen des Klarna Rechnungs-Templates (z.b. Klarna.rtm ). Dieses Rechnungs-Template finden Sie zum Download im pixi* App-Store unter der URL: http://www.pixi.eu/app-store/display/zahlungsanbieter-klarna_2146870644.html Standardmäßig sollten Sie dieses Template im Ordner c:\pixi\templates ablegen und dann im Druck-Modul für die Zahlungsart Klarna hinterlegen. Bei der Integration musste bis Januar 2013 im bisherigen Rechnungs- Template die HRB-Nummer noch manuell vom pixi* Support eingetragen werden. Seit Februar 2013 kann dafür das Feld si_logo_top verwendet werden, das vom pixi* Support befüllt werden kann, so dass eine Anpassung des Templates entfällt. Der pixi* Support muss dann lediglich noch sicherstellen, dass die Stammdaten des Händlers in den dafür vorgesehenen Feldern hinterlegt sind, damit die Platzhalter im Template korrekt ersetzt werden. Um Ihr eigenes Logo auf dem Template anzeigen zu können, muss im Ordner C:\pixi\templates das Logo(xxx.jpg) nach dem pixi* Datenbank-Kürzel (Shop-ID) benannt werden und die Shop-ID muss in der Shoptabelle (ControlCenter - > Tabellen->Shops) unter SI Name des Logos in pixi* hinterlegt werden. Wenden Sie sich hierfür bitte an den pixi* Support. 14
6. Sollten Sie Klarna für Zahlungen von Kunden aus verschiedenen Ländern nutzen, müssen Sie für jedes Land eine eigene Druck-Regel definieren, und jeweils das zugehörige länderspezifische Klarna Rechnungs-Template hinterlegen. Bei den Parametern der Regel wird dazu im Drop-Down Land jeweils das Zielland gewählt, und bei Template Name das entsprechende Template hinterlegt. Für jedes Land gibt es dann also jeweils eine Klarna Druck-Regel. Im übrigen sind die Punkte 2./3./4. hier für jedes Land zu wiederholen. 7. Bitte überprüfen Sie, ob Ihre korrekten Artikelnummern beim Ausdruck von Klarna Rechnungen erscheinen. Im Standard werden die Templates mit dem pixi* Feld ItemNrSuppl ausgeliefert. Falls Sie das Feld ItemNrInt nutzen möchten, müsste dies optional im Template vom pixi* Support für Sie angepasst werden. Bitte beachten Sie: Die Shop-Bezeichnung top concepts in den Screenshots wird durch Ihren jeweiligen Shop-Namen ersetzt. 15
Event-IDs in pixi* anlegen Bitte stellen Sie sicher, dass in pixi* zwei neue Events angelegt werden, einmal für bezahlte Klarna-Rechnungen und einmal für Klarna-Gutschriften. Das Event für Klarna Invoice muss mit Multiplikator +1 eingerichtet werden, das Event Klarna Gutschrift mit Multiplikator -1. Die korrekte Einstellung kann im pixi* Kundenservice unter Extras Einstellungen Kundenkonto überprüft werden und bei entsprechender Berechtigung auch selbständig angelegt oder geändert werden. 16
In der Ansicht Neues Konto können Sie selbständig den Bezeichner für die Konto ID festlegen. Hier im Beispiel der Wert KLA. Den hier definierte Bezeichner müssen Sie auch in der Web-Oberfläche der Klarna pixi* App als Event-ID für Klarna hinterlegen (siehe unter Konfiguration der Klarna pixi* App Einstellungen ). Im Feld Konto Nr. geben Sie bitte die Konto-Nummer des DATEV-Kontos an, auf das Klarna Rechnungen bzw. Gutschriften gebucht werden sollen. Wiederholen Sie diese Einstellung entsprechend auch für das Klarna Gutschrift Event. Wenn dieser Schritt erledigt wurde, ist innerhalb von pixi* zunächst alles fertig konfiguriert. Fahren Sie als nächstes mit der Konfiguration der Web-Oberfläche der Klarna pixi* App fort. 17
Konfiguration der Klarna pixi* App Loggen Sie sich in die Web-Oberfläche der Klarna pixi* App ein, um diese zu konfigurieren. Die Login URL der Klarna pixi* App lautet: http://apps.pixi.eu/app/31e6de9b190c85f10ce4422f8d4195f3/ Weitere Hinweise zum Login in die Web-Oberfläche der Klarna pixi* App finden Sie im Klarna pixi* App Handbuch! 18
Einstellungen Im nachfolgenden Screenshot sehen Sie, wie die Klarna pixi* App mindestens konfiguriert sein sollte. Dies ist die Standard-Einrichtung. Alle weiteren Optionen sollten nur in Abstimmung mit Ihrem persönlichen Klarna Integrationsmanager aktiviert werden. 19
Bestellungen ab diesem Datum mit der APP verarbeiten: Hier können Sie festlegen, dass nur Bestellungen, die ab einem bestimmten Datum erstellt wurden mit der APP verarbeitet werden. Wenn es eine Änderung bei einer Bestellung gibt, die vor diesem Datum erstellt wurde, wird diese Bestellung trotzdem nicht an die App übertragen. Sollten Sie vor Inbetriebnahme der Klarna pixi* App also schon Bestellungen mit Klarna bzw. mit dem gleichen Rechnungs-Kürzel (z.b. X ) verarbeitet haben, dann muss hier unbedingt das Datum / Uhrzeit der Inbetriebnahme eingetragen werden, damit alle vorherigen Bestellungen ignoriert werden. Wichtig: Geben Sie bitte in das Feld Bestellungen ab diesem Datum verarbeiten unbedingt das Datum und die Uhrzeit der Installation und erstmaligen Inbetriebnahme der Klarna pixi* App ein, damit alte Bestellungen vor diesem Zeitpunkt von der App ignoriert werden. Das Datums-Format ist: 2012-11-03T12:30:00.000 ( JJJJ-MM-TT [T] SS:MM:ss.ttt ) Feld für Artikelnummer: Hier tragen Sie den Namen des pixi* API Feldes ein, in dem die Artikelnummer steht, die an Klarna übermittelt wird. Standard ist hier die Herstellerartikelnummer ItemNrSuppl. Sprechen Sie mit Ihrem Techniker, falls Sie ein anderes Feld ausgeben möchten. Dies sollte die gleiche Artikelnummer sein, die auch auf Ihren Lieferscheinen und Rechnungen angegeben wird, damit ein Kunde im Falle einer Nachfrage zu einer Rechnung auch entsprechende Unterstützung von Klarna erhalten kann. Eine Änderung der Artikelnummer nach Inbetriebnahme der Klarna pixi* App kann einen nicht zu unterschätzenden Zusatzaufwand verursachen. Bitte überlegen Sie daher genau, welches Feld Sie an dieser Stelle konfigurieren. Kürzel für die Zahlungsart Klarna in pixi*: Das Kürzel für die Zahlungsart Klarna in pixi* muss mit der Einstellung in pixi* übereinstimmen, hier im Screenshot wurde der Standard 'X' verwendet. Dies kann in Ihrer pixi* Installation allerdings anders sein. Event ID für bezahlte Rechnungen / Retouren: Hinterlegen Sie hier bitte die während der App-Installation in pixi* konfigurierten Event IDs für die Verbuchung Klarnaspezifischer Zahlungen. Die Event-IDs in den App-Einstellungen (im Screenshot oben KIN und KRT ) müssen mit den Einstellungen in pixi* übereinstimmen, die Sie oben in der Rubrik Event-IDs in pixi* anlegen vergeben haben. 20
Klarna Shops Hier müssen Sie für jeden Shop, den Sie betreiben, die jeweilige Shop-ID eintragen, die Ihnen Klarna dafür jeweils mitgeteilt hat und die passenden Secrets (Passwörter). Shop-ID und Secret werden auch im jeweiligen Shop hinterlegt, damit der Shop und auch die pixi* App mit dem Klarna Backend kommunizieren können. Ohne Shop-ID und Secret lässt sich die App daher nicht benutzen. 21
Nächste Schritte Sobald Sie die vorstehenden Schritte erfolgreich abgeschlossen haben, überprüfen Sie bitte anhand der Checkliste für den Händler im Anhang dieses Handbuchs noch einmal, ob tatsächlich sämtliche Einzelschritte erfolgreich von Ihnen durchgeführt wurden. Lassen Sie sich auch vom pixi* Support bestätigen, dass die Checkliste für den pixi* Support (am Ende dieses Dokuments) ebenfalls in allen Punkten abgearbeitet wurde. Wichtig: Alle Punkte beider Checklisten müssen erfolgreich abgearbeitet worden sein, da eine Verwendung der pixi* App ansonsten zu Fehlern führen wird. Abnahme durch Klarna Wenden Sie sich an Ihren persönlichen Klarna Integrationsmanager, um die Abnahme der Integration vorzunehmen. Dazu werden verschiedene Test-Bestellungen durchgeführt und anschließend in pixi* die Standard-Prozesse wie Versand, Retoure, Storno etc. getestet. Nach der Abnahme durch Klarna kann dann die Live-Schaltung der Zahlungsart Klarna in Ihrem Web-Shop erfolgen. 22
Support für die Klarna pixi* App Bei Bedarf erhalten Sie First Level Support bei der Installation, Konfiguration oder beim täglichen Betrieb Ihrer App direkt von Klarna. Wenden Sie sich dazu bitte direkt an Ihren persönlichen Klarna Integrationsmanager. Sollte eine tiefergreifende Unterstützung (Second Level Support) erforderlich sein, wird Klarna Sie an den Hersteller der pixi* App, die pixi* Partner-Agentur top concepts verweisen. Damit top concepts Sie unterstützen kann, werden folgende Daten benötigt: 1. der Name Ihrer pixi* Datenbank 2. ein gültiger pixi* Benutzer samt Passwort, mit dem das Einloggen in Ihre Klarna pixi* App möglich ist 3. Sie müssen für die Klarna pixi* App den Entwickler-Zugang freischalten. Diese Berechtigung erteilen Sie im pixi* Appstore. 23
Anhang Checkliste für den pixi* Support Die pixi* API muss eingerichtet sein, und folgende API-Aufrufe müssen zur Verfügung stehen: pixigetaddress pixigetinvoice pixigetinvoicelines pixigetiteminfo pixigetorderheader pixigetorderline pixigetorderlinesfororder pixigetupdatedinvoices pixiinvoicesetinfo pixiordersetinfo pixireleaseorder pixiimportfindxml Das Erweiterte pixi* Druck-Modul muss eingerichtet sein Der pixi* Shop-Connector, der den Shop des Händlers mit der pixi* Versandhandelssoftware verbindet, muss angepasst werden. Details finden Sie weiter oben in diesem Dokument in der Rubrik Anpassung des pixi* Shop-Connectors. Klarna-Bestellungen, die in pixi* ankommen, müssen auf Status HOLD gesetzt werden. In pixi* muss die Zahlart Klarna mit dem internen Zahlarten-Kürzel "X" angelegt werden. Dieser Wert muss dem in der Web-Oberfläche der App hinterlegten Eintrag bei Kürzel für die Zahlungsart Klarna in pixi* entsprechen. Bei Retouren mit der Zahlart Klarna dürfen keine automatischen Konto-Überweisungen durchgeführt werden Die Funktion Adresse von Bankzeile aktualisieren muss für die Zahlart Klarna deaktiviert sein. pixi* muss im Klarna Rechnungs-Template (bis Januar 2013) die HRB-Nummer ergänzen. Ab Februar 2013 im neuen Klarna Rechnungs-Template genügt es das Feld si_logo_top in pixi* mit der HRB-Nummer zu füllen. Alle Stammdaten des Händlers (Name, Anschrift, etc.) müssen korrekt in pixi* hinterlegt sein, damit diese Daten auch korrekt auf den Klarna Rechnungen angezeigt werden können Event-IDs Klarna Rechnung und Klarna Gutschrift hinzugefügt und in der App entsprechend hinterlegt. Checkliste für den Händler Sie haben einen Vertrag mit Klarna abgeschlossen und gültige Zugangsdaten (Shop-ID und Secret) von Klarna erhalten In Ihrem Shop haben Sie Klarna gemäß den Klarna-Vorgaben installiert auf Basis der erweiterten Integration unter Verwendung des Api-Calls reserve_amount. Die Klarna pixi* App haben Sie im pixi* Appstore aktiviert Sie haben einen App-Access-Key (siehe gleichnamige Rubrik weiter oben in diesem Dokument) eingerichtet Sie haben den pixi* Shop-Connector angepasst (für Standard-Shops wie OXID beauftragen Sie dies bitte direkt bei pixi*); eigene Shop-Lösungen müssen Sie gemäß der Rubrik Anpassung des pixi* Shop- Connectors weiter oben in diesem Dokument selbständig anbinden Sie haben das Klarna Rechnungs-Template heruntergeladen und auf allen PC's installiert, auf denen Rechnungen ausgedruckt werden sollen Sie haben für das Rechnungs-Template Ihr Firmenlogo auf allen PC's hinterlegt Beim Probe-Ausdruck einer Klarna Rechnungen haben Sie sich vegewissert, dass Ihre korrekten Artikelnummern ausgegeben werden. Ihre korrekte Absender-Adresse inkl. Handelsregister-Angabe erscheint auf dem Ausdruck der Rechnung Sie haben die Druckregeln im pixi* Druck-Modul hinterlegt gemäß Rubrik Einrichtung des erweiterten pixi* Druck-Moduls weiter oben in diesem Dokument. Sie haben sich in die Web-Oberfläche der App eingeloggt und dort sämtliche Einstellungen vorgenommen, insbesondere: der Testmodus und die Debug Ausgaben sind ausgeschaltet bei Kürzel für die Zahlungsart Klarna in pixi* ist der Buchstabe für die Zahlungsart Klarna wie in pixi* definiert hinterlegt, standardmäßig ist das ein X unter Klarna-Shops ist mindestens eine Klarna Shop-ID samt Secret hinterlegt worden Sie haben das aktuelle Datum im Feld Bestellungen ab diesem Datum verarbeiten eingetragen 24
25