JUNG, DMS & CIE
Was die Integration JUNG, DMS & CIE kann, was du dafür brauchst und wie du sie aktivierst, einen Account mit Client-ID und Client Secret anlegst und das Client Secret änderst.
JUNG, DMS & CIE (JDC Group) ist ein Maklerpool mit Abwicklungsplattform für Versicherungs- und Investmentbestände. Wickelt deine Organisation über JDC ab, verbindest du hier deinen JDC-API-Zugang mit i-Planner. i-Planner prüft dann die Zugangsdaten, startet nach Zeitplan einen Datenabruf und meldet erledigte Wiedervorlagen an JDC zurück.
Kurz erklärt
Die Integration JUNG, DMS & CIE unter Organisation › Integrationen verbindet einen JDC-API-Zugang mit i-Planner. Der Zugang besteht aus Client Id und Client Secret. Daraus ergeben sich drei Funktionen:
- Um die Zugangsdaten zu prüfen, meldet sich i-Planner mit Client-ID und Client Secret bei JDC an. Ob das klappt, zeigt es auf der Seite des Accounts unter Organisation › Accounts. Die Prüfung läuft direkt nach dem Anlegen, bei jedem Klick auf Verbindung prüfen und einmal täglich automatisch.
- Schaltest du am Account Automatischer Abruf ein, startet i-Planner nach diesem Zeitplan im Hintergrund einen Datenabruf für den Account, zum Beispiel jeden Tag um 06:00.
- Setzt du in der Kundenverwaltung eine Aktivität auf erledigt, die mit einer Wiedervorlage in JDC verknüpft ist, stellt i-Planner die Wiedervorlage bei JDC auch auf erledigt.
Was die Integration nicht kann:
- Sie bietet keinen Absprung in die JDC-Plattform. Aus der Kundenverwaltung heraus öffnet i-Planner JDC nicht, auch nicht über das Symbol Schnittstellen in der Kopfzeile.
- Einen Abruf auf Knopfdruck gibt es nicht. Den Datenabruf startet nur der Zeitplan Automatischer Abruf.
- Die manuelle Dokumentenabholung im Posteingang fragt JDC-Accounts nicht ab.
Typische Aufgaben mit JUNG, DMS & CIE:
- Du richtest den JDC-Zugang zum ersten Mal ein: JUNG, DMS & CIE einrichten.
- i-Planner soll regelmäßig Daten von JDC abrufen: Automatischen Abruf einrichten.
- Erledigte Aktivitäten sollen bei JDC als erledigt ankommen: Erledigte Wiedervorlagen an JDC zurückmelden.
- Du hast ein neues Client Secret von JDC bekommen: Client Secret ändern.
- Anlegen, Prüfen oder der Abruf klappt nicht: Fehlerbehebung.
Voraussetzungen
- Ein API-Zugang bei JDC mit Client-ID und Client Secret. Damit meldet sich i-Planner an der JDC-Schnittstelle an.
- Das Recht Integrationen, um JUNG, DMS & CIE unter Organisation › Integrationen zu öffnen und zu aktivieren. Im Rollen-Editor steht es im Block Organisation.
- Das Recht Accounts mit dem Bearbeitungsrecht Lesen + Bearbeiten oder Lesen + Bearbeiten + Löschen, um den Account unter Organisation › Accounts anzulegen.
- JUNG, DMS & CIE muss aktiviert sein. Ist die Integration nicht aktiviert, steht sie bei Neuer Account nicht zur Auswahl.
- Wer das Recht Integrationen nicht hat, muss in den Einschränkungen der Integration freigegeben sein.
Für den automatischen Abruf und für die Rückmeldung an JDC gelten zusätzliche Bedingungen. Sie stehen in den Abschnitten Automatischen Abruf einrichten und Erledigte Wiedervorlagen an JDC zurückmelden.
JUNG, DMS & CIE einrichten
Zuerst aktivierst du die Integration für deine Organisation, dann legst du einen Account mit den JDC-Zugangsdaten an.
Integration aktivieren
- Öffne Organisation › Integrationen und klicke JUNG, DMS & CIE an. Du findest die Integration unter Entdecken › Alle. Die Detailseite zeigt neben dem Namen das Kennzeichen Official, darunter Built by JDC Group und die Website jdcgroup.de.
- Schalte im Bereich Aktivierung den Schalter Integration aktivieren ein. i-Planner speichert die Änderung sofort.
- Optional: Danach erscheint der Bereich Einschränkungen. Dort stellst du das Feld Freigabe auf Alle Mitarbeiter oder Nur ausgewählte Mitarbeiter. Wie die Auswahl von Rollen, Gruppen und Personen funktioniert, steht unter Organisation › Integrationen im Abschnitt Wer die Integration nutzen darf.
Account anlegen
- Öffne Organisation › Accounts und klicke auf Neuer Account.
- Wähle in der Liste JUNG, DMS & CIE.
- Trage unter Stammdaten im Feld Name einen Anzeigenamen ein, unter Zugangsdaten die Client Id und das Client Secret.
- Klicke auf Account anlegen.
Die Felder beim Anlegen:
| Feld | Pflicht | Was eintragen |
|---|---|---|
| Name | Ja | Frei wählbarer Anzeigename, an dem du den Account unter Organisation › Accounts wiedererkennst. Bleibt das Feld leer, meldet i-Planner Name ist erforderlich. |
| Accountinhaber | Ja | Das Teammitglied, dem der Account gehört. Vorbelegt bist du selbst. Das Feld erscheint nur, wenn deine Benutzerrolle Accounts anderen Teammitgliedern zuordnen darf. |
| Client Id | Ja | Die Client-ID deines JDC-API-Zugangs. |
| Client Secret | Ja | Geheim. Das Client Secret deines JDC-API-Zugangs. Die Eingabe ist maskiert, und i-Planner speichert den Wert verschlüsselt. |
Ob Client Id und Client Secret ausgefüllt sind, prüft das Formular nicht. Fehlt ein Wert, schlägt die anschließende Verbindungsprüfung fehl.
Nach dem Klick auf Account anlegen meldet i-Planner „Account erstellt“ und prüft die Verbindung sofort selbst. Nimmt JDC die Zugangsdaten an, erscheint „Verbindung erfolgreich“. Neben der Überschrift steht dann grün Verbunden mit Datum und Uhrzeit. Lehnt JDC ab, steht der Account auf Fehler. Es öffnet sich das Fenster Validierung fehlgeschlagen mit der Meldung „Zugangsdaten fehlerhaft.“ Wiederholen kannst du die Prüfung jederzeit auf der Seite des Accounts, mit Verbindung prüfen im Bereich Verbindung. Was du bei einer Fehlermeldung tust, steht unter Fehlerbehebung.
Auf der Seite des Accounts gibt es außerdem den Bereich Freischaltung mit Alle Mitarbeiter, Nur das Team des Accountinhabers, Nur der Accountinhaber und Accountinhaber + ausgewählte. Mehr dazu steht unter Organisation › Accounts. Ob und wann i-Planner den JDC-Account täglich prüft, den automatischen Abruf startet oder erledigte Wiedervorlagen zurückmeldet, hängt nicht von der Freischaltung ab.
Client Secret ändern
Öffne den JDC-Account unter Organisation › Accounts. Das Feld Client Secret im Bereich Zugangsdaten ist leer. Es zeigt nur die letzten vier Zeichen des gespeicherten Werts maskiert und dazu den Hinweis „Gespeichert — aus Sicherheit nicht erneut anzeigbar. Leer lassen behält ihn, eine Eingabe ersetzt ihn.“ Trage das neue Client Secret ein und klicke danach im Bereich Verbindung auf Verbindung prüfen. Hat sich i-Planner in den 25 Minuten davor mit derselben Client-ID erfolgreich bei JDC angemeldet, kann die Prüfung diese Anmeldung weiterverwenden. Sie meldet dann „Verbindung erfolgreich“, ohne das neue Client Secret bei JDC zu testen. Verlässlich ist eine Prüfung, die mehr als 25 Minuten nach der letzten erfolgreichen Prüfung mit dieser Client-ID stattfindet.
Häufige Fragen
Im Account, nicht auf der Detailseite der Integration. Unter Organisation › Integrationen schaltest du JUNG, DMS & CIE nur ein und legst unter Einschränkungen die Freigabe fest. Die Zugangsdaten trägst du unter Organisation › Accounts ein. Klicke auf Neuer Account, wähle JUNG, DMS & CIE und fülle im Bereich Zugangsdaten Client Id und Client Secret aus.
Nein. Einen Absprung in die JDC-Plattform bietet die Integration nicht, auch nicht über das Symbol Schnittstellen in der Kopfzeile der Kundenverwaltung.
Gegen die Produktivumgebung. Die Verbindungsprüfung meldet sich ausschließlich dort an.
Abrufe startet i-Planner nicht mehr. Der automatische Abruf pausiert, solange die Integration deaktiviert ist. Die Accounts selbst bleiben aber aktiv. Der Hinweis am Schalter Integration aktivieren sagt dazu: „Deaktivieren suspendiert die Accounts nicht — es schränkt nur die Nutzung der Schnittstelle ein. Zum Stilllegen der Accounts den Schalter ‚Alle Accounts deaktivieren‘ nutzen.“ Die tägliche Prüfung der Zugangsdaten läuft deshalb weiter. Willst du die Accounts ganz stilllegen, schalte sie aus. Einzeln geht das unter Organisation › Accounts mit dem Schalter Account aktiv. Gesammelt geht es unter Organisation › Integrationen auf der Detailseite von JUNG, DMS & CIE mit Alle Accounts deaktivieren im Bereich Accounts. Dieser Schalter erscheint nur, solange die Integration deaktiviert ist. Was er bewirkt, steht unter Organisation › Integrationen im Abschnitt Alle Accounts einer Integration stilllegen.
Weitere Themen
- Daten abrufen und Wiedervorlagen melden: welche Daten fließen, automatischer Abruf, Rückmeldung an JDC.
- Fehlerbehebung: wenn Anlegen, Prüfen, Abruf oder Rückmeldung nicht klappt.
- Integrationen: Integrationen aktivieren, freigeben und ihre Accounts stilllegen.
- Accounts: Accounts anlegen, freischalten und prüfen.