Prohyp
Was Prohyp kann und wie du es aktivierst, freigibst und jedem Mitarbeiter einen Prohyp-Account mit seinem eigenen Token anlegst, prüfst und wieder löschst.
Prohyp ist eine Baufinanzierungsplattform für Vermittler. Die Integration verbindet i-Planner über dein persönliches Prohyp-Token mit Prohyp. In der Kundenverwaltung zeigt die Seite Prohyp Datenschnittstelle die Prohyp-Antragsnummern eines Kunden. Anträge übergeben, ansehen und übernehmen lassen sich darüber nicht, weil ihre weiteren Seiten Prohyp ohne dein Token anfragen.
Kurz erklärt
Die Prohyp-Integration besteht aus zwei Teilen:
- Prohyp-Account mit Token: Jeder Mitarbeiter, der Prohyp nutzen soll, hinterlegt sein Prohyp-Token in einem Prohyp-Account unter Organisation › Accounts. i-Planner prüft das Token nach dem Anlegen, auf Knopfdruck und einmal täglich. Wechselt ein Account bei der täglichen Prüfung in den Fehlerzustand, erhält der Accountinhaber eine Benachrichtigung.
- Seite Prohyp Datenschnittstelle: Sie öffnet sich aus der Kundenverwaltung in einem neuen Browserfenster und zeigt unter Übersicht die am Kunden gespeicherten Antragsnummern. Ihre weiteren Seiten fragen Prohyp ohne das Token deines Prohyp-Accounts an. Deshalb legt Kunde an Prohyp übergeben keinen Antrag an, und die Antragslisten zeigen keine Antragsdaten. Antragsteller, Darlehen und Immobilie lassen sich nicht übernehmen. Was dabei genau passiert, steht unter Anträge übergeben und übernehmen.
Die Seite Prohyp Datenschnittstelle gehört zu i-Planner und ist keine Anmeldung in der Weboberfläche von Prohyp. Baufinanzierungsanträge legst du direkt bei Prohyp an. Einen automatischen Datenabgleich gibt es nicht, und Dokumente von Prohyp landen nicht im Posteingang. Automatisch läuft nur die tägliche Prüfung des Tokens.
Typische Aufgaben:
- Prohyp soll in deinem Büro verfügbar sein: Prohyp einrichten.
- Ein Mitarbeiter hat ein neues Prohyp-Token: Prohyp-Token prüfen und ersetzen.
- Du willst sehen, welche Prohyp-Anträge an einem Kunden hängen: Prohyp aus der Kundenverwaltung öffnen.
- Ein Kunde braucht eine Baufinanzierung: Kunden als neuen Antrag an Prohyp übergeben.
- Prohyp fehlt oder meldet einen Fehler: Fehlerbehebung.
Voraussetzungen
- Ein Prohyp-Zugang mit API-Token. i-Planner prüft das Token an der Antragsdaten-Schnittstelle von Prohyp.
- Zum Aktivieren von Prohyp und zum Festlegen der Freigabe braucht deine Benutzerrolle das Recht Integrationen.
- Zum Anlegen eines Prohyp-Accounts braucht deine Benutzerrolle das Recht Accounts.
- Prohyp ist unter Organisation › Integrationen aktiviert. Ohne Aktivierung erscheint in der Kundenverwaltung keine Kachel Prohyp, und unter Organisation › Accounts lässt sich kein Prohyp-Account anlegen.
- Du bist für Prohyp freigegeben. Voreingestellt ist die Freigabe Alle Mitarbeiter.
- Zum Öffnen der Seite Prohyp Datenschnittstelle brauchst du einen Prohyp-Account, der dir gehört oder für dich freigeschaltet ist. Bei ihm muss der Schalter Account aktiv eingeschaltet sein, und sein Token muss erfolgreich geprüft sein. Sonst zeigt das Fenster Prohyp in der Kundenverwaltung nur einen Hinweis und Schließen.
- Zum Öffnen von Prohyp in der Kundenverwaltung wählst du einen Kunden aus.
Prohyp einrichten
Die Einrichtung hat zwei Teile. Zuerst aktivierst du Prohyp einmal für die Organisation. Danach legt jeder Mitarbeiter, der Prohyp nutzen soll, einen eigenen Prohyp-Account mit seinem eigenen Token an.
Prohyp aktivieren
- Öffne Organisation › Integrationen und klicke Prohyp an. Du findest die Integration unter Entdecken › Datenlieferanten oder Entdecken › Alle.
- Schalte im Bereich Aktivierung den Schalter Integration aktivieren ein.
- Optional: Lege im Bereich Einschränkungen unter Freigabe fest, wer Prohyp nutzen darf. Bei Nur ausgewählte Mitarbeiter wählst du im Bereich Ausgewählte Mitarbeiter Rollen, Gruppen und Personen aus. Wie das funktioniert, steht unter Organisation › Integrationen im Abschnitt Wer die Integration nutzen darf.
Einen Bereich Zugangsdaten für die ganze Organisation hat die Detailseite von Prohyp nicht. Das Token gehört in den Prohyp-Account jedes Mitarbeiters. Sobald es Prohyp-Accounts gibt, zeigt die Detailseite zusätzlich den Bereich Accounts mit ihrer Anzahl.
Prohyp-Account anlegen
- Öffne Organisation › Accounts und klicke auf Neuer Account.
- Wähle in der Liste Prohyp. Die Liste zeigt nur aktivierte Integrationen.
- Fülle im Abschnitt Stammdaten das Feld Name aus. Wird dir das Feld Accountinhaber angeboten, wähle dort das Teammitglied, das Prohyp mit diesem Token nutzen soll.
- Trage im Abschnitt Zugangsdaten dein Prohyp-Token in das Feld Token ein.
- Klicke auf Account anlegen.
i-Planner meldet „Account erstellt“ und prüft das Token automatisch bei Prohyp. Bei Erfolg erscheint „Verbindung erfolgreich“, und oben auf der Seite des Accounts steht Verbunden mit Datum. Lehnt Prohyp das Token ab, erscheint das Fenster Validierung fehlgeschlagen mit dem Grund. Ist Prohyp nicht erreichbar, erscheint nur ein Hinweis, und der Status bleibt unverändert. Was die Meldungen bedeuten, steht unter Fehlerbehebung.
Die Eingabefelder
| Feld | Pflicht | Was eintragen |
|---|---|---|
| Integration aktivieren | Ja | Einschalten, auf der Detailseite von Prohyp im Bereich Aktivierung |
| Freigabe | Nein | Alle Mitarbeiter (Voreinstellung) oder Nur ausgewählte Mitarbeiter, im Bereich Einschränkungen |
| Ausgewählte Mitarbeiter | Nur bei Nur ausgewählte Mitarbeiter | Rollen, Gruppen und Personen, die Prohyp nutzen dürfen |
| Name | Ja | Frei wählbarer Anzeigename für den Prohyp-Account |
| Accountinhaber | Ja | Das Teammitglied, dem der Account gehört. Voreingestellt bist du selbst. Das Feld erscheint nur, wenn deine Benutzerrolle Accounts für andere anlegen darf. |
| Token | Ja, geheim | Dein Prohyp-Token. Unter dem Feld steht „Dein Zugriffstoken für den Dienst.“ Die Eingabe ist verdeckt, das Token wird verschlüsselt gespeichert und danach nicht mehr angezeigt. Das Formular verlangt das Feld nicht. Ohne Token scheitert aber die Verbindungsprüfung mit „token required“, und der Account steht auf Fehler. |
Prohyp-Token prüfen und ersetzen
- Öffne Organisation › Accounts und klicke auf die Zeile deines Prohyp-Accounts.
- Lies oben auf der Seite den Status ab: Verbunden mit Datum, Nicht geprüft, solange noch kein Prüfergebnis vorliegt, oder die Fehlermeldung der letzten Prüfung.
- Willst du das Token ersetzen, trage das neue im Abschnitt Zugangsdaten in das Feld Token ein. Das gespeicherte Token zeigt das Feld nicht an. Dort steht der Hinweis „Gespeichert — aus Sicherheit nicht erneut anzeigbar. Leer lassen behält ihn, eine Eingabe ersetzt ihn.“
- Klicke im Abschnitt Verbindung auf Verbindung prüfen.
Wie Änderungen auf der Seite eines Accounts gespeichert werden, steht unter Organisation › Accounts im Abschnitt Einen Account bearbeiten.
Einmal täglich prüft i-Planner jeden Prohyp-Account, bei dem unter Stammdaten der Schalter Account aktiv eingeschaltet ist. Wechselt ein Account dabei in den Fehlerzustand, erhält der Accountinhaber die Benachrichtigung „Verbindung fehlgeschlagen:“ mit dem Namen des Accounts. Darin steht „Die tägliche Überprüfung des Accounts ist fehlgeschlagen:“, gefolgt vom Grund. Ein Link führt zum Account. Bleibt der Fehler bestehen, kommt die Benachrichtigung nicht jeden Tag erneut.
Den Überblick über alle Prohyp-Accounts gibt die Detailseite von Prohyp unter Organisation › Integrationen. Sobald es Prohyp-Accounts gibt, steht dort im Bereich Accounts ihre Anzahl, zum Beispiel 2 Accounts verknüpft und darunter davon 2 aktiv. Ein Klick darauf führt zur Liste unter Organisation › Accounts.
Prohyp-Account löschen
Öffne den Prohyp-Account unter Organisation › Accounts und klicke im Bereich Gefahrenzone auf Account löschen. Bestätige im Dialog Account löschen? mit Endgültig löschen. i-Planner meldet „Account gelöscht“ und zeigt wieder die Liste Alle. Danach verschickt i-Planner die Sicherheits-E-Mail „Konto getrennt“. Die Gefahrenzone erscheint nur, wenn deine Benutzerrolle diesen Account löschen darf. Den zweiten Weg über die Accounts-Liste findest du unter Accounts › Account löschen.
Häufige Fragen
Zum Öffnen der Seite Prohyp Datenschnittstelle ja. Schalte deinen Prohyp-Account unter Organisation › Accounts im Abschnitt Freischaltung für sie frei. Dann zeigt ihr das Fenster Prohyp in der Kundenverwaltung die Kundenauswahl, und sie sieht wie du die am Kunden gespeicherten Antragsnummern. Wie das Freischalten geht, steht unter Accounts › Einen Account für Kolleginnen und Kollegen freischalten.
Nein. Nach dem Deaktivieren verschwindet die Kachel Prohyp in der Kundenverwaltung, und neue Prohyp-Accounts lassen sich nicht anlegen. Bestehende Accounts bleiben aktiv. Am Schalter Integration aktivieren steht dazu der Hinweis „Deaktivieren suspendiert die Accounts nicht — es schränkt nur die Nutzung der Schnittstelle ein. Zum Stilllegen der Accounts den Schalter ‚Alle Accounts deaktivieren‘ nutzen.“ Legst du die Accounts mit Alle Accounts deaktivieren still, erhalten ihre Inhaber die Benachrichtigung Accounts deaktiviert. Wie das Stilllegen funktioniert, steht unter Integrationen › Alle Accounts einer Integration stilllegen. Solange Alle Accounts deaktivieren eingeschaltet ist, lehnt i-Planner Änderungen an den Accounts und ihr Einschalten ab. Es meldet dann „Die Accounts dieser Integration sind gesammelt deaktiviert. Bitte zuerst im Integrationsbereich wieder aktivieren.“
Weitere Themen
- Anträge übergeben und übernehmen: Prohyp aus der Kundenverwaltung öffnen und was beim Übergeben, Ansehen und Übernehmen von Anträgen passiert.
- Fehlerbehebung: wenn die Kachel fehlt, die Token-Prüfung scheitert oder die Übergabe mit einer Fehlermeldung endet.
- Integrationen: Integrationen aktivieren, freigeben und ihre Accounts gesammelt stilllegen.
- Accounts: Accounts bearbeiten, einschalten und löschen.
- Datenlieferanten: die anderen Vergleichsrechner und Partnerportale im Überblick.