Synchroniser Microsoft Business Central
Reliez Microsoft Business Central à FinovRelance grâce aux services web OData V4 pour alimenter automatiquement vos comptes à recevoir. C'est la connexion la plus riche : vous fournissez les URLs des tables, vous autorisez l'accès chez Microsoft, vous associez chaque champ, vous ajoutez un filtre et un tri, puis un seul bouton Synchroniser importe clients, factures et paiements dans le bon ordre.
Ouvrir la carte Business Central
Dans Paramètres de l'entreprise, onglet Connexions comptables, repérez la carte Microsoft Business Central parmi les connecteurs disponibles, puis cliquez sur Configurer Business Central.
Saisir les deux URLs OData V4
Business Central expose ses tables via des services web OData V4. Collez l'URL de la table Customer dans URL OData pour les Clients et l'URL de la table SalesInvoice dans URL OData pour les Factures. Le format attendu est https://api.businesscentral.dynamics.com/v2.0/[tenant]/[environment]/ODataV4/Company('[company]')/[table]. Cliquez ensuite sur Continuer vers l'authentification.
Astuce : les URLs se récupèrent dans Business Central sous Web Services. Vérifiez que les services OData V4 sont bien publiés pour Customer et Sales Invoice, puis copiez l'URL complète incluant le tenant et l'environnement. Les deux tables passent par le même jeton OAuth : une seule autorisation Microsoft suffit pour les deux.
Autoriser l'accès chez Microsoft
FinovRelance vous redirige vers la page d'autorisation officielle de Microsoft. Connectez-vous à votre compte et acceptez l'accès à Business Central ; le retour vers FinovRelance est automatique. Cette page appartient à Microsoft : elle n'est pas illustrée ici car son apparence n'est pas contrôlée par FinovRelance. C'est une connexion sécurisée standard (OAuth 2.0) et aucun mot de passe Microsoft n'est stocké par FinovRelance.
Associer les champs Clients
L'écran de mapping s'ouvre. Pour chaque champ FinovRelance, choisissez le champ Business Central correspondant dans la liste déroulante. Les champs marqués d'une étoile sont obligatoires : Code Client et Nom Client. Vous associez aussi l'email, le téléphone, l'Adresse Complète (6 composants concaténés : deux lignes d'adresse, ville, code postal, province et pays), le représentant, les conditions de paiement et le mapping des langues (les valeurs FR et EN de Business Central).
Filtrer et trier les clients (tri obligatoire)
C'est le point clé de Business Central. Le Filtre OData (optionnel) restreint les données importées, par exemple startswith(No, 'CUST') or Balance_LCY gt 100. Le Champ de Tri Clients est obligatoire : il DOIT exister dans Business Central, sinon la synchronisation échoue avec une erreur 400. Utilisez Aperçu des données (10 lignes) pour valider votre filtre et votre tri avant de synchroniser.
Astuce : le tri sert de pagination fiable à Business Central. Choisissez un champ toujours renseigné et unique, comme No, plutôt qu'un champ optionnel. Un doute sur un nom de colonne ? L'aperçu des données affiche les vraies colonnes disponibles : recopiez le libellé exact pour éviter l'erreur 400.
Activer la synchronisation delta (incrémentale)
Renseignez le Champ Date de Modification, par exemple SystemModifiedAt. Une fois activé, FinovRelance ne réimporte que les enregistrements modifiés depuis la dernière synchronisation, ce qui réduit le temps de traitement d'environ 90 %. Laissez le champ vide pour désactiver le delta et tout resynchroniser à chaque fois.
Astuce : gardez le delta désactivé pour la toute première synchronisation (import complet), puis activez-le ensuite. Les syncs suivantes seront bien plus rapides car seules les fiches modifiées remontent.
Associer les champs Factures
Dans la section Factures, associez la Référence Client dans Facture, le Numéro de Facture, la Date d'Émission et la Date d'Échéance. Le champ Solde Restant à Payer est obligatoire : c'est le montant impayé qui alimente vos comptes à recevoir. Le Montant Total de la Facture reste optionnel. Comme pour les clients, un filtre OData et un champ de tri obligatoire s'appliquent aux factures.
Enregistrer le mapping, puis synchroniser en un clic
Cliquez sur Enregistrer le Mapping pour conserver votre configuration. Revenez ensuite à la carte du connecteur dans les Paramètres de l'entreprise : un seul bouton Synchroniser lance tout. Il enchaîne automatiquement, dans l'ordre, 1) les clients, 2) les factures en souffrance rattachées aux clients, puis 3) les paiements qui alimentent le délai moyen de paiement (DMP). Si une étape échoue, les suivantes ne sont pas exécutées. Un bilan détaillé confirme les clients, factures et paiements créés ou mis à jour, et la date de Dernière synchronisation se met à jour.
Astuce : il n'y a plus de boutons séparés pour les clients et les factures. Enregistrez votre mapping, puis cliquez le bouton unique Synchroniser : l'ordre métier (clients avant factures avant paiements) est garanti automatiquement. Relancez ce même bouton chaque fois que vous voulez rafraîchir vos données.
À retenir
Business Central se connecte par les services web : une URL pour la table Customer, une pour SalesInvoice, au format api.businesscentral.dynamics.com.
Sans champ de tri valide (présent dans Business Central), la synchronisation renvoie une erreur 400. Vérifiez-le avec l'aperçu des données.
Après avoir enregistré le mapping, un clic enchaîne clients, factures puis paiements dans le bon ordre. Un échec d'étape stoppe la suite.
Côté factures, le solde restant à payer est le champ obligatoire : c'est lui qui alimente vos comptes à recevoir.