JTL-Wawi (in Bearbeitung)
In diesem Artikel geht es darum, wie man die JTL-Wawi API mit melibo verbindet. Dabei geht es konkret um die Registrierung einer App/Anwendung in JTL sowie die Erweiterung der Scopes.
Scopes sind Berechtigungen/Rechte, die ein API-Schlüssel besitzt, um über die API bzw. Datenbank Informationen (z. B. Kunden-, Bestell- oder Produktdaten) zu lesen oder schreiben. Von Scope-Erweiterung spricht man, weil in JTL bestehende Berechtigungen eines API-Tokens nicht nachträglich geändert werden können. Wenn du also neue Scopes benötigst, musst du eine neue App registrieren.
💻 1.JTL-Wawi öffnen
Öffne JTL-Wawi auf deinem Windows-PC. Das ist die Software, mit der du die üblichen Operationen wie Bestellungen verwalten, Bestände prüfen oder Warenwirtschaftsprozesse durchführst.
⚙️2. App-Registrierung starten
Klicke im Menü auf "Admin" → "App-Registrierung" (neue Oberfläche). Daraufhin öffnet sich das Fenster "JTL-Wawi API – Anwendungsregistrierungen" .Das Registrierungsfenster muss offen sein, bevor du den ersten API-Call sendest. Nur dann ist der erste Call zulässig.
➕ 3. Neue Registrierung anlegen
Klicke unten links auf "Hinzufügen" und dann auf "Weiter", bis du bei "Registrierungsanfrage entgegennehmen" ankommst.
Das Fenster bleibt geöffnet – du führst die eigentliche Registrierung nun per API-Aufruf durch (z.B. Postman).
✉️ 4. Registrierungsanfrage
Öffne ein API-Testing-Tool wie Postman und führe folgende Abfrage aus:
Ersetze <IP> und <PORT> durch die Daten deiner JTL-Wawi API.
Header: X-ChallengeCode: <random-wert>
Body:
Das Feld MandatoryApiScopes kannst du um die Scopes erweitern, die du für deinen Use Case in melibo brauchst (z. B. orders.read, customers.read etc.).
Beispiel-Response:
Damit hast du deine App erfolgreich registriert und erhältst die RegistrationRequestId, die du im nächsten Schritt benötigst. Kopiere sie dir einmal heraus.
📝 5. App-Registrierung in JTL bestätigen
Nach der erfolgreichen Anfrage ändert sich das Fenster in JTL-Wawi und zeigt nun die "Anwendungsinformationen" an. Das melibo-Icon erscheint automatisch (da du es im API-Body mitgesendet hast). Klicke auf "Weiter".
🔒 6. API-Scopes verwalten
Im Schritt "Verwaltung der API-Scopes" kannst du nochmals überprüfen, welche Scopes du deiner App erteilen möchtest.
Wenn Scopes rot markiert sind, sind sie nicht erlaubt.
Möglichkeit 1: Abbrechen und Schritt 2–5 wiederholen - diesmal ohne die fehlerhaften Scopes.
Möglichkeit 2: Wenn die Scopes nicht zwingend erforderlich sind, kannst du sie einfach entfernen und dann weitermachen
Wenn alles korrekt ist, klicke auf "Einrichtung abschließen" → "Fertigstellen".
🔑 7. API-Token abrufen
Zurück in Postman: Führe jetzt folgende Abfrage aus, um den API-Token deiner registrierten App zu erhalten. Damit stellst du später die Verbindung zu melibo her.
Header: X-ChallengeCode: <derselbe_random_wert_wie_vorher> (! Wichtig: Es muss der selbe Wert, wie in Schritt 4. sein)
Beispiel-Response:
Im Feld ApiKey erhältst du den eigentlichen API-Token, den du künftig für die Integration mit melibo verwenden kannst.
🔍 8. Verbindung testen
Um zu prüfen, ob die Verbindung zwischen deiner neu registrierten App und deinem API-Token funktioniert, führe folgenden Request in Postman aus:
Header:
Wenn die Anfrage erfolgreich ist, ist deine Verbindung aktiv.
✅ Damit ist die App-Registrierung und Scope-Erweiterung in JTL-Wawi abgeschlossen. Nach erfolgreicher Verbindung kannst du das Fenster in JTL schließen und erneut öffnen – dann sollte rechts ein Häkchen angezeigt werden, das bestätigt, dass die App aktiv ist.
🔗 Referenz: Anleitung zur offiziellen JTL-Wawi API
Zuletzt aktualisiert
War das hilfreich?