Modules d'Intégration ERP

Viridem propose une quinzaine de modules d'intégration avec des systèmes comptables, ERP et métiers tiers. Chacun de ces modules — Acomba, Sage, Dynamics, SAP Business One, Avantage, et bien d'autres — utilise le service de communication ViridemConnect combiné au SDK ou à l'API du système cible pour faire le pont entre les solutions. Le principe est partout le même : un programme d'exportation (ou d'importation) s'exécute lors d'une transition de flux de travail, et transmet automatiquement les données du document vers le système financier — ou inversement, enrichit le document avec des informations provenant du système.

Tous les modules ERP sont disponibles sous licence. La configuration demande une coordination avec votre équipe TI et idéalement l'aide d'un intégrateur Viridem qui maîtrise les structures de données du système cible.

Information : Certains détails concernant le contenu des modules sur les systèmes tiers ou financiers présentés dans ce guide peuvent ne pas refléter exactement votre environnement, car la version installée du système, le module activé et la configuration locale varient d'un client à l'autre. Contactez un intégrateur Viridem pour les spécificités de votre instance.

Dans ce guide

• Comment choisir le bon module ERP
• Configurer un programme ERP — schéma commun
• Famille Acomba
• Famille Sage
• Famille Microsoft Dynamics
• SAP Business One
• Avantage
• Genius
• Fidelio
• Visual Manufacturing
• MIR, Servex, Transnet
• Connecteur universel (API sur mesure)
• Bonnes pratiques de mapping comptable

Comment choisir le bon module ERP {#choix}

Le bon module est celui correspondant à votre système comptable installé. Si vous utilisez Acomba X, il vous faut le Module Acomba X (et non le Module Acomba pour l'ancienne version). Vérifiez auprès de votre service comptable la version exacte du logiciel utilisé.

Si votre système n'a pas de module dédié dans Viridem, deux options :

1. Le Connecteur universel si votre système expose une API REST (XML ou JSON).
2. Une exportation générique (CSV, XML, base de données) avec un import manuel ou automatisé côté ERP — voir v3_integrations_import_export.md.

Un même client peut activer plusieurs modules simultanément — par exemple, exporter les factures fournisseurs vers Sage 300 et les bons de commande vers Dynamics GP.

Configurer un programme ERP — schéma commun {#schéma-commun}

Tous les modules ERP suivent le même schéma de configuration. Une fois compris, vous pouvez l'appliquer à n'importe quel module.

Étapes générales

1. Allez dans Configuration > Système > Modules et cliquez sur le module ERP voulu. La page du Programme d'exportation [Nom de l'ERP] s'ouvre.
2. La vue par défaut affiche le programme principal du module. Si plusieurs programmes coexistent (par exemple Import + Export pour Dynamics 365), utilisez le bouton Lien ou la liste déroulante pour passer de l'un à l'autre.
3. Cliquez sur le bouton Liens pour ouvrir la fenêtre Liens des champs globaux. C'est ici que vous indiquez à Viridem quel champ Viridem correspond à quel champ ERP.
4. Pour chaque ligne, sélectionnez le champ global Viridem dans la liste déroulante, et indiquez la cible côté ERP.
5. Configurez les paramètres de connexion : URL du service, identifiants techniques, code de compagnie ERP, etc.
6. Cliquez sur Tester pour valider la connexion.
7. Cliquez sur Enregistrer.

Activer le programme dans un flux

Une fois le programme configuré, attachez-le à une transition dans un flux de travail pour qu'il s'exécute automatiquement quand un document atteint l'étape voulue. Voir v3_flux_de_travail.md pour la configuration des programmes au niveau d'une étape.

Famille Acomba {#acomba}

Trois variantes existent selon votre version d'Acomba.

Module Acomba (version classique)

Viridem utilise ViridemConnect + le SDK Acomba pour communiquer avec Acomba.

1. Allez dans Configuration > Système > Modules > Module Acomba.
2. La fenêtre du Programme d'exportation Acomba s'affiche par défaut. Utilisez Lien pour basculer vers les autres options si applicable (par exemple, programmes d'export du compte GL, du numéro de projet, factures clients ou encaissements).
3. Configurez les liens et les paramètres de connexion comme indiqué dans la section schéma commun.
4. Enregistrez.

Module Acomba X

Version plus récente, configuration similaire mais via un programme dédié.

1. Allez dans Configuration > Système > Modules > Module Acomba X.
2. Cliquez sur Liens pour configurer les correspondances champs Viridem ↔ Acomba X.
3. Saisissez les paramètres de connexion (URL, identifiants, base de données Acomba).
4. Enregistrez. Le programme s'exécutera lors d'une transition de flux.

Module Acomba Construction

Variante spécialisée pour l'industrie de la construction.

Ce module est prévu pour l'exportation des factures fournisseurs vers Acomba Construction. Les factures fournisseurs sont saisies automatiquement sans intervention humaine. Configuration identique au Module Acomba — la différence se joue côté SDK Acomba Construction.

Astuce : Les trois modules Acomba peuvent coexister dans la même instance Viridem si vous avez des compagnies sur des versions différentes — un module par compagnie.

Famille Sage {#sage}

Trois modules selon la gamme Sage utilisée.

Module Sage

Pour la version Sage classique. Viridem utilise ViridemConnect + le SDK Sage.

1. Allez dans Configuration > Système > Modules > Module Sage.
2. La fenêtre du Programme d'exportation Sage s'affiche.
3. Cliquez sur Lien puis utilisez la liste déroulante pour voir tous les programmes disponibles (export factures fournisseurs, export factures clients Sage, etc.).
4. Configurez les liens et la connexion, enregistrez.

Module Sage 300

Variante pour Sage 300 (anciennement ACCPAC).

1. Allez dans Configuration > Système > Modules > Module Sage 300.
2. Cliquez sur Liens pour configurer les champs globaux.
3. Configurez la connexion et enregistrez.

Module Sage X3

Variante pour Sage X3 (ERP intermédiaire). Permet de créer plusieurs programmes.

1. Allez dans Configuration > Système > Modules > Module Sage X3.
2. Cliquez sur Ajouter un programme Sage X3 pour configurer un programme spécifique.
3. Configurez nom, liens, connexion, et enregistrez.

Vous pouvez modifier ou supprimer un programme Sage X3 en le sélectionnant dans la grille.

Famille Microsoft Dynamics {#dynamics}

Trois variantes selon le produit Dynamics.

Module Dynamics 365

Module le plus moderne. Deux types de programmes coexistent :

• Programme Dynamics 365 de type Import : récupère des données depuis Dynamics 365 pour enrichir un document Viridem
• Programme Dynamics 365 de type Export : envoie les données du document vers Dynamics 365

Ajouter un programme Dynamics 365

1. Allez dans Configuration > Système > Modules > Module Dynamics 365.
2. Cliquez sur Ajouter un programme Dynamics 365 de type Import ou de type Export selon votre besoin.
3. Saisissez le nom, configurez les liens vers les champs Dynamics, renseignez la connexion (URL Dynamics 365, tenant, identifiants).
4. Enregistrez.

Module Dynamics GP

Pour Microsoft Dynamics GP (Great Plains). Configuration via ViridemConnect.

1. Allez dans Configuration > Système > Modules > Module Dynamics GP.
2. Cliquez sur Liens pour le mapping des champs.
3. Configurez la connexion (instance Dynamics GP, code compagnie, identifiants).
4. Enregistrez.

Module AX

Pour Microsoft Dynamics AX (versions plus anciennes). Viridem utilise ViridemConnect.

1. Allez dans Configuration > Système > Modules > Module AX.
2. La fenêtre du Programme d'exportation AX s'affiche par défaut. Utilisez Lien pour voir les autres programmes (import).
3. Configurez liens, connexion, enregistrez.

SAP Business One {#sap}

Module pour l'ERP SAP Business One (PME). Viridem utilise ViridemConnect.

1. Allez dans Configuration > Système > Modules > Module SAP Business One.
2. La fenêtre du Programme d'exportation de factures fournisseurs SAP Business One s'affiche par défaut.
3. Plusieurs programmes coexistent — utilisez Lien pour basculer entre :
   • Exportation de factures fournisseurs
   • Exportation de factures fournisseurs à partir de réceptions de PO
4. Configurez les liens vers les champs SAP, la connexion (URL Service Layer, base de données SBO, identifiants), et enregistrez.

Astuce : SAP Business One est très sensible à la cohérence des codes fournisseurs et codes articles entre Viridem et SAP. Configurez vos listes de données externes (voir v3_parametres_fiscaux_et_listes.md) pour synchroniser ces listes en temps réel — vous éviterez les rejets d'export.

Avantage {#avantage}

Le module Avantage permet l'exportation et l'importation de données. Viridem utilise ViridemConnect + le SDK Avantage.

Plusieurs programmes coexistent dans ce module :

• Programme d'exportation Avantage (factures fournisseurs)
• Programme d'exportation de compte client Avantage
• Programme d'exportation de facture d'item Avantage
• Programme d'exportation de transactions Avantage
• Programme d'exportation en lot Avantage
• Programme d'importation d'un projet Avantage
• Programme d'importation en lot de projets Avantage

Configurer le module Avantage

1. Allez dans Configuration > Système > Modules > Module Avantage.
2. La fenêtre du Programme d'exportation Avantage s'affiche par défaut.
3. Utilisez Lien puis la liste déroulante pour basculer vers le programme voulu.
4. Configurez les liens et la connexion pour chaque programme utilisé.
5. Enregistrez.

Genius {#genius}

L'objectif du Module Genius est d'exporter des factures vers Genius en liant les items de facture aux items de réception. Pour cela, il faut d'abord importer les lignes des items de réception via le Programme d'importation des items de réception.

Lors de l'exportation, si un écart apparaît entre la somme des items et le sous-total, un item non lié à une réception est automatiquement créé pour équilibrer la facture.

Configurer Genius

1. Allez dans Configuration > Système > Modules > Module Genius.
2. Configurez d'abord le Programme d'importation des items de réception (récupère les réceptions depuis Genius).
3. Puis configurez le Programme d'exportation Genius (envoie les factures rapprochées).
4. Pour chacun, cliquez sur Liens pour le mapping, renseignez la connexion, et enregistrez.

Fidelio {#fidelio}

Le module Fidelio permet l'importation des réceptions et l'exportation des factures (payables et fournisseur).

1. Allez dans Configuration > Système > Modules > Module Fidelio.
2. La fenêtre Module Fidelio s'affiche.
3. Cliquez sur Liens pour configurer les liens avec les champs globaux.
4. Sélectionnez le programme à configurer dans la liste déroulante (Import réceptions, Export factures payables, Export factures fournisseur).
5. Renseignez les paramètres et enregistrez.

Visual Manufacturing {#visual-manufacturing}

Avertissement : Une connexion externe doit être configurée au préalable pour utiliser le module Visual Manufacturing. Voir la section Connexions externes de v3_integrations_import_export.md.

1. Allez dans Configuration > Système > Modules > Module Visual Manufacturing.
2. Cliquez sur Liens pour configurer les champs globaux.
3. Configurez la connexion en sélectionnant la connexion externe préalablement créée.
4. Configurez également les programmes d'exportation Visual Manufacturing et le programme de prétraitement Visual Manufacturing si applicable.
5. Enregistrez.

MIR, Servex, Transnet {#mir-servex-transnet}

Trois modules spécialisés qui suivent le même modèle simple : un programme d'exportation CSV qui s'exécute lors d'une transition de flux.

Module MIR

Le programme MIR-exportation CSV s'exécute lors d'une transition.

1. Configuration > Système > Modules > Module MIR.
2. Cliquez sur Liens pour configurer les champs globaux.
3. Renseignez les paramètres et enregistrez.

Module Servex

Permet d'exporter les fichiers PDF de factures fournisseurs directement dans les appels de service de Servex. Les factures contenant des numéros d'appel de service valides sont automatiquement ajoutées dans les appels de service correspondants.

1. Configuration > Système > Modules > Module Servex.
2. Configurez les liens et la connexion.
3. Enregistrez.

Module Transnet

Le programme Transnet-exportation CSV s'exécute lors d'une transition.

1. Configuration > Système > Modules > Module Transnet.
2. Configurez les liens et la connexion.
3. Enregistrez.

Connecteur universel (API sur mesure) {#connecteur-universel}

Le Module Connecteur universel permet l'exportation des données d'un document vers une API tierce quelconque. Les échanges peuvent se faire en XML ou en JSON selon votre système. Le SOAP n'est pas pris en charge.

C'est la solution lorsque votre système comptable ne dispose pas de module dédié dans Viridem mais expose une API REST.

Avertissement : Les requêtes API doivent être construites par des personnes d'expérience connaissant les structures d'appels API. Loginnove se décharge de toutes responsabilités quant à la mauvaise utilisation de ce module et à la corruption de données qui pourrait en résulter. Validez chaque programme sur un environnement de test.

Configurer un programme Connecteur universel

1. Allez dans Configuration > Système > Modules > Module Connecteur universel.
2. Cliquez sur Ajouter pour créer un nouveau programme.
3. Renseignez :

1. Cliquez sur Tester pour valider l'appel.
2. Enregistrez.

Vous pouvez créer autant de programmes que nécessaire dans le module — un par endpoint d'API.

Bonnes pratiques de mapping comptable {#bonnes-pratiques}

Quel que soit le module ERP utilisé, les mêmes principes améliorent la qualité de votre intégration.

Synchroniser les listes maîtres

Avant d'exporter, vérifiez que vos codes fournisseurs, codes articles et comptes GL sont identiques côté Viridem et côté ERP. Une divergence cause des rejets d'export silencieux.

Utilisez les listes de données externes (voir v3_parametres_fiscaux_et_listes.md) pour interroger l'ERP en temps réel et garantir que les valeurs sélectionnées dans Viridem existent toujours dans le système cible.

Tester avec un sous-ensemble

Avant d'activer l'export pour tous les documents, configurez le programme sur un seul gabarit de test et faites transiter quelques documents témoins. Vérifiez côté ERP que les écritures arrivent comme prévu — montants, taxes, comptes, fournisseurs.

Surveiller les logs

Activez la consultation des logs dans Configuration > Système > Dépannage et assistance. Les programmes ERP y enregistrent leurs erreurs (timeout, rejet de l'API, payload invalide). Voir v3_configuration_systeme.md.

Documenter le mapping

Tenez un document — externe à Viridem — qui liste pour chaque programme : quels champs Viridem correspondent à quels champs ERP, et pourquoi. Quand quelqu'un d'autre devra maintenir l'intégration, ce document vaut son pesant d'or.

Gérer les écarts gracieusement

Pour les intégrations bidirectionnelles (BC → facture → réception, par exemple), prévoyez dans votre flux de travail une étape « Écart à investiguer » où arrivent automatiquement les documents que l'ERP refuse. Un utilisateur dédié les regarde et résout les divergences, plutôt que d'avoir des documents qui disparaissent dans la nature.