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