Une opportunité est prête à partir de Dynamics 365 Sales vers l’ERP. Les deux sociétés du groupe utilisent le code client 004208. Si le connecteur ne connaît pas la société retenue sur le devis, le dossier peut remonter avec le mauvais statut de facturation.
Le risque existe même quand l’appel réussit. Le connecteur doit d’abord prouver quel compte il traite et qui a le droit de modifier le champ. Ensuite, la réponse technique sert à décider si l’opération peut avancer ou doit être rapprochée.
Le cas fictif ci-dessous suit un compte de la société française jusqu’au retour de son statut dans Dataverse. Il couvre le choix de l’interface, la clé du compte, les mises à jour concurrentes et la réponse perdue.
Pour une intégration Dynamics 365 CRM et ERP, commencez par identifier l’application qui valide le devis et celle qui émet la référence de commande.
Pour qui raccorder Dynamics 365 CRM à un ERP
Le commerce doit retrouver les engagements de l’opportunité et du devis. La gestion doit savoir quel client facturer et quelle version du dossier elle a reçue. Le support doit pouvoir partir de l’opportunité, retrouver la demande de commande et expliquer l’état visible dans le CRM.
Commencez avec une société, une catégorie de vente et une opération confirmable. Si le statut de facturation vient de l’ERP, alors testez d’abord sa remontée sur un compte existant. L’ouverture de commandes dans un second flux exige une preuve distincte du résultat côté ERP.
Choisir l’interface selon le produit Dynamics
Pour les tables de Dynamics 365 Sales dans Dataverse, utilisez la Web API de l’environnement, par exemple sous /api/data/v9.2/. Elle expose les jeux d’entités, leurs propriétés et leurs relations selon la configuration publiée. Vérifiez le nom du jeu d’entités dans les métadonnées avant de coder une opération. Opérations de la Web API Dataverse.
Pour Finance et Supply Chain Management, identifiez l’entité de données publiée. Le service OData des entités publiques utilise la racine /data. La double écriture (dual-write) peut aussi synchroniser certaines données entre les applications Finance and Operations et Dataverse. Vérifiez le mapping et les responsabilités si ce mécanisme est déjà actif. Entités OData de Finance and Operations et Options d’intégration Dynamics 365.
Pour Business Central, examinez son API v2.0 et la société ciblée. Une synchronisation Business Central vers Dataverse peut être configurée à part. Le fait de retrouver un compte côté CRM indique une relation à vérifier avec la société ERP concernée. Référence Business Central API v2.0.
Attribuer les accès à l’application
Pour un service Symfony sans utilisateur interactif, enregistrez l’application dans Microsoft Entra ID. Pour un client confidentiel avec le flux client credentials, demandez le jeton pour la ressource Dataverse de l’environnement avec le scope <URL-environnement>/.default. L’utilisateur d’application et ses rôles dans Dataverse déterminent les opérations autorisées. Authentification OAuth de Dataverse.
Faites vérifier en recette la lecture du compte et l’écriture du seul champ autorisé, puis tentez une opération hors périmètre. Gardez des paramètres et des identifiants d’application adaptés à chaque environnement. Stockez les secrets dans le mécanisme prévu pour le déploiement et retirez les jetons des traces.
Quand la connexion fonctionne mais qu’un appel est refusé, relevez l’environnement, l’utilisateur d’application, le jeu d’entités et le privilège attendu. Ce contrôle aide l’administrateur à distinguer un jeton destiné à une autre ressource d’un droit manquant sur la table ou la ligne.
Identifier le compte Dataverse par société
Dans le cas fictif, FR01 et BE01 sont deux sociétés de la même instance ERP. Chacune a un client 004208. Une clé Dataverse qui reprend uniquement le numéro rapprocherait ces deux dossiers. Associez le numéro à la société et ajoutez la source au contrat si plusieurs ERP peuvent émettre les mêmes références.
Le GUID Dataverse identifie la ligne. Une clé alternative active peut servir à la retrouver depuis l’ERP. Pour l’exemple, le jeu d’entités est accounts et les colonnes personnalisées fictives sont int_legalentity et int_erpnumber. Les noms exacts, les valeurs autorisées et l’état de la clé doivent être vérifiés dans votre environnement. Définition des clés alternatives Dataverse.
Relire le compte avant la mise à jour
La première requête retrouve le GUID, le nom et le statut ERP actuel. Pour la seconde, copiez l’@odata.etag reçu quand la table autorise la concurrence optimiste. Le code client conserve les zéros du numéro ERP. Il transmet seulement la valeur que la gestion est autorisée à écrire.
GET /api/data/v9.2/accounts(int_legalentity='FR01',int_erpnumber='004208')?$select=accountid,name,int_billingstatus
PATCH /api/data/v9.2/accounts(int_legalentity='FR01',int_erpnumber='004208')
Content-Type: application/json
If-Match: W/"812345"
{"int_billingstatus": "validated"}
Le statut et l’ETag sont fictifs. Le client ajoute le jeton de l’environnement et ses en-têtes OData aux deux requêtes. L’ETag doit venir de la lecture de cette ligne. En cas de 412, comparez la nouvelle fiche avec la décision initiale avant d’appliquer le changement. Écritures conditionnelles et concurrence optimiste.
Sur une table standard, un PATCH sans précondition de mise à jour peut créer une ligne si elle manque. If-Match: * limite l’opération à une ligne existante. If-None-Match: * réserve l’écriture à une création. Pour les tables élastiques, vérifiez leur comportement avant de reprendre une stratégie d’upsert conçue pour une table standard. Comportement des opérations Upsert.
Répartir les écritures entre le CRM et l’ERP
Pour le dossier de recette OPP-624, le commerce valide la version du devis et le compte associé. La gestion décide si le client peut être facturé et crée la commande ERP. Dataverse peut recevoir sa référence et son statut, avec la société, la version de devis et l’identifiant d’opération qui ont produit ce résultat.
Power Automate peut notifier le gestionnaire si la référence de commande manque. Si le flux écrit en retour dans la même table, alors limitez son déclenchement aux modifications qui l’intéressent. Réservez au traitement qui suit la commande la responsabilité de décider si une création est encore nécessaire.
En réalité, une boucle peut commencer avec deux opérations réussies. L’ERP envoie le statut, Dataverse le sauvegarde, puis un déclencheur remonte la même mise à jour comme une nouvelle demande. Faites rejouer une réponse identique pour vérifier que le nombre de demandes de commande reste égal à un.
Reprendre les changements Dataverse
Pour une table éligible dont le suivi des modifications est activé, demandez Prefer: odata.track-changes. Suivez les URL de pagination retournées et conservez le lien delta après avoir traité durablement les pages. Un lien delta est opaque. Conservez-le avec le périmètre qu’il suit, sans en reconstruire les paramètres. Suivi des modifications Dataverse.
Le suivi des modifications en Web API exclut notamment $filter, $orderby, $expand et $top sur cette requête. Si vous devez appliquer un filtre métier, alors vérifiez comment limiter le périmètre côté traitement. Si le lien delta est refusé, organisez un nouvel état de référence et rapprochez les écritures déjà effectuées avant de reprendre le flux.
Un webhook Dataverse peut signaler un changement. Pour une reprise durable, consignez l’événement avant de confirmer sa prise en charge et relisez les champs nécessaires. Si un ancien événement réapparaît après une correction, comparez la version et l’autorité du champ avant de relancer une écriture. Webhooks de Dataverse.
Erreurs fréquentes et décisions après un appel
| Situation | Décision |
|---|---|
| 204 après mise à jour | Confirmer l’écriture et vérifier le statut attendu pendant la recette. |
404 avec If-Match: * | Vérifier la clé, la société et l’accès avant d’autoriser une création. |
| 412 avec l’ETag lu | Relire le compte et décider si la mise à jour reste pertinente. |
429 avec Retry-After: 30 | Différer les appels concernés de 30 secondes au minimum et ajuster le débit. |
| Réponse perdue après écriture | Comparer le statut et la référence déjà visibles avant toute nouvelle tentative. |
Journalisez la société, la clé du client, la version de décision et la référence de corrélation. Sur limitation, respectez Retry-After. Par exemple, pour une réponse reçue à 09:00:10 avec une attente de 30 secondes, la première relance peut partir à 09:00:40 au plus tôt. Coordonnez les traitements qui partagent l’identité technique. Limites de protection de Dataverse.
Plan d’action pour recetter le premier flux
- Relever l’application, la table, la société et la personne qui valide chaque champ.
- Vérifier les droits de l’utilisateur d’application et la clé alternative active dans l’environnement de recette.
- Lire les deux comptes de même code et confirmer que leurs GUID diffèrent. Écrire le statut du seul compte
FR01. - Provoquer une modification concurrente et simuler une réponse perdue. Le support doit retrouver le résultat sans deviner l’état de l’ERP.
- Contrôler que la reprise du changement laisse une seule demande de commande pour l’opportunité et la version retenue.
Mesurez le délai entre la validation commerciale et le retour de la commande. Si l’ERP a répondu mais que la référence est absente du CRM, alors mesurez séparément le délai de retour. Vous saurez si le traitement doit réparer un accusé de réception ou si la commande attend encore d’être créée.
Avant la bascule, comparez les métadonnées et les permissions des deux environnements. Conservez la version du mapping et rejouez un cas où le code client est identique dans deux sociétés.
Approfondir les clés, le SDK et les commandes
Pour implémenter la lecture et le suivi des changements, consultez le SDK Dataverse sous Symfony. Si la clé ERP comporte des caractères particuliers, vérifiez la compatibilité des références ERP avec les clés Dataverse.
Pour attribuer les écritures par champ, approfondissez le partage des responsabilités entre Dynamics CRM, ERP et middleware. Le flux de commandes Dynamics 365 CRM vers ERP détaille la preuve à garder après une création.
Si les imports concurrents déclenchent des 429, vérifiez les limites partagées par les workers Dataverse. Pour un stockage volumineux, lisez les contrôles d’upsert sur les tables élastiques.
Conclusion sur le premier compte à synchroniser
Choisissez un compte dont le code ERP est connu et dont la société est confirmée. Le flux doit retrouver la bonne ligne, mettre à jour le champ autorisé et laisser la référence de la décision.
Refaites le test avec une modification concurrente puis une réponse perdue. Demandez au support de retrouver le compte et la version concernée avant de valider l’ouverture du périmètre suivant.
Dawap peut cadrer et recetter votre intégration Dynamics 365 CRM avec Dataverse, des accès de l’application jusqu’au rapprochement du premier flux ERP.