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

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](/organisation/integrationen/datenlieferanten/prohyp/antraege).

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](/organisation/integrationen/datenlieferanten/prohyp/uebersicht#prohyp-einrichten).
- Ein Mitarbeiter hat ein neues Prohyp-Token: [Prohyp-Token prüfen und ersetzen](/organisation/integrationen/datenlieferanten/prohyp/uebersicht#prohyp-token-pruefen-ersetzen).
- Du willst sehen, welche Prohyp-Anträge an einem Kunden hängen: [Prohyp aus der Kundenverwaltung öffnen](/organisation/integrationen/datenlieferanten/prohyp/antraege#prohyp-kundenverwaltung-oeffnen).
- Ein Kunde braucht eine Baufinanzierung: [Kunden als neuen Antrag an Prohyp übergeben](/organisation/integrationen/datenlieferanten/prohyp/antraege#kunden-neuen-antrag-prohyp-uebergeben).
- Prohyp fehlt oder meldet einen Fehler: [Fehlerbehebung](/organisation/integrationen/datenlieferanten/prohyp/fehlerbehebung).

## Voraussetzungen {#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 {#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

1. Öffne **Organisation › Integrationen** und klicke **Prohyp** an. Du findest die Integration unter **Entdecken › Datenlieferanten** oder **Entdecken › Alle**.
2. Schalte im Bereich **Aktivierung** den Schalter **Integration aktivieren** ein.

*Animation: Die Detailseite von Prohyp mit Logo, Kennzeichen Official, der Beschreibung Baufinanzierungsplattform für Vermittler und den Angaben Built by Prohyp, Docs i-Planner Docs und Website prohyp.de. Die Integration ist aus, im Bereich Accounts steht zum Beispiel 1 Account verknüpft, davon 1 aktiv, darunter der Schalter Alle Accounts deaktivieren. Im Bereich Aktivierung wird der Schalter Integration aktivieren eingeschaltet, es erscheint Feld „Integration aktivieren“ wurde gespeichert!; Alle Accounts deaktivieren verschwindet, und unter Accounts 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: 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](/organisation/integrationen/uebersicht#wer-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

1. Öffne **Organisation › Accounts** und klicke auf **Neuer Account**.
2. Wähle in der Liste **Prohyp**. Die Liste zeigt nur aktivierte Integrationen.
3. 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.
4. Trage im Abschnitt **Zugangsdaten** dein Prohyp-Token in das Feld **Token** ein.
5. 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](/organisation/integrationen/datenlieferanten/prohyp/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 {#prohyp-token-pruefen-ersetzen}

1. Öffne **Organisation › Accounts** und klicke auf die Zeile deines Prohyp-Accounts.
2. 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.
3. 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.“
4. 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](/organisation/accounts/bearbeiten#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 {#account-loeschen}

Ö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](/organisation/accounts/ausschalten-und-loeschen#account-loeschen).

::callout
---
icon: i-heroicons-exclamation-triangle
color: amber
---
Das Löschen lässt sich nicht rückgängig machen. Die gespeicherten Zugangsdaten gehen verloren. Willst du den Prohyp-Account nur vorübergehend nicht nutzen, schalte stattdessen **Account aktiv** aus.
::

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

::faq
  :::faq-item{question="Kann eine Kollegin meinen Prohyp-Account mitbenutzen?"}
  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](/organisation/accounts/bearbeiten#account-kolleginnen-kollegen-freischalten).
  :::

  :::faq-item{question="Ich habe Prohyp deaktiviert — sind die Prohyp-Accounts jetzt stillgelegt?"}
  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](/organisation/integrationen/uebersicht#accounts-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 {#weitere-themen}

- [Anträge übergeben und übernehmen](/organisation/integrationen/datenlieferanten/prohyp/antraege): Prohyp aus der Kundenverwaltung öffnen und was beim Übergeben, Ansehen und Übernehmen von Anträgen passiert.
- [Fehlerbehebung](/organisation/integrationen/datenlieferanten/prohyp/fehlerbehebung): wenn die Kachel fehlt, die Token-Prüfung scheitert oder die Übergabe mit einer Fehlermeldung endet.
- [Integrationen](/organisation/integrationen/uebersicht): Integrationen aktivieren, freigeben und ihre Accounts gesammelt stilllegen.
- [Accounts](/organisation/accounts/uebersicht): Accounts bearbeiten, einschalten und löschen.
- [Datenlieferanten](/organisation/integrationen/datenlieferanten/uebersicht): die anderen Vergleichsrechner und Partnerportale im Überblick.