Pour les implémentations Microsoft Dynamics 365 Business Central sur site, vous installez le connecteur de gestion des dépenses d'avantages sociaux 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 sur site :

1. Installez l'extension.
2. Configurer Business Central pour Microsoft Entra.
3. Configurez le connecteur dans Business Central.
4. Configurer l'exportation dans Perk :
   1. exportation de dépenses
   2. Exportation de factures
5. Synchroniser les données maîtres et transactionnelles.

Attention : L’édition locale de Business Central peut être hébergée sur des serveurs web privés dont l’accès aux réseaux non sécurisés est restreint. Assurez-vous que les politiques de sécurité n’empêchent pas les échanges de données entre Perk et les services du locataire Business Central.
En d'autres termes, les règles de pare-feu, les règles de redirection de ports et les passerelles réseau sécurisées doivent être configurées pour autoriser le passage du trafic entre Business Central On-premises et Perk avant de procéder à la synchronisation des données ou au déclenchement de l'exportation.

Aperçu architectural

Pour échanger des données entre Perk et Microsoft Dynamics 365 Business Central, l'application utilise l'authentification et l'autorisation OAuth 2.0 pour sécuriser le transfert de données.

Microsoft Entra est utilisé comme fournisseur d'identité (IdP). Il gère de manière sécurisée les informations utilisateur, les droits d'accès et les relations de confiance entre Business Central et Perk. Après l'authentification de l'utilisateur (connexion), le serveur d'autorisation émet des jetons de sécurité que l'application cliente (l'application web Perk) utilise pour accorder, refuser ou révoquer l'accès à l'API Business Central (autorisation). Une fois que l'application cliente dispose de jetons d'accès valides (accès, ID et actualisation), elle peut accéder aux données de Business Central et effectuer des opérations telles que la création, la mise à jour ou la suppression. Autrement dit, lorsque l'application Perk effectue des appels API vers Business Central, l'extension vérifie les jetons d'accès fournis et détermine si l'accès aux ressources demandées doit être autorisé ou refusé. Si l'accès est autorisé, Perk peut alors enregistrer des dépenses ou des factures.

Vous devez donc configurer Microsoft Entra pour qu'il reconnaisse l'application cliente (Perk) et émette des jetons de sécurité.

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 :

Remarque : Les plages d’identifiants sont dynamiques et peuvent être influencées par votre licence.
Si vous utilisez 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.

Configurer Business Central pour Microsoft Entra

Une fois l'extension installée, vous devez registre et configurez-le dans Microsoft Entra pour autoriser Perk à accéder aux points de terminaison de l'API Business Central. Vous devez également : configurer les autorisations de l'application.

Attention :Il est très important que vous suiviez les étapes décrites dans le Documentation officielle de Microsoft, en particulier les sections Configurer Business Central Server et Configurer le composant serveur Web Business Central

Pour faire confiance aux jetons de sécurité émis par Microsoft Entra, vous devez enregistrer votre application. Lors de l'enregistrement, la plateforme attribue des valeurs clés, telles que :

• ID de l'application (client) : Également appelé ID d'application ou ID client, cet identifiant unique est attribué à votre application par la plateforme d'identité. L'ID client permet d'identifier votre application au sein de la plateforme et est inclus dans les jetons de sécurité émis par celle-ci.
• URI de redirection : L’URI de redirection indique où le serveur d’autorisation doit rediriger l’agent utilisateur (par exemple, un navigateur web ou une application mobile) une fois l’authentification terminée. Par exemple, après la connexion de l’utilisateur, le serveur d’autorisation le redirige vers l’URI spécifiée. Notez que certains types de clients ne nécessitent pas d’URI de redirection.

L'enregistrement de l'application fournit également les points de terminaison d'authentification et d'autorisation nécessaires pour obtenir les jetons d'identification et d'accès.

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:///BC230/Connexion
   • https:///BC230/réponse-d'authentification
   • https:///BC230/OAuthLanding.htm
   • https://test.yokoy.ai/oauth2/callback (test) ou https://app.yokoy.ai/oauth2/callback (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 l'ensemble d'autorisations Perk BC (PERMISSIONSET YKY) pour effectuer des modifications ultérieures de l'intégration et synchroniser les données.

De plus, vous devez déterminer la plage d'ID sur laquelle de nouveaux objets peuvent être créés (par exemple 50000 à 55000).

Étant donné que la plage d'identifiants utilisée pour les développements personnalisés peut varier, il est important de la spécifier, car le package d'installation écrasera tous les objets existants auxquels est attribuée la même plage d'identifiants. Voir Installez le connecteur comme une extension pour obtenir la liste des plages d'identifiants utilisées par défaut dans l'extension.

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 : Dépenses d’importation YKY (63807)
   • Traitement des factures : Webhooks YKY (63806)
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.

Une fois que vous aurez fait cela, 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.

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 les avoirs pour l'entité juridique.

Vous devez configurer l'onglet d'exportation des dépenses (Admin > Intégrations, Exportation des dépenses) pour envoyer les données de dépenses (dépenses, transactions par carte, frais de voyage) à Business Central.

Attention :Vous ne pouvez pas utiliser le connecteur Perk pour exporter séparément les indemnités journalières/kilométrage.

Pour ce faire :

1. Accédez à Paramètres> > Intégrations.
2. Sélectionnez la carte Exportation des dépenses.
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 :

Avertissement :Le paramètre d’exportation des dépenses Exclure les objets de coût de l'exportation Cette intégration n'est pas compatible. L'intégration Perk pour MS Dynamics 365 Business Central requiert systématiquement 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 la carte Exportations de factures.
3. Veuillez saisir les informations suivantes :
   • Nom d'exportationFactures Business Central
   • Type de document: Factures des fournisseurs
4. Dans Système onglet, sélectionnez Intégration de Business Central.
5. 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.