Benutzer-Werkzeuge
public:klarna-de
Unterschiede
Hier werden die Unterschiede zwischen zwei Versionen gezeigt.
| Beide Seiten der vorigen Revision Vorhergehende Überarbeitung Nächste Überarbeitung | Vorhergehende Überarbeitung | ||
|
public:klarna-de [2022/04/11 15:57] josefineleuschner |
public:klarna-de [2024/04/29 07:34] (aktuell) markusmichalski |
||
|---|---|---|---|
| Zeile 3: | Zeile 3: | ||
| OXID eShop Dokumentation / Handbuch | OXID eShop Dokumentation / Handbuch | ||
| - | | Modul-Version | 5.5.1 – Stand 30.06.2021 | | + | | Modul-Version | 5.5.4 – Stand 29.04.2024 | |
| | Modulname | Klarna Checkout und Klarna Payments Modul für den OXID eShop | | | Modulname | Klarna Checkout und Klarna Payments Modul für den OXID eShop | | ||
| | Modulkategorie | Bezahlmethoden / Payments \\ Dieses Modul fügt dem OXID eShop zusätzliche Zahlungsarten hinzu. | | | Modulkategorie | Bezahlmethoden / Payments \\ Dieses Modul fügt dem OXID eShop zusätzliche Zahlungsarten hinzu. | | ||
| | Modulanbieter | Klarna AB [[https://www.klarna.com/de/verkaeufer/plattformen-und-partner/oxid/|www.klarna.com]] Mail: [[oxid@klarna.com|oxid@klarna.com]] | | | Modulanbieter | Klarna AB [[https://www.klarna.com/de/verkaeufer/plattformen-und-partner/oxid/|www.klarna.com]] Mail: [[oxid@klarna.com|oxid@klarna.com]] | | ||
| - | | Entwicklung des Moduls | cgrd GmbH [[https://www.cgrd.de|www.cgrd.de]] Mail: [[support@cgrd.de|support@cgrd.de]] | | + | | Entwicklung des Moduls | Fatchip GmbH [[https://www.fatchip.de|www.fatchip.de]] Mail: [[support@fatchip.de|support@fatchip.de]] | |
| | Klarna Integrations-Support: | Sofern Ihnen kein technischer Ansprechpartner von Klarna zugewiesen wurde, wenden Sie sich bitte an: ...\\ Falls Sie bereits Klarna Transaktionen abwickeln: [[shop@klarna.de|shop@klarna.de]]\\ Oder wenn Sie noch in der Integration sind:[[oxid@klarna.com|oxid@klarna.com]] | | | Klarna Integrations-Support: | Sofern Ihnen kein technischer Ansprechpartner von Klarna zugewiesen wurde, wenden Sie sich bitte an: ...\\ Falls Sie bereits Klarna Transaktionen abwickeln: [[shop@klarna.de|shop@klarna.de]]\\ Oder wenn Sie noch in der Integration sind:[[oxid@klarna.com|oxid@klarna.com]] | | ||
| Zeile 34: | Zeile 34: | ||
| ==== Unterstützte OXID eShop Versionen ==== | ==== Unterstützte OXID eShop Versionen ==== | ||
| - | * Community Edition: ab Version 6.0.0 | + | * Community Edition: Version 6.0.x - 6.5.x |
| - | * Professional Edition: ab Version 6.0.0 | + | * Professional Edition: Version 6.0.x - 6.5.x |
| - | * Enterprise Edition: ab Version 6.0.0 | + | * Enterprise Edition: Version 6.0.x - 6.5.x |
| **Bitte prüfen Sie, ob Ihnen das passende Paket für Ihre OXID eShop Version vorliegt.** \\ | **Bitte prüfen Sie, ob Ihnen das passende Paket für Ihre OXID eShop Version vorliegt.** \\ | ||
| **Installieren Sie diese Modulversion nicht, wenn Sie eine andere Shopversion einsetzen!** | **Installieren Sie diese Modulversion nicht, wenn Sie eine andere Shopversion einsetzen!** | ||
| Zeile 45: | Zeile 45: | ||
| ==== Unterstützte PHP Versionen ==== | ==== Unterstützte PHP Versionen ==== | ||
| - | Das Klarna Checkout und Klarna Payments Modul für den OXID eShop ist lauffähig und getestet mit PHP 7.1 bis PHP 7.4. | + | Das Klarna Checkout und Klarna Payments Modul für den OXID eShop ist lauffähig und getestet mit PHP 7.1 bis PHP 8.1. |
| ==== Update eines bereits installierten Klarna OXID Moduls ==== | ==== Update eines bereits installierten Klarna OXID Moduls ==== | ||
| Zeile 51: | Zeile 51: | ||
| Bitte erstellen Sie zunächst ein Backup Ihrer Shop-Dateien und Datenbank.\\ | Bitte erstellen Sie zunächst ein Backup Ihrer Shop-Dateien und Datenbank.\\ | ||
| - | Wenn Sie z.B. eine OXID eShop Version 6.1.3 vorliegen haben, dann wurde diese mit dem Klarna Modul 4.2.2 ausgeliefert. Um hier nun die aktuelle Version 5.5.1 zu verwenden, führen Sie die folgenden Schritte durch:\\ | + | Wenn Sie z.B. eine OXID eShop Version 6.1.3 vorliegen haben, dann wurde diese mit dem Klarna Modul 4.2.2 ausgeliefert. Um hier nun die aktuelle Version 5.5.3 zu verwenden, führen Sie die folgenden Schritte durch:\\ |
| Bearbeiten Sie folgende Dateien in Ihrem Shop Ordner: \\ | Bearbeiten Sie folgende Dateien in Ihrem Shop Ordner: \\ | ||
| - | <code> vendor/oxid-esales/oxideshop-metapackage-ce/composer.json \\ | + | <code> vendor/oxid-esales/oxideshop-metapackage-ce/composer.json |
| vendor/composer/installed.json</code> | vendor/composer/installed.json</code> | ||
| - | suchen Sie dort alle Zeilen, die Klarna enthalten und ersetzen Sie die Versionsnummer 4.2.2 durch 5.5.1.\\ | + | suchen Sie dort alle Zeilen, die Klarna enthalten und ersetzen Sie die Versionsnummer 4.2.2 durch 5.5.4.\\ |
| Bearbeiten Sie anschließend die composer.json in Ihrem Shop Hauptverzeichnis. | Bearbeiten Sie anschließend die composer.json in Ihrem Shop Hauptverzeichnis. | ||
| In der „require“ Sektion ergänzen Sie:\\ | In der „require“ Sektion ergänzen Sie:\\ | ||
| - | <code>"topconcepts/oxid-klarna-6": "v5.5.1"</code> | + | <code>"fatchip-gmbh/oxid-klarna-6": "v5.5.4"</code> |
| Danach löschen Sie bitte die Datei composer.lock aus Ihrem Shop Hauptverzeichnis.\\ | Danach löschen Sie bitte die Datei composer.lock aus Ihrem Shop Hauptverzeichnis.\\ | ||
| Dann entfernen Sie noch folgende Ordner komplett samt Inhalt:\\ | Dann entfernen Sie noch folgende Ordner komplett samt Inhalt:\\ | ||
| - | <code> source/modules/tc/tcklarna\\ | + | <code> source/modules/tc/tcklarna |
| vendor/topconcepts/oxid-klarna-6</code> | vendor/topconcepts/oxid-klarna-6</code> | ||
| Dann führen Sie die folgenden Befehle aus: \\ | Dann führen Sie die folgenden Befehle aus: \\ | ||
| - | <code> composer clearcache\\ | + | <code> composer clearcache |
| composer update</code> | composer update</code> | ||
| Zeile 98: | Zeile 98: | ||
| ==== Unterstützte Länder / Märkte ==== | ==== Unterstützte Länder / Märkte ==== | ||
| - | Das vorliegende Klarna Checkout und Klarna Payments Modul für den OXID eShop stellt den Klarna Checkout sowie die Klarna Payments für die folgenden Länder zur Verfügung: SE, NO, FI, DE, AT, CH, NL, UK, BE, IT, ES, FR + KCO global (siehe https://developers.klarna.com/documentation/klarna-checkout/kco-global/implementation-guidelines – KCO global steht in den meisten weiteren Ländern dieser Welt zur Verfügung, das bedeutet, dass Kunden aus diesen Ländern zumindest per Kreditkarte im Klarna Checkout Iframe bezahlen können.) | + | Das vorliegende Klarna Checkout und Klarna Payments Modul für den OXID eShop stellt den Klarna Checkout sowie die Klarna Payments für die folgenden Länder zur Verfügung: SE, NO, FI, DE, AT, CH, NL, UK, BE, IT, ES, FR, DK, IRL + KCO global (siehe https://developers.klarna.com/documentation/klarna-checkout/kco-global/implementation-guidelines – KCO global steht in den meisten weiteren Ländern dieser Welt zur Verfügung, das bedeutet, dass Kunden aus diesen Ländern zumindest per Kreditkarte im Klarna Checkout Iframe bezahlen können.) |
| Welche Produkte pro Land unterstützt werden, entnehmen Sie bitte der Klarna Developers Seite: https://developers.klarna.com/en/gb/kco-v3/checkout | Welche Produkte pro Land unterstützt werden, entnehmen Sie bitte der Klarna Developers Seite: https://developers.klarna.com/en/gb/kco-v3/checkout | ||
| Zeile 130: | Zeile 130: | ||
| Die Installation erfolgt bei OXID6 per Composer. | Die Installation erfolgt bei OXID6 per Composer. | ||
| - | Führen Sie im Ordner mit der composer.json Ihres Projekts folgenden Befehl aus: <code>composer require topconcepts/oxid-klarna-6:v5.5.1</code> | + | Führen Sie im Ordner mit der composer.json Ihres Projekts folgenden Befehl aus: <code>composer require fatchip-gmbh/oxid-klarna-6:v5.5.4</code> |
| - | oder ergänzen Sie in der zentralen composer.json Datei Ihres Projekts im Abschnitt „require“ die folgende Zeile:<code>"topconcepts/oxid-klarna-6": "v5.5.1"</code> | + | oder ergänzen Sie in der zentralen composer.json Datei Ihres Projekts im Abschnitt „require“ die folgende Zeile:<code>"fatchiop-gmbh/oxid-klarna-6": "v5.5.4"</code> |
| und führen Sie anschließend diesen Befehl aus: <code>composer update</code> | und führen Sie anschließend diesen Befehl aus: <code>composer update</code> | ||
| Ggf. müssen bestehende Abhängigkeiten mit dem OXID Metapackage bei Installation einer abweichenden Modul-Version manuell angepasst werden.\\ | Ggf. müssen bestehende Abhängigkeiten mit dem OXID Metapackage bei Installation einer abweichenden Modul-Version manuell angepasst werden.\\ | ||
| Zeile 276: | Zeile 276: | ||
| Im Klarna Payments Modus wählen Sie auf dieser Seite lediglich aus, welche Klarna Payments Sie anbieten möchten: | Im Klarna Payments Modus wählen Sie auf dieser Seite lediglich aus, welche Klarna Payments Sie anbieten möchten: | ||
| - | {{:public:faq:klarna-de:konfig-klarna-payments.png?nolink&800|}} | + | {{:public:faq:klarna-de:konfig-klarna-payments_neu.png?nolink&800|}} |
| Weitere Einstellungen sind für die Klarna Payments im Bereich der Design Einstellungen möglich. | Weitere Einstellungen sind für die Klarna Payments im Bereich der Design Einstellungen möglich. | ||
| Zeile 431: | Zeile 431: | ||
| Das Feld „Preisauf-/abschlag“ dürfen Sie bei Klarna Zahlungsarten nicht verwenden. | Das Feld „Preisauf-/abschlag“ dürfen Sie bei Klarna Zahlungsarten nicht verwenden. | ||
| - | **Keine Benutzergruppen zuweisen zum Klarna Checkout**\\ | + | **Keine Benutzergruppen zuweisen zum Klarna Checkout wenn Gastbestellungen erlaubt sind**\\ |
| - | Da der Klarna Checkout auch Gast-Benutzern angezeigt wird, noch bevor eine Registrierung oder ein Login stattfindet ist, darf die Zahlungsart „Klarna Checkout“ hinsichtlich der Benutzergruppen nicht eingeschränkt werden. | + | Da der Klarna Checkout auch Gast-Benutzern angezeigt wird, noch bevor eine Registrierung oder ein Login stattfindet ist, darf die Zahlungsart „Klarna Checkout“ hinsichtlich der Benutzergruppen nicht eingeschränkt werden.\\ |
| + | Auch für die Versandarten und Versandkostenregeln gilt: Es muss jeweils mindestens eine Versandart und eine Versandkostenregel geben, die keine Einschränkungen hinsichtlich der Benutzergruppen haben. | ||
| ==== Mehrsprachigkeit ==== | ==== Mehrsprachigkeit ==== | ||
| Wenn Sie in Ihrem Shop weitere Sprachen außer deutsch und englisch anbieten, dann müssen Sie die mitgelieferten Sprach-Dateien (wie z.B. „de/klarna_lang.php“) auch in die anderen Sprach-Ordner kopieren und entsprechend anpassen. Das Klarna Checkout und Klarna Payments Modul für den OXID eShop wird generell nur mit der Sprachunterstützung für deutsch und englisch ausgeliefert. Durch Hinterlegung entsprechender Übersetzungen in den unverschlüsselt mit ausgelieferten *lang*-Dateien können Sie aber beliebige Sprachen ergänzen. | Wenn Sie in Ihrem Shop weitere Sprachen außer deutsch und englisch anbieten, dann müssen Sie die mitgelieferten Sprach-Dateien (wie z.B. „de/klarna_lang.php“) auch in die anderen Sprach-Ordner kopieren und entsprechend anpassen. Das Klarna Checkout und Klarna Payments Modul für den OXID eShop wird generell nur mit der Sprachunterstützung für deutsch und englisch ausgeliefert. Durch Hinterlegung entsprechender Übersetzungen in den unverschlüsselt mit ausgelieferten *lang*-Dateien können Sie aber beliebige Sprachen ergänzen. | ||
| Zeile 497: | Zeile 497: | ||
| Leider gibt es unabhängig vom Klarna Checkout und Klarna Payments Modul für den OXID eShop einige bekannte Probleme im OXID eShop bei der Bearbeitung von Bestellungen über das OXID Admin Backend: | Leider gibt es unabhängig vom Klarna Checkout und Klarna Payments Modul für den OXID eShop einige bekannte Probleme im OXID eShop bei der Bearbeitung von Bestellungen über das OXID Admin Backend: | ||
| - | Bundle-Artikel („Artikel dazu“) werden z.B. beim Speichern gelöscht\\ | + | Bundle-Artikel („Artikel dazu“) werden z.B. beim Speichern gelöscht https://bugs.oxid-esales.com/view.php?id=5610 |
| - | https://bugs.oxid-esales.com/view.php?id=5610 | + | |
| - | Artikelbasierte Rabatte werden gelöscht, wenn weitere Rabatte hinzugefügt werden\\ | + | Artikelbasierte Rabatte werden gelöscht, wenn weitere Rabatte hinzugefügt werden https://bugs.oxid-esales.com/view.php?id=6807 |
| - | https://bugs.oxid-esales.com/view.php?id=6807 | + | |
| Wir empfehlen daher, auf umfangreiche Anpassungen von Bestellungen mittels OXID Admin Backend zu verzichten, sondern hier lediglich den Standardprozess wie z.B. „Komplette Bestellung capturen“ oder „Bestellung stornieren“ zu nutzen. Ab Modul Version 5.4.0 kann für eine zuvor vollständig mit „Capture“ erledigte Bestellung anschließend auch ein vollständiger „Refund“ über das OXID Admin-Backend an Klarna übermittelt werden. Alle weiteren notwendigen Anpassungen an Bestellungen und auch z.B. die Abwicklung von Teil-Retouren können bequem über das Klarna Portal vorgenommen werden. | Wir empfehlen daher, auf umfangreiche Anpassungen von Bestellungen mittels OXID Admin Backend zu verzichten, sondern hier lediglich den Standardprozess wie z.B. „Komplette Bestellung capturen“ oder „Bestellung stornieren“ zu nutzen. Ab Modul Version 5.4.0 kann für eine zuvor vollständig mit „Capture“ erledigte Bestellung anschließend auch ein vollständiger „Refund“ über das OXID Admin-Backend an Klarna übermittelt werden. Alle weiteren notwendigen Anpassungen an Bestellungen und auch z.B. die Abwicklung von Teil-Retouren können bequem über das Klarna Portal vorgenommen werden. | ||
| Zeile 608: | Zeile 606: | ||
| ===== Updates für dieses Modul ===== | ===== Updates für dieses Modul ===== | ||
| - | Updates des Klarna Checkout und Klarna Payments Moduls für den OXID eShop werden im OXID eXchange Marktplatz veröffentlicht. Den aktuellen Versions-Stand Ihres installierten Moduls sehen Sie, wenn Sie im OXID Admin Bereich in der Rubrik „Klarna“ auf „Start“ klicken. | + | Updates des Klarna Checkout und Klarna Payments Moduls für den OXID eShop werden auf Github veröffentlicht. Den aktuellen Versions-Stand Ihres installierten Moduls sehen Sie, wenn Sie im OXID Admin Bereich in der Rubrik „Klarna“ auf „Start“ klicken. |
| - | Zusätzlich finden Sie den aktuellsten Stand der Entwicklung auch im Github Repository: | + | Github Repository: |
| - | Für OXID eShop 6: https://github.com/topconcepts/OXID-Klarna-6 | + | https://github.com/FATCHIP-GmbH/OXID-Klarna-6/releases |
| ---- | ---- | ||
public/klarna-de.1649685449.txt.gz · Zuletzt geändert: 2022/04/11 15:57 von josefineleuschner
Seiten-Werkzeuge
