# MR.MONEY

> Was MR.MONEY kann und wie du die Integration aktivierst, freigibst und deinen MR.MONEY-Account mit dem Token anlegst und im Blick behältst.

MR.MONEY ist ein Maklerverwaltungs- und Datendienst. Die Integration ist für Maklerbüros gedacht, die einen Zugang bei MR.MONEY haben. Mit dem Token dieses Zugangs holt i-Planner Dokumente von MR.MONEY in den Posteingang der **Kundenverwaltung**. Dort ordnest du sie Kunden und Verträgen zu oder legst mit den mitgelieferten Angaben neue Kunden und Verträge an.

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

Die MR.MONEY-Integration verbindet deinen MR.MONEY-Zugang über ein Token mit i-Planner:

- Dokumente abholen: Im Posteingang der **Kundenverwaltung** holst du mit einem Klick alle Dokumente, die MR.MONEY in diesem Moment auflistet und die noch nicht importiert sind. Beim Öffnen des Posteingangs ordnet i-Planner sie im Hintergrund über die Vertragsnummer oder einen eindeutigen Kundennamen zu. Je nach Ergebnis landen sie in den Listen **Zugeordnet über Vertragsnummer**, **Zugeordnet über Kunden** oder **Nicht zugeordnet**.
- Dokumente mit Vorbelegung ablegen: Zu jedem Dokument liefert MR.MONEY Angaben wie Kundenname, Geburtsdatum, Vertragsnummer und Gesellschaft mit. Sie dienen der automatischen Zuordnung und belegen beim Ablegen den Dialog vor. Damit ordnest du ein nicht zugeordnetes Dokument einem vorhandenen Kunden und Vertrag zu oder legst Kunde und Vertrag neu an.
- Zugang prüfen: i-Planner prüft das Token direkt nach dem Anlegen des Accounts, bei jedem Klick auf **Verbindung prüfen** und einmal täglich automatisch. Stuft die tägliche Prüfung den Account erstmals als fehlerhaft ein, erhält der **Accountinhaber** eine Benachrichtigung.
- Kachel MR.MONEY: In der **Kundenverwaltung** steht hinter dem Raster-Symbol **Schnittstellen** in der Kopfzeile die Kachel **MR.MONEY**. Sie öffnet in einem neuen Fenster das Login von portal.makler-bund.de. Benutzername und Passwort übergibt i-Planner dabei nicht.

::callout
---
color: amber
icon: i-heroicons-exclamation-triangle
---
Dokumente kommen nur über die Abholung im Posteingang nach i-Planner, und die startest du selbst. Einen zeitgesteuerten Import von MR.MONEY-Dateien in den Posteingang gibt es nicht. Der Abschnitt **Automatischer Abruf** auf der Seite des MR.MONEY-Accounts holt bei MR.MONEY nur die Liste der Dokumente ohne Dateien. Einträge im Posteingang legt er keine an.
::

Typische Aufgaben:

- Deine Organisation will MR.MONEY anbinden: [MR.MONEY einrichten](/organisation/integrationen/datenlieferanten/mr-money/uebersicht#mr-money-einrichten).
- Neue Dokumente von MR.MONEY sollen in den Posteingang: [Dokumente von MR.MONEY abholen](/organisation/integrationen/datenlieferanten/mr-money/dokumente-abholen#dokumente-mr-money-abholen).
- Ein Dokument soll zu einem Kunden und Vertrag: [MR.MONEY-Dokumente ablegen](/organisation/integrationen/datenlieferanten/mr-money/dokumente-abholen#mr-money-dokumente-ablegen).
- Du hast ein neues Token von MR.MONEY: [MR.MONEY-Account im Blick behalten](/organisation/integrationen/datenlieferanten/mr-money/uebersicht#mr-money-account-blick-behalten).
- Es kommen keine Dokumente an: [Fehlerbehebung](/organisation/integrationen/datenlieferanten/mr-money/fehlerbehebung).

## Voraussetzungen {#voraussetzungen}

- Ein Zugang bei MR.MONEY mit einem Zugriffstoken. Das Token ist das einzige Zugangsdatum. i-Planner stellt jede Anfrage an MR.MONEY nur mit diesem Token.
- Zum Aktivieren von MR.MONEY unter **Organisation › Integrationen** braucht deine Benutzerrolle das Recht **Integrationen**.
- Zum Anlegen des MR.MONEY-Accounts unter **Organisation › Accounts** braucht deine Benutzerrolle das Recht **Accounts**.
- MR.MONEY ist für deine Organisation aktiviert. Vorher steht MR.MONEY bei **Neuer Account** nicht zur Auswahl, die Kachel **MR.MONEY** fehlt, und die Abholung im Posteingang lässt MR.MONEY aus.
- Du bist für MR.MONEY freigegeben. Voreingestellt ist die **Freigabe** **Alle Mitarbeiter**. Wer selbst das Recht **Integrationen** hat, darf einen MR.MONEY-Account auch ohne Freigabe anlegen. Die Kachel **MR.MONEY** sieht dagegen nur, wer freigegeben ist.
- Für die Abholung im Posteingang und für die Kachel brauchst du einen MR.MONEY-Account, der dir gehört oder für dich freigeschaltet ist. Er muss eingeschaltet sein und den Status **Verbunden** haben.

## MR.MONEY einrichten {#mr-money-einrichten}

Die Einrichtung hat zwei Teile. Zuerst aktivierst du MR.MONEY einmal für die Organisation. Danach legst du einen MR.MONEY-Account mit deinem Token an.

### MR.MONEY aktivieren

1. Öffne **Organisation › Integrationen** und klicke **MR.MONEY** an, zum Beispiel unter **Entdecken › Datenlieferanten**. Die Detailseite trägt das Kennzeichen **Official** und die Beschreibung „Maklerverwaltungs- und Datendienst“.
2. Schalte im Bereich **Aktivierung** den Schalter **Integration aktivieren** ein. In der Listenansicht unter **Organisation › Integrationen** hat MR.MONEY danach den Status **Aktiv**.

*Animation: Die Detailseite von MR.MONEY mit Logo, Kennzeichen Official, der Beschreibung Maklerverwaltungs- und Datendienst und den Angaben Built by MR.MONEY, Docs i-Planner Docs und Website mrmoney.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 MR.MONEY nutzen darf. Der Bereich erscheint nur bei aktivierter Integration. Wie die Auswahl funktioniert, steht unter **Organisation › Integrationen** im Abschnitt [Wer die Integration nutzen darf](/organisation/integrationen/uebersicht#wer-integration-nutzen-darf).

Sobald es MR.MONEY-Accounts gibt, zeigt die Detailseite von MR.MONEY zusätzlich den Bereich **Accounts**, zum Beispiel mit „2 Accounts verknüpft“ und darunter „davon 1 aktiv“. Ein Klick darauf führt zu **Organisation › Accounts**.

### MR.MONEY-Account anlegen

1. Öffne **Organisation › Accounts** und klicke auf **Neuer Account**.
2. Klicke in der Liste auf **MR.MONEY**.
3. Trage unter **Stammdaten** einen **Name** ein und wähle, falls das Feld angeboten wird, den **Accountinhaber**.
4. Trage unter **Zugangsdaten** dein MR.MONEY-Token in das Feld **Token** ein.
5. Klicke auf **Account anlegen**.

i-Planner meldet „Account erstellt“ und prüft die Verbindung sofort. Akzeptiert MR.MONEY das Token, erscheint „Verbindung erfolgreich“, und oben auf der Seite des Accounts steht **Verbunden** mit Datum und Uhrzeit. Lehnt MR.MONEY das Token ab, öffnet sich das Fenster **Validierung fehlgeschlagen** mit der Meldung. Der Account erhält dann den Status **Fehler**, und oben auf seiner Seite steht die Fehlermeldung. Ist MR.MONEY nicht erreichbar, erscheint nur ein Hinweis, und der Status bleibt **Nicht geprüft**.

## Eingabefelder am MR.MONEY-Account {#eingabefelder-mr-money-account}

Diese Felder gehören zur Einrichtung von MR.MONEY. Sie stehen auf der Detailseite der Integration unter **Organisation › Integrationen** und am MR.MONEY-Account unter **Organisation › Accounts**.

| Feld | Pflicht | Was eintragen |
|---|---|---|
| **Integration aktivieren** | Ja | Einschalten. Ohne Aktivierung lassen sich keine MR.MONEY-Accounts anlegen, und die Kachel **MR.MONEY** fehlt. |
| **Freigabe** | Nein | **Alle Mitarbeiter** (Voreinstellung) oder **Nur ausgewählte Mitarbeiter** mit Rollen, Gruppen und Personen. Regelt, wer MR.MONEY-Accounts anlegen und die Kachel öffnen darf. |
| **Name** | Ja | Frei wählbarer Anzeigename. Er erscheint beim Abholen im Fortschrittsfenster des Posteingangs. |
| **Accountinhaber** | Ja | Das Teammitglied, dem der Account gehört. Voreingestellt bist du selbst. Nur sichtbar, wenn deine Benutzerrolle Accounts anderen Mitgliedern zuordnen darf. |
| **Token** | Für die Verbindung nötig, **geheim** | Dein MR.MONEY-Zugriffstoken, das einzige Zugangsdatum für MR.MONEY. Die Eingabe ist verdeckt. Früher hieß das Feld **PDFBox Token**. Nach dem Speichern wird es nicht mehr angezeigt. Lässt du das Feld leer, bleibt das Token erhalten, eine Eingabe ersetzt es. |
| **Account aktiv** | Nein | Schalter des gespeicherten Accounts. Ist er aus, holt der Posteingang für diesen Account keine Dokumente ab. |
| **Freischaltung** | Nein | Beim gespeicherten Account: **Alle Mitarbeiter**, **Nur das Team des Accountinhabers**, **Nur der Accountinhaber** (gilt, wenn nichts eingestellt ist) oder **Accountinhaber + ausgewählte**. Bestimmt, wer die Dokumente des Accounts im Posteingang abholen kann. |
| **Automatischer Abruf** und **Erstabruf-Zeitraum (Tage)** | Nein | Legen bei MR.MONEY keine Dokumente im Posteingang an. Der automatische Abruf holt nur die Liste der Dokumente ohne Dateien. Der Erstabruf-Zeitraum (Voreinstellung 90) wirkt nicht, weil MR.MONEY keinen Datumsfilter kennt. |

## MR.MONEY-Account im Blick behalten {#mr-money-account-blick-behalten}

Öffne unter **Organisation › Accounts** den MR.MONEY-Account mit einem Klick auf seine Zeile.

- Status ablesen: Oben auf der Seite steht **Verbunden** mit Datum und Uhrzeit, wenn die letzte Prüfung erfolgreich war. Solange die Verbindung noch nicht mit Ergebnis geprüft wurde, steht dort **Nicht geprüft**, sonst ein Fehlertext.
- Token wechseln: Das Feld **Token** unter **Zugangsdaten** ist beim Öffnen leer und trägt den Hinweis „Gespeichert — aus Sicherheit nicht erneut anzeigbar. Leer lassen behält ihn, eine Eingabe ersetzt ihn.“ Trage das neue Token ein und klicke danach im Abschnitt **Verbindung** auf **Verbindung prüfen**. Ein geändertes Token wird nur gespeichert, nicht geprüft. Ohne diesen Klick ändert sich der Status erst mit der täglichen Prüfung.
- Tägliche Prüfung: i-Planner prüft alle eingeschalteten Accounts einmal täglich automatisch. Stuft die Prüfung den MR.MONEY-Account erstmals als fehlerhaft ein, erhält der **Accountinhaber** die Benachrichtigung „Verbindung fehlgeschlagen:“ mit dem Namen des Accounts. Darin stehen der Text „Die tägliche Überprüfung des Accounts ist fehlgeschlagen:“ samt Meldung und ein Link zur Seite des Accounts. Bleibt der Fehler bestehen, kommt die Benachrichtigung nicht jeden Tag erneut.
- Ein- und ausschalten: Dafür gibt es den Schalter **Account aktiv** unter **Stammdaten**. Für einen ausgeschalteten MR.MONEY-Account holt der Posteingang keine Dokumente ab, und die Kachel **MR.MONEY** lässt ihn als Zugang nicht gelten.
- Löschen: Das geht im Bereich **Gefahrenzone** über **Account löschen**. Mehr dazu steht unter **Organisation › Accounts** im Abschnitt [Account löschen](/organisation/accounts/ausschalten-und-loeschen#account-loeschen).

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

::faq
  :::faq-item{question="Was ist der Unterschied zwischen „Freigabe“ und „Freischaltung“?"}
  Die **Freigabe** stellst du unter **Organisation › Integrationen** auf der Detailseite von MR.MONEY ein. Sie legt fest, wer MR.MONEY-Accounts anlegen und die Kachel **MR.MONEY** öffnen darf. Die **Freischaltung** gehört zu einem einzelnen Account unter **Organisation › Accounts**. Nach ihr richtet sich, wer die Dokumente dieses Accounts im Posteingang abholen kann und für wen der Account bei der Kachel als Zugang zählt. Ohne Freischaltung ist das nur der Accountinhaber.
  :::

  :::faq-item{question="Wie kann eine Kollegin die Dokumente meines MR.MONEY-Accounts abholen?"}
  Öffne den Account unter **Organisation › Accounts** und stelle im Abschnitt **Freischaltung** **Alle Mitarbeiter**, **Nur das Team des Accountinhabers** oder **Accountinhaber + ausgewählte** ein. Bei **Accountinhaber + ausgewählte** wählst du die Kollegin im Bereich **Freigeschaltete Mitarbeiter** aus. Ist nichts eingestellt, gilt **Nur der Accountinhaber**, und nur der Accountinhaber holt die Dokumente dieses Accounts im Posteingang ab.
  :::

  :::faq-item{question="Ich habe MR.MONEY deaktiviert — sind die MR.MONEY-Accounts jetzt stillgelegt?"}
  Nein. 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.“ Solange MR.MONEY deaktiviert ist, lässt die Abholung im Posteingang MR.MONEY aus, und die Kachel **MR.MONEY** fehlt. Neue MR.MONEY-Accounts lassen sich dann nicht anlegen. Legst du die Accounts mit **Alle Accounts deaktivieren** still, erhalten ihre Inhaber die Benachrichtigung **Accounts deaktiviert**. Wie das geht, steht unter **Organisation › Integrationen** im Abschnitt [Alle Accounts einer Integration stilllegen](/organisation/integrationen/uebersicht#accounts-integration-stilllegen).
  :::
::

## Weitere Themen {#weitere-themen}

- [Dokumente abholen und ablegen](/organisation/integrationen/datenlieferanten/mr-money/dokumente-abholen): Dokumente in den Posteingang holen, ablegen und sehen, welche Daten fließen.
- [Fehlerbehebung](/organisation/integrationen/datenlieferanten/mr-money/fehlerbehebung): wenn das Token abgelehnt wird, keine Dokumente ankommen oder die Kachel fehlt.
- [Accounts](/organisation/accounts/uebersicht): die Verbindung prüfen, einen Account freischalten oder löschen.
- [Zeitsprung](/organisation/integrationen/datenlieferanten/zeitsprung/uebersicht): ein weiterer Datenlieferant, der Dokumente in den Posteingang holt.
