# KT-Solutions - Modul für PrestaShop

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

# 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.

[![grafik.png](https://docs.onlineshop-module.de/uploads/images/gallery/2024-07/scaled-1680-/grafik.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2024-07/grafik.png)

# 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.

<p class="callout warning">**Hinweis** Bitte beachten Sie, dass das Modul stetig weiterentwickelt wird und ggf. ältere Versionen nicht alle Funktionen enthalten. </p>

# 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 &amp; 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](https://www.kt-solutions.de/spotpreise-edelmetallhaendler/)**. 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

[![kt-solutions-website.jpg](https://docs.onlineshop-module.de/uploads/images/gallery/2024-07/scaled-1680-/kt-solutions-website.jpg)](https://docs.onlineshop-module.de/uploads/images/gallery/2024-07/kt-solutions-website.jpg)

# 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ü

[![grafik.png](https://docs.onlineshop-module.de/uploads/images/gallery/2024-07/scaled-1680-/UKfgrafik.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2024-07/UKfgrafik.png)

### Cron Infos

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

### Log Einstellungen

[![gc_goldapi_2023-06-15 13_52_22-Module Manager • 1786 – Mozilla Firefox.png](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/scaled-1680-/gc-goldapi-2023-06-15-13-52-22-module-manager-1786-mozilla-firefox.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/gc-goldapi-2023-06-15-13-52-22-module-manager-1786-mozilla-firefox.png)

#### 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

[![grafik.png](https://docs.onlineshop-module.de/uploads/images/gallery/2024-07/scaled-1680-/8ehgrafik.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2024-07/8ehgrafik.png)

# Cronjob einrichten

### Cron Infos

[![grafik.png](https://docs.onlineshop-module.de/uploads/images/gallery/2024-07/scaled-1680-/Ns6grafik.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2024-07/Ns6grafik.png)

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.

[![gc_goldapi_2023-06-15 13_48_40-Schedule a Task - Plesk Obsidian 18.0.53 – Mozilla Firefox.png](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/scaled-1680-/gc-goldapi-2023-06-15-13-48-40-schedule-a-task-plesk-obsidian-18-0-53-mozilla-firefox.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2023-06/gc-goldapi-2023-06-15-13-48-40-schedule-a-task-plesk-obsidian-18-0-53-mozilla-firefox.png)

# Ü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.

[![grafik.png](https://docs.onlineshop-module.de/uploads/images/gallery/2024-07/scaled-1680-/dv6grafik.png)](https://docs.onlineshop-module.de/uploads/images/gallery/2024-07/dv6grafik.png)

# 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

<p class="callout info">**Hinweis:** Falls Sie eine PrestaShop 1.7. Version nutzen, können die Screenshots lt. dieser Dokumentation abweichen.</p>

# 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](https://www.onlineshop-module.de/prestashop-kt-solutions.html)  
KT-Solutions für PrestaShop 8 (aktuell nur auf Anfrage erhältlich)

<p class="callout warning">**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.</p>

**Hilfreiche Links** [KT-Solutions](https://www.kt-solutions.de/spotpreise-edelmetallhaendler/)  
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](https://www.gurkcity.de/kontakt.php) steht Ihnen nicht nur bei der Modulinstallation zur Seite, sondern bietet Ihnen auch umfassende Dienstleistungen als [PrestaShop Full-Service-Agentur](https://www.gurkcity.de/) an.