Perk vérifie votre connexion à Business Central avant chaque exportation de dépenses. En cas de connexion invalide, l'exportation est immédiatement bloquée et un message d'erreur clair et exploitable s'affiche, au lieu d'échouer silencieusement en cours d'exécution. Cet article explique les raisons pour lesquelles l'authentification peut échouer et comment résoudre chaque problème.

Quand et où Perk affiche des erreurs d'authentification

Perk effectue la vérification des informations d'identification avant le début de l'exportation, de sorte que l'erreur apparaît immédiatement, avant que les documents ne soient envoyés à Business Central, plutôt qu'après une tentative infructueuse.

• Exportations manuelles — L'erreur s'affiche sous forme de notification au moment où vous lancez l'exportation. Cette notification contient le message d'erreur précis afin que vous puissiez intervenir immédiatement.
• Exportations automatiques — L'erreur s'affiche directement sur la note de frais, car aucun déclencheur manuel ne permet d'y associer une notification. Consultez l'enregistrement de la dépense pour connaître l'erreur d'authentification et les étapes suivantes.

Dans les deux cas, l'exportation est totalement bloquée (aucun échec partiel ou silencieux) et le message affiché correspond à l'une des causes ci-dessous. Ce contrôle vérifie uniquement l'authentification. Il ne détecte pas :

• Nom de société, nom de service Web, instance ou URL de base incorrects.
• Erreurs après une authentification réussie, telles que des échecs d'API entre Azure AD et Business Central.
• Erreurs de mappage des données de référence.

Ces problèmes se manifestent par des documents d'exportation défectueux lors de l'exportation elle-même.

Identifiants manquants

Pourquoi cela se produit : L’ID client ou le secret client pour la connexion Business Central n’ont jamais été enregistrés dans Perk.

Que faire : Accédez à Paramètres Intégrations Business Central et terminez la configuration des informations d’identification en saisissant l’ID client et le secret client.

Configuration du locataire Azure AD manquante

Pourquoi cela se produit :

• Cloud Business Central : le champ ID du locataire est vide dans la configuration ERP.
• Business Central sur site : l’identifiant d’annuaire est manquant dans les informations d’identification.

Ce qu'il faut faire:

• Cloud : accédez à Paramètres Intégrations Business Central [API] et vérifiez l’ID du locataire dans les paramètres d’intégration.
• Sur site : accédez à Paramètres Intégrations Business Central [API] et vérifiez l’ID du répertoire dans la section des informations d’identification.

Informations d'identification rejetées par Azure AD

Pourquoi cela se produit-il ? Azure AD a rejeté les informations d’identification : l’ID client ou le secret client est peut-être incorrect ou expiré, ou l’inscription de l’application dans Azure AD a peut-être été supprimée. Le message d’erreur comprend le code d’erreur et la description d’Azure AD.

Ce qu'il faut faire:

1. Vérifiez le code d'erreur Azure AD affiché dans le message.
2. Accédez à Paramètres Intégrations Business Central et reconnectez-vous en utilisant des informations d'identification valides.
3. Si l'enregistrement de l'application a été supprimé, créez-en un nouveau dans Azure AD et mettez à jour les informations d'identification dans Perk.

Réseau ou pare-feu bloquant le service de connexion Microsoft

Pourquoi cela se produit-il : Perk ne parvient pas à se connecter à login.microsoftonline.com : un pare-feu ou une configuration DNS bloque la connexion. L’erreur affiche le code d’erreur POSIX (par exemple, ECONNREFUSED ou ETIMEDOUT) et le point de terminaison bloqué.

Que faire ? Contactez votre administrateur informatique ou réseau et communiquez-lui le code d’erreur et le point de terminaison affichés dans le message. Assurez-vous que login.microsoftonline.com est accessible.

Échec inattendu lors de la vérification des informations d'identification

Pourquoi cela se produit-il : Une erreur inattendue s’est produite lors de la vérification, par exemple une erreur d’analyse de la configuration ou une exception d’exécution. Le message d’erreur brut est affiché.

Que faire : Notez le message d’erreur complet et contactez l’assistance. Les problèmes de configuration de Business Central (tels que le nom de l’entreprise ou le nom du service Web) ne sont pas détectés par cette vérification et peuvent apparaître séparément sous forme de documents d’exportation ayant échoué.