Installationsanleitung

Das Modul stellt die Bezahlmethode Kauf auf Rechnung für den Einkauf in Ihrem Oxid Shop bereit.

Einkäufe mit dieser Bezahlmethode werden von axytos ggf. bis zum Forderungsmanagement übernommen.

Alle relevanten Änderungen an Bestellungen mit dieser Bezahlmethode werden automatisch an axytos übermittelt.

Anpassungen über die Installation hinaus, z.B. von Rechnungs- und E-Mail-Templates, sind nicht notwendig.

Weitere Informationen erhalten Sie unter https://www.axytos.com/.

Voraussetzungen

1. Vertragsbeziehung mit https://www.axytos.com/.
2. Verbindungsdaten, um das Modul mit https://portal.axytos.com/ zu verbinden.

Um dieses Modul nutzen zu können benötigen Sie zunächst eine Vertragsbeziehung mit https://www. axytos.com/https://www.axytos.com/.

Während des Onboarding erhalten Sie die notwendigen Verbindungsdaten, um das Modul mit https://portal.axytos.com/ zu verbinden.

Modul-Installation

Zuerst muss der Code des Moduls heruntergeladen und auf dem Server installiert werden. Befolgen Sie dazu folgende Schritte:

1. Zur Installation Ihrer Oxid Distribution wechseln. Dort im Ordner modules einen neuen Ordner namens axytos anlegen
2. Den Quellcode des Kauf auf Rechnung OXID-5 Moduls herunterladen und im axytos-Ordner in einen Ordner namens kaufaufrechnung entpacken
3. Mit dem Terminal in den modules/axytos/kaufaufrechnung Ordner wechseln und dort das install.php script ausführen:

cd <oxid-installations-ordner>/modules/axytos/kaufaufrechnung
php install.php

Nachdem das Modul erfolgreich installiert wurde, kann es nun aktiviert werden. Dies erfolgt über die Administrations-Oberfläche von Oxid.

1. Zur Administration Ihrer Oxid Distribution wechseln. Nach Installation ist das Modul unter Erweiterungen > Module aufgeführt.
2. Unter Stamm Aktivieren ausführen.

Das Modul ist jetzt installiert und aktiviert und kann konfiguriert werden.

Um das Modul nutzen zu können, benötigen Sie valide Verbindungsdaten zu https://portal.axytos.com/ (siehe Voraussetzungen).

Modul- und Shop-Konfiguration in Oxid

1. Zur Administration Ihrer Oxid Distribution wechseln. Das Modul ist unter Erweiterungen > Module aufgeführt.
2. Zu Einstell. wechseln und API Einstellungen aufklappen, um die Konfiguration zu öffnen.
3. API Host eintragen. Entweder https://api.axytos.com/ oder https://api-sandbox.axytos.com/, die korrekten Werte werden Ihnen von axytos während des Onboarding mitgeteilt (siehe Voraussetzungen)
4. API Key zwei mal eintragen. Der korrekte Wert wird Ihnen während des Onboarding von axytos mitgeteilt (siehe Voraussetzungen).
5. Client Secret zwei mal eintragen. Der korrekte Wert wird Ihnen ebenfalls im Onboarding mitgeteilt (siehe Voraussetzungen).
6. Speichern ausführen.
7. Die Bezahlmethode einer Versandart unter Shopeinstellungen > Versandarten > (Ausgewählte Versandart) > Zahlungsarten > Zahlungsarten zuordnen zuordnen.

Zur Konfiguration müssen Sie valide Verbindungsdaten zu https://portal.axytos.com/ (siehe Voraussetzungen), d.h. API Host, API Key und Client Secret für das Modul speichern.

Cron-Job aktivieren

Das Kauf auf Rechnung Modul benötigt einen regelmäßig ausgeführten Cron-Job, um Änderungen am Bestellstatus synchronisieren zu können. Dieser wird automatisch in Oxid registriert, sobald das Modul aktiviert wurde.

Damit dieser jedoch auch ausgeführt wird, muss der Oxid-Cron-Job selbst aktiviert werden. Dazu müssen folgende Voraussetzungen gegeben sein:

Cron muss in dem Betriebssystem installiert und aktiviert sein. Falls dies nicht der Fall ist, kontaktieren Sie ihren Server-Administrator, um Cron zu installieren und aktivieren.

Es muss ein Cron-Job existieren, welcher <oxid-installations-ordner>/bin/cron.php in regelmäßigen Abständen ausführt. Falls dies nicht der Fall ist, kann mit folgendem Befehl einer angelegt werden, welcher die Synchronisation einmal stündlich anstößt. Dabei muss <oxid-installations-ordner> durch den vollständigen Dateipfad zu dem Ordner Ihrer Oxid-Installation ersetzt werden.

echo '0 */1 * * * php <oxid-installations-ordner>/bin/cron.php' > /tmp/crontab.txt
crontab /tmp/crontab.txt
rm /tmp/crontab.txt

Hinweis: Es ist auch möglich, andere Scheduler-Lösung zu verwenden. Wichtig ist nur, dass bin/ cron.php regelmäßig ausgeführt wird. Für alternative Scheduler stellen wir keine Einrichtungshilfen bereit.

Kauf auf Rechnung kann nicht für Einkäufe ausgewählt werden?

Überprüfen Sie folgende Punkte:

1. Das Modul axytos Kauf auf Rechnung ist installiert.
2. Das Modul axytos Kauf auf Rechnung ist aktiviert.
3. Das Modul axytos Kauf auf Rechnung ist mit korrekten Verbindungsdaten (API Host & API Key) konfiguriert.
4. Sie haben Versandarten, Benutzergruppen und Länder zugeordnet.
   Der Oxid-Cron-Job ist aktiviert und wird regelmäßig ausgeführt.

Fehlerhafte Verbindungsdaten führen dazu, dass das Modul nicht für Einkäufe ausgewählt werden kann. Wird der Cron-Job zu selten ausgeführt (z.B. nur 1x täglich) führt dies dazu, das Änderungen an einer Bestellung nur verzögert übertragen werden.