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

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.

Typische Aufgaben mit Starpool:

Du hinterlegst deine Starpool-Zugangsdaten zum ersten Mal: Starpool einrichten.
Du hast ein neues Client Secret bekommen: Starpool-Account bearbeiten.
Du willst sehen, ob dein Zugang noch funktioniert: Starpool-Zugang im Blick behalten.
Die Prüfung meldet einen Fehler: Fehlerbehebung.

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

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

Starpool aktivieren

Ö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.
Schalte im Bereich Aktivierung den Schalter Integration aktivieren ein. i-Planner speichert die Änderung sofort, einen Speichern-Knopf gibt es nicht.

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.

Starpool-Account anlegen

Öffne Organisation › Accounts und klicke auf Neuer Account.
Wähle in der Liste Starpool.
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.
Trage unter Zugangsdaten Client Id und Client Secret ein. Das Feld Benutzername brauchst du für die Prüfung nicht.
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.

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

Ö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.

Ändere unter Zugangsdaten die Client Id oder gib ein neues Client Secret ein.
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

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.

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.

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.

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.

Weitere Themen

Zugang prüfen: welche Daten bei der Prüfung fließen und wie du den Status im Blick behältst.
Fehlerbehebung: was die Meldungen beim Anlegen und Prüfen bedeuten.
Integrationen: Integrationen aktivieren, freigeben und ihre Accounts stilllegen.
Accounts: Accounts anlegen, freischalten und prüfen.