# Starpool

> Was die Starpool-Integration kann, was du dafür brauchst und wie du Starpool aktivierst, freigibst und einen Starpool-Account mit Client Id und Client Secret anlegst und bearbeitest.

Starpool ist eine Plattform für Baufinanzierung, Bausparen und Ratenkredit für Vermittler. In i-Planner hinterlegst du dafür Client ID und Client Secret deines Zugangs als Account. Diese Zugangsdaten prüft i-Planner beim Anlegen, auf Knopfdruck und einmal täglich an der Anmeldeschnittstelle von Europace.

## Kurz erklärt {#kurz-erklaert}

Unter **Organisation › Integrationen** und **Organisation › Accounts** hinterlegst du deine Starpool-Zugangsdaten und erfährst, ob sie funktionieren:

- Einen Starpool-Account mit **Client Id** und **Client Secret** legst du unter **Organisation › Accounts** an. i-Planner speichert das Client Secret verschlüsselt.
- Um die Zugangsdaten zu prüfen, meldet sich i-Planner mit Client Id und Client Secret des Starpool-Accounts bei Europace an. Das Ergebnis zeigt es als Status auf der Seite des Accounts. Das passiert automatisch direkt nach dem Anlegen, bei jedem Klick auf **Verbindung prüfen** und einmal täglich.
- Wechselt ein Account bei der täglichen Prüfung in den Fehlerzustand, erhält der **Accountinhaber** die Benachrichtigung „Verbindung fehlgeschlagen: …“ mit dem Namen des Accounts.

::callout
---
color: amber
icon: i-heroicons-exclamation-triangle
---
Daten von Starpool holt i-Planner nicht ab. Für Starpool gibt es keinen Posteingang, keine Dokumentenabholung, keine Synchronisation und keinen automatischen Datenabruf. Bei der Prüfung der Zugangsdaten überträgt i-Planner keine Kundendaten.
::

Typische Aufgaben mit Starpool:

- Du hinterlegst deine Starpool-Zugangsdaten zum ersten Mal: [Starpool einrichten](/organisation/integrationen/pool/starpool/uebersicht#starpool-einrichten).
- Du hast ein neues Client Secret bekommen: [Starpool-Account bearbeiten](/organisation/integrationen/pool/starpool/uebersicht#starpool-account-bearbeiten).
- Du willst sehen, ob dein Zugang noch funktioniert: [Starpool-Zugang im Blick behalten](/organisation/integrationen/pool/starpool/zugang-pruefen#starpool-zugang-blick-behalten).
- Die Prüfung meldet einen Fehler: [Fehlerbehebung](/organisation/integrationen/pool/starpool/fehlerbehebung).

## Voraussetzungen {#voraussetzungen}

- API-Zugangsdaten für Starpool mit einer Client ID und einem Client Secret. i-Planner prüft sie an der Anmeldeschnittstelle von Europace.
- Zum Aktivieren von Starpool braucht deine Benutzerrolle das Recht **Integrationen**. Im Rollen-Editor steht es im Block **Organisation**.
- Zum Anlegen und Prüfen des Starpool-Accounts braucht deine Benutzerrolle das Recht **Accounts**. Es steht auch im Block **Organisation**, und sein **Bearbeitungsrecht** muss mindestens **Lesen + Bearbeiten** sein.
- Starpool muss unter **Organisation › Integrationen** für deine Organisation aktiviert sein. Vorher steht Starpool unter **Organisation › Accounts** bei **Neuer Account** nicht zur Auswahl.
- Steht die **Freigabe** von Starpool auf **Nur ausgewählte Mitarbeiter**, musst du dort ausgewählt sein. Wer selbst das Recht **Integrationen** hat, braucht keine Freigabe.

## Starpool einrichten {#starpool-einrichten}

Die Einrichtung hat zwei Teile. Du aktivierst Starpool einmal für die Organisation und legst danach einen Account mit den Zugangsdaten an.

### Starpool aktivieren

1. Öffne **Organisation › Integrationen**, wähle links unter **Entdecken** den Eintrag **Alle** und klicke **Starpool** an. Die Detailseite zeigt oben das Kennzeichen **Official** und die Beschreibung „Plattform für Baufinanzierung, Bausparen und Ratenkredit für Vermittler.“ Dazu kommen **Built by** Starpool und **Website** starpool.de.
2. Schalte im Bereich **Aktivierung** den Schalter **Integration aktivieren** ein. i-Planner speichert die Änderung sofort, einen **Speichern**-Knopf gibt es nicht.

*Animation: Die Detailseite von Starpool mit Logo, Kennzeichen Official, der Beschreibung Plattform für Baufinanzierung, Bausparen und Ratenkredit für Vermittler und den Angaben Built by Starpool und Website starpool.de; im Bereich Aktivierung ist der Schalter Integration aktivieren noch aus. Er wird 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: Jetzt erscheint der Bereich **Einschränkungen**. Dort legst du unter **Freigabe** fest, wer Starpool-Accounts anlegen darf: **Alle Mitarbeiter** (Voreinstellung) oder **Nur ausgewählte Mitarbeiter**. Bei **Nur ausgewählte Mitarbeiter** wählst du im Bereich **Ausgewählte Mitarbeiter** Rollen, Gruppen und Personen aus. Wie diese Auswahl funktioniert, steht unter **Organisation › Integrationen** im Abschnitt [Wer die Integration nutzen darf](/organisation/integrationen/uebersicht#wer-integration-nutzen-darf).

### Starpool-Account anlegen

1. Öffne **Organisation › Accounts** und klicke auf **Neuer Account**.
2. Wähle in der Liste **Starpool**.
3. Fülle unter **Stammdaten** das Feld **Name** aus. Wird dir das Feld **Accountinhaber** angeboten, wähle dort das Teammitglied, dem der Account gehören soll.
4. Trage unter **Zugangsdaten** **Client Id** und **Client Secret** ein. Das Feld **Benutzername** brauchst du für die Prüfung nicht.
5. Klicke auf **Account anlegen**.

i-Planner meldet „Account erstellt“, öffnet die Seite des neuen Accounts und prüft die Zugangsdaten sofort bei Europace. Klappt die Anmeldung, erscheint „Verbindung erfolgreich“, und oben auf der Seite steht **Verbunden** mit Datum und Uhrzeit. Klappt sie nicht, öffnet sich das Fenster **Validierung fehlgeschlagen** mit dem Grund. Was die einzelnen Meldungen bedeuten, steht unter [Fehlerbehebung](/organisation/integrationen/pool/starpool/fehlerbehebung).

### Die Eingabefelder

| Feld | Nötig | Was eintragen |
|---|---|---|
| **Name** | Ja | Frei wählbarer Anzeigename für diesen Account. Bleibt das Feld leer, erscheint **Name ist erforderlich**. |
| **Accountinhaber** | Ja | Das Teammitglied, dem der Account gehört. Voreingestellt bist du selbst. Das Feld erscheint nur, wenn deine Benutzerrolle Accounts anderen Mitgliedern zuordnen darf. |
| **Client Id** | Ja, für die Prüfung | Die Client ID deiner API-Zugangsdaten. Fehlt sie, meldet die Verbindungsprüfung **Zugangsdaten unvollständig.** |
| **Client Secret** | Ja, für die Prüfung, **geheim** | Das Client Secret deiner API-Zugangsdaten. i-Planner speichert es verschlüsselt und zeigt es danach nicht mehr an. Fehlt es, meldet die Verbindungsprüfung **Zugangsdaten unvollständig.** |
| **Benutzername** | Nein, die Prüfung verwendet es nicht | Die Verbindungsprüfung verwendet und überträgt es nicht. In der früheren Kontenmaske hieß das Feld **Partner-ID**. |

## Starpool-Account bearbeiten {#starpool-account-bearbeiten}

Öffne unter **Organisation › Accounts** den Starpool-Account mit einem Klick auf seine Zeile. Änderungen auf der Seite des Accounts speichert i-Planner Feld für Feld, eine Speichern-Schaltfläche gibt es nicht. Mehr dazu steht unter **Organisation › Übersicht** im Abschnitt [Speichern geschieht automatisch](/organisation/uebersicht#speichern-geschieht-automatisch).

1. Ändere unter **Zugangsdaten** die **Client Id** oder gib ein neues **Client Secret** ein.
2. Klicke im Abschnitt **Verbindung** auf **Verbindung prüfen**. Das Speichern allein prüft geänderte Zugangsdaten nicht.

Das Feld **Client Secret** ist beim Öffnen leer. Es zeigt höchstens die letzten vier Zeichen hinter Punkten und dazu den Hinweis „Gespeichert — aus Sicherheit nicht erneut anzeigbar. Leer lassen behält ihn, eine Eingabe ersetzt ihn.“ Lässt du das Feld leer, bleibt das gespeicherte Client Secret erhalten. Eine Eingabe ersetzt es.

Im Abschnitt **Freischaltung** legst du fest, wer den Account außer dem Accountinhaber nutzen darf. Zur Wahl stehen **Alle Mitarbeiter**, **Nur das Team des Accountinhabers**, **Nur der Accountinhaber** (Voreinstellung) und **Accountinhaber + ausgewählte**.

## Häufige Fragen {#haeufige-fragen}

::faq
  :::faq-item{question="Muss ich das Feld „Benutzername“ ausfüllen?"}
  Für die Verbindungsprüfung nicht. Sie prüft nur **Client Id** und **Client Secret**. Den **Benutzernamen** verwendet und überträgt sie nicht. In der früheren Kontenmaske hieß das Feld **Partner-ID**.
  :::

  :::faq-item{question="Wo trage ich Client ID und Client Secret für die ganze Organisation ein?"}
  Die Verbindungsprüfung verwendet ausschließlich die Zugangsdaten, die an einem Starpool-Account hinterlegt sind. Lege dafür unter **Organisation › Accounts** über **Neuer Account** einen Starpool-Account an und trage dort **Client Id** und **Client Secret** ein.
  :::

  :::faq-item{question="Holt i-Planner Daten oder Dokumente von Starpool ab?"}
  Nein. Für Starpool gibt es keinen Posteingang, keine Dokumentenabholung, keine Synchronisation und keinen automatischen Datenabruf. Bei Europace meldet sich i-Planner nur an, um Client Id und Client Secret zu prüfen.
  :::

  :::faq-item{question="Ich habe Starpool deaktiviert — sind die Starpool-Accounts jetzt stillgelegt?"}
  Nein. Der Hinweis hinter dem Info-Symbol 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 läuft für die eingeschalteten Starpool-Accounts deshalb weiter. Den Schalter **Alle Accounts deaktivieren** findest du unter **Organisation › Integrationen** auf der Detailseite von Starpool im Bereich **Accounts**. Er erscheint, solange Starpool deaktiviert ist und Accounts hat. Schaltest du ihn ein, schaltet i-Planner die aktiven Starpool-Accounts aus, und die tägliche Prüfung überspringt sie. Ihre Accountinhaber erhalten die Benachrichtigung **Accounts deaktiviert**, zum Beispiel mit dem Text „Starpool: 2 Account(s) wurden gesammelt deaktiviert.“ Aktivierst du Starpool wieder, schaltet i-Planner genau diese Accounts wieder ein. Neue Starpool-Accounts lassen sich erst wieder anlegen, wenn Starpool aktiviert ist. Mehr dazu unter **Organisation › Integrationen** im Abschnitt [Alle Accounts einer Integration stilllegen](/organisation/integrationen/uebersicht#accounts-integration-stilllegen).
  :::
::

## Weitere Themen {#weitere-themen}

- [Zugang prüfen](/organisation/integrationen/pool/starpool/zugang-pruefen): welche Daten bei der Prüfung fließen und wie du den Status im Blick behältst.
- [Fehlerbehebung](/organisation/integrationen/pool/starpool/fehlerbehebung): was die Meldungen beim Anlegen und Prüfen bedeuten.
- [Integrationen](/organisation/integrationen/uebersicht): Integrationen aktivieren, freigeben und ihre Accounts stilllegen.
- [Accounts](/organisation/accounts/uebersicht): Accounts anlegen, freischalten und prüfen.