Beheben von Authentifizierungsproblemen in Business Central während des Spesenexports

Perk prüft Ihre Business Central-Verbindung vor jedem Spesenexport. Ist die Verbindung ungültig, wird der Export sofort mit einer klaren, aussagekräftigen Fehlermeldung abgebrochen, anstatt stillschweigend mittendrin zu scheitern. Dieser Artikel erläutert die Gründe für mögliche Authentifizierungsfehler und deren Behebung.

Nur Admins können dies ausführen.

Wann und wo Perk Authentifizierungsfehler anzeigt

Perk führt die Überprüfung der Anmeldeinformationen durch, bevor der Export beginnt, sodass der Fehler sofort auftritt, bevor Dokumente an Business Central gesendet werden, und nicht erst nach einem fehlgeschlagenen Versuch.

Manuelle Exporte – Der Fehler wird als Benachrichtigung angezeigt, sobald Sie den Export auslösen. Die Benachrichtigung enthält die genaue Fehlermeldung, sodass Sie sofort reagieren können.
Automatische Exporte – der Fehler wird direkt im Ausgabenbeleg angezeigt, da kein manueller Auslöser für eine Benachrichtigung vorhanden ist. Überprüfen Sie den Ausgabenbeleg, um den Authentifizierungsfehler und die nächsten Schritte einzusehen.

In beiden Fällen wird der Export vollständig blockiert – es gibt keine Teil- oder stillen Fehler – und die angezeigte Meldung entspricht einer der unten aufgeführten Ursachen. Diese Prüfung validiert ausschließlich die Authentifizierung. Folgendes wird nicht erkannt:

Falscher Firmenname, Webdienstname, Instanz oder Basis-URL.
Fehler nach erfolgreicher Authentifizierung, wie z. B. API-Fehler bei der Verbindung von Azure AD mit Business Central.
Stammdatenzuordnungsfehler.

Diese Probleme treten während des Exportvorgangs selbst in Form fehlerhafter Exportdokumente zutage.

Hinweis: Alle diese Probleme führen wie gewohnt zu fehlerhaften Exportdokumenten und sind von dieser Änderung nicht betroffen.

Fehlende Zugangsdaten

Warum das passiert: Die Client-ID oder das Client-Geheimnis für die Business Central-Verbindung wurden in Perk nie gespeichert.

Vorgehensweise: Gehen Sie zu Einstellungen Integrationen Business Central und schließen Sie die Einrichtung der Anmeldeinformationen ab, indem Sie die Client-ID und das Client-Geheimnis eingeben.

Fehlende Azure AD-Mandantenkonfiguration

Warum das passiert:

Cloud Business Central: Das Feld „Tenant-ID“ ist in der ERP-Konfiguration leer.
Lokales Business Central: Die Verzeichnis-ID fehlt in den Anmeldeinformationen.

Was zu tun:

Cloud: Gehen Sie zu Einstellungen Integrationen Business Central [API] und überprüfen Sie die Mandanten-ID in den Integrationseinstellungen.
Lokal: Gehen Sie zu Einstellungen Integrationen Business Central [API] und überprüfen Sie die Verzeichnis-ID im Abschnitt Anmeldeinformationen.

Die Anmeldeinformationen wurden von Azure AD abgelehnt.

Ursache: Azure AD hat die Anmeldeinformationen abgelehnt – die Client-ID oder das Clientgeheimnis sind möglicherweise falsch oder abgelaufen, oder die App-Registrierung in Azure AD wurde gelöscht. Die Fehlermeldung enthält den Azure AD-Fehlercode und eine Beschreibung.

Was zu tun:

Überprüfen Sie den in der Meldung angezeigten Azure AD-Fehlercode.
Gehen Sie zu Einstellungen Integrationen Business Central und stellen Sie die Verbindung mit gültigen Anmeldeinformationen wieder her.
Falls die App-Registrierung gelöscht wurde, erstellen Sie eine neue in Azure AD und aktualisieren Sie die Anmeldeinformationen in Perk.

Netzwerk oder Firewall blockiert den Anmeldedienst von Microsoft

Ursache: Perk kann login.microsoftonline.com nicht erreichen – eine Firewall oder DNS-Konfiguration blockiert die Verbindung. Die Fehlermeldung zeigt den POSIX-Fehlercode (z. B. ECONNREFUSED oder ETIMEDOUT) und den blockierten Endpunkt an.

Was ist zu tun? Wenden Sie sich an Ihren IT- oder Netzwerkadministrator und teilen Sie ihm den Fehlercode und den im Fehlerhinweis angezeigten Endpunkt mit. Stellen Sie sicher, dass login.microsoftonline.com erreichbar ist.

Unerwarteter Fehler bei der Überprüfung der Anmeldeinformationen

Ursache: Während der Überprüfung ist ein unerwarteter Fehler aufgetreten – beispielsweise ein Fehler beim Parsen der Konfiguration oder eine Laufzeitausnahme. Die Fehlermeldung im Original wird angezeigt.

Vorgehensweise: Notieren Sie sich die vollständige Fehlermeldung und wenden Sie sich an den Support. Konfigurationsprobleme von Business Central (z. B. Firmenname oder Webdienstname) werden von dieser Prüfung nicht erkannt und können separat als fehlgeschlagene Exportdokumente auftreten.