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
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.
- Du willst den Kfz-Vergleich für einen Kunden starten: NAFI NOVA für einen Kunden öffnen.
- Dein NAFI-Passwort hat sich geändert: Ein geändertes NAFI-Passwort eintragen.
- Eine Kollegin soll deinen Account nutzen: NAFI-NOVA-Account mit Kolleginnen und Kollegen teilen.
- Das Fenster zeigt nur einen Hinweis, oder der Tab bleibt leer: Fehlerbehebung.
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
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
- Öffne Organisation › Integrationen und klicke in der Liste Entdecken › Alle auf NAFI NOVA.
- Schalte im Bereich Aktivierung den Schalter Integration aktivieren ein. Die Änderung wird sofort gespeichert, einen Speichern-Knopf gibt es nicht.
- 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.
NAFI-NOVA-Account anlegen
- Ö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.
- Trage unter Stammdaten einen Namen ein.
- Fülle unter Zugangsdaten die Felder Benutzername, Passwort, Client Secret und Company Username aus.
- 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.
| 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
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:
- Öffne den NAFI-NOVA-Account unter Organisation › Accounts.
- 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“. |
| 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.
Ein geändertes NAFI-Passwort eintragen
Ö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.
NAFI-NOVA-Account mit Kolleginnen und Kollegen teilen
Ein NAFI-NOVA-Account ist zunächst nur für seinen Accountinhaber freigeschaltet. So gibst du ihn für weitere Mitarbeiter frei:
- Öffne unter Organisation › Accounts den NAFI-NOVA-Account.
- 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.
Einen NAFI-NOVA-Account löschen
Ö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.
Häufige Fragen
- 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.
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.
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.
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.
Weitere Themen
- NAFI NOVA öffnen: NAFI NOVA für einen Kunden oder aus einem Vertrag öffnen.
- Fehlerbehebung: wenn die Prüfung scheitert, die Kachel fehlt oder der Tab leer bleibt.
- Accounts: die Verbindung prüfen, einen Account freischalten oder löschen.
- Wer die Integration nutzen darf: die Freigabe für Rollen, Gruppen und Personen.