> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dreizack-medien.de/llms.txt
> Use this file to discover all available pages before exploring further.

# Shop verbinden

> DZM Emelly installieren und deinen JTL-Shop mit Emelly verbinden

> [!WARNING]
>
> **BEVOR DU BEGINNST**
>
> Resources & Health muss VOR allen anderen Plugins installiert und aktualisiert werden.

## Schnellübersicht

**1. Shop in Emelly anlegen**

Den Verbindungsschlüssel kopieren

**2. Plugins installieren**

Zuerst Resources & Health, dann DZM Emelly

**3. Schlüssel eintragen und Verbindung prüfen**

Im Plugin unter **Einstellungen → Verbindung**

**4. Cron einrichten**

Der Abgleich läuft bei jedem Aufruf des Shop-Crons, am besten jede Minute

**5. Daten einschalten**

Erst im Trockenlauf ansehen, dann Art für Art einschalten

## Shop in Emelly anlegen

Lege in deinem Emelly-Workspace einen Shop an. Emelly erzeugt dafür einen **Verbindungsschlüssel**, der mit `eck_` beginnt. Kopiere ihn, du trägst ihn gleich im Plugin ein.

> [!NOTE]
>
> Ein Schlüssel gehört zu genau einem Shop in genau einem Workspace. Verbindest du mehrere Shops, bekommt jeder seinen eigenen.

## Plugins installieren

**1. Resources & Health installieren**

Installiere bzw. aktualisiere zuerst **Resources & Health** in der Pluginverwaltung.

**2. DZM Emelly installieren**

Installiere danach **DZM Emelly**. Nach der Installation ist alles ausgeschaltet und der Trockenlauf an: Das Plugin sendet noch nichts.

## Schlüssel eintragen

**1. Einstellungen öffnen**

Öffne das Plugin und wechsle zu **Einstellungen**.

**2. Schlüssel eintragen**

Trage unter **Verbindung** den Verbindungsschlüssel ein und speichere. Das Plugin speichert ihn verschlüsselt und zeigt ihn danach nicht mehr an.

**3. Verbindung prüfen**

Klicke auf **Verbindung prüfen**. Das Plugin fragt dann den Zählerstand bei Emelly ab.

> [!TIP]
>
> Alternativ setzt du den Schlüssel als Konstante `DZM_EMELLY_API_KEY` in der `includes/config.JTL-Shop.ini.php`. Die Konstante hat Vorrang vor dem Eintrag in den Einstellungen.

## Cron einrichten

Das Plugin gleicht in kurzen Takten ab: Es erkennt Änderungen, sendet sie an Emelly und holt Abmeldungen aus Emelly zurück. Jeder Takt läuft beim Aufruf des Crons.

> [tab] JTL-Cron (empfohlen)
>
> Das Plugin meldet sich beim Cron des Shops an und läuft bei jedem Aufruf mit. Richte bei deinem Hoster einen Server-Cron ein, der den JTL-Cron **jede Minute** aufruft. Unter **Status → Cron** siehst du, wann der Takt zuletzt lief. Fehlt der Cron-Job, legt **Reparieren** ihn neu an.

> [tab] Aufruf per URL
>
> Kann dein Hoster keinen Server-Cron, lässt du eine URL jede Minute aufrufen, z. B. von einem externen Cron-Dienst. Die URL steht unter **Status → Cron → Aufruf per URL**. Sie enthält einen geheimen Schlüssel. Wer die URL kennt, kann einen Takt auslösen, mehr nicht. Über das Pfeil-Symbol erzeugst du einen neuen Schlüssel, dann gilt die alte URL nicht mehr.

## Daten einschalten

**1. Im Trockenlauf ansehen**

Schalte unter **Einstellungen → Abgleich** die gewünschten Arten ein und lass den **Trockenlauf** an. Unter **Status → Daten** siehst du je Art, was gesendet würde. **Vorschau** zeigt einen Beispiel-Eintrag.

**2. Trockenlauf ausschalten**

Passt alles, schalte den Trockenlauf aus. Ab dem nächsten Takt gehen die Daten an Emelly.

**3. Ergebnis prüfen**

Unter **Status** siehst du je Art, was Emelly angenommen hat. Lehnt Emelly etwas ab, steht es unter **Zuletzt abgelehnt** mit dem Grund. Ein abgelehnter Eintrag geht erst nach einer Änderung erneut raus.

> [!NOTE]
>
> Daten, die vor dem Einschalten entstanden sind (Altbestand), überträgt das Plugin nach und nach im Hintergrund. Laufende Änderungen haben immer Vorrang. Emelly kennzeichnet den Altbestand, er löst nie eine Automation aus. Eine Bestellung von vor zwei Jahren startet also keine Kampagne.

> [!TIP]
>
> Dein Shop ist mit Emelly verbunden. Die einzelnen Optionen beschreibt [Einstellungen](https://docs.dreizack-medien.de/Emelly/einstellungen.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.