# Fehlerbehebung

> Die häufigsten Probleme unter Organisation › Integrationen › NAFI NOVA, geordnet nach dem, was du beobachtest – jeder Abschnitt nennt die Ursache und den nächsten Schritt.

Wie du NAFI NOVA einrichtest und öffnest, steht auf den anderen Seiten unter [NAFI NOVA](/organisation/integrationen/datenlieferanten/nafi-nova).

## NAFI NOVA fehlt bei „Neuer Account“, oder das Anlegen wird abgelehnt {#neuer-account-fehlt}

- Fehlt NAFI NOVA in der Liste bei **Neuer Account** unter **Organisation › Accounts**, ist die Integration nicht aktiviert oder nicht für dich freigegeben. Mit dem Recht **Integrationen** zählt nur die Aktivierung. Die Seite schreibt dazu „Accounts können nur für aktivierte Integrationen angelegt werden.“ Steht dort „Keine Integrationen aktiviert“, ist für dich gar keine Integration verfügbar.
- Erscheint beim Anlegen „Integration nicht verfügbar — bitte zuerst unter Integrationen aktivieren“, ist NAFI NOVA nicht oder nicht mehr aktiviert. Aktiviere die Integration unter **Organisation › Integrationen**.
- Erscheint beim Anlegen „Für diese Integration sind Sie nicht freigegeben.“, stehst du nicht in der **Freigabe** von NAFI NOVA. Eine Person mit dem Recht **Integrationen** wählt dich unter **Ausgewählte Mitarbeiter** aus oder stellt die **Freigabe** auf **Alle Mitarbeiter**.

## Die Prüfung meldet „Validierung fehlgeschlagen“ {#validierung-fehlgeschlagen}

Das Fenster **Validierung fehlgeschlagen** zeigt die Meldung zur Prüfung. Dieselbe Meldung steht danach rot oben auf der Account-Seite unter **Organisation › Accounts**:

| Meldung | Bedeutung |
|---|---|
| „External ID oder User Credentials fehlerhaft.“, gegebenenfalls mit einem Zusatz von NAFI in Klammern | NAFI hat das **Client Secret** angenommen, lehnt aber **Company Username**, **Benutzername** oder **Passwort** ab. |
| „Zugangsdaten fehlerhaft“ oder ein anderer Fehlertext von NAFI | NAFI lehnt schon den ersten Anmeldeschritt mit dem **Client Secret** ab. |
| „client_secret required“, „username required“ oder „password required“ | Im Account fehlt **Client Secret**, **Benutzername** oder **Passwort**. |

Korrigiere den Wert unter **Zugangsdaten** und klicke im Bereich **Verbindung** auf **Verbindung prüfen**. **Passwort** und **Client Secret** sind beim Öffnen des Accounts leer. Lässt du sie leer, bleibt der gespeicherte Wert erhalten, eine Eingabe ersetzt ihn.

## Die Prüfung meldet „Der Anbieter ist momentan nicht erreichbar“ {#anbieter-nicht-erreichbar}

Die vollständige Meldung lautet „Der Anbieter ist momentan nicht erreichbar — bitte später erneut versuchen.“ NAFI NOVA war bei der Verbindungsprüfung nicht erreichbar oder hat mit einem Serverfehler geantwortet. Über deine Zugangsdaten sagt das nichts. Der Status des Accounts bleibt unverändert. Klicke später erneut auf **Verbindung prüfen**. Ähnlich ist die Meldung „Der Validierungsdienst ist gerade nicht erreichbar — bitte später erneut versuchen.“ Dann kam innerhalb von 20 Sekunden keine Antwort vom Prüfdienst von i-Planner, zum Beispiel weil NAFI NOVA so lange für die Anmeldung braucht. Auch dann bleibt der Status unverändert.

## Der NAFI-NOVA-Account steht auf „Nicht geprüft“ {#nicht-geprueft}

Die Zugangsdaten dieses Accounts wurden noch nicht bei NAFI geprüft. Ein solcher Account reicht nicht, damit sich das Fenster **NAFI NOVA** nutzen lässt. Öffne ihn unter **Organisation › Accounts** und klicke im Bereich **Verbindung** auf **Verbindung prüfen**.

## Eine Benachrichtigung meldet „Verbindung fehlgeschlagen“ {#verbindung-fehlgeschlagen}

i-Planner prüft aktive Accounts einmal täglich automatisch. Lehnt NAFI die Zugangsdaten dabei ab, bekommt der **Accountinhaber** diese Benachrichtigung mit dem Namen des Accounts und dem Grund. Darin steht zum Beispiel „Die tägliche Überprüfung des Accounts ist fehlgeschlagen: External ID oder User Credentials fehlerhaft.“ Die Benachrichtigung kommt nur, wenn die tägliche Prüfung den Account in den Fehlerstatus versetzt, nicht an jedem weiteren Tag. Steht dir kein anderer aktiver NAFI-NOVA-Account mit **Verbunden** zur Verfügung, bleibt das Fenster **NAFI NOVA** gesperrt. Das ändert sich erst, wenn die Zugangsdaten korrigiert und neu geprüft sind. Die Benachrichtigung führt zur Account-Seite. Korrigiere dort die **Zugangsdaten** und klicke im Bereich **Verbindung** auf **Verbindung prüfen**.

## Die Kachel „NAFI NOVA“ fehlt in der Kundenverwaltung {#kachel-fehlt}

Die Kachel **NAFI NOVA** hinter dem Symbol **Schnittstellen** erscheint nur, wenn beides zutrifft:

- NAFI NOVA ist unter **Organisation › Integrationen** aktiviert. Auf der Detailseite ist also der Schalter **Integration aktivieren** eingeschaltet.
- Du bist freigegeben. Steht dort im Bereich **Einschränkungen** die **Freigabe** auf **Nur ausgewählte Mitarbeiter**, müssen du selbst, deine Rolle oder eine deiner Gruppen im Bereich **Ausgewählte Mitarbeiter** ausgewählt sein. Das gilt auch, wenn du das Recht **Integrationen** hast.

Einen NAFI-NOVA-Account braucht die Kachel nicht. Fehlt er, zeigt erst das Fenster **NAFI NOVA** einen Hinweis. Das Symbol **Schnittstellen** selbst erscheint nur, wenn für dich mindestens eine Schnittstelle verfügbar ist. Hast du NAFI NOVA gerade erst aktiviert und fehlt das Symbol noch, lade die **Kundenverwaltung** neu.

## Das Fenster meldet „Für diese Schnittstelle ist noch kein Zugang eingerichtet“ {#kein-zugang-eingerichtet}

Die vollständige Meldung lautet „Für diese Schnittstelle ist noch kein Zugang eingerichtet. Bitte hinterlege zunächst deine Zugangsdaten, um sie nutzen zu können.“ Für dich gibt es weder einen eigenen NAFI-NOVA-Account noch einen, den jemand für dich freigeschaltet hat. Das Fenster **NAFI NOVA** zeigt dann nur **Schließen**. Lege unter **Organisation › Accounts** über **Neuer Account** einen NAFI-NOVA-Account an. Dafür braucht deine Benutzerrolle das Recht **Accounts**. Oder bitte den Inhaber eines vorhandenen NAFI-NOVA-Accounts, ihn im Bereich **Freischaltung** für dich freizugeben.

## Das Fenster meldet „Der hinterlegte Zugang ist derzeit nicht gültig“ {#zugang-nicht-gueltig}

Die vollständige Meldung lautet „Der hinterlegte Zugang ist derzeit nicht gültig. Bitte überprüfe deine Zugangsdaten für diese Schnittstelle.“ Es gibt für dich NAFI-NOVA-Accounts, aber keiner davon ist aktiv und steht auf **Verbunden**. Auch ein Account mit **Nicht geprüft** oder mit einer Fehlermeldung zählt hier als ungültig. Öffne den Account unter **Organisation › Accounts** und prüfe, ob der Schalter **Account aktiv** eingeschaltet ist. Korrigiere bei Bedarf die **Zugangsdaten** und klicke im Bereich **Verbindung** auf **Verbindung prüfen**. Gehört der Account einem Kollegen, bitte ihn darum. Sobald oben auf der Account-Seite **Verbunden** steht, öffne das Fenster **NAFI NOVA** erneut.

## Das Fenster meldet „Für diese Schnittstelle bist du nicht freigegeben“ {#nicht-freigegeben}

Die vollständige Meldung lautet „Für diese Schnittstelle bist du nicht freigegeben. Bitte wende dich an deinen Administrator.“ Die **Freigabe** von NAFI NOVA steht auf **Nur ausgewählte Mitarbeiter**, und du gehörst nicht dazu. Das Fenster **NAFI NOVA** zeigt dann nur **Schließen**. Eine Person mit dem Recht **Integrationen** öffnet unter **Organisation › Integrationen** die Detailseite von NAFI NOVA. Dort wählt sie im Bereich **Ausgewählte Mitarbeiter** dich, deine Rolle oder eine deiner Gruppen aus. Oder sie stellt die **Freigabe** auf **Alle Mitarbeiter**.

## Im Fenster „NAFI NOVA“ ist der Kunde nicht zu finden {#kunde-nicht-gefunden}

Das Feld **Kunde suchen** findet nur Kunden, keine Produktpartner und keine Mitarbeiter. Ist die gesuchte Person nicht als Kunde angelegt, lässt sie sich im Fenster **NAFI NOVA** nicht auswählen.

## Nach „Öffnen“ erscheint nur „Bitte wähle einen Kunden aus“ {#kein-kunde-ausgewaehlt}

Im Fenster **NAFI NOVA** ist unter **Kunde** noch kein Kunde eingetragen. Deshalb erscheint „Bitte wähle einen Kunden aus und drücke "Öffnen", um die Daten zu übertragen.“ Suche den Kunden über **Kunde suchen**, oder starte das Fenster aus dem geöffneten Kunden heraus. Dann ist er schon eingetragen.

## Der neue Browser-Tab bleibt nach „Öffnen“ leer {#tab-leer}

Bleibt der neue Browser-Tab leer, ist kein gültiger Link in NAFI NOVA zurückgekommen. Eine Fehlermeldung zeigt i-Planner in diesem Fall nicht. Auf den Link wartet i-Planner höchstens 20 Sekunden. Schließe den leeren Tab und prüfe, welcher Account verwendet wurde. Ohne eigene Auswahl unter **Account** nimmt i-Planner deinen eigenen Account, auch wenn er deaktiviert ist oder seine Verbindungsprüfung fehlgeschlagen ist. Prüfe diesen Account unter **Organisation › Accounts** mit **Verbindung prüfen**. Oder wähle im Fenster **NAFI NOVA** einen Account, der auf **Verbunden** steht, und versuche es erneut.

## Im Vertrag fehlt der Eintrag „Nafi öffnen“ {#nafi-oeffnen-fehlt}

**Nafi öffnen** gibt es nur, wenn du selbst einen aktiven NAFI-NOVA-Account hast. Du musst sein **Accountinhaber** sein, und der Schalter **Account aktiv** muss eingeschaltet sein. Ein Account, den Kollegen für dich freigeschaltet haben, reicht hier nicht, auch wenn er im Fenster **NAFI NOVA** funktioniert. In Vertragsentwürfen fehlt der Eintrag immer. Fehlt im Vertrag das Stecker-Symbol **Schnittstellen** ganz, gibt es dort für dich keinen einzigen Eintrag. Lege dir unter **Organisation › Accounts** einen eigenen NAFI-NOVA-Account an. Oder öffne NAFI NOVA über das Symbol **Schnittstellen** in der Kopfzeile.

## i-Planner meldet „Die Schnittstelle konnte nicht geöffnet werden.“ {#schnittstelle-nicht-geoeffnet}

Die Meldung mit der Überschrift **Achtung** erscheint nach **Nafi öffnen** im Vertrag, wenn kein Link in NAFI NOVA zurückgekommen ist. Der schon geöffnete Tab schließt sich wieder. Eine Ursache nennt i-Planner nicht. Prüfe unter **Organisation › Accounts** mit **Verbindung prüfen**, ob NAFI die Zugangsdaten deines Accounts annimmt. Versuche es danach erneut.

## Weitere Themen {#weitere-themen}

- [NAFI NOVA](/organisation/integrationen/datenlieferanten/nafi-nova/uebersicht): einrichten, Zugangsdaten ändern und Accounts teilen.
- [NAFI NOVA öffnen](/organisation/integrationen/datenlieferanten/nafi-nova/oeffnen): für einen Kunden oder aus einem Vertrag öffnen.
- [Verbindung zu NAFI prüfen](/organisation/integrationen/datenlieferanten/nafi-nova/uebersicht#verbindung-nafi-pruefen): die Zugangsdaten prüfen und das Ergebnis lesen.
- [Wer die Integration nutzen darf](/organisation/integrationen/uebersicht#wer-integration-nutzen-darf): die Freigabe für Rollen, Gruppen und Personen.