KT-Solutions - Modul für PrestaShop

Produktpreise einfach und automatisiert mit KT-Solutions XML-Schnittstelle verbinden.

• Einführung
• Edelmetallpreise in Echtzeit
• Funktionsübersicht
• Installation
• 7 Schritte zur einfachen Modulinstallation
• Einrichtung
• KT-Solutions Konto einrichten
• allgemeine Modul-Konfiguration
• Cronjob einrichten
• Übersetzungen & Sprachen
• Übersetzungen
• Modul-Kompatibilität
• Kompatibilität mit PrestaShop
• Lizenz
• Lizenz KT-Solutions Modul
• Fazit / Downloads
• Download und weiterführende Links

Einführung

Edelmetallpreise in Echtzeit

Dieses Modul ermöglicht die automatische Preisaktualisierung für Edelmetall-Artikel wie Goldmünzen, Goldbarren, Silbermünzen und Silberbarren basierend auf XML-Dateien, die der Anbieter KT-Solutions zur Verfügung stellt. Im Folgenden werden die Einstellungen und Funktionen des Moduls detailliert beschrieben. 

Funktionsübersicht

• Produktpreise mit der XML-Schnittstelle von KT-Solutions verbinden
• Max Änderung (%): Kontrollierte Preisänderungen, vermeidet drastische Schwankungen.
• Max Zeit (Sekunden): Nur aktuelle Preise, garantiert keine veralteten Daten.
• Haupt URL: Zentralisierte Preisaktualisierung, zuverlässig und effizient.
• Backup URLs: Höchste Ausfallsicherheit mit zwei Backup-URLs.
• Differenzsteuer: Automatische Steuerberechnung für differenzbesteuerte Artikel.
• Cron Infos: Automatisierte Preisupdates, spart Zeit und Aufwand.
• Log Einstellungen: Volle Transparenz und Kontrolle durch detailliertes Logging und E-Mail-Benachrichtigungen.

Hinweis
Bitte beachten Sie, dass das Modul stetig weiterentwickelt wird und ggf. ältere Versionen nicht alle Funktionen enthalten. 

Installation

7 Schritte zur einfachen Modulinstallation

1. Gehen Sie im PrestaShop Backoffice zur Modulverwaltung (ehemals Modul-Manager) und klicken Sie auf „Modul hochladen“
2. Ziehen Sie nun die Moduldatei (zip-Datei) per Drag & Drop oder wählen Sie
   die Datei im System-Verzeichnisbaum aus
3. Wählen Sie die hochzuladende ZIP-Datei aus und klicken Sie auf "OK"
4. Ihr Modul wird installiert und erscheint in der Liste der installierten Module
5. Warten Sie bis die Modulinstallation erfolgreich abgeschlossen ist
6. Um mit der Einrichtung zu beginnen, klicken Sie auf "Konfigurieren". Wenn Sie mehrere Shops haben, müssen Sie jeden Shop separat konfigurieren. Bitte wählen Sie Ihren Shop direkt aus dem Menü aus, mit dem Sie beginnen möchten.
7. Testen Sie das Modul: Gehen Sie zur Frontend-Ansicht Ihrer Website und überprüfen Sie, ob das Modul wie erwartet funktioniert.

Viel Erfolg!

Einrichtung

KT-Solutions Konto einrichten

Sie benötigen für die Nutzung des Moduls ein gültiges und aktives Konto bei KT-Solutions.

Echtzeit Edelmetallkurse und Währungsspotkurse im Shop

Seit vielen Jahren vertrauen Edelmetallhändler auf die Spot- und Währungskurse von KT-Solutions. Ob zum Aktualisieren von Preisen im Shopsystem, in der Warenwirtschaft, zum Anzeigen von Graphen oder einfach nur um stets aktuelle Kurse in Ihrer Filiale zu zeigen: Die von KT-Solutions gelieferten Daten ermöglichen Ihnen all das. Händler aus mehreren Ländern und von unterschiedlicher Größe und mit verschiedenen Geschäftsmodellen nutzen bereits heute die volle Flexibilität des Angebotes.

Vorteile von KT-Solutions

• Stets aktuell: Minütliche Aktualisierung
• Ausfallsicher: Sehr hohe Ausfallsicherheit durch dreifache Redundanz
• Konfigurierbar: Frei wählbare Metalle und Währungspaare
• Flexibel: Optional zeitgesteuerte Anpassung der Kurse (z.B. zur Erhöhung der Marge nachts), Originaldaten werden zusätzlich mitgeliefert
• Sicherheit: Optionale IP-Beschränkung schützt vor unerwünschtem Zugriff

allgemeine Modul-Konfiguration

Einstellungen

Nach der Installation und Aktivierung des Moduls können Sie die folgenden Einstellungen im Backend konfigurieren:

• Max Änderung (in %):

  • Beschreibung: Ignoriert Preise, wenn die Änderung in der aktuellen Importdatei größer als diese prozentuale Änderung ist. Geben Sie 0 an, um diese Funktion zu deaktivieren.
  • Beispiel: 10 (Nur Änderungen bis zu 10% werden akzeptiert)

• Max Zeit (in Sekunden):

  • Beschreibung: Wenn die bereitgestellte XML Datei älter als diese Zeit in Sekunden ist, wird sie nicht für die Preisänderung verwendet, da die Preise nicht mehr stimmen. Geben Sie 0 an, um diese Funktion zu deaktivieren.
  • Beispiel: 3600 (Nur Dateien, die in der letzten Stunde aktualisiert wurden, werden akzeptiert)

• Haupt URL:

  • Beschreibung: Die Haupt Import URL, in der die XML Inhalte für die Preisaktualisierung stehen.
  • Beispiel: https://example.com/main-price.xml

• 1. Backup URL:

  • Beschreibung: Die erste Backup URL, falls die Haupt URL nicht funktioniert.
  • Beispiel: https://example.com/backup1-price.xml

• 2. Backup URL:

  • Beschreibung: Die zweite Backup URL, falls die erste Backup URL nicht funktioniert.
  • Beispiel: https://example.com/backup2-price.xml

• Differenzsteuer:

  • Beschreibung: Wählen Sie die Steuerregel für differenzbesteuerte Artikel. Hierbei wird der Bruttopreis anstatt der Nettopreis verwendet.
  • Beispiel: Auswahl der entsprechenden Steuerregel im Dropdown-Menü

Cron Infos

Die Einstellungen zum Cronjob werden separat im nächsten Kapitel beschrieben

Log Einstellungen

1) Loglevel

In diesem Dropdown wird das Log-Level festgelegt. Das sind interne Loglevel, die in der Programierung verschiedene Log-Mengen in das Log schreiben. NONE schaltet das Log ganz aus, DEBUg erzeugt die meisten und Emergency die wenigsten Log-Einträge.

2) Logdateien

Die Logdateien sind mit einem Zeitstempel versehen.

• admin-Logdateien wurden durch das Back Office erzeugt
• cron durch den Cronjob
• install und uninstall Logs erscheinen bei den Installations- und Deinstallationsvorgängen

3) Logdateien löschen

Über diesen Button lassen sich alle Logdateien aus dem Modulverzeichnis löschen

Logs per E-Mail senden

In dem Modul gibt es noch die Möglichkeit, sich die Fehler Logs per Mail zusenden zu lassen

Cronjob einrichten

Cron Infos

Der Cron Aufruf kann entweder per Wget oder über den Browser aufgerufen werden. Bitte prüfen Sie bei Ihrem Provider, wie Crons eingerichtet werden.

1) Cron Aufruf per Wget

Hier wird die hier angegebene URL per Wget auf dem Server ausgeführt. Dieser Aufruf wird zum Beispiel über die CLI (Command Line Interface / Shell) direkt auf dem Server ausgeführt. Klicken Sie doppelt auf die hinterlegte URL und kopieren Sie diese dann komplett in die Zwischenablage.

2) Cron Aufruf per Button / Browser

Wen Sie diesen Button anklicken wird der Cron-Aufruf umittelbar in einem neuen Browsertab ausgeführt. Sie können per Rechtsklick auf den Button auf die Cron-URL kopieren, um den Link z.B. in Plesk bei den geplanten Aufgaben zu hinterlegen.

Im Plesk stellen Sie den Cronjob dann auf "Fetch a URL" und geben im Feld "URL" den kopierten Link ein.

Übersetzungen & Sprachen

Übersetzungen

Die Übersetzungen können direkt in der Modulkonfigurationsansicht vorgenommen werden. Klicken Sie dazu einfach auf Übersetzen und wählen Sie anschließend die gewünschte Sprache aus. Zur Auswahl stehen alle von Ihnen installierten Sprachen. Deutsch und Englisch werden mit dem Modul mitgeliefert.

Modul-Kompatibilität

Das Modul "EU-Fernverkaufsregelung" ist kompatibel mit PrestaShop 8.x und 1.7.x. Spezifizierte technische Angaben sind auf der Modulverkaufsseite zu finden und werden regelmäßig gepflegt.

Kompatibilität mit PrestaShop

KT-Solutions für PrestaShop 8

• kompatibel mit PrestaShop 8.x ab Version 8.x.
• mindestens PHP 7.1

KT-Solutions für PrestaShop 1.7

• kompatibel mit PrestaShop 1.7.x ab Version 1.7.8.6.
• mindestens PHP 7.1

Hinweis: Falls Sie eine PrestaShop 1.7. Version nutzen, können die Screenshots lt. dieser Dokumentation abweichen.

Lizenz

Lizenz KT-Solutions Modul

• Das Modul unterliegt einer kommerziellen Lizenz. Sie dürfen das Modul auf einer Domain installieren.
• Zu Test- und Debugzwecken ist keine weitere Lizenz notwendig.
  
• Nach Bestellung können Sie die Domain lizenzieren, unter der das Modul verwendet wird.
  
• In Ihrem Kundenkonto können Sie Ihre Lizenzen unter dem Link "Meine Lizenzen" verwalten.

Fazit / Downloads

KT-Solutions bietet Edelmetallhändlern aktuelle Spot- und Währungskurse, die minütlich aktualisiert werden. Die Daten sind durch dreifache Redundanz sehr ausfallsicher und flexibel konfigurierbar, einschließlich der Wahl der Metalle und Währungspaare sowie zeitgesteuerter Anpassungen. Optionaler IP-Schutz sichert den Zugriff. Händler weltweit nutzen diese Lösung für ihre Shopsysteme, Warenwirtschaft und Filialanzeigen.

Download und weiterführende Links

Aktuelle Modul-Downloads
Download KT-Solutions für PrestaShop 1.7
KT-Solutions für PrestaShop 8 (aktuell nur auf Anfrage erhältlich)

Hinweis
Bitte beachten Sie, dass diese Dokumentation eine Momentaufnahme darstellt und sich von älteren oder zukünftigen Versionen unterscheiden kann. Wir sind darum bemüht, unsere Dokumentation aktuell zu halten. Bei Rückfragen oder Unsicherheiten stehen wir Ihnen jederzeit gerne zur Verfügung.

Hilfreiche Links
KT-Solutions
Anbieter der Wechselkurs-Schnittstelle für Edelmetalle

Falls Sie Unterstützung bei der Optimierung Ihres PrestaShop-Shops benötigen, zögern Sie nicht, Gurkcity zu kontaktieren. Unser Support-Team steht Ihnen nicht nur bei der Modulinstallation zur Seite, sondern bietet Ihnen auch umfassende Dienstleistungen als PrestaShop Full-Service-Agentur an.