# 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 {#kurz-erklaert}

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](/organisation/integrationen/pool/jung-dms-und-cie/uebersicht#jung-dms-cie-einrichten).
- i-Planner soll regelmäßig Daten von JDC abrufen: [Automatischen Abruf einrichten](/organisation/integrationen/pool/jung-dms-und-cie/abruf-und-wiedervorlagen#automatischen-abruf-einrichten).
- Erledigte Aktivitäten sollen bei JDC als erledigt ankommen: [Erledigte Wiedervorlagen an JDC zurückmelden](/organisation/integrationen/pool/jung-dms-und-cie/abruf-und-wiedervorlagen#erledigte-wiedervorlagen-jdc-zurueckmelden).
- Du hast ein neues Client Secret von JDC bekommen: [Client Secret ändern](/organisation/integrationen/pool/jung-dms-und-cie/uebersicht#client-secret-aendern).
- Anlegen, Prüfen oder der Abruf klappt nicht: [Fehlerbehebung](/organisation/integrationen/pool/jung-dms-und-cie/fehlerbehebung).

## Voraussetzungen {#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](/organisation/integrationen/pool/jung-dms-und-cie/abruf-und-wiedervorlagen#automatischen-abruf-einrichten) und [Erledigte Wiedervorlagen an JDC zurückmelden](/organisation/integrationen/pool/jung-dms-und-cie/abruf-und-wiedervorlagen#erledigte-wiedervorlagen-jdc-zurueckmelden).

## JUNG, DMS & CIE einrichten {#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**

1. Ö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.
2. Schalte im Bereich **Aktivierung** den Schalter **Integration aktivieren** ein. i-Planner speichert die Änderung sofort.

*Animation: Die Detailseite von JUNG, DMS & CIE mit Logo, Kennzeichen Official, der Beschreibung Maklerpool und Abwicklungsplattform für Versicherungs- und Investmentbestände und den Angaben Built by JDC Group und Website jdcgroup.de. Im Bereich Aktivierung wird der Schalter Integration aktivieren eingeschaltet, es erscheint Feld „Integration aktivieren“ wurde gespeichert!, und darunter erscheint der Bereich Einschränkungen mit der Freigabe Alle Mitarbeiter. Dann wird die Freigabe auf Nur ausgewählte Mitarbeiter gestellt. Im neuen Bereich Ausgewählte Mitarbeiter mit der Liste aus Gruppen, Rollen und Personen wird die Rolle Administrator angekreuzt, der Zähler springt auf 2 Mitglieder, es erscheint Freigabe gespeichert.*

3. 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](/organisation/integrationen/uebersicht#wer-integration-nutzen-darf).

**Account anlegen**

4. Öffne **Organisation › Accounts** und klicke auf **Neuer Account**.
5. Wähle in der Liste **JUNG, DMS & CIE**.
6. Trage unter **Stammdaten** im Feld **Name** einen Anzeigenamen ein, unter **Zugangsdaten** die **Client Id** und das **Client Secret**.
7. 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](/organisation/integrationen/pool/jung-dms-und-cie/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 {#client-secret-aendern}

Ö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 {#haeufige-fragen}

::faq
  :::faq-item{question="Wo trage ich Client-ID und Client Secret ein?"}
  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.
  :::

  :::faq-item{question="Kann ich aus i-Planner direkt in JDC springen?"}
  Nein. Einen Absprung in die JDC-Plattform bietet die Integration nicht, auch nicht über das Symbol **Schnittstellen** in der Kopfzeile der Kundenverwaltung.
  :::

  :::faq-item{question="Prüft i-Planner gegen die Test- oder die Produktivumgebung von JDC?"}
  Gegen die Produktivumgebung. Die Verbindungsprüfung meldet sich ausschließlich dort an.
  :::

  :::faq-item{question="Ich habe JUNG, DMS & CIE deaktiviert — startet i-Planner noch Abrufe oder meldet zurück?"}
  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](/organisation/integrationen/uebersicht#accounts-integration-stilllegen).
  :::
::

## Weitere Themen {#weitere-themen}

- [Daten abrufen und Wiedervorlagen melden](/organisation/integrationen/pool/jung-dms-und-cie/abruf-und-wiedervorlagen): welche Daten fließen, automatischer Abruf, Rückmeldung an JDC.
- [Fehlerbehebung](/organisation/integrationen/pool/jung-dms-und-cie/fehlerbehebung): wenn Anlegen, Prüfen, Abruf oder Rückmeldung nicht klappt.
- [Integrationen](/organisation/integrationen/uebersicht): Integrationen aktivieren, freigeben und ihre Accounts stilllegen.
- [Accounts](/organisation/accounts/uebersicht): Accounts anlegen, freischalten und prüfen.