L'intégration Perk Spend connecte Perk à Microsoft Dynamics 365 Finance (D365 Finance) afin que les objets de coûts, les étiquettes, les catégories, les fournisseurs et les employés soient automatiquement synchronisés, et que les dépenses et les factures soient exportées vers l'entité juridique appropriée. Cet article vous guide tout au long de la configuration, de l'enregistrement de l'application dans Entra ID ou AD FS à la vérification de la première synchronisation.

Pour plus d'informations sur les éléments synchronisés par l'intégration et sur son fonctionnement, consultez Intégration avec Microsoft Dynamics 365 Finance pour le traitement des dépenses et des factures.

Avant de commencer

La configuration de l'intégration concerne à la fois votre environnement D365 Finance et votre compte Perk. Assurez-vous de respecter les prérequis suivants avant de commencer. Prérequis D365 Finance :

• Une version en service de D365 Finance (et non une version hors service).
• Un système de comptes fournisseurs entièrement fonctionnel module, si vous configurez l'intégration de la facturation.
• Une gestion des dépenses pleinement fonctionnelle module, si vous configurez l'intégration des dépenses.
• Accès à Entra ID (cloud) ou accès AD FS (sur site) pour enregistrer l'application.
• Accès LCS (Lifecycle Services) pour déployer le package d'intégration.
• Les rôles de sécurité D365 Finance appropriés à vos utilisateurs : un rôle de gestionnaire d’intégration pour les administrateurs nécessitant un accès complet à la configuration et un rôle d’agent d’intégration pour les utilisateurs ayant uniquement besoin d’un accès aux opérations courantes. Attribuez ces rôles via Administration système > Utilisateurs de sécurité..

Conditions requises pour bénéficier des avantages :

• Un compte Perk actif.
• Accès administrateur du compte aux Paramètres Intégrations pour configurer les paramètres d'intégration, et pour Personnes attribuer des rôles.
• L'ID client et le secret client de votre ID Entra ou de l'enregistrement de votre application AD FS.

Enregistrez l'application dans Entra ID ou AD FS

L'enregistrement d'une application permet à Perk de disposer d'une identité sécurisée pour se connecter à votre environnement D365 Finance. Commencez par cette étape, car les suivantes nécessiteront l'ID client et le secret client générés. Le système utilisé dépend de votre type de déploiement : cloud (D365 Finance utilise Microsoft Entra ID) et sur site (D365 Finance utilise AD FS). Cloud : enregistrez l'application dans Entra ID

1. Accédez à l'identifiant Microsoft Entra dans le portail Azure, ouvrez les Propriétés et notez l'ID d'annuaire (votre ID de locataire).
2. Accéder à la section Inscriptions à l'application Nouvelle inscription.
3. Saisissez un nom qui identifie l'application externe, par exemple Intégration des avantagesVous n'avez pas besoin de définir d'URI de redirection : cette application s'authentifie en tant que client confidentiel à l'aide d'un secret client, et non par le biais d'une redirection de connexion.
4. Copiez l'ID de l'application (client) — vous en aurez besoin dans les étapes suivantes.
5. Configurer les autorisations API : sélectionnez Ajouter une autorisation Autorisations déléguées Microsoft Dynamics ERP (Microsoft.ERP), puis sélectionnez Accéder au service personnalisé Dynamics AX, Accéder aux données Dynamics AXet Accédez à Dynamics AX en ligne en tant qu'utilisateurs de l'organisation.
6. Générer un secret client : accédez à Certificats et secrets > Nouveau secret client et définissez la durée d’expiration sur la période la plus longue autorisée par la politique de sécurité de votre organisation.

Sur site : enregistrez l’application dans AD FS Si votre environnement D365 Finance est sur site, enregistrez l'application auprès d'AD FS plutôt qu'Entra ID. L'enregistrement auprès d'AD FS est spécifique à votre déploiement sur site ; suivez donc les instructions de Microsoft. documentation de déploiement sur site et la configuration AD FS de votre organisation pour enregistrer l'application et générer un ID client et un secret client pour celle-ci.

Enregistrez l'application dans Dynamics 365 Finance

D365 Finance a besoin de son propre enregistrement de l'identifiant Entra ou de l'application AD FS avant de pouvoir accepter les appels de Perk. Cela permet de lier l'identifiant client à un compte de service au sein de D365 Finance.

1. Accédez à Administration système Configuration des applications Microsoft Entra ID Nouvelles.
2. Saisissez l'ID client figurant sur votre identifiant Entra ou lors de l'enregistrement de votre application AD FS.
3. Saisissez un nom pour l'application.
4. Sélectionnez l'identifiant utilisateur approprié pour le compte de service.
5. Sauvegardez l'enregistrement.

Installez le package d'intégration via Lifecycle Services

L'intégration est fournie sous forme de package déployable que vous téléchargez et appliquez via Lifecycle Services (LCS), puis que vous promouvez de l'environnement de test à l'environnement de production. Cette étape installe le code qui alimente l'intégration dans D365 Finance. Partie 1 : Télécharger le package sur LCS

1. Connectez-vous à lcs.dynamics.com.
2. Sélectionnez le projet correspondant à votre environnement cible.
3. Accéder à Plus d'outils Bibliothèque de ressources Package logiciel déployable.
4. Sélectionnez + pour ajouter un nouveau colis, puis saisissez un nom et une description.
5. Sélectionnez Ajouter un fichier et téléchargez le fichier ZIP du package d'intégration.
6. Sélectionnez Confirmer pour traiter le téléchargement et attendez la validation ; une coche apparaîtra dans la colonne Valide une fois la validation terminée.

Partie 2 : Appliquez le package à votre environnement

1. Ouvrez la page des détails de l'environnement.
2. Accédez à Maintenance Appliquer les mises à jour.
3. Veuillez saisir un nom unique pour la mise à jour.
4. Sélectionnez le paquet téléchargé dans la liste.
5. Sélectionnez Appliquer et suivez l'évolution de l'état : En attente, En cours de traitement, Après traitement, puis Déployé.

Partie 3 : Déploiement de la mise à jour en production

1. Dans l'environnement de test, accédez à Historique des modifications de l'environnement.
2. Sélectionnez la mise à jour validée.
3. Sélectionner Marquer comme candidat à la publication.
4. Dans l'environnement de production, accédez à Maintenir et mettre à jour l'environnement.
5. Sélectionnez le bac à sable source et la version candidate.
6. Planifiez la période d'indisponibilité et sélectionnez « Planifier ».

Configurer les paramètres d'intégration dans Dynamics 365 Finance

Les paramètres d'intégration indiquent à D365 Finance avec quelle organisation Perk et quelles entités juridiques se synchroniser, ainsi que les dimensions financières et les données fiscales à inclure. Configurez-les à trois niveaux : système, entité juridique et paramètres d'intégration globaux.

1. Définir les paramètres système : accédez à Administration système Paramètres systèmeOuvrez l'onglet Général, trouvez la section Intégration et saisissez l'ID de l'organisation Perk.
2. Définir les paramètres de l'entité juridique : accédez à Administration de l'organisation Organisations Entités juridiquesPour chaque entité juridique utilisant l'intégration, ouvrez la fiche, repérez la section d'intégration dans l'onglet Général et saisissez l'identifiant de l'entité juridique Perk.
3. Définir les paramètres d'intégration globaux : accédez à la zone de configuration des paramètres d'intégration sous Administration de l'organisation et configurez les éléments suivants.
   • Dans l'onglet Général, définissez le type de document utilisé pour la création de pièces jointes via l'intégration.
   • Dans l'onglet Dimension financière, définissez le nom de la dimension financière qui représente les centres de coûts, puis déplacez les dimensions que vous souhaitez synchroniser dans la zone Sélectionnée.
   • Dans l'onglet Taux de taxe, sélectionnez les groupes de taxes de vente et les groupes de taxes sur les articles que vous souhaitez synchroniser. Seules les combinaisons que vous configurez ici seront synchronisées avec Perk.

Configurer les points de terminaison des événements d'entreprise

Les événements métiers déclenchent la synchronisation des données en temps réel entre D365 Finance et Perk. Vous configurez un point de terminaison pour la plupart des données et activez les événements métiers individuels dont vous avez besoin.

1. Accédez à Administration système Événements professionnels Catalogue des événements professionnels Onglet Points de terminaison Nouveau.
2. Définissez le type de point de terminaison sur connecteur Spendet donnez-lui un nom (par exemple Point de terminaison d'intégration des avantages) et description.
3. Saisissez les URL d'authentification et de point de terminaison pour votre environnement (voir ci-dessous).
4. Ajoutez l'en-tête X-Yk-Auth-Method:yokoy Exactement comme indiqué — il s'agit d'un en-tête technique fixe attendu par le package d'intégration, et non d'un nom d'affichage.
5. Saisissez l'ID client Perk et le secret client Perk (générés dans Outils de développement Outils de gestion des dépenses Identifiants d'accès).

URL des points de terminaison pour l'environnement de test :

• Point de terminaison d'authentification : https://accounts.test.yokoy.ai/oauth2/token
• Point de terminaison des données maîtres : https://api.test.yokoy.ai/v1
• Point de terminaison du fournisseur : https://service.test.yokoy.ai/microsoft-dynamics-service/api/eu/public/be-terna/v1

URL des points de terminaison pour l'environnement de production :

• Point de terminaison d'authentification : https://accounts.yokoy.ai/oauth2/token
• Point de terminaison des données maîtres : https://api.yokoy.ai/v1
• Point de terminaison du fournisseur : https://service.yokoy.ai/microsoft-dynamics-service/api/eu/public/be-terna/v1

Une fois votre point de terminaison configuré, activez les événements professionnels dont vous avez besoin dans le catalogue des événements professionnels :

• Pour l'intégration des factures : l'événement des données du fournisseur, l'événement de la dimension du centre de coûts, l'événement des autres dimensions financières, l'événement des catégories d'approvisionnement, l'événement de confirmation de commande, l'événement de réception des produits de la commande, l'événement des conditions de paiement et l'événement du taux de taxe.
• Pour l'intégration des dépenses : les événements relatifs aux données des employés, aux catégories de dépenses et aux projets sont partagés entre les deux intégrations. Les événements relatifs aux centres de coûts et aux autres dimensions financières sont également partagés.

Vous pouvez activer des événements métier sans spécifier d'entité juridique ; ils se déclenchent pour chaque entité juridique disposant de la configuration d'intégration requise.

Exécuter la synchronisation initiale des données

Avant d'activer la synchronisation automatique continue, exécutez des traitements par lots ponctuels pour importer vos données de référence existantes de D365 Finance vers Perk. Vous trouverez ces traitements par lots dans la section « Traitement par lots » de l'intégration, sous « Administration de l'organisation ». Exécutez les traitements par lots suivants :

• Employés, catégories de dépenses et projets, si vous configurez l'intégration des dépenses.
• Synchronisation des dimensions financières pour les centres de coûts et autres dimensions financières en tant que champs personnalisés.
• Les fournisseurs, utilisant le point de terminaison fournisseur approprié, avec Envoyer une requête de test Désactivé. (traitement des factures uniquement)
• Les catégories d'approvisionnement nécessitent au préalable la mise en place d'associations de rôles hiérarchiques. (traitement des factures uniquement)
• Les taux d'imposition, que vous devriez programmer pour s'exécuter de manière récurrente, par exemple toutes les dix minutes, sont synchronisés uniquement par traitement par lots et non par événements commerciaux.
• Les commandes d'achat ne sont synchronisées que si elles sont confirmées et qu'un journal de confirmation existe déjà. (Traitement des factures uniquement)
• Conditions de paiement, basées sur des requêtes et prenant en charge le filtrage. (traitement des factures uniquement)
• Reçus de produits.

Configurez l'intégration dans Perk

Une fois D365 Finance configuré, terminez la configuration côté Perk : liez vos entités juridiques et configurez l’exportation des dépenses et des factures.

1. Configurer le code de l'entreprise : accédez à Paramètres Compte Entreprise Paramètres de dépenses Général, et saisissez l'identifiant de l'entité juridique D365 Finance dans Code société (ERP) pour chaque entité juridique Perk. Cela garantit que les dépenses et les factures sont exportées vers l'entité juridique D365 Finance appropriée.
2. Configurez deux champs techniques personnalisés sur l'objet de coût, utilisés pour la synchronisation des centres de coûts et des projets. Accédez à Paramètres > Compte > Sociétés > Paramètres de dépenses et cliquez sur Ajouter un champ personnalisé Centres de coûts:

1. Configurer l'exportation des dépenses : accédez à Paramètres > Intégrations > Exportation des dépenses, sélectionnez Finances et opérations Dans la liste des systèmes ERP, saisissez l'ID client et le secret client issus de votre identifiant Entra ou de l'enregistrement de votre application AD FS, puis sélectionnez Mettre à jour l'ERP. pour enregistrer les informations d'identification. Ensuite, définissez l'URL du jeton et l'URL de base (l'URL de votre environnement D365 Finance) :
   • Nuage: L'URL du jeton est https://login.microsoftonline.com/{tenant-id}jeton OAuth2, remplaçant {tenant-id} avec votre identifiant Entra ID. L'URL de base est l'URL de votre environnement cloud, par exemple : https://votre-entreprise.opérations.dynamics.com.
   • Sur siteL'URL du jeton correspond au point de terminaison du jeton de votre serveur AD FS et non à login.microsoftonline.com. Obtenez cette information auprès de votre équipe d'administration réseau ou AD FS. L'URL de base correspond à l'URL de votre serveur local, par exemple : https://votre-serveur-msd365f.votre-domaine.com.

Vous pouvez activer l'option Envoyer des documents. Pour envoyer les reçus et les pièces jointes, Soumettre une note de frais dans le service Finances et Opérations Pour soumettre automatiquement les dépenses au flux de travail D365 Finance, Inclure la taxe dans Finance et Opérations Pour exporter les champs des groupes de taxes et configurer le mappage des modes de paiement, répétez cette opération pour chaque type de dépense : frais remboursables, transactions et frais de déplacement.

1. Configurer l'exportation des factures : accédez à Paramètres > Intégrations > Exportation des factures, sélectionnez Finances et opérations > Exporter les factures fournisseursDans l'onglet Configuration, saisissez l'URL du jeton et l'URL de base en respectant le même format que pour l'exportation des dépenses (cloud ou sur site, selon votre déploiement). Vous pouvez également activer l'option Envoyer les documents. et Saisir la facture dans la section Finance et Opérations Pour automatiser la facturation, dans l'onglet Autorisation, saisissez l'ID client et le code secret client, puis sélectionnez Enregistrer pour terminer l'assistant.
2. Si vous utilisez des dimensions financières comme champs personnalisés, consultez Paramètres > Gestion des coûts > Champs personnalisés pour voir vos champs personnalisés synchronisés.

Vérifiez la synchronisation

Après la synchronisation initiale, vérifiez que les données ont bien été importées dans Perk avant la mise en production. Contrôlez les points suivants :

• Paramètres Gestion des coûts Objets de coûts, pour les centres de coûts et les projets.
• Paramètres Gestion des coûts Champs personnalisés, pour les dimensions financières.
• Paramètres des dépenses Catégories de dépenses, pour les catégories de dépenses.
• Paramètres > Factures fournisseurs > Catégories de factures, pour les catégories d'approvisionnement.
• Les gens, pour les travailleurs et les utilisateurs.
• Factures des fournisseurs, pour les vendeurs.

Si l'une de ces zones semble vide ou incomplète, revenez en arrière et vérifiez le traitement par lots ou l'événement métier correspondant des étapes précédentes avant de déployer l'intégration auprès de votre équipe élargie.

Résoudre les problèmes de configuration

Voici quelques problèmes potentiels que vous pourriez rencontrer et comment les résoudre.

Les événements professionnels n'atteignent pas Perk

• Vérifiez que l'événement métier est activé dans Administration système Événements métier.
• Vérifiez la configuration du point de terminaison (URL d'authentification, URL du point de terminaison, informations d'identification).
• Assurez-vous que l'entité juridique possède bien son identifiant d'entité juridique Perk.
• Consultez le journal des événements métier pour détecter les erreurs.

La synchronisation initiale n'a pas transféré les données.

• Vérifiez que les paramètres du traitement par lots sont correctement configurés.
• Vérifiez que le point de terminaison correspond à celui requis pour ce traitement par lots (les fournisseurs utilisent le point de terminaison fournisseur distinct, avec l'option « Envoyer une requête de test » désactivée).
• Assurez-vous que le compte de service dispose des autorisations suffisantes.
• Consultez l'historique des tâches par lots pour obtenir plus de détails sur les erreurs.

Les dépenses ou les factures ne sont pas exportées

• Vérifiez la configuration d'exportation dans Perk (URL du jeton, URL de base, informations d'identification).
• Pour les dépenses, vérifiez que le travailleur dispose d'une connexion utilisateur D365 Finance valide et active (ou d'un délégué qui en dispose).
• Pour les factures, vérifiez que le fournisseur existe bien dans D365 Finance.
• Consultez les journaux d'exportation pour obtenir plus de détails sur les erreurs.

Les taux d'imposition ne sont pas mis à jour.

Les taux d'imposition sont synchronisés via une tâche par lots planifiée, et non en temps réel.

• Vérifiez que le traitement par lots du taux d'imposition est planifié et en cours d'exécution.
• Vérifiez que les combinaisons Groupe de taxes de vente / Groupe de taxes de vente d'articles sont sélectionnées dans les paramètres d'intégration.