Configuration des rôles et des autorisations pour l’intégration de Payhawk à D365 Finance

Prev Next

Avant de connecter Payhawk à Microsoft Dynamics 365 Finance, assurez-vous que les accès et paramètres suivants sont en place.

Ce dont vous avez besoin

  • Un accès administrateur à Microsoft Lifecycle Services (LCS), pour installer l’extension Payhawk sur votre environnement Microsoft Dynamics 365 Finance. Pour plus d’informations, consultez l’installation de l’extension Payhawk.

  • Un compte Microsoft Dynamics 365 Finance disposant d’un accès administrateur. Ce compte est utilisé pour s’authentifier lors de la connexion des deux systèmes. Le rôle System administrator est l’option la plus simple, mais un rôle personnalisé couvrant l’extension Payhawk convient également.

Azure et Microsoft Entra ID

Votre équipe informatique n’a pas besoin de créer ni de gérer une inscription d’application dans votre locataire Azure. Payhawk se connecte via sa propre application Azure, que Payhawk inscrit et gère dans son propre locataire Microsoft Entra.

Votre équipe informatique n’a pas besoin de :

  • Créer une inscription d’application

  • Générer un secret client ou un certificat

  • Configurer des URI de redirection ou des autorisations d’API

  • Inscrire une application sous System administration > Setup > Microsoft Entra applications dans Microsoft Dynamics 365 Finance

Si votre locataire n’autorise pas les utilisateurs à donner leur consentement à des applications tierces, Microsoft affiche une demande d’approbation lorsque le compte s’authentifie lors de la connexion. Un administrateur Microsoft Entra l’approuve une seule fois. Aucune autre configuration Azure n’est nécessaire.

Détails techniques pour votre équipe informatique :

  • Propriétaire de l’application - Payhawk, inscrite et gérée dans le propre locataire Microsoft Entra de Payhawk

  • Autorité - https://login.microsoftonline.com/common/oauth2/v2.0

  • Type d’octroi - Code d’autorisation OAuth 2.0, délégué (au nom de l’utilisateur connecté)

  • Étendues demandées - https://<your environment URL>/.default et offline_access

  • URI de redirection - https://microsoft-dynamics-fo-adapter.payhawk.com/callback

  • Données accessibles à Payhawk - Uniquement votre environnement Microsoft Dynamics 365 Finance, dans les limites des rôles de sécurité du compte qui s’authentifie

  • Identifiants stockés par Payhawk - Jetons OAuth uniquement, aucun mot de passe

Le compte d’intégration

Dans Microsoft Dynamics 365 Finance, Payhawk agit au nom du compte qui s’authentifie lors de la connexion. Chaque enregistrement créé par Payhawk peut être rattaché à ce compte dans la piste d’audit de Microsoft Dynamics 365 Finance.

Nous recommandons d’utiliser un compte dédié, par exemple payhawk.integration@yourcompany.com, plutôt que le compte d’une personne, afin que la connexion continue de fonctionner lorsque des personnes quittent l’entreprise ou changent de rôle. Le compte doit :

  • Exister dans votre Microsoft Entra ID.

  • Être activé dans Microsoft Dynamics 365 Finance avec un accès à l’entité juridique que vous connectez.

  • Pouvoir effectuer une connexion interactive une première fois.

Payhawk utilise ce compte pour :

  • Accéder aux dimensions financières

  • Accéder aux taux d'imposition

  • Accéder aux fournisseurs

  • Accéder aux codes GL/projets

  • Créer des en-têtes de journal

  • Créer des entrées de journal

  • Ajouter des pièces jointes

Si le compte est désactivé, si son mot de passe est réinitialisé ou si ses sessions sont révoquées, la connexion s’interrompt. Pour la rétablir, un administrateur Payhawk se reconnecte depuis Paramètres > Intégrations.

Après la première connexion, Payhawk renouvelle son accès en arrière-plan depuis ses propres serveurs. Les stratégies d’accès conditionnel qui exigent une authentification multifacteur (MFA) répétée, une fréquence de connexion courte, un appareil conforme ou un réseau approuvé bloquent ces renouvellements et interrompent la connexion. Excluez le compte d’intégration de ces stratégies ou autorisez-y l’application Payhawk.

Paramètres dans Microsoft Dynamics 365 Finance

Les journaux et les paramètres de comptabilisation ne font pas partie de l’assistant de connexion Payhawk. Vous les définissez sur la page Payhawk Parameters de Microsoft Dynamics 365 Finance, installée avec l’extension :

  • Journal des paiements fournisseur

  • Journaux généraux et du grand livre

  • Journal des dépôts

  • Mode de paiement par défaut

  • Compte de frais

  • Groupe de taxe

  • Types de transactions bancaires

Vous pouvez connecter les deux systèmes avant de les renseigner, mais les exports vers Microsoft Dynamics 365 Finance échouent tant que ce n’est pas fait. Pour plus d’informations, consultez la configuration de l’extension Payhawk.

Avant la connexion

  • L’extension Payhawk est installée, et la page Payhawk Parameters s’ouvre et est renseignée.

  • La personne disposant de l’accès administrateur à Microsoft Dynamics 365 Finance est disponible pour s’authentifier lors de la connexion.

  • Un administrateur Payhawk est disponible pour effectuer la connexion. Il peut s’agir de la même personne.

  • Vous disposez de l’URL de votre environnement Microsoft Dynamics 365 Finance. Elle se termine par .dynamics.com, par exemple contoso.operations.dynamics.com.

  • Votre équipe financière a choisi la structure des dimensions financières.

Pour la configuration au moment de la connexion, il vous faudra :

  1. Effectuer l’authentification.

  2. Mettre en correspondance les comptes.

  3. Effectuer la synchronisation initiale des données.

Étapes suivantes