Konnektoren
Schemaobjekte
Die SQL- und Dateibrücke
Das OAuth 2.0 Verfahren
Gesperrte Datensätze

JTL Konnektor

Der JTL Konnektor ermöglicht die Anbindung von Syncler an die JTL-Wawi EazyBusiness API.
Damit können Sie Kundendaten, Artikel, Bestellungen, Rechnungen und weitere Stammdaten direkt mit Syncler synchronisieren und weiterverarbeiten.
Besonders praktisch: Auch individuelle Kundenfelder (Custom Fields) aus Ihrer JTL-Wawi werden automatisch erkannt und können genutzt werden.

Voraussetzungen

Bevor Sie den Konnektor einrichten, stellen Sie bitte sicher:

  • Sie haben Zugriff auf die JTL-Wawi EazyBusiness REST API.
  • Sie verfügen über eine gültige App-Registrierung bei JTL (mit App-ID, App-Version und App-Beschreibung).
  • Die nötigen API-Berechtigungen (Scopes) sind freigeschaltet.
  • Sie haben Zugriff auf Ihre Netzwerkumgebung (API-Host, Port, ggf. Proxy).

Einrichtung in Syncler

  1. Neues System anlegen

    • Öffnen Sie Syncler und legen Sie ein neues System mit dem Konnektor „JTL“ an.

  2. Verbindungseinstellungen eintragen

    • Tragen Sie die Basis-URL der JTL-API ein (z. B. https://meinserver:443/api/eazybusiness/v1/).
    • Geben Sie Ihre AppId, Anzeigename, Beschreibung, Version, Anbietername und Anbieter-Webseite ein.
    • Falls von JTL verlangt, hinterlegen Sie auch ein AppIcon und/oder einen ChallengeCode.

  3. API-Authentifizierung

    • Beim ersten Speichern erzeugt Syncler automatisch eine Registrierungsanfrage.
    • Anschließend wird der API-Key abgerufen und gespeichert.
    • Dieser Key wird für alle weiteren API-Aufrufe verwendet.

  4. Schema aktualisieren

    • Sobald alle Daten eingetragen sind, aktualisiert Syncler das verfügbare Schema.
    • Damit stehen Ihnen alle JTL-Objekte (z. B. Kunden, Artikel, Bestellungen) für Synchronisationen zur Verfügung.

Unterstützte Datenobjekte

Der JTL-Konnektor stellt eine Vielzahl an Datenobjekten bereit, darunter:

  • Kunden (customers) mit Adress- und Zahlungsinformationen sowie eigenen Feldern (Custom Fields).
  • Kundengruppen und Kundenkategorien.
  • Lieferanten und Unternehmen.
  • Artikel (items) inkl. Preise, Lager- und Versandinformationen.
  • Bestellungen (salesOrders) inkl. Zahlungen und Versanddetails.
  • Rechnungen (invoices) inkl. Rechnungsadressen, Zahlungs- und Stornodetails.
  • Kategorien zur Strukturierung von Artikeln.
  • Buchungsdaten (accountingData) für den Abgleich mit Finanzsystemen.

Arbeiten mit Daten

Daten abrufen (Lesen)

  • Sie können Daten einzeln (z. B. einen bestimmten Kunden) oder als Liste abrufen.
  • Für große Datenmengen empfiehlt es sich, Änderungsabfragen zu nutzen.
    • Beispiel: Kundenänderungen seit einem bestimmten Datum (lastChangeFrom).
    • Beispiel: Artikeländerungen seit einem Datum (changedSince).
  • Die Ergebnisse können direkt in Syncler verarbeitet oder in andere Systeme übertragen werden.

Daten schreiben (Erstellen/Aktualisieren)

  • Sie können Kunden und Kundengruppen in JTL anlegen, ändern oder auch löschen.
  • Für Artikel, Rechnungen oder Buchungsdaten ist nur das Lesen vorgesehen, Änderungen werden hier nicht unterstützt.
  • Kundenfelder (Custom Fields) können ebenfalls geschrieben werden – Änderungen werden einzeln per API an JTL übertragen.

Benutzerhinweise

  • Schema-Aktualisierung: Falls in JTL neue Felder oder Custom Fields angelegt wurden, aktualisieren Sie das Schema in Syncler, um diese nutzen zu können.
  • Fehlerbehandlung: Wenn Objekte nicht unterstützt werden, zeigt Syncler eine klare Fehlermeldung an.
  • Nachrichten & Logs: Alle API-Aufrufe (inkl. URL, Parameter, Ergebnisse) können in Syncler zur Diagnose eingesehen werden.

Mit dem JTL Konnektor steht Ihnen eine flexible Schnittstelle zwischen Ihrer JTL-Wawi und Syncler zur Verfügung.
So können Sie Prozesse automatisieren, Daten zentralisieren und individuelle Erweiterungen (z. B. durch Custom Fields) optimal einbinden.