Integrationen

Deine Apps können Daten direkt aus euren Systemen holen. Als Erstes geht das mit JTL Cloud: Artikel, Bestände, Lager, Kunden und Aufträge. Die Apps lesen nur, in deiner Warenwirtschaft ändert sich nichts.

Dazu kommen frei verfügbare Daten, für die du kein Konto brauchst: Wetter (Vorhersage, aktuelle Werte und Unwetterwarnungen des Deutschen Wetterdienstes für jeden Ort in Deutschland) und Wechselkurse (die Kurse der Europäischen Zentralbank für rund 30 Währungen, tagesaktuell und zurück bis 1999), Postleitzahlen & Straßen (Orte zu einer Postleitzahl und Straßen zu einem Ort in ganz Deutschland, etwa zum Ausfüllen und Prüfen von Adressen), Wasserstände (aktuelle Wasserstände, Abflüsse und Verläufe der Pegel an Rhein, Elbe, Donau und allen Bundeswasserstraßen) und Luftqualität (Luftqualität, Prognose und Messwerte für Feinstaub, Stickstoffdioxid und Ozon von den Messstationen des Umweltbundesamts und der Länder).

Integrationen finden

Öffne oben Integrationen. Die Seite ist aufgebaut wie ein App-Store:

• Ganz oben steht die Empfehlung: JTL Cloud mit den ersten Vorlagen, die du damit bauen kannst.
• Mit der Suche findest du eine Integration nach Name, Anbieter oder Thema.
• Über die Kategorien (Alle, Warenwirtschaft, Wetter & Umwelt, Finanzen, Orte & Verkehr) grenzt du die Liste ein.
• Darunter die Bereiche Ohne Anmeldung startklar (frei verfügbare Daten), Deine Systeme verbinden und In deinem Team (was ihr schon nutzt).

Rechts neben jeder Integration steht, was du tun kannst: Hinzufügen, Verbinden, Öffnen (sie ist schon in eurem Team) oder Bald (noch nicht verfügbar). Bist du Mitglied, siehst du Ansehen: Hinzufügen und Verbinden können nur Inhaber und Admins.

Die Seite einer Integration

Ein Klick auf eine Integration öffnet ihre Seite. Dort findest du:

• oben Name, Anbieter und den Knopf zum Hinzufügen oder Verbinden, bzw. ob sie schon Hinzugefügt oder Verbunden ist,
• auf einen Blick Kategorie, Zugang (mit oder ohne Anmeldung), wo die Daten verarbeitet werden (zum Beispiel „Bei JTL“ oder „Deutschland“) und was es kostet,
• Freigegeben für: welche Apps die Daten nutzen dürfen,
• Damit starten: Vorlagen für neue Apps,
• Was deine Apps damit können,
• Informationen: Anbieter, Kategorie, Zugang, Datenstandort, Kosten, wie aktuell die Daten sind, die Lizenz und der Quellenhinweis.

JTL Cloud verbinden

Verbinden können Inhaber und Admins des Teams. Die Verbindung gilt für das ganze Team.

1. Öffne oben Integrationen und klicke bei JTL Cloud auf Verbinden (in der Empfehlung oder auf der Seite von JTL Cloud).
2. Melde dich mit deinem JTL-Konto an und wähle eure Organisation.
3. Du kommst zurück auf die Seite von JTL Cloud. Dort steht jetzt Verbunden, und du kannst gleich Apps freigeben.

Heinzelapps muss in eurer JTL-Organisation installiert sein. Fehlt die App dort, sagt Heinzelapps dir das nach der Anmeldung. Installiere sie dann im JTL Hub und verbinde noch einmal.

Du kannst auch direkt in einer App verbinden: im Baukasten unter Integrationen. Die App darf die Daten dann gleich nutzen. Was noch nicht im Team ist, steht dort als Noch nicht eingerichtet; Mehr erfahren öffnet die Seite der Integration.

Frei verfügbare Daten hinzufügen

Hier musst du dich nirgends anmelden. Hinzufügen können Inhaber und Admins des Teams.

1. Öffne oben Integrationen.
2. Klicke bei Wetter, Wechselkurse, Postleitzahlen & Straßen, Wasserstände oder Luftqualität auf Hinzufügen.
3. Du landest auf der Seite der Integration. Gib dort die Apps frei, die die Daten nutzen sollen (siehe unten).

Danach kannst du im Chat einfach sagen, was du brauchst, zum Beispiel: „Zeig zu jedem Standort das Wetter für die nächsten Tage“, „Rechne die Belege in Euro um“ oder „Füll den Ort aus, sobald ich die Postleitzahl eingebe“.

Du kannst das auch umgekehrt machen und gleich im Chat danach fragen. Braucht deine App Daten, die sie noch nicht nutzen darf, zeigt der Chat eine Karte dafür. Als Inhaber oder Admin fügst du die Daten dort mit einem Klick hinzu, gibst sie für die App frei oder verbindest JTL Cloud. Als Mitglied siehst du in der Karte, dass ein Inhaber oder Admin das erledigt.

Postleitzahlen & Straßen kennt Orte und Straßen, aber nicht, wo genau eine Adresse liegt. Das Wetter für eine Adresse findet es deshalb nicht von selbst.

Die Quelle steht immer dabei

Die Daten sind frei, aber meist nur unter einer Bedingung: Wer sie zeigt, nennt die Quelle. Deine App zeigt deshalb bei den Daten einen kurzen Hinweis wie „Quelle: Deutscher Wetterdienst“, „Quelle: Europäische Zentralbank“ oder „Quelle: Umweltbundesamt“. Lass ihn bitte stehen, auch wenn du die App später änderst. Den genauen Wortlaut und die Lizenz findest du auf der Seite der Integration unter Informationen.

Zwei Dinge sagt deine App außerdem dazu:

• Wasserstände sind ungeprüfte Messwerte, so wie sie vom Pegel kommen. Sie sind keine amtliche Hochwasserwarnung. Warnungen findest du beim Hochwasserdienst deines Bundeslandes.
• Luftqualität: Die aktuellen Werte sind vorläufig. Endgültig geprüft sind sie erst ab Juni des folgenden Jahres, bis dahin können sie sich noch ändern oder Lücken haben.

Welche Apps dürfen die Daten nutzen?

Nach dem Verbinden darf noch keine App auf die Daten zugreifen. Auf der Seite der Integration setzt du unter Freigegeben für bei jeder App, die die Daten nutzen soll, ein Häkchen. Im Baukasten einer App geht das auch mit Diese App darf die Daten nutzen.

Nimmst du das Häkchen weg, kommt die App sofort nicht mehr an die Daten. Mitglieder sehen die Freigaben, ändern können sie nur Inhaber und Admins.

Mit einer Vorlage starten

Auf der Seite jeder Integration stehen unter Damit starten fertige Ideen für neue Apps, zum Beispiel für JTL Cloud eine Nachbestellliste, eine Bestandsauskunft oder eine Übersicht der offenen Aufträge. Genauso bringen Wetter (etwa „Wetter für unsere Standorte“ oder „Wetter für Außentermine“), Wechselkurse („Reisekosten in Euro“, „Preise in Fremdwährung“), Postleitzahlen & Straßen („Adressen sauber erfassen“, „Adressliste prüfen“), Wasserstände („Pegelstände im Blick“, „Wasserstand für Schifffahrt und Logistik“) und Luftqualität („Luftqualität an unseren Standorten“, „Feinstaub-Verlauf an einer Messstation“) eigene Vorlagen mit.

Klicke bei einer Vorlage auf Damit bauen. Heinzelapps legt die App an, gibt ihr die Daten frei und öffnet sie im Baukasten. Frei verfügbare Daten werden dabei gleich hinzugefügt, falls ihr sie noch nicht habt. JTL Cloud musst du vorher verbinden.

Als Mitglied geht das, sobald die Integration in eurem Team ist. Die neue App bittest du dann einen Admin freizugeben.

Ist eine Integration in eurem Team, zeigt auch die Startseite unter Vorlagen ihre Ideen. Ein Klick übernimmt die Beschreibung, du kannst sie noch anpassen.

Integrationen gleich beim Beschreiben wählen

Auf der Startseite wählst du unter dem Eingabefeld über Integrationen aus, welche Daten die neue App nutzen darf. Die gewählten erscheinen als kleine Schilder neben dem Knopf, ein Klick auf das Kreuz nimmt eine wieder heraus. Wählst du eine Vorlage einer Integration, ist sie schon ausgewählt.

Mit App bauen gibt Heinzelapps die neue App für alle gewählten Integrationen frei, bevor die Heinzelmännchen loslegen. Frei verfügbare Daten werden dabei gleich hinzugefügt. JTL Cloud lässt sich erst wählen, wenn sie unter Integrationen verbunden ist. Auswählen können Inhaber und Admins.

In der Vorschau siehst du Beispieldaten

Während du eine App baust, zeigt die Vorschau Beispieldaten: ein paar ausgedachte Artikel, ein Beispielwetter, Beispielkurse, einige Beispielpegel oder Beispiel-Messstationen. So kannst du alles ausprobieren, ohne echte Daten anzufassen. Die echten Daten sieht erst die veröffentlichte App.

Apps im JTL-ERP anzeigen

Mit JTL Cloud kann eine veröffentlichte App direkt im JTL-ERP erscheinen:

• In der Seitenleiste des ERP unter „Apps von Drittanbietern“. Die App füllt dann den ganzen Bereich.
• Als schmale Leiste rechts neben Kunden, Artikeln, Aufträgen, Angeboten oder Rechnungen. Dort weiß die App, welcher Kunde, Artikel oder Auftrag gerade offen ist.

So geht es: Öffne die App, wechsle zum Reiter Integrationen und wähle unter In JTL anzeigen, wo die App erscheinen soll und wer sie in JTL benutzen darf. Dann In JTL anlegen. Das können Inhaber und Admins, sobald die App veröffentlicht ist.

Darunter steht, was noch fehlt, mit einem Link an die richtige Stelle in JTL:

• JTL-Wawi (deine Warenwirtschaft) mit JTL Cloud verbunden: In der JTL-Wawi unter Admin → „JTL Cloud Verbindung“ verbinden und im JTL Administrator den Dienst starten, der deine Wawi mit der Cloud verbindet.
• Deine Organisation darf eigene Apps anlegen: Einmal im JTL Partner-Portal als Herausgeber einrichten, falls JTL das verlangt.
• App in JTL installiert: Die Installation einmal in JTL bestätigen. Danach erscheint die App im ERP.

Mit Erneut prüfen siehst du, ob ein Schritt erledigt ist.

Du kannst auch im Chat fragen, zum Beispiel „Kann die App in JTL neben den Aufträgen erscheinen?“. Die Heinzelmännchen schlagen dann passende Plätze vor und zeigen eine Karte, in der du die App mit einem Klick in JTL anlegst.

Wer darf sie in JTL benutzen?

• Alle aus deiner JTL-Organisation: Wer im ERP angemeldet ist, kommt ohne eigene Anmeldung in die App und erscheint unter Benutzer als „Meldet sich über JTL an“.
• Nur freigegebene Personen: Wer die App zum ersten Mal öffnet, wartet, bis ein Admin der App die Person unter Benutzer freigibt.

Willst du die Plätze ändern, wähle neu und klick Speichern. Aus JTL entfernen nimmt die App wieder aus dem ERP.

Entfernen oder trennen

Auf der Seite der Integration öffnest du neben Hinzugefügt oder Verbunden das Menü mit den drei Punkten:

• Entfernen (frei verfügbare Daten) oder Trennen (JTL Cloud): Danach kommt keine App mehr an die Daten. Fügst du sie später wieder hinzu oder verbindest neu, gibst du die Apps wieder frei.
• Neu verbinden (JTL Cloud): Du meldest dich noch einmal an, ohne vorher zu trennen. Bleibt es dieselbe Organisation, bleiben die Freigaben erhalten.
• Trennst du JTL Cloud oder verbindest eine andere Organisation, verschwinden deine Apps aus dem JTL-ERP. Zeig sie danach bei Bedarf neu an.

Was mit deinen Zugangsdaten passiert

Dein JTL-Passwort gibst du nur bei JTL ein, Heinzelapps sieht es nie. Heinzelapps merkt sich, welche Organisation verbunden ist, und eine verschlüsselte Anmeldung der Person, die verbunden hat. Mit ihr legt Heinzelapps deine Apps in JTL an, wenn du sie im ERP anzeigen lässt. In deinen Apps, im Code und im Chat erscheinen keine Zugänge. Trennst du JTL Cloud, löscht Heinzelapps die Anmeldung.