Klarna Checkout pixi* App Dokumentation / Handbuch Version 1.0 Stand 19.06.2015 Anbieter: Klarna AB integration.klarna.com integration@klarna.de Technische Realisierung: top concepts GmbH www.topconcepts.com klarna-pixi@support.topconcepts.com
Inhaltsverzeichnis Einleitung...3 Über dieses Handbuch...3 Funktionsweise...3 Unterstützte Bezahlarten...3 Unterstützte Versandprozesse...3 Arbeitsweise der App im Überblick...5 Einschränkungen...5 Die Web-Oberfläche der Klarna Checkout pixi* App...6 Willkommens-Bildschirm...7 Einstellungen...8 Klarna Shops...11 Bestellungen...12 Rechnungen...13 Cronjobs...14 CHANGED_INVOICES...14 CHANGED_ORDERS...15 CLEAR_LOG...15 HOLD_STATUS_WARNING...15 INVOICE_NOTIFICATION...15 OFFLINE_UPDATES...15 PENDING_ORDERS...15 REQUEST_QUEUE...15 REQUEST_QUEUE_INVOICES...15 SETTLEMENT...15 SETTLEMENT_SCAN...15 Offene Calls...16 API-Log...17 Settlement...18 Arbeitsabläufe...19 Standard-Prozess...19 Bestellung in pixi* bearbeiten...19 Artikel nachträglich hinzufügen...19 Artikel nachträglich stornieren...19 Preis eines Artikels nachträglich ändern...19 Anzahl einer Bestellposition nachträglich ändern...20 Retouren...20 Umtausch...20 "no_risk" Bestellungen...21 Ausdrucken von Klarna Rechnungen aus pixi*...21 Was Sie unbedingt vermeiden sollten...22 Updates der App...23 Support für die Klarna Checkout pixi* App...23 Anhang...24 Fehlermeldungen der Klarna Checkout pixi* App...24 TYPE_API_CALL_SUCCESS...24 TYPE_INVOICE_ACTIVATE_ERROR...24 TYPE_INVOICE_ACTIVATE_ERROR_NO_ORDER...24 TYPE_CRONJOB_STATUS...25 Changelog...28 2
Einleitung Über dieses Handbuch Dieses Handbuch informiert über die Funktionsweise der Klarna Checkout pixi* App im Allgemeinen und im täglichen Betrieb. Für eine Installations-Anleitung lesen Sie bitte das Dokument: Installations-Anleitung: klarna-checkout-pixi-app-installation-v1.pdf Bitte lesen Sie zur Inbetriebnahme der Klarna Checkout pixi* App unbedingt zunächst die Installations- Anleitung und führen Sie die genannten Schritte gewissenhaft durch. Beachten Sie dabei außerdem die im Anhang der Installations-Anleitung befindlichen Checklisten, die Punkt für Punkt abgearbeitet werden müssen, damit ein zuverlässiger Betrieb sichergestellt ist. Das aktuellste Handbuch und weitere Informationen zur Klarna Checkout pixi* App finden Sie stets im pixi* App Store unter: https://www.pixi.eu/apps-marketplace/ Funktionsweise Die Klarna Checkout pixi* App verbindet Klarna mit der pixi* Versandhandelssoftware mit Hilfe des von der pixi* Software GmbH bereitgestellten App-Frameworks. Klarna bietet als Finanzdienstleister Händlern die Möglichkeit, Zahlungen auf offene Rechnung oder als Ratenkauf in ihren Web-Shops anzubieten. Klarna führt dabei ein sogenanntes Factoring durch und kauft die Forderung des Händlers ab. Die Shop-Kunden müssen folglich ihre Rechnungen / Raten an Klarna bezahlen. Die pixi* Versandhandelssoftware ist ein Software-Tool für die reibungslose Logistik- und Versandabwicklung, mit der Shop-Betreiber effizient den Versand der bestellten Waren organisieren können. Ziel der App ist es, sämtliche Standard-Geschäftsvorfälle, die im Versandhandel im Zusammenhang mit über Klarna bezahlten Shop-Bestellungen vorkommen können, für den Händler vollautomatisch im Hintergrund abzubilden. Dabei soll sich am Workflow des Händlers im Vergleich zum Handling von Bestellungen, die beispielsweise per Kreditkarte oder Vorkasse getätigt wurden, möglichst nichts ändern und somit kein zusätzlicher manueller Aufwand entstehen. Erreicht wird dieses Ziel durch die Klarna Checkout pixi* App, die permanent sämtliche mit Klarna getätigten Bestellungen in pixi* überwacht und jede Veränderung registriert und vollautomatisch an das Klarna API-Gateway meldet. So wird beispielsweise das spätere Hinzufügen oder Stornieren eines Artikels, der Versand oder Teil-Versand der Ware, oder auch eine Retoure bzw. Teil-Retoure jeweils direkt an Klarna gemeldet, so dass dort das Kunden-Konto entsprechend angepasst werden kann oder auch der Ratenplan neu erzeugt werden kann. Wird in pixi* eine Rechnung für eine mit Klarna bezahlte Bestellung gedruckt, dürfen Sie nicht Ihr normales Rechnungs-Template verwenden. Sie müssen stattdessen ein Lieferschein-Template ohne Preise und Bankverbindungen verwenden. Die eigentliche Rechnung erhält der Kunde direkt von Klarna. Zum Hinterlegen des Lieferschein-Templates für Klarna in pixi* finden Sie weitere Hinweise in der Installations-Anleitung. Unterstützte Bezahlarten Folgende Bezahlarten werden von der Klarna Checkout pixi* App unterstützt: Klarna Kauf auf Rechnung (KPM) Klarna Ratenkauf (KPM) Klarna Checkout (KCO) Unterstützte Versandprozesse Folgende Versandprozesse werden durch die Klarna Checkout pixi* App abgedeckt: Vor dem Versand: Teilstornierung und Vollstornierung 3
Vor dem Versand: Nachträgliches Verändern der Bestellung, z.b. einen Artikel hinzufügen (dies funktioniert jedoch nicht bei mit Kreditkarte oder Sofortüberweisung bezahlten KCO Bestellungen) Komplettversand und Teilversand einer Bestellung Nach dem Versand: Teilretoure und Vollretoure Umtausch 4
Arbeitsweise der App im Überblick Der einfachste Versandprozess ist sicherlich das Versenden eines Pakets. Dieser Prozess läuft mit der Klarna Checkout pixi* App wie folgt ab: 1. In ihrem Online Shop wird eine Bestellung mit einer Zahlungsart Klarna-Zahlungsart, also Ratenkauf, Kauf auf Rechnung oder Klarna Checkout getätigt. 2. Der Shop übermittelt während des Bestell-Prozesses die Kunden-Daten an Klarna, wo Bonität und Limit überprüft werden. 3. Bei Erfolg erhält der Shop als Antwort von Klarna eine sogenannte Reservierungsnummer. Diese wird im Shop abgespeichert und anschließend über den pixi* Konnektor an pixi* in bestimmte Datenbank-Felder übergeben (mehr dazu: siehe Installations-Anleitung) 4. Die an pixi* übertragene Bestellung erhält dort zunächst den Status HOLD, damit nicht sofort der Versand eingeleitet wird. 5. Die Klarna Checkout pixi* App holt sich alle 5 Minuten per Cronjob über die pixi* API sämtliche neuen Bestellungen, die mit einer Klarna-Zahlungsart getätigt wurden und speichert diese in der App Datenbank ab. 6. Die pixi* App baut als nächstes eine Verbindung zur Klarna Api auf, und fragt für KPM Bestellungen mit Hilfe des Aufrufs checkorderstatus die Freigabe ab. Anschließend wird ein update Befehl an Klarna gesendet mit den in pixi* vorliegenden Bestelldaten. 7. Danach wird die Bestellung in pixi* freigegeben, d.h. der Status der Bestellung und auch der Status aller Bestellzeilen in pixi* ändert sich dann auf ANG (= Angenommen). Dies dauert im Höchstfall 10 Minuten nach Eingang der Bestellung in pixi*. 8. Sie picken jetzt ganz normal die Bestellung und schließlich wird in pixi* die Rechnung erzeugt. Ihr pixi* System muss allerdings so konfiguriert sein, dass keine Rechnung sondern nur ein Lieferschein aus dem Drucker kommt. Die eigentliche Rechnung erhält Ihr Kunde direkt von Klarna. 9. Jeden Abend wird Klarna per Cronjob von der pixi* App über alle von Ihnen verschickten Bestellungen informiert. Klarna aktiviert die zugehörigen Rechnungen dann automatisch. Im Prinzip ändert sich also an dem regulären Pickprozess des Händlers nichts gegenüber anderen Zahlungsarten es sind keine zusätzlichen Anpassungen oder Einstellungen in der App notwendig. Die Klarna Checkout pixi* App erkennt alle betroffenen Bestellungen und Veränderungen in pixi* vollautomatisch und regelt im Hintergrund die Kommunikation mit Klarna. Einschränkungen Bitte beachten Sie folgende Einschränkungen bei der Nutzung der Klarna Checkout pixi* App: Klarna unterstützt in Deutschland den Verkauf an Firmen nicht. Das Ergebnis der Bonitätsabfrage ist daher ungewiss und endet womöglich in einer No_Risk -Meldung. Bestellungen erfolgen ausschließlich über den Shop, nicht über das Call-Center. Schulungsthema! Kunden müssen für Bestellungen stets auf den Shop verwiesen werden. Sie dürfen eine Klarna Bestellung nicht manuell über das pixi* Kundenservice Programm anlegen. Einzige Ausnahme stellen Umtausch-Vorgänge dar. 5
Die Web-Oberfläche der Klarna Checkout pixi* App Loggen Sie sich in die Web-Oberfläche der Klarna Checkout pixi* App ein, um diese zu konfigurieren oder um Protokolle einzusehen. Die Login URL der Klarna Checkout pixi* App lautet: http://apps.pixi.eu/app/c302ebeb724e17db2a69317fa6cd1c8f/ Beim Aufruf erscheint die Eingabe-Maske für Datenbank-Kennung, Benutzername und Passwort: In der Regel können Sie hier mit Ihren ganz normalen Zugangsdaten einloggen, die Sie auch verwenden, um Ihr pixi* Programm zu starten. Beachten Sie bitte jedoch die verschärften Richtlinien für Benutzer- und Passwort-Kombinationen im Bereich der pixi* Apps: Benutzername und Passwort dürfen nicht übereinstimmen Benutzername und Passwort dürfen nicht rückwärts übereinstimmen Das Passwort darf keines der folgenden Wörter sein: pixi, passwort, password, pass Das Passwort muss mindestens 6 Zeichen haben D.h., obwohl Ihr Passwort in pixi* und auch für den App Store oder die pixipedia normalerweise funktioniert, wird der App Zugriff nur ermöglicht, wenn das Passwort die oben genannten Kriterien erfüllt. Nachdem Sie Ihr Passwort entsprechend geändert haben, können Sie sich einloggen. Sollte trotz Beachtung dieser Richtlinien kein Login möglich sein, wenden Sie sich bitte an den pixi* Support! 6
Willkommens-Bildschirm Nach dem erfolgreichen Login sehen Sie den Willkommens-Bildschirm der Web-Oberfläche: 7
Einstellungen 8
Testmodus: Der Testmodus lässt alle Anfragen an das Test-Backend von Klarna laufen. Es werden keine echten Buchungen durchgeführt. Dieser Modus ist vor allem nützlich, wenn Sie die APP erst einmal evaluieren möchten. Der Testmodus muss explizit von Klarna freigeschaltet werden. Sie erhalten dafür gesonderte Zugangsdaten von Klarna. Bitte beachten Sie, dass Sie für Test-Bestellungen in Ihrem Shop dann die vorgegebenen Testbenutzer von Klarna verwenden müssen. Debug Ausgaben anschalten: Verwenden Sie diese Option auf keinen Fall im LIVE-Betrieb. Ein Rechnungsdruck ist nicht möglich, wenn der Debug Modus aktiviert ist. Dies dient ausschließlich der Fehler- Analyse und sollte nur in enger Absprache mit top concepts genutzt werden. Offline-Cronjobs Ausführung Stunde: Tragen Sie hier die Stunde des Tages ein, an dem automatische Updates installiert werden sollen. Wir empfehlen, hier den Wert 2 einzutragen, damit täglich um 2 Uhr nachts auf Updates geprüft wird und diese ggf. automatisch installiert werden können. Letzter Sync: Hier findet sich das Datum der letzten Synchronisation der Bestellungen mit der APP. Das Feld ist veränderbar, allerdings empfehlen wir, dies nicht zu tun. Über dieses Feld lässt sich steuern, ab welchem Datum Bestelländerungen von der App abgeholt werden. Über dieses Feld können Sie u.a. nicht verarbeitete Bestellungen später erneut ans System übertragen lassen. Letzter Rechnungs Sync: Hier findet sich das Datum der letzten Synchronisation der Rechnungen mit der App. Das Feld ist veränderbar, allerdings empfehlen wir, dies nicht zu tun. Über dieses Feld lässt sich steuern, ab welchem Datum Rechnungsänderungen von der App abgeholt werden. Über dieses Feld können Sie u.a. nicht verarbeitete Rechnungen später erneut ans System übertragen lassen. 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 Checkout 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. Das Datums-Format ist: 2012-11-03T12:30:00.000 ( JJJJ-MM-TT [T] SS:MM:ss.ttt ) Uhrzeit für die Aktivierung von Rechnungen: Einmal pro Tag werden für die Pakete, die im Laufe des Tages verschickt wurden, die zugehörigen Rechnungen bei Klarna aktiviert. Hier können Sie die Uhrzeit angeben, zu der täglich die Verarbeitung gestartet wird. Dies sollte nach Betriebsschluss erfolgen, also nachdem in der Regel das letzte Paket des Tages ausgeshippt wurde. Benachrichtigung im Erfolgsfall: Dieses Feld schaltet ein, dass sie auch bei erfolgreichen Transaktionen jedes mal per E-Mail benachrichtigt werden, anstatt nur bei Fehlermeldungen. Dies kann ein erhebliches E- Mailaufkommen verursachen. Postversand und E-Mail Versand: Hiermit schalten Sie ein, ob der Kunde Klarna Rechnungen zusätzlich per Post bzw. per E-Mail erhalten soll. Dies geschieht von Klarna Seite. Ggf. entstehen dadurch zusätzliche Kosten für Sie. E-Mail für Benachrichtigungen: Hier tragen Sie bitte die E-Mailadresse ein, die für Benachrichtigungen (Erfolgs- oder Fehlermeldungen) verwendet wird. Dieses Postfach sollten Sie permanent im Auge behalten, um frühzeitig zu erkennen, wenn z.b. ein Paket aufgehalten werden muss. Aktuell können Sie maximal 1 E- Mail-Adresse in diesem Feld hinterlegen. Wichtig: Die Benachrichtigungen sollten bei den Mitarbeitern aufschlagen und dort auch unmittelbar gelesen werden, wo die Pakete gepackt werden. 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 Checkout pixi* App kann einen nicht zu unterschätzenden Zusatzaufwand verursachen. Bitte überlegen Sie daher genau, welches Feld Sie an dieser Stelle konfigurieren. Von Klarna abgelehnte Bestellungen stornieren: Ist dieses Häkchen gesetzt, so werden Bestellungen, die von Klarna abgelehnt werden, automatisch auch in pixi* storniert. Dieser Haken sollte daher in der Regel immer gesetzt werden. Kürzel für die Zahlungsarten Klarna Ratenkauf und Kauf auf Rechnung (KPM) in pixi*: Standardmäßig bekommen die Zahlarten Klarna Ratenkauf und Kauf auf Rechnung (KPM) von pixi* das Kürzel X, wenn Ihnen von pixi* jedoch ein anderes Kürzel mitgeteilt wird können Sie dieses hier hinterlegen. 9
Kürzel für die Zahlungsart Klarna Checkout (KCO) in pixi*: Standardmäßig bekommt die Zahlart Klarna Checkout von pixi* das Kürzel Y, wenn Ihnen von pixi* jedoch ein anderes Kürzel mitgeteilt wird können Sie dieses hier hinterlegen. Lösche API Logs die älter sind als: Um ein Überlaufen der Festplatten zu verhindern, werden alte API Log Einträge spätestens nach 12 Wochen gelöscht. Auf Wunsch können Sie ein kürzeres Interval angeben. Die API Logs sind nützlich, falls im Detail nach einem Fehler geforscht werden muss oder um zu untersuchen, welche Kommandos die App zu welchem Zeitpunkt versendet hat. Settlement-Files: Hinterlegen Sie hier die Zugangsdaten, die Ihnen Klarna auf Anfrage zur Verarbeitung von Settlement Files bereitstellt. Testen Sie anschließend per Klick auf die Taste FTP Verbindung testen, ob ein Zugriff erfolgreich ist. Bevor Sie die automatische Verarbeitung von Settlement Files aktivieren, sollten Sie zunächst manuelle Tests zur Inbetriebnahme durchführen. Grenzen Sie in jedem Fall bitte die Bestellnummern ein, damit bereits abgeschlossene Bestellungen aus der Vergangenheit, die ggf. schon manuell von Ihnen verbucht wurden, nicht nachträglich noch einmal als bezahlt oder offen gesetzt werden. 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 Klarna-spezifischer Zahlungen. Siehe auch Installations-Handbuch. Warnung nach 24h bei nicht aktivierten Rechnungen: Aktivieren Sie diese Checkbox, um automatisch per E-Mail zu alarmieren, falls es versandte Bestellungen gibt, für die länger als 24 Stunden keine Aktivierung an Klarna übermittelt werden konnte. Produkte anonymisieren: Aktivieren Sie diese Checkbox nur im Ausnahmefall, wenn Sie aus Datenschutz- Gründen eine Übertragung der Artikel-Informationen an Klarna unterbinden müssen. Dies kann z.b. für Apotheken eine sinnvolle Einstellung sein, damit keine Informationen über Medikamente, Krankheiten, o.ä. an Klarna übertragen werden. Konsultieren Sie auf jeden Fall Ihren Klarna Integrationsmanager, bevor Sie eigenmächtig diese Einstellung aktivieren. Im nachfolgenden Feld Produkt-Titel für anonymisierte Produkte können Sie festlegen, welcher Textbaustein für die anonymisierten Produkte anstatt der Produktbezeichnung an Klarna übertragen werden soll. Anzahl Bestellungen mit Status HALTEN ab der eine Warn-Email versendet wird: Die App kann selbständig überprüfen, ob Bestellungen erfolgreich zum Versand freigegeben werden. Sollten mehr als die hier angegebene Anzahl Bestellungen der Klarna Zahlungsarten auf HALTEN stehen, so wird eine E-Mail Warnung an die oben hinterlegte E-Mail-Adresse verschickt. 10
Klarna Shops Hier müssen Sie für jeden Shop, den Sie betreiben, die jeweilige Eshop-ID eintragen, die Ihnen Klarna dafür jeweils mitgeteilt hat und die passenden Secrets (Passwörter). Eshop-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 Eshop-ID und Secret lässt sich die App daher nicht benutzen. 11
Bestellungen Hier sehen Sie alle mit einer Klarna Zahlungsart eingegangenen Bestellungen im Überblick. Über den Link "zur Rechnung" gelangen Sie zur jeweils zugehörigen Rechnung. Es besteht ebenso die Möglichkeit, per Klick auf die Spalten-Überschriften in der Kopfzeile nach bestimmten Bestellnummern oder anderen Merkmalen zu suchen. Die Übersicht der Bestellungen dient ausschließlich zu Informationszwecken. 12
Rechnungen Im Rechnungsbereich können Sie sämtliche Rechnungen einsehen. Genauso wie in der Bestellübersicht haben Sie hier Such- und Filtermöglichkeiten. Die Übersicht der Rechnungen dient ausschließlich zu Informationszwecken. 13
Cronjobs Hier können Sie die Ausführungszeiten der einzelnen Cronjobs ansehen. In der Regel werden alle 5 Minuten alle Cronjobs ausgeführt. CHANGED_INVOICES Dieser Cronjob überprüft ob sich Rechnungen in pixi* geändert haben und ob die gedruckten Rechnungen bei Klarna aktiviert wurden. Falls es nicht aktivierte Rechnungen gibt werden Sie hierüber per E-Mail informiert und abhängig von Ihren Einstellungen werden die Rechnungen direkt aktiviert. 14
CHANGED_ORDERS Überprüft, ob sich Bestellungen in pixi* geändert haben und löst entsprechende Aktionen aus, die in die REQUEST_QUEUE eingereiht werden. CLEAR_LOG Dieser Cronjob löscht einmal täglich alte API Logfile Einträge. HOLD_STATUS_WARNING Überprüft ob mehr Bestellungen auf Status HALTEN stehen, als in den Einstellungen konfiguriert. Wird der Schwellwert überschritten, so wird der Händler per E-Mail alarmiert. INVOICE_NOTIFICATION Benachrichtigt den Händler bei Bestellungen, die länger als 24 Stunden versandt aber bei Klarna nicht aktiviert wurden. OFFLINE_UPDATES Führt neue Updates der pixi* App durch. PENDING_ORDERS Überprüft, ob noch nicht freigegebene Bestellungen inzwischen von Klarna zur Ausführung freigegeben wurden und releast diese ggf. in pixi*. REQUEST_QUEUE Sämtliche Kommandos, die an die Klarna API gesendet werden, werden in einer Warteschlange eingereiht, die dann sukzessive per Cronjob abgearbeitet wird. REQUEST_QUEUE_INVOICES Cronjob der einmal pro Tag alle Aktivierungen von Rechnungen an Klarna meldet. SETTLEMENT Verarbeitet erkannte neue Settlement-Files (nur wenn Automatik aktiviert) SETTLEMENT_SCAN Prüft den FTP-Server auf neue Settlement-Files (nur wenn Automatik aktiviert) und liest diese ein. Sollte einmal ein Cronjob dauerhaft laufen, werden Sie per E-Mail benachrichtigt und können ggf. den Cronjob per Klick zurücksetzen. Sollte dies keine Besserung geben, wenden Sie sich bitte an den Klarna Checkout pixi* App Support (siehe Kapitel: Support für die Klarna Checkout pixi* App) 15
Offene Calls Hier können Sie die Warteschlange (Request Queue) der API-Calls bzw. Requests einsehen, die noch ausgeführt werden müssen. Sollte einmal ein Api-Call nicht erfolgreich ausgeführt werden können, so würden Sie neben einer Benachrichtigung per E-Mail hier außerdem einen Überblick erhalten, jeweils nach Bestellung gruppiert. Ist ein Call für eine bestimmte Bestellung fehlgeschlagen, so wird kein weiterer Call mehr für die gleiche Bestellung ausgeführt. Ob ein Call fehlgeschlagen ist, erkennen Sie am Text "Dieser Request ist fehlgeschlagen...", dahinter befindet sich der Fehlercode und die Fehlermeldung die Klarna geliefert hat. Jeder Call kann "übersprungen" werden, allerdings ist zu beachten, dass manche Requests in Abhängigkeit zueinander stehen und häufig aufeinander aufbauen. Daher überspringen Sie Requests nur, wenn Sie sicher sind, dass dadurch keine Probleme auftreten. Den Request checkorderstatus können Sie in jedem Falle überspringen, um eine blockierte Bestellung zu lösen. 16
API-Log Das API-Log zeigt ein Protokoll aller Befehle, die an die Klarna API bzw. die pixi* API gesendet wurden. Das API-Log dient der Recherche und der Fehlersuche, wenn man analysieren möchte, was mit einer Bestellung im Detail passiert ist. Beachten Sie bitte, dass Logfiles nur solange rückwirkend vorhanden sind, wie Sie es auf der Seite Einstellungen konfiguriert haben, also maximal 12 Wochen. Per Klick auf den Funktionsnamen erhalten Sie weitere Details, wie z.b. die Aufruf-Parameter und die detaillierte Antwort der API. Die Processid Spalte zeigt Ihnen an, welche Kommandos im Zuge desselben Cronjobs ausgeführt wurden, um unmittelbare Zusammenhänge von API-Calls besser nachvollziehen zu können. Per Klick auf die Spalten- Überschriften können Sie das API-Log durchsuchen und filtern. 17
Settlement Klarna stellt auf Anfrage auf einem FTP-Server CSV-Dateien bereit, die Zahlungsinformationen enthalten, die dazu dienen, die pixi* Kundenkonten auszugleichen. Konfigurieren Sie dazu in den App-Einstellungen bitte zunächst den FTP-Server wie von Klarna vorgegeben. Anschließend können Sie auf der Seite Settlement mit der Taste Scan FTP manuell überprüfen, ob neue Settlement-Files auf dem Klarna Server bereitliegen. Nach dem Download, den Sie manuell auslösen müssen, können Sie mit dem Link process die Verarbeitung starten. Dabei wird jede Zeile aus der CSV-Datei einer offenen Rechnung bzw. Gutschrift in pixi* zugeordnet. So werden die Kundenkonten in pixi* ausgeglichen. Nachdem Sie sich manuell von der korrekten Funktion überzeugt haben, können Sie in den App-Einstellungen auch die Automatik zur Verarbeitung von Settlement-Files im Hintergrund aktivieren. Sie erhalten dann per E-Mail jeweils ein Protokoll über die verarbeiteten Buchungen. In dem Moment, wo Klarna Ihnen die Rechnungssumme für eine Bestellung gutschreibt, bekommen Sie dafür einen entsprechenden Eintrag in einem Settlement-File. Die bis zu diesem Zeitpunkt in pixi* als noch unbezahlt gekennzeichnete Rechnung wird nun als bezahlt gekennzeichnet. Auf die gleiche Art und Weise werden Gutschriften aufgrund von Retouren nachträglich mittels eines Settlement-Files von Klarna an Sie mitgeteilt, so dass das durch die Erstellung einer Gutschrift entstandene Guthaben im pixi* Kunden- Konto somit ausgeglichen wird. Damit die vollautomatischen Buchungen funktionieren müssen Rechnungsnummern und Beträge in den Settlement- Files mit den entsprechenden Daten in pixi* übereinstimmen. Bei Abweichungen erhalten Sie Fehlermeldungen. Haben Sie die automatische Verarbeitung der Settlement-Files aktiviert, werden Sie per E-Mail über die Verarbeitung informiert. 18
Arbeitsabläufe Standard-Prozess Ziel der Klarna Checkout pixi* App ist es, dass Händler in pixi* ganz normal mit Klarna Bestellungen arbeiten können, wie sie es auch mit Bestellungen gewohnt sind, die mit anderen Zahlungsarten gewöhnt sind. Die Klarna Checkout pixi* App läuft dabei automatisch im Hintergrund und meldet die verschiedenen Aktionen stets an Klarna. Der Standard-Prozess lässt sich wie folgt beschreiben: 1. Eine Klarna-Bestellung wird aus dem Webshop in pixi* importiert 2. Der pixi* Bestell-Status ist zunächst HAL ( = Halten) 3. Wenige Minuten später springt der Bestell-Status in pixi* um auf ANG ( = Angenommen) 4. Die Bestellung geht nun in den regulären Pick-Prozess 5. Bei Picken des letzten Artikels wird der Druck der Rechnung in pixi* ausgelöst. Im Falle von Klarna Bestellungen kommt jedoch ein Lieferschein aus dem Drucker, so dass dieser dem Paket beigefügt werden kann. Die Rechnung wird von Klarna direkt zum Kunden geschickt. 6. Jeden Abend meldet die Klarna Checkout pixi* App die Aktivierungen aller Klarna Rechnungen an Klarna 7. Sobald Klarna Ihnen den Umsatz der Bestellung gutschreibt, wird Ihnen dies in Form eines Settlement-Files mitgeteilt, das die App automatisch einliest, und somit die Klarna Rechnung in pixi* auf bezahlt setzt. Dies bedeutet, dass für den Händler keinerlei Zusatzaufwand bei der Bearbeitung einer ganz normalen Klarna- Bestellung entsteht. Lediglich bei einigen Sonderfällen, die vom hier aufgeführten Standard-Prozess abweichen, sind ein paar Dinge vom Händler zu beachten. Diese führen wir im Folgenden auf. Bestellung in pixi* bearbeiten Eine aus dem Shop in pixi* importiere Bestellung können Sie nachträglich in pixi* bearbeiten. Folgende Aktionen werden dabei im Zusammenhang mit der Verwendung der Klarna Checkout pixi* App unterstützt: Artikel nachträglich hinzufügen Sie können nachträglich Artikel hinzufügen. Typisches Szenario: Ihr Kunde tätigt eine Bestellung im Shop mit der Zahlungsart Klarna und ruft hinterher an, weil er noch etwas vergessen hat. Sie erfassen den neuen Artikel als zusätzliche Bestellposition in der bestehenden Kunden-Bestellung direkt in pixi*. Wichtiger Unterschied bei Klarna: Sie dürfen diese Erweiterung der Bestellung nicht selbst manuell freigeben. Warten Sie bitte stattdessen, bis die Klarna Checkout pixi* App die Veränderung der Bestellung erkannt hat. Dies dauert maximal 5 Minuten. Die App führt dann eine erneute Bonitätsprüfung durch und gibt den Artikel anschließend selbständig in pixi* für den Versand frei. Bei negativer Bonität wird die Bestellung geblockt und der Händler wird per E-Mail informiert. Achtung: Nachträgliche Erhöhungen des Bestellwertes sind nicht möglich bei Bestellungen, die per Klarna Checkout über Kreditkarte oder Sofortüberweisung bezahlt wurden. Artikel nachträglich stornieren Sie können nachträglich Artikel stornieren. Typisches Szenario: Ihr Kunde tätigt eine Bestellung im Shop mit der Zahlungsart Klarna und ruft hinterher an, weil er einen Artikel stornieren möchte. Sie können ganz normal ein Storno in pixi* durchführen. Innerhalb von 5 Minuten wird der nächste Cronjob diese Veränderung der Bestellung erkennen und an Klarna melden. Preis eines Artikels nachträglich ändern Bitte beachten Sie, falls Sie in pixi* nachträglich bei einer Bestellung eine Preisänderung durchführen, dass Sie die Bestellung einmal freigeben und wieder sperren müssen, da es sonst passieren kann, dass die Klarna Checkout pixi* App diese Preisänderung nicht bemerkt und daher nicht an Klarna übermittelt. 19
Anzahl einer Bestellposition nachträglich ändern Sie dürfen die Anzahl einer Bestellposition in pixi* nachträglich ändern. Beachten Sie jedoch, dass dies bei Erhöhung der Anzahl ggf. eine Erhöhung des Bestellwertes zur Folge hat, was bei Zahlungen per KCO Kreditkarte oder Sofortüberweisung nicht erlaubt ist. Retouren Retouren erfassen Sie in pixi* ganz normal, wie Sie es auch mit anderen Zahlungsmitteln durchführen würden. Einzig es ist darauf zu achten, dass im letzten Schritt des Retouren-Wizards die Checkbox Keine Erstattung gewählt wird, da Klarna selbst eine Gutschrift auslöst und eine gesonderte Handhabung in pixi* daher überflüssig ist. Beachten Sie bitte, dass aktuell keine Abwicklung von Wertminderungen bei Rücksendungen möglich ist. Umtausch Wir unterscheiden hier den a) Umtausch NACH dem Versand und den b) Umtausch VOR dem Versand. a) Umtausch NACH dem Versand Dies ist der Prozess, der ausgelöst wird, wenn Sie Ware verschickt haben, und der Kunden wegen Nicht-Gefallens, Nicht-Passens, o.ä. die Ware zurücksendet, und stattdessen einen alternativen Artikel von Ihnen wünscht. Der Umtauschprozess ist ein Prozess, der bei Klarna Bestellungen anders laufen muss, als Sie es sonst in pixi* gewohnt sind. Sie nutzen hier nicht die Umtauschfunktionalität (Umtausch-Wizard) von pixi*, sondern lösen zunächst für die zurück geschickte Ware eine Teilretoure aus und erstellen anschließend eine komplett neue Bestellung für diesen Kunden. Der Umtausch kann nur per Klarna bezahlt werden, wenn auch die ursprüngliche Bestellung mit Klarna getätigt wurde. Ansonsten müssen Sie den Kunden bitten, die geänderte Ware neu im Shop zu bestellen. So gehen Sie vor: 1. Erfassen Sie für den oder die zurückgesandten Artikel eine Teil- oder Voll-Retoure in pixi* 2. Erstellen Sie eine neue Bestellung in pixi* und fügen Sie die gewünschten neuen Artikel hinzu. 3. Der Umtausch funktioniert nur, wenn die letzte Bestellung dieses Kunden, die Klarna-Bestellung ist, für die der Umtausch erfolgen soll. Wurde zwischenzeitlich eine oder mehrere weitere Bestellungen des gleichen Kunden getätigt, ist ein Umtausch über die pixi* App zur Zeit leider nicht möglich. Die App liest sich alle benötigten Daten (wie z.b. Geschlecht, Geburtsdatum) aus der ursprünglichen Klarna- Bestellung aus und verwendet diese, um einen creditpart für die ursprüngliche Bestellung an Klarna zu senden unter Verwendung des ersetzten Artikels. 4. Bitte geben Sie händisch angelegte Bestellungen genauso wie andere Klarna Bestellungen niemals manuell frei. Die Klarna App erkennt die neue Klarna Bestellung automatisch und gibt diese bei erfolgreicher Bestätigung in der Regel innerhalb von 10 Minuten selbständig für den Pick-Prozess frei. b) Umtausch VOR dem Versand Wenn der Kunde nach Absenden seiner Bestellung einen Irrtum bemerkt, und daher einen bestellten Artikel durch einen anderen ersetzen möchte oder Sie stellen fest, dass der gewünschte Artikel wider Erwarten doch nicht vorrätig ist, sie dem Kunden aber eine Alternative liefern möchten, dann nutzen Sie bitte den folgenden Prozess: Fügen Sie zuerst den neuen Artikel hinzu und stornieren Sie anschließend den nicht mehr gewünschten Artikel. Diese Reihenfolge ist wichtig, da wenn Sie zuerst stornieren würden, ggf. die Reservierung bei Klarna komplett gelöscht wird und nicht wieder neu aufgebaut werden könnte. Nach dem Hinzufügen des Artikels geht die Bestellung in pixi* auf HALTEN. Das ist sehr wichtig! Geben Sie die Bestellung unter keinen Umständen manuell wieder frei. Die Klarna Checkout pixi* App braucht nun bis zu 5 Minuten, um die Änderungen an der Bestellung zu erkennen. Anschließend springt die Bestellung in pixi* automatisch auf ANG (= angenommen), und Sie können den Versand durchführen. 20
"no_risk" Bestellungen Bei Bestellungen mit dem Status "no_risk" wird von Klarna das Betrugsrisiko nicht übernommen. Sie erhalten über solche Bestellungen immer eine E-Mail. In pixi* bleiben diese Bestellungen auf Status HAL (= Halten). Versenden Sie diese Bestellungen nur, wenn Sie sich absolut sicher sind, dass der betreffende Kunde kein Betrugsfall sein kann. Dies ist zum Beispiel bei Bestandskunden der Fall, die telefonisch um Adressänderung bitten. Klarna übernimmt in diesen Fällen nicht das Zahlungsrisiko. Zu diesem Thema können Sie auch den Klarna-Support befragen. Ausdrucken von Klarna Rechnungen aus pixi* Mit der hier vorliegenden neuen Klarna Checkout pixi* App ist es so, dass im Gegensatz zu früheren Versionen der Klarna Checkout pixi* App, keine Klarna Rechnung mehr in pixi* gedruckt wird. Stattdessen wird am Ende des Pick- Prozesses lediglich ein Lieferschein gedruckt, der ins Paket gelegt werden kann. Die eigentliche Rechnung verschickt Klarna selbst direkt zum Kunden. 21
Was Sie unbedingt vermeiden sollten 1. Nie eigenmächtig Klarna Bestellungen in pixi* freigeben Der pixi* Status einer Klarna Bestellung darf niemals von Ihnen selbst händisch von HAL (= Halten) auf ANG ( = Angenommen) geändert werden, da sonst gegebenenfalls Bestellungen versendet werden, die von Klarna nicht freigegeben wurden. Sie würden hier ggf. kein Geld erhalten. Klarna Bestellungen kommen generell in pixi* mit dem Status HAL ( = Halten) an. In der Regel ändert die Klarna Checkout pixi* App diesen Status innerhalb weniger Minuten automatisch auf Status ANG ( = Angenommen). Manchmal jedoch erhält eine Klarna Bestellung zunächst den Klarna Status "Pending". In solchen Fällen kann eine Bestellung bis zu 24 Stunden in pixi* auf Status HAL (= Halten) bleiben. Der Status Pending bedeutet bei Klarna nichts anderes, als dass diese Rechnung aufgrund von einer nachgelagerten manuellen Betrugsprüfung nicht nicht von Klarna freigegeben wurde. Folglich dürfen Sie diese Bestellungen auch noch nicht verschicken. Die App schaltet Pending-Bestellungen automatisch von pixi* Status HAL (= Halten) auf ANG (= Angenommen), sobald diese von Klarna freigegeben wurden. 2. Nie Bestellungen bearbeiten, die in pixi* noch auf HAL (= Halten) stehen Klarna Bestellungen dürfen in pixi* erst bearbeitet werden (Artikel hinzufügen, stornieren, etc.), sobald diese von der Klarna Checkout pixi* App eingelesen und in pixi* freigegeben wurden (Status ANG = Angenommen). 3. Nie die Adresse des Kunden ändern Es ist nicht erlaubt Adressen oder Kundendaten im Allgemeinen nachträglich zu ändern. Klarna übernimmt nicht das Zahlungsrisiko, falls Änderungen durchgeführt werden. 4. Nie Bestellungen zusammenfassen Klarna Bestellungen dürfen Sie nicht mit anderen Bestellungen des Kunden zusammenfassen auch nicht wenn dies ebenfalls Klarna Bestellungen sind. 5. Nie die Artikel-Anzahl einer Bestellposition verändern Zum Erhöhen der Anzahl fügen Sie bitte stattdessen eine neue Bestellposition für den zusätzlichen Artikel ein. Zum Verringern der Anzahl stornieren Sie bitte die gesamte Bestellzeile, warten Sie 5 Minuten bis die pixi* App Gelegenheit hatte, diese Veränderung zu bemerken, und fügen Sie anschließend eine neue Bestellzeile mit der gewünschten Anzahl hinzu. 6. Nie nachträglich die Versandkosten verändern Leider wird diese Veränderung nicht an die Klarna Checkout pixi* App übertragen. D.h. wenn Sie den Preis der Bestellung nachträglich reduzieren oder erhöhen möchten, dann dürfen Sie dies ausschließlich durch Hinzufügen einer neuen Bestellposition tun. 7. Nie Teillieferungen auslösen für Bestellungen, die Rabatte oder Gutscheine enthalten Gewähren Sie Ihrem Kunden z.b. durch einen Gutschein 20 % Rabatt auf eine Bestellung und lösen eine Teillieferung aus, dann wird der gesamte Gutschein-Betrag schon mit der ersten Rechnung abgezogen. Es empfiehlt sich daher bei Gebrauch von Gutscheinen, auf Teillieferungen zu verzichten. 8. Nie stornierte Bestellungen von Hand in pixi* reaktivieren Eine Aktivierung dieser Rechnungen bei Klarna ist nach einem Storno nicht mehr möglich. Würden Sie eine derartige Bestellung trotzdem versenden, erhalten Sie keine Deckung seitens Klarna. 9. Legen Sie keine Rechnung manuell in pixi* mit einer Klarna Zahlungsart an. Nur aus dem Shop importierte Bestellungen können durch die vorherige Reservierung des Rechnungsbetrages später aus pixi* heraus mit der Klarna Checkout pixi* App aktiviert werden. 10. Wertminderungen bei Retouren werden aktuell von der Klarna Checkout pixi* App nicht unterstützt. 11. Sie dürfen nicht mehrfach den gleichen Artikel als Bestellzeilen anlegen mit unterschiedlichen Preisen. Das heißt, Sie dürfen nicht ein und dasselbe Produkt einmal für Preis X und ein weiteres mal für Preis Y in der gleichen Bestellung haben. 12. Wenn Sie die Klarna Checkout pixi* App nutzen, verzichten Sie bitte auf die Nutzung von Klarna Online: Bearbeiten Sie nie Bestellungen, die über die Klarna Checkout pixi* App verarbeitet werden sollen, über Klarna Online. Wenn Sie z.b. in Klarna Online eine Reservierung löschen, dann bekommt die Klarna Checkout pixi* App diese Information nicht mit und es wird zu Fehlern bei der Verarbeitung kommen. 22
Updates der App Updates der Klarna Checkout pixi* App werden automatisch für Sie aktiviert. Den aktuellen Versions-Stand sehen Sie unten rechts in der Web-Oberfläche. Im pixi* App-Store unter der Adresse http://www.pixi.eu/apps-marketplace/ können Sie sich stets über neue Updates und deren Inhalt informieren. Setzen Sie die Einstellung Offline-Cronjobs Ausführung Stunde, um festzulegen, wann Updates in Ihrer App installiert werden sollen. Support für die Klarna Checkout pixi* App Bei Bedarf erhalten Sie First Level Support bei der Installation und Konfiguration 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 oder in der täglichen Anwendung der pixi* App Störungen vorkommen, dürfen Sie sich direkt an den Hersteller der pixi* App, die pixi* Partner-Agentur top concepts wenden: Die zentrale E-Mail Adresse bei Störungen lautet: klarna-pixi@support.topconcepts.com Bitte beachten Sie, dass top concepts keine telefonische Unterstützung zu pixi* App Fragestellungen bietet. Damit top concepts Sie optimal 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 Checkout pixi* App möglich ist 3. Sie müssen für die Klarna Checkout pixi* App den Entwickler-Zugang freischalten. Diese Berechtigung erteilen Sie im pixi* Appstore. 4. Nennen Sie bitte ggf. die betroffenen pixi* Bestellnummern, anhand der ein mögliches Fehlverhalten nachvollzogen werden kann sowie Ihre konkrete Fehlerbeschreibung. 23
Anhang Fehlermeldungen der Klarna Checkout pixi* App TYPE_API_CALL_SUCCESS Wird nur ausgeführt, wenn reportsuccessfulqueries == true ist. Wir für jeden API-Call und jede Bestellung ausgeführt, der erfolgreich aus der Request-Queue verarbeitet wurde Betreff: 1234 (DMO) - Aktion erfolgreich: "Name der Funktion" Sehr geehrter Händler, diese E-Mail wird aus Informationszwecken von der Klarna Pixi-App versendet. Es besteht kein Handlungsbedarf. "Name der Funktion" für OrderId 12345 Sollten Sie diese Mail nicht weiter erhalten wollen, dann können Sie dies in der App-Konfiguration abstellen. TYPE_INVOICE_ACTIVATE_ERROR Wird im Fehlerfall beim Activate Call ausgeführt, welcher über den Rechungsdruck von pixi* getriggert wird. Liefert die Klarna API keinen Rückgabe-Wert wird diese Email versendet. Betreff: 1234 (DMO) - Achtung! Paket bitte aufhalten Sehr geehrter Händler, diese E-Mail wird aus Informationszwecken von der Klarna Pixi-App versendet. Folgen Sie bitte den unten stehenden Anweisungen bzw. beachten Sie die unten stehenden Hinweise. Es ist ein Fehler bei der Kommunikation mit Klarna aufgetreten, sodass keine Rechnungsaktivierung stattgefunden hat. Fehlermeldung: "Beispiel-Fehlermeldung von Klarna" (123) pixi* Rechnungsnummer: DMO123456 pixi* Bestell-Nummer: 12345 Klarna Reservierungsnummer: 1234567 Weitere Vorgehensweise: 1. Überprüfen Sie die Fehlermeldung und analysieren Sie ob Sie hier selbst etwas unternehmen können. Im Falle von fehlenden Daten (Telefonnummer, etc.) müssen Sie beispielsweise die Rechnung manuell in Klarna Online erfassen, weil Sie Pixi Rechnungen nicht mehr ändern können 2. Drucken Sie die Rechnung erneut und prüfen Sie damit ob es sich um ein temporäres Problem gehandelt hat. Bei "CURL"-Fehlern ist dies i.d.r. immer temporär und sollte mit einem erneuten Druck - wenige Minuten später - gelöst sein 3. Sollten Sie das Problem nicht selbst lösen können, kontaktieren Sie unseren Merchant Support (shop@klarna.de) TYPE_INVOICE_ACTIVATE_ERROR_NO_ORDER Wird im Fehlerfall beim Activate Call ausgeführt, welcher über den Rechungsdruck von pixi* getriggert wird. Liefert die 24
in der Queue gespeicherte pixi OrderNr kein Ergebnis wird diese Fehlermeldung erzeugt. Betreff: 1234 (DMO) - Fehler beim Ausdrucken der Rechnung Nr. DMO123456 Sehr geehrter Händler, diese E-Mail wird aus Informationszwecken von der Klarna Pixi-App versendet. Sie haben in pixi* eine Klarna Rechnung ausgedruckt, die in der pixi* App bislang nicht bekannt war. Die Rechnung konnte daher nicht aktiviert werden. pixi* Rechnungsnummer: DMO123456 pixi* Bestell-Nummer: 12345 Sie werden diese Nachricht wieder erhalten, wenn Sie erneut versuchen, diese Rechnung in pixi* auszudrucken. Eine Aktivierung ist demnach - aufgrund einer wohl vorhandenen Fehlkonfiguration - nicht möglich. Überprüfen Sie warum die Rechnung nicht in der App gespeichert wurde. Dies kann z.b. passieren, wenn Sie die Bestellung manuell den Halten-Status ändern, der Shop-Konnektor nicht korrekt konfiguriert war oder die Bestellung vor dem offiziellen Livegang der Klarna Integration getätigt wurde. TYPE_CRONJOB_STATUS Wird versendet, wenn die App feststellt, dass einer der Cronjobs nicht beendet wird und länger als 60 Minuten läuft. Betreff: 1234 (DMO) - Status Information - Automatismus "Name des Jobs" Sehr geehrter Händler, diese E-Mail wird aus Informationszwecken von der Klarna Pixi-App versendet. Es besteht zunächst kein Handlungsbedarf. Folgen Sie bitte den unten stehenden Anweisungen bzw. beachten Sie die unten stehenden Hinweise. Der Automatismus (Cronjob) "Name des Jobs" wurde zuletzt ausgeführt am 12.12.2012 um 12:12 Uhr und lief nach 1 Stunde immer noch. Vermutlich funktionierte dieser Automatismus nicht mehr korrekt und deshalb wurde soeben automatisch neu gestartet. Sollten Sie diese Fehlermeldung in 1 Stunde wiederum per E-Mail erhalten, liegt ein Fehler in der App bzw. in der Datenbank vor. Bitte wenden Sie sich im Wiederholungsfalle an den top concepts App-Support unter support@topconcepts.de. ======================================================================= TYPE_INVOICES_ACTIVATION Aktuell nicht verwendet!! Wird mit dem Job ChangedInvoices ausgeführt, wenn die Konfiguration invoice_auto_activate == 1 gesetzt ist. ------------------------------------------------------------------------------------------ Betreff: 1234 (DMO) - Nicht aktivierte Klarna Rechnungen erfolgreich aktiviert Email: Sehr geehrter Händler, diese E-Mail wird aus Informationszwecken von der Klarna Pixi-App versendet. Es besteht kein Handlungsbedarf. Es wurden @count nicht bei Klarna aktivierte Rechnungen gefunden und aktiviert. @list ======================================================================= TYPE_INVOICES_TO_ACTIVATE Wird mit dem Job ChangedInvoices ausgeführt, wenn die Konfiguration invoice_auto_activate!= 1 gesetzt ist. ------------------------------------------------------------------------------------------ Betreff: 1234 (DMO) - Nicht aktivierte Klarna Rechnungen müssen aktiviert werden Email: Sehr geehrter Händler, diese E-Mail wird aus Informationszwecken von der Klarna Pixi-App versendet. Es wurden @count nicht bei Klarna aktivierte Rechnungen gefunden. Bitte Aktivieren Sie die unten stehenden Rechnungen, indem Sie die Belege in pixi* nochmals ausdrucken. 25
@list ======================================================================= =================== TYPE_NO_RISK_REPORT Wird beim Klarna API Call activatereservation ausgeführt, wenn der Rückgabewert 'no_risk' ist. ------------------------------------------------------------------------------------------ Betreff: 1234 (DMO) - Hinweis: Die Daten der Bestellung haben sich geändert Email: Sehr geehrter Händler, diese E-Mail wird aus Informationszwecken von der Klarna Pixi-App versendet. Klarna hat festgestellt, dass bei dieser Bestellung, von der Shopbestellung abweichende Daten für die Rechnungsaktivierung an uns übermittelt wurden. Aus diesem Grunde kann Klarna das Betrugsrisiko nicht mehr übernehmen. Sie können die Ware selbstverständlich wie gewohnt versenden, wenn die an uns übermittelten Daten von Ihrer Seite aus korrekt sind. Gerne können Sie sich für Rückfragen auch an unserem Merchant Support (shop@klarna.de) wenden. pixi* Rechnungsnummer: DMO123456 pixi* Bestell-Nummer: 12345 Klarna Reservierungsnummer: 1234567 ======================================================================= TYPE_TEMP_EXCEPTION_REPORT Standard Fehler-Email, die bei nicht weiter klassifizierten Exceptions versendet wird. Zusätzlich wird diese Email versendet, wenn beim Invoice Activate bzw. Klarna API Call ActivateReservation eine Exception ausgelöst wird. ------------------------------------------------------------------------------------------ Betreff: 1234 (DMO) - Fehler 123 beim Ausführen der Klarna Funktion "Name der Funktion" Email: Sehr geehrter Händler, diese E-Mail wird aus Informationszwecken von der Klarna Pixi-App versendet. Es ist ein temporärer Fehler bei der Kommunikation mit Klarna aufgetreten. Fehlermeldung: "Beispiel-Fehlermeldung von Klarna" pixi* Rechnungsnummer: DMO123456 pixi* Bestell-Nummer: 12345 Klarna Reservierungsnummer: 1234567 Weitere Vorgehensweise: 1. Überprüfen Sie die Fehlermeldung und analysieren Sie ob Sie hier selbst etwas unternehmen können. Im Falle von fehlenden Daten (Telefonnummer,etc.) müssen Sie beispielsweise die Rechnung manuell in Klarna Online erfassen, weil Sie Pixi Rechnungen nicht mehr ändern können 2. Drucken Sie die Rechnung erneut und prüfen Sie damit ob es sich um ein temporäres Problem gehandelt hat. Bei "CURL"-Fehlern ist dies i.d.r. immer temporär und sollte mit einem erneuten Druck - wenige Minuten später - gelöst sein 3. Sollten Sie das Problem nicht selbst lösen können, kontaktieren Sie unseren Merchant Support (shop@klarna.de) ======================================================================= TYPE_ORDER_CANCEL Wird beim Klarna-API Call CheckOrderStatus ausgeführt. Email wird versendet wenn Konfiguration cancel_declined_orders == 1 ist und der Rückgabe-Wert == 3 ist. ------------------------------------------------------------------------------------------ Betreff: 1234 (DMO) - Bestellung 12345 wurde automatisch storniert Email: Sehr geehrter Händler, diese E-Mail wird aus Informationszwecken von der Klarna Pixi-App versendet. Eine Pending-Bestellung wurde von Klarna abgelehnt und in Pixi storniert, weil Klarna einen begründeten Betrugsverdacht festgestellt hat. 26
pixi* Bestell-Nummer: 12345 Klarna Reservierungsnummer: 1234567 Weitere mögliche Vorgehensweise: Kontaktieren Sie den Kunden und informieren Sie ihn, dass er doch nicht mit Klarna bezahlen konnte und bieten Sie ihm eine alternative, sichere Zahlungsmöglichkeit an. ======================================================================= TYPE_INVOICE_ACTIVATION_SKIPPED Wird ausgelöst beim Erzeugen der Rechnung in pixi* Email wird versendet, wenn die Bestellung in der Klarna pixi* App den Verarbeitungsstatus QUEUE_STATE_PENDING_ACTIVATION hat. Dieser Status wird zurückgegeben, wenn der Konfigurationwert invoice_auto_activate gesetzt ist oder für die Bestellung in der Request-Queue als nächste Aktion ActivateReservation eingetragen ist und die dazu eingetragene pixi Rechnungs-Nummer gleich der auslösenden Rechnungsnummer ist. Also in der Regel, wenn die Rechnung 2 Mal gedruckt wird. ------------------------------------------------------------------------------------------ Betreff: 1234 (DMO) - Fehler 3202 beim Ausführen der Klarna Funktion activatereservation Email: Sehr geehrter Händler, diese E-Mail wird aus Informationszwecken von der Klarna Pixi-App versendet. Sie haben soeben in pixi* den Druck einer Rechnung ausgelöst. Bitte beachten Sie, dass eine Aktivierung bei Klarna nicht erfolgt ist, da es bei der Verarbeitung dieser Bestellung bereits vorher einen Fehler gab. In der Web-Oberfläche der pixi* App unter "Offene Calls" gibt es einen oder mehrere Vorgänge für diese Bestellung, die nicht erfolgreich ausgeführt wurden. Solange für eine Bestellung fehlerhafte Calls vorliegen, können für diese Bestellungen keine Rechnungen aktiviert werden. pixi* Rechnungsnummer: DMO123456 pixi* Bestell-Nummer: 12345 Klarna Reservierungsnummer: 1234567 Weitere Vorgehensweise: 1. Überprüfen Sie die Übersicht "Offene Calls" um herauszufinden, welche Fehler die Aktivierung der Rechnung verhindern. 2. Sollten das Problem bestehen bleiben, kontaktieren Sie unseren Merchant Support (shop@klarna.de) ======================================================================= TYPE_UNPROCESSED_SETTLEMENT_FILES Email wird beim Cronjob SettlementScan versendet, wenn es neue Einträge für Settlement-Files in der Datenbank gibt. Die Email enthält eine Liste der Datei-Urls ------------------------------------------------------------------------------------------ Betreff: 1234 (DMO) - Pending settlement files Email: Sehr geehrter Händler, diese E-Mail wird aus Informationszwecken von der Klarna Pixi-App versendet. @files ======================================================================= TYPE_INACTIVE_INVOICES Wird über den Cronjob InvoiceNotification versendet. Enthält eine Liste mit Rechnungen, deren processing_state!= 'OK' ist und das letzte Aktualisierungsdatum in der Datenbank mindestens 24 Stunden zurückliegt. ------------------------------------------------------------------------------------------ Betreff: 1234 (DMO) - List of invoices not activated longer than 24 hours Email: Sehr geehrter Händler, diese E-Mail wird aus Informationszwecken von der Klarna Pixi-App versendet. @invoices ======================================================================= 27
Changelog 1.0 Initial Release 28