Pour les implémentations de Microsoft Dynamics 365 Business Central Cloud, vous pouvez choisir d'installer le connecteur de gestion des dépenses d'avantages sociaux à partir d'AppSource ou en tant qu'extension.

Prudence: En installant le connecteur Perk comme extension, vous devez savoir qu'il ne bénéficiera pas de mises à jour automatiques incluant de nouvelles fonctionnalités. Il vous incombera d'installer et de gérer vous-même les mises à jour du connecteur Perk.

L'extension doit être enregistrée et configurée auprès de Microsoft Entra pour permettre à Perk d'accéder aux points de terminaison de l'API Business Central.

Pour configurer le connecteur pour Business Central Cloud :

1. Installez l'extension soit depuis le AppSource ou comme une extension.
2. Configurez le service web dans Business Central Cloud.
3. Configurez le connecteur dans Business Central.
4. Configurer l'exportation dans Perk :
   • exportation de dépenses
   • Exportation de factures
5. Synchroniser les données maîtres et transactionnelles.

Installez le connecteur Perk à partir de Microsoft 365 Dynamics App Source

Pour installer le connecteur Perk, recherchez le extension dans AppSource en tapant Avantage et en cliquant Obtenez-le maintenant.

Cela installe l'extension dans votre locataire Microsoft 365 Dynamics Business Central.

Installez le connecteur Perk en tant qu'extension

Pour installer le connecteur Perk en tant qu'extension, vous devez avoir accès au package du connecteur (.app). ouvrir une demande de service pour obtenir l'accès au package de connecteurs.

Une fois que vous aurez accès à ce fichier, vous pourrez procéder à installez l'application en utilisant Gestion de l'extension page.

Le package d'extension utilise ces plages d'identifiants pour les objets listés ci-dessous :

Note: Les plages d'identifiants sont dynamiques et peuvent être influencées par la licence du client.
Si le client utilise ces plages d'identifiants, vous devrez peut-être en attribuer une autre aux objets du package d'extension. Sinon, des conflits risquent de survenir.

Les extensions peuvent être désinstallées automatiquement après une mise à jour de Business Central sans perte de données. Voir Désinstallation de l'extension.

Configurez le service Web dans Business Central pour le Cloud

Étant donné que Business Central est responsable de la récupération des données de Perk, vous devez créer le service Web dans Business Central pour gérer ce processus.

1. Enregistrez une application sur le portail MS Azure.
2. Publiez le service Web sur la page des services Web dans Business Central..
3. Attribuez les autorisations appropriées dans Business Central.

Prudence: Veillez à désactiver l'actualisation du bac à sable si vous installez l'extension dans un environnement de test. Sinon, vous devrez la reconfigurer après chaque actualisation.

Enregistrez une application sur le portail MS Azure

Vous devez d'abord enregistrer une application sur le portail MS Azure pour le connecteur Perk.
Voir Enregistrez une application sur la plateforme d'identité Microsoft. pour vous guider.

Créez la définition de base de l'application en configurant le Aperçu, Authentification, Certificats et secrets, et Autorisation API sections.

Aperçu section:

• Nom de l'applicationConnecteur Perk Business Central
• Application (identifiant client)Copiez cet identifiant, vous en aurez besoin plus tard.

Authentification languette:

Cliquez + Ajouter une plateforme.

1. Sélectionner Web.
2. Entrer URI de redirection:
   • https://businesscentral.dynamics.com/OAuthLanding.htm
   • https://businesscentral.dynamics.com/
   • https://test.yokoy.ai/oauth2/callback (Test d'avantage) ou https://app.yokoy.ai/oauth2/callback (Perk prod)
3. Cliquez sur Enregistrer.

Conseil: Pour ajouter plusieurs URI de redirection, vous devez en ajouter une et cliquer SauvegarderVous pouvez ensuite ajouter le deuxième élément à l'écran principal.

Autorisations API section:

1. Cliquez + Ajouter une autorisation.
2. Sélectionner Dynamics 365 Business Central.
3. Dans Autorisations déléguées, sélectionnez et ajoutez des autorisations :
   • usurpation d'identité de l'utilisateur
   • Finances.ReadWrite.Tout
4. Dans Autorisations de l'application, sélectionnez et ajoutez des autorisations :
   • accès à l'application
   • AdminCenter.ReadWrite.All
   • API.ReadWrite.All
5. Cliquez Accorder le consentement de l'administrateur pour…

Certificats et secrets section:

Créez un nouveau secret client. Nous vous recommandons de définir une durée de validité de 24 mois. Copiez le Valeur et Identifiant secret.

Publiez le service Web dans Business Central.

Entrer "Applications Microsoft Entra« » dans l’outil de recherche global de Business Central (coin supérieur droit) pour accéder à la configuration de l’application.

Créez l'application

Vous devez créer une nouvelle application dans Business Central :

1. Créer une nouvelle fiche de candidature.
2. Saisissez l'identifiant de l'application (créé dans la section Vue d'ensemble du portail Azure) dans ID client.
3. Entrer Avantage pour Business Central dans la description.
4. Sous « État », sélectionnez Activé.

Attribuer des autorisations utilisateur dans Business Central

Vous devez configurer l'application pour qu'elle ait permissions de super administrateur.

Plus précisément, vous devez ajouter ces ensembles d'autorisations dans le Groupes d'utilisateurs section de la carte d'application Microsoft Entra que vous venez de créer.

Une fois l'installation initiale terminée, les utilisateurs standard ont besoin de Ensemble d'autorisations Perk BC (PERMISSIONSET YKY) pour apporter des modifications ultérieures à l'intégration et synchroniser les données.

Ensuite, vous devriez configurer la page de configuration des intégrations d'avantages dans Business Central avant de poursuivre la configuration de l'exportation des dépenses ou des factures dans Perk.

Configurer les services Web

Vous devez ajouter les services Web dans Business Central pour chaque module que vous prévoyez d'intégrer (par exemple, un service Web pour le traitement des factures et un autre pour le traitement des dépenses).

Pour ce faire :

1. Allez à Services Web.
2. Cliquez + Nouveau pour créer un nouvel objet.
3. Sélectionnez le Type d'objet Codeunit.
4. Recherchez les identifiants des objets en fonction du module que vous souhaitez implémenter :
   • Traitement des dépenses: Frais d'importation YKY (3110567)
   • Traitement des factures: Webhooks YKY (3110566)
5. Saisissez un nom de service unique (par exemple, Traitement des factures ou Traitement des dépenses). Assurez-vous que le Publié La case à cocher est sélectionnée.

Configurez l'exportation des dépenses dans Perk

Perk se charge d'exporter les données de dépenses vers le grand livre de Business Central. Les justificatifs de dépenses et leurs pièces justificatives peuvent être joints aux écritures comptables, le cas échéant. Si l'entreprise prévoit de traiter des avoirs, vous devez activer cette fonctionnalité pour l'entité juridique.

Vous devez configurer l'onglet d'exportation des dépenses (Administration > Intégrations, Exportation des dépensesPour envoyer les données de dépenses (dépenses, transactions par carte, frais de déplacement) à Business Central, vous pouvez utiliser le connecteur Perk. Il n'est pas possible d'exporter séparément les indemnités journalières et kilométriques.

Pour ce faire :

1. Accédez à Paramètres> > Intégrations.
2. Sélectionnez le Exportation des dépenses carte d'intégration.
3. Choisir Business Central [API] comme le Système ERP.
4. Saisissez les informations d'identification :
   • ID d'annuaire Azure: ID du locataire Business Central
   • ID client: ID client du portail Microsoft Azure créé précédemment
   • Secret client: Secret client du portail Microsoft Azure créé précédemment
5. Cliquez Connectez-vous avec Business Central.

Assurez-vous de désactiver tous les bloqueurs de pop-up Dans votre fenêtre de navigateur, l'authentification MS Dynamics utilise une fenêtre contextuelle pour effectuer la requête d'authentification auprès de MS Entra.

Prudence: Assurez-vous de sélectionner le système ERP approprié ! Microsoft Dynamics Cloud & MS Dynamic OnPrem Ce sont les fonctionnalités d'exportation d'un autre connecteur MS Dynamics Business Central, et non du connecteur développé par Perk.

Une fois la connexion établie, vous pouvez configurer les paramètres d'exportation :

Paramètre d'exportation des dépenses Exclure les objets de coûts de l'exportation n'est pas compatible avec cette intégration.
L'intégration Perk pour MS Dynamics 365 Business Central attend toujours un objet de coût lors de l'exportation des dépenses.

Configurez l'exportation des factures dans Perk

Pour traiter les factures avec Business Central, Perk utilise des webhooks afin d'informer Business Central des changements de statut des documents. Perk dispose d'une fonctionnalité d'exportation de factures dédiée à la gestion des réponses des webhooks. Actuellement, les webhooks sont synchrones ; le fournisseur doit donc attendre la fin du traitement pour recevoir une réponse.

Pour permettre à Business Central de se connecter à Perk, vous devez configurer l'intégration dans Perk :

1. Accédez à Paramètres > Intégrations .
2. Sélectionnez le Exportation de factures carte.
3. Dans le Exportations de factures onglet, cliquez Assistant de démarrage.
4. Veuillez saisir les informations suivantes :
   • Nom d'exportationFactures Business Central
   • Type de document: Factures des fournisseurs
5. Dans Système onglet, sélectionnez Intégration de Business Central.
6. Dans Configuration Dans l'onglet, saisissez les données utilisées pour former l'URL d'accès à l'API Business Central. Vous devez saisir les données suivantes :

Vous devez faire ceci pour chaque entité juridique que vous souhaitez lier à une société Business Central.

Avertissement: Si vous essayez de configurer plusieurs fonctionnalités d'exportation (par exemple, le connecteur Perk et les intégrations existantes), vous risquez de rencontrer l'erreur suivante : Validation : Plusieurs installations d'exportation applicables Lorsque vous tentez d'exporter une facture, vous ne pouvez activer qu'une seule fonction d'exportation à la fois.

Conseil: Étape suivante : Configurer et synchroniser les données de référence et transactionnelles.