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

# JTL-Wawi Integration

> JTL-Wawi über Cloud, Connector oder Direct DB verbinden

## Übersicht

like.photo unterstützt mehrere Wege, um JTL-Wawi anzubinden. Welcher Modus passt, hängt davon ab, ob du JTL Cloud, einen gehosteten SQL-Server oder eine lokale Wawi nutzt.

<Frame>
  <img src="https://mintcdn.com/josua-de13c98b/VfBKG_KkiHdM-c93/images/jtl-integration.png?fit=max&auto=format&n=VfBKG_KkiHdM-c93&q=85&s=d7440dbe2e47d7578389212a7053eada" alt="JTL-Wawi Integration" width="1440" height="810" data-path="images/jtl-integration.png" />
</Frame>

<CardGroup cols={3}>
  <Card title="JTL Cloud/App" icon="cloud">
    App- und OAuth-basierte Verbindung für JTL Cloud Setups.
  </Card>

  <Card title="OnPrem Connector" icon="server">
    Lokaler Connector für eigene Wawi-Installationen ohne offenen SQL-Port.
  </Card>

  <Card title="Direct DB" icon="database">
    Direkter MS-SQL-Zugriff, z.B. für ecomdata oder andere erreichbare Hosts.
  </Card>
</CardGroup>

## Verbindungsmodi

### JTL Cloud / JTL App

Nutze diesen Modus, wenn deine JTL-Umgebung über die JTL Cloud/App-Anbindung verbunden wird. Die Verbindung läuft über die JTL-App-Flows und benötigt keine manuelle SQL-Konfiguration im Dashboard.

### OnPrem Connector

Der OnPrem Connector ist für lokale oder selbst betriebene JTL-Wawi-Installationen gedacht. Er baut eine ausgehende Verbindung zu like.photo auf, sodass du keinen SQL-Port ins Internet öffnen musst.

Typischer Ablauf:

1. Gehe zu **Einstellungen → Integrationen**
2. Wähle **JTL OnPrem Connector**
3. Lade den Connector herunter
4. Installiere ihn auf dem Server oder Rechner mit Zugriff auf die Wawi-Datenbank
5. Aktiviere ihn mit dem angezeigten Verbindungscode
6. Teste die Verbindung und starte den Sync

<Tip>
  Für lokale Installationen ist der Connector in der Regel die bevorzugte Variante, weil keine Port-Freigabe für SQL nötig ist.
</Tip>

### JTL Direct DB

Direct DB verbindet like.photo direkt mit einem MS-SQL-Server. Das ist sinnvoll, wenn dein Wawi-SQL-Server erreichbar ist, zum Beispiel bei ecomdata oder einem anderen Hoster.

Unter **Einstellungen → Integrationen → JTL Direct DB** stehen zwei Wege zur Verfügung:

<Tabs>
  <Tab title="ecomdata">
    Für ecomdata gibst du die Kunden-ID ein. like.photo bildet daraus automatisch den Servernamen nach dem Muster:

    ```text theme={null}
    c1234.servers.ecomdata.de
    ```

    Typische Werte:

    | Feld                  | Wert                      |
    | --------------------- | ------------------------- |
    | Kunden-ID             | `c1234`                   |
    | Port                  | `50000`                   |
    | Datenbank             | `eazybusiness`            |
    | Instanz               | `JTLWAWI`, falls benötigt |
    | Benutzername/Passwort | SQL-Zugangsdaten          |
  </Tab>

  <Tab title="Manuell">
    Für andere Hosts gibst du Server, Port, Datenbank, Benutzername und Passwort manuell ein.

    | Feld                  | Typischer Wert   |
    | --------------------- | ---------------- |
    | Server                | Hostname oder IP |
    | Port                  | `1433`           |
    | Datenbank             | `eazybusiness`   |
    | Benutzername/Passwort | SQL-Zugangsdaten |
  </Tab>
</Tabs>

<Warning>
  Bei Direct DB muss der SQL-Server für like.photo erreichbar sein. Veröffentliche SQL nicht ungeschützt im Internet; nutze dedizierte Benutzer, IP-Regeln, VPN/Tunnel oder den OnPrem Connector.
</Warning>

## Nach der Einrichtung

<Steps>
  <Step title="Verbindung testen">
    Klicke auf **Verbindung testen**. Bei Erfolg siehst du Produktanzahl, Produkte mit Bildern sowie Lese- und Schreibstatus.
  </Step>

  <Step title="Bildspeicher prüfen">
    Wähle, ob Bilder aus BLOB-Daten oder Dateipfaden gelesen werden sollen. Bei Dateipfaden kann ein Bild-Basisverzeichnis nötig sein.
  </Step>

  <Step title="Kategorien wählen">
    Optional kannst du den Sync auf bestimmte JTL-Kategorien beschränken.
  </Step>

  <Step title="Synchronisieren">
    Starte den ersten Sync. Spätere Läufe aktualisieren geänderte Produkte.
  </Step>
</Steps>

## Was wird synchronisiert?

### Import von JTL → like.photo

| Feld              | Beschreibung                               |
| ----------------- | ------------------------------------------ |
| **Artikelnummer** | SKU/Artikelnummer                          |
| **Name**          | Produktbezeichnung                         |
| **Beschreibung**  | Kurz- und Langbeschreibung, HTML bereinigt |
| **Hersteller**    | Marke/Hersteller                           |
| **Kategorien**    | JTL-Kategorien                             |
| **Merkmale**      | Attribute wie Farbe, Größe, Material       |
| **Bilder**        | BLOB-Daten oder Dateipfade                 |
| **EAN/Barcode**   | Barcode/GTIN                               |

### Export von like.photo → JTL

| Feld               | Beschreibung                                       |
| ------------------ | -------------------------------------------------- |
| **Bilder**         | Akzeptierte generierte Bilder                      |
| **Bildposition**   | Reihenfolge der Artikelbilder                      |
| **Verkaufskanäle** | Aktivierung für Shops, eBay und weitere JTL-Kanäle |
| **Modus**          | Anhängen oder Ersetzen                             |

## Verkaufskanäle

like.photo erkennt konfigurierbare Verkaufskanäle aus JTL:

* **Onlineshops** - JTL-Shop, WooCommerce usw.
* **SCX Marktplätze** - Amazon, Otto, Kaufland via JTL
* **eBay** - eBay-User-Accounts

Beim Publish wählst du, auf welchen Kanälen die generierten Bilder aktiviert werden sollen.

## Häufige Fragen

<AccordionGroup>
  <Accordion title="Muss ich Direct DB verwenden?">
    Nein. Je nach Setup kannst du JTL Cloud/App, OnPrem Connector oder Direct DB verwenden.
  </Accordion>

  <Accordion title="Werden bestehende Bilder überschrieben?">
    Standardmäßig werden generierte Bilder angehängt. Auf der Publish-Seite kannst du auch Ersetzen wählen.
  </Accordion>

  <Accordion title="Unterstützt ihr ecomdata?">
    Ja. Direct DB enthält eine ecomdata-Vorlage mit Port `50000` und Servernamen aus der Kunden-ID.
  </Accordion>

  <Accordion title="Was passiert bei Vaterartikeln?">
    Vater- und Kindartikel werden beim Import verknüpft, soweit die JTL-Daten diese Zuordnung enthalten.
  </Accordion>
</AccordionGroup>

## Fehlerbehebung

<AccordionGroup>
  <Accordion title="Verbindung fehlgeschlagen">
    * Prüfe Server, Port, Datenbankname und Zugangsdaten
    * Prüfe, ob der SQL-Server erreichbar ist
    * Bei lokalen Setups: nutze den OnPrem Connector statt eines offenen SQL-Ports
  </Accordion>

  <Accordion title="Keine Produkte gefunden">
    * Prüfe, ob die richtige Datenbank ausgewählt ist
    * Entferne testweise Kategorie-Filter
    * Prüfe, ob der SQL-Benutzer Leserechte auf Artikel-Tabellen hat
  </Accordion>

  <Accordion title="Bilder werden nicht importiert">
    * Prüfe, ob Bilder in BLOB-Daten oder als Dateipfade gespeichert sind
    * Aktiviere die passende Option in der Direct-DB-Konfiguration
    * Prüfe das Bild-Basisverzeichnis, falls Dateipfade genutzt werden
  </Accordion>
</AccordionGroup>

## SQL-Berechtigungen für Direct DB

Minimal benötigt der SQL-Benutzer Leserechte für Produkt-, Kategorie-, Merkmal- und Bilddaten. Für Publishing sind zusätzlich Schreibrechte auf Bild- und Artikelbild-Zuordnungen nötig.

<Warning>
  Erstelle einen dedizierten SQL-Benutzer für like.photo und gib nur die Rechte frei, die dein gewünschter Workflow benötigt.
</Warning>

<Card title="Support kontaktieren" icon="envelope" href="mailto:support@like.photo">
  Probleme bei der Einrichtung? Wir helfen dir gerne.
</Card>