# NAFI NOVA

> Was NAFI NOVA kann und wie du die Integration aktivierst, freigibst und deine NAFI-Zugangsdaten als Account hinterlegst, prüfst, teilst und wieder löschst.

NAFI NOVA ist ein Kfz-Vergleichsrechner für Versicherungsmakler von NAFI. Mit der Integration hinterlegst du deine NAFI-Zugangsdaten einmal in i-Planner. Danach öffnest du NAFI NOVA direkt aus der **Kundenverwaltung**, für einen ausgewählten Kunden oder aus einem Vertrag heraus.

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

Die Integration ist ein Absprung aus der **Kundenverwaltung** in NAFI NOVA:

- Für einen Kunden öffnen: Über das Symbol **Schnittstellen** in der Kopfzeile öffnest du das Fenster **NAFI NOVA**, wählst einen Kunden und klickst auf **Öffnen**. NAFI NOVA öffnet sich dann in einem eigenen Browser-Tab. Startest du aus einem geöffneten Kunden, ist er im Fenster schon eingetragen.
- Aus einem Vertrag öffnen: Im geöffneten Vertrag öffnet der Eintrag **Nafi öffnen** NAFI NOVA. i-Planner übermittelt dabei die Kennung des Kunden, zu dem der Vertrag gehört, und zusätzlich die Kennung des Vertrags.
- Zugangsdaten einmal hinterlegen: Deine NAFI-Zugangsdaten legst du als Account unter **Organisation › Accounts** an. i-Planner prüft sie bei NAFI direkt nach dem Anlegen, auf Knopfdruck und bei aktiven Accounts einmal täglich.
- Accounts teilen: Über die **Freischaltung** gibst du einen NAFI-NOVA-Account für Kolleginnen und Kollegen frei. Sie können ihn dann im Fenster **NAFI NOVA** nutzen.

Einen Dokumentenabruf in den Posteingang und einen automatischen Abruf nach Zeitplan gibt es für NAFI NOVA nicht.

Typische Aufgaben:

- Deine Organisation will NAFI NOVA nutzen: [NAFI NOVA einrichten](/organisation/integrationen/datenlieferanten/nafi-nova/uebersicht#nafi-nova-einrichten).
- Du willst den Kfz-Vergleich für einen Kunden starten: [NAFI NOVA für einen Kunden öffnen](/organisation/integrationen/datenlieferanten/nafi-nova/oeffnen#nafi-nova-kunden-oeffnen).
- Dein NAFI-Passwort hat sich geändert: [Ein geändertes NAFI-Passwort eintragen](/organisation/integrationen/datenlieferanten/nafi-nova/uebersicht#passwort-geaendert).
- Eine Kollegin soll deinen Account nutzen: [NAFI-NOVA-Account mit Kolleginnen und Kollegen teilen](/organisation/integrationen/datenlieferanten/nafi-nova/uebersicht#nafi-nova-account-kolleginnen-kollegen).
- Das Fenster zeigt nur einen Hinweis, oder der Tab bleibt leer: [Fehlerbehebung](/organisation/integrationen/datenlieferanten/nafi-nova/fehlerbehebung).

## Voraussetzungen {#voraussetzungen}

- Zum Aktivieren und zum Festlegen der Freigabe unter **Organisation › Integrationen** braucht deine Benutzerrolle das Recht **Integrationen**. Zum Anlegen des NAFI-NOVA-Accounts unter **Organisation › Accounts** braucht sie das Recht **Accounts**. Beide Rechte stehen im Rollen-Editor im Block **Organisation**.
- NAFI NOVA ist unter **Organisation › Integrationen** aktiviert. Sonst erscheint die Kachel **NAFI NOVA** in der **Kundenverwaltung** nicht, und es lässt sich kein NAFI-NOVA-Account anlegen.
- Du bist für NAFI NOVA freigegeben. Voreingestellt ist bei **Freigabe** die Auswahl **Alle Mitarbeiter**.
- Du hast deine NAFI-Zugangsdaten zur Hand: **Client Secret** (dein Maklerkey bei NAFI), **Company Username** (deine Externe ID bei NAFI), **Benutzername** und **Passwort**.
- Für das Fenster **NAFI NOVA** brauchst du mindestens einen aktiven NAFI-NOVA-Account mit dem Status **Verbunden**. Das kann dein eigener sein oder einer, den jemand für dich freigeschaltet hat.
- Für **Nafi öffnen** im Vertrag brauchst du einen eigenen aktiven NAFI-NOVA-Account. Accounts, die Kollegen für dich freigeschaltet haben, zählen dort nicht.

## NAFI NOVA einrichten {#nafi-nova-einrichten}

Die Einrichtung hat zwei Teile. Zuerst aktivierst du NAFI NOVA unter **Organisation › Integrationen**. Danach hinterlegst du die NAFI-Zugangsdaten unter **Organisation › Accounts** als Account.

### NAFI NOVA aktivieren

1. Öffne **Organisation › Integrationen** und klicke in der Liste **Entdecken › Alle** auf **NAFI NOVA**.
2. Schalte im Bereich **Aktivierung** den Schalter **Integration aktivieren** ein. Die Änderung wird sofort gespeichert, einen **Speichern**-Knopf gibt es nicht.

*Animation: Die Detailseite von NAFI NOVA mit Logo, Kennzeichen Official, der Beschreibung Kfz-Vergleichsrechner für Versicherungsmakler und den Angaben Built by NAFI und Website nafi.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. Lege im Bereich **Einschränkungen** unter **Freigabe** fest, wer NAFI NOVA nutzen darf: **Alle Mitarbeiter** (Voreinstellung) oder **Nur ausgewählte Mitarbeiter**. Der Bereich erscheint erst nach dem Aktivieren. Bei **Nur ausgewählte Mitarbeiter** wählst du im Bereich **Ausgewählte Mitarbeiter** die Rollen, Gruppen und Personen aus. Einzelheiten stehen unter **Organisation › Integrationen** im Abschnitt [Wer die Integration nutzen darf](/organisation/integrationen/uebersicht#wer-integration-nutzen-darf).

### NAFI-NOVA-Account anlegen

1. Öffne **Organisation › Accounts**, klicke auf **Neuer Account** und wähle **NAFI NOVA**. Angeboten werden nur aktivierte Integrationen, die für dich freigegeben sind. Mit dem Recht **Integrationen** siehst du alle aktivierten, auch ohne Freigabe.
2. Trage unter **Stammdaten** einen **Namen** ein.
3. Fülle unter **Zugangsdaten** die Felder **Benutzername**, **Passwort**, **Client Secret** und **Company Username** aus.
4. Klicke auf **Account anlegen**. i-Planner meldet „Account erstellt“ und prüft die Zugangsdaten sofort bei NAFI. Wie du das Ergebnis liest, steht im Abschnitt [Verbindung zu NAFI prüfen](/organisation/integrationen/datenlieferanten/nafi-nova/uebersicht#verbindung-nafi-pruefen).

| Feld | Pflicht | Was eintragen |
|---|---|---|
| **Name** | Ja | Frei wählbarer Anzeigename für diesen Account. Ohne Namen meldet das Formular „Name ist erforderlich“. |
| **Accountinhaber** | Ja | Das Teammitglied, dem der Account gehört. Nur sichtbar, wenn deine Benutzerrolle Accounts anderen zuweisen darf. Voreingestellt bist du selbst. |
| **Benutzername** | Ja | Dein Login-Name bei NAFI NOVA. Das Formular lässt das Feld auch leer zu. Die Verbindungsprüfung meldet dann aber „username required“. |
| **Passwort** (geheim) | Ja | Dein NAFI-Passwort zum **Benutzernamen**. Der Hinweis unter dem Feld spricht von einem Postfach, gemeint ist trotzdem das NAFI-Passwort. Ohne Eingabe meldet das Formular „Passwort ist erforderlich“. |
| **Client Secret** (geheim) | Ja | Dein Maklerkey bei NAFI. Fehlt er, meldet die Verbindungsprüfung „client_secret required“. |
| **Company Username** | Nein | Deine Externe ID bei NAFI, also Agenturnummer oder Vermittler-ID. i-Planner verlangt sie nicht, gibt sie bei der Anmeldung aber mit **Benutzername** und **Passwort** an NAFI weiter. |

**Passwort** und **Client Secret** sind geheim. Die Eingabe ist verdeckt, der Wert wird verschlüsselt gespeichert und später nicht mehr im Klartext angezeigt. Beim Bearbeiten ist ein solches Feld leer. Als Platzhalter stehen nur Punkte und höchstens die letzten vier Zeichen. Lässt du es leer, bleibt der gespeicherte Wert erhalten, eine Eingabe ersetzt ihn.

## Verbindung zu NAFI prüfen {#verbindung-nafi-pruefen}

i-Planner prüft die Zugangsdaten eines NAFI-NOVA-Accounts direkt nach **Account anlegen** und bei aktiven Accounts einmal täglich automatisch. Von Hand startest du die Prüfung so:

1. Öffne den NAFI-NOVA-Account unter **Organisation › Accounts**.
2. Klicke im Bereich **Verbindung** auf **Verbindung prüfen**.

Das Ergebnis steht oben auf der Account-Seite:

| Anzeige | Bedeutung |
|---|---|
| **Verbunden** mit Datum und Uhrzeit der Prüfung. Direkt nach der Prüfung meldet i-Planner **Verbindung erfolgreich**. | NAFI hat die Zugangsdaten angenommen. Ist der Account aktiv, reicht er, damit sich das Fenster **NAFI NOVA** nutzen lässt. |
| Rote Fehlermeldung. Direkt nach der Prüfung öffnet sich das Fenster **Validierung fehlgeschlagen** mit derselben Meldung. | Die Anmeldung bei NAFI ist fehlgeschlagen. Was die Meldungen bedeuten, steht unter [Die Prüfung meldet „Validierung fehlgeschlagen“](/organisation/integrationen/datenlieferanten/nafi-nova/fehlerbehebung#validierung-fehlgeschlagen). |
| **Nicht geprüft** | Die Zugangsdaten dieses Accounts wurden noch nicht geprüft. |

Ist NAFI während der Prüfung nicht erreichbar, bleibt der Status unverändert. Versetzt die tägliche Prüfung einen Account in den Fehlerstatus, bekommt der **Accountinhaber** die Benachrichtigung „Verbindung fehlgeschlagen: …“ mit dem Grund. Steht der Account schon auf Fehler, kommt keine weitere.

::callout
---
color: amber
icon: i-heroicons-exclamation-triangle
---
Das Fenster **NAFI NOVA** lässt sich nur nutzen, wenn dir mindestens ein aktiver NAFI-NOVA-Account mit dem Status **Verbunden** zur Verfügung steht. Lehnt NAFI bei der täglichen Prüfung deinen einzigen solchen Account ab, bleibt das Fenster gesperrt. Das ändert sich erst, wenn die **Zugangsdaten** unter **Organisation › Accounts** korrigiert und mit **Verbindung prüfen** erneut geprüft sind.
::

## Ein geändertes NAFI-Passwort eintragen {#passwort-geaendert}

Öffne den NAFI-NOVA-Account unter **Organisation › Accounts** und trage unter **Zugangsdaten** im Feld **Passwort** das neue Passwort ein. Klicke dann im Bereich **Verbindung** auf **Verbindung prüfen**. Das Feld **Passwort** ist beim Öffnen leer. Neben ihm steht ein Hinweis-Symbol mit dem Text „Gespeichert — aus Sicherheit nicht erneut anzeigbar. Leer lassen behält ihn, eine Eingabe ersetzt ihn.“ Einen **Speichern**-Knopf gibt es auf der Account-Seite nicht. Wie dort gespeichert wird, steht unter **Organisation › Accounts** im Abschnitt [Einen Account bearbeiten](/organisation/accounts/bearbeiten#account-bearbeiten).

## NAFI-NOVA-Account mit Kolleginnen und Kollegen teilen {#nafi-nova-account-kolleginnen-kollegen}

Ein NAFI-NOVA-Account ist zunächst nur für seinen **Accountinhaber** freigeschaltet. So gibst du ihn für weitere Mitarbeiter frei:

1. Öffne unter **Organisation › Accounts** den NAFI-NOVA-Account.
2. Wähle im Bereich **Freischaltung** eine der Möglichkeiten **Alle Mitarbeiter**, **Nur das Team des Accountinhabers**, **Nur der Accountinhaber** (Voreinstellung) oder **Accountinhaber + ausgewählte**.

Freigeschaltete Mitarbeiter können den Account im Fenster **NAFI NOVA** nutzen. i-Planner verwendet dann die Zugangsdaten dieses Accounts. Stehen ihnen mehrere Accounts zur Verfügung, wählen sie ihn im Fenster unter **Account** aus. Für **Nafi öffnen** im Vertrag zählt ein freigeschalteter Account nicht. Wer den Account nutzen soll, muss außerdem für NAFI NOVA freigegeben sein. Wie die vier Möglichkeiten im Einzelnen wirken, steht unter **Organisation › Accounts** im Abschnitt [Einen Account für Kolleginnen und Kollegen freischalten](/organisation/accounts/bearbeiten#account-kolleginnen-kollegen-freischalten).

## Einen NAFI-NOVA-Account löschen {#account-loeschen}

Öffne den NAFI-NOVA-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 **Organisation › Accounts** im Abschnitt [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 NAFI-NOVA-Account nur vorübergehend nicht nutzen, schalte stattdessen **Account aktiv** aus.
::

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

::faq
  :::faq-item{question="Was trage ich bei „Client Secret“ und „Company Username“ ein?"}
  - **Client Secret**: deinen Maklerkey bei NAFI. Damit meldet sich i-Planner im ersten Schritt bei NAFI NOVA an.
  - **Company Username**: deine Externe ID bei NAFI, also deine Agenturnummer oder Vermittler-ID. i-Planner gibt sie im zweiten Anmeldeschritt zusammen mit **Benutzername** und **Passwort** an NAFI weiter.

  **Client Secret** ist ein geheimes Feld. Die Eingabe ist verdeckt, und nach dem Speichern wird der Wert nicht mehr im Klartext angezeigt. **Company Username** bleibt lesbar.
  :::

  :::faq-item{question="Welches Passwort gehört in das Feld „Passwort“?"}
  Dein Passwort bei NAFI NOVA, passend zum **Benutzernamen**. Unter dem Feld steht zwar „Passwort bzw. App-Passwort des Postfachs.“ Das ist aber ein allgemeiner Text, der nicht für NAFI NOVA geschrieben ist. Ein Postfach ist bei NAFI NOVA nicht gemeint.
  :::

  :::faq-item{question="Kann eine Kollegin meinen NAFI-NOVA-Account mitbenutzen?"}
  Ja, im Fenster **NAFI NOVA**. Öffne den Account unter **Organisation › Accounts** und stelle im Bereich **Freischaltung** auf **Alle Mitarbeiter**, **Nur das Team des Accountinhabers** oder **Accountinhaber + ausgewählte**. i-Planner verwendet dann beim Öffnen die Zugangsdaten deines Accounts. Stehen der Kollegin mehrere Accounts zur Verfügung, wählt sie deinen im Fenster unter **Account** aus. Ist es ihr einziger, nimmt i-Planner ihn ohne Auswahl. Für **Nafi öffnen** im Vertrag braucht sie dagegen einen eigenen NAFI-NOVA-Account. Außerdem muss sie für NAFI NOVA freigegeben sein.
  :::

  :::faq-item{question="Ich habe NAFI NOVA deaktiviert. Sind die Accounts jetzt stillgelegt?"}
  Nein. Das Info-Symbol am Schalter **Integration aktivieren** zeigt dazu den 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.“ Nach dem Deaktivieren fehlt die Kachel **NAFI NOVA** in der Kundenverwaltung. Aktive NAFI-NOVA-Accounts prüft i-Planner aber weiter täglich. Im Vertrag bleibt **Nafi öffnen** außerdem für alle sichtbar, die einen eigenen aktiven NAFI-NOVA-Account haben. Das endet erst, wenn diese Accounts deaktiviert sind. Den Schalter **Alle Accounts deaktivieren** zeigt die Detailseite von NAFI NOVA erst, wenn Accounts verknüpft sind und die Integration deaktiviert ist. Schaltest du ihn ein, erhalten die Inhaber der dabei ausgeschalteten NAFI-NOVA-Accounts die Benachrichtigung **Accounts deaktiviert**. Was er bewirkt, steht unter **Organisation › Integrationen** im Abschnitt [Alle Accounts einer Integration stilllegen](/organisation/integrationen/uebersicht#accounts-integration-stilllegen).
  :::
::

## Weitere Themen {#weitere-themen}

- [NAFI NOVA öffnen](/organisation/integrationen/datenlieferanten/nafi-nova/oeffnen): NAFI NOVA für einen Kunden oder aus einem Vertrag öffnen.
- [Fehlerbehebung](/organisation/integrationen/datenlieferanten/nafi-nova/fehlerbehebung): wenn die Prüfung scheitert, die Kachel fehlt oder der Tab leer bleibt.
- [Accounts](/organisation/accounts/uebersicht): die Verbindung prüfen, einen Account freischalten oder löschen.
- [Wer die Integration nutzen darf](/organisation/integrationen/uebersicht#wer-integration-nutzen-darf): die Freigabe für Rollen, Gruppen und Personen.