Configurer une interface de données automatisée entre Factorial et Sage

Configurer une interface de données automatisée entre Factorial et Sage

Résumé :

Cet article explique comment mettre en place l'interface automatisée BrynQ qui envoie les données de base des salariés de Factorial vers Sage 100 France (v9).

Prérequis :

- Un accès à BrynQ avec le droit de créer ou de modifier des interfaces.
- Un compte administrateur Factorial ayant accès à toutes les données des salariés.
- Un administrateur Sage 100 France et un utilisateur paie capable de vérifier les résultats d'importation.
- Un accès au serveur Windows sur lequel tourne Sage, y compris l'accès à SQL Server, aux fichiers PRH de Sage, ainsi qu'aux dossiers programFiles et programData.
- Le programme d'installation de l'Agent BrynQ et la clé API BrynQ fournis par le support BrynQ.

Notes de préparation importantes

  • Enregistrez souvent votre travail dans Sage. L'enregistrement automatique de Sage n'est pas toujours fiable.
  • L'utilisateur qui connecte Factorial dans BrynQ doit pouvoir voir tous les salariés. Sinon, BrynQ ne synchronise que les salariés auxquels cet utilisateur a accès.
  • Ayez la clé API BrynQ à portée de main avant de commencer. Elle est nécessaire pour la partie 1 et la partie 2.

Partie 1 - Guide vidéo



Partie 1.A) Télécharger l'Agent BrynQ sur le serveur Sage

  • Téléchargez la dernière version de l'Agent BrynQ depuis BrynQ. Dans la plateforme BrynQ, allez dans Organisation > Agent et téléchargez le programme d'installation.


  • Remarque : nous avons signé et publié les fichiers sous le nom 'Salure ICT BV'. Votre navigateur et Windows peuvent néanmoins signaler ces fichiers comme non fiables. 

Partie 1.B) Installer et configurer l'agent

  1. Lancez le programme d'installation et choisissez votre langue. Ce guide continue en anglais.


  2. Lisez et acceptez le contrat.
  3. Saisissez la clé API BrynQ qui vous a été fournie par le support BrynQ.
    Remarque : cette étape n'est nécessaire que lors de la première installation (complète).
  4. Sélectionnez les modules suivants :
  5. Sélectionnez les fichiers PRH trouvés sur votre serveur que vous souhaitez connecter à l'interface. 
    Remarque : si un fichier n'apparaît pas, vous pouvez l'ajouter manuellement avec le bouton 'Add PRH File...'. 
    Chaque fichier PRH correspond à la base de données d'une société dans Sage.

  6. Sélectionnez le ODBC Driver ... for SQL Server le plus récent disponible, s'il diffère de celui sélectionné par défaut dans la liste déroulante.
  7. Saisissez le nom du serveur.
  8. Choisissez Windows Authentication, sauf si votre configuration nécessite SQL Server Authentication. Dans ce cas, saisissez le nom d'utilisateur et le mot de passe d'accès à ce serveur.

  9. Dans Sage 100 France, créez un utilisateur de service Sage dédié. Une fois connecté à un fichier PRH, ouvrez Fichier -> Droits d'accès -> Utilisateurs.


    Un exemple : le code et la description sont facultatifs, mais 'Compte de service' et un jeton (token) sont obligatoires. Copiez ce jeton.



  10. Dans le programme d'installation, collez le code de l'utilisateur de service et le jeton.

  11. ConnectImport devrait déjà être configuré pour vous, mais vous pouvez l'adapter sur cette page. Ne le faites que si vous connaissez le fonctionnement du module ConnectImport ou si un problème doit être résolu.

  12. Nous vous recommandons de créer un raccourci sur le bureau.

  13. Si nécessaire, vous pouvez définir des paramètres réseau locaux personnalisés. Si vous n'êtes pas sûr d'en avoir besoin, ce n'est probablement pas le cas.
  14. Facultatif : vérifiez et, si besoin, modifiez la configuration de l'Agent BrynQ dans le tableau de bord d'administration local. Le raccourci sur le bureau vous y mène directement. Sinon, utilisez l'adresse IP d'écoute et le port d'administration dans votre navigateur, par défaut 127.0.0.1:7071/admin

Vérifier l'agent

  • Ouvrez le Gestionnaire des tâches.
  • Ouvrez l'onglet Services.
  • Vérifiez que les trois services BrynQ sont à l'état En cours d'exécution (Running).


    Astuce : en cas de problème de connexion à l'Agent BrynQ, vérifiez d'abord que ces services sont bien en cours d'exécution.

Partie 2 : Créer l'interface dans BrynQ

Une fois Sage et l'Agent BrynQ prêts, finalisez l'interface dans BrynQ.

Créer l'interface à partir du modèle

  1. Ouvrez BrynQ et allez dans Interfaces.
  2. Cliquez sur New interface.
  3. Choisissez Use our templates.
  4. Recherchez Sage.
  5. Sélectionnez Factorial - Sage 100 France Employees.

  6. Cliquez sur Use template.

Compléter les onglets Configuration et Scenarios

  • Ouvrez l'onglet Configuration.


  • Définissez la fréquence de paie (payment frequency) de la société.

  • Saisissez éventuellement quelques identifiants de salariés pour un test contrôlé.

  • Ouvrez l'onglet Scenarios et vérifiez chaque élément marqué d'un point d'interrogation. Par exemple, confirmez ou complétez les correspondances de valeurs (value mappings).

  • Nous allons détailler la correspondance 'Legal Entity -> Paying Establishment and Dossier'. Complétez cette correspondance avec soin : elle détermine quelle entité est synchronisée vers quelle société dans Sage.
  • Trouvez l'ID et le nom de l'entité juridique dans Factorial (Paramètres -> Informations sur l'entreprise).


  • Saisissez cette valeur dans la partie gauche de la correspondance (plusieurs valeurs si vous souhaitez synchroniser plusieurs entités).


  • Trouvez la Raison sociale / le dossier correspondant au fichier PRH de Sage.
    Dans cet exemple, nous avions un dossier 'BRYNQ.PRH'.
  • Trouvez également l''Etablissement principal' correspondant.

  • Saisissez ces valeurs dans la partie droite de la correspondance. Notre résultat :

  • Confirmez chaque correspondance complétée et enregistrez-la.
  • Procédez de la même manière pour les correspondances non standard. Il s'agit de :



    Et vérifiez l'exactitude des correspondances de valeurs standard :




Ajouter les autorisations

  • Ouvrez l'onglet Authorization.
  • Ajoutez d'abord l'autorisation Factorial.
  • Cliquez sur Add authorization (TEST and LIVE), saisissez un nom reconnaissable et utilisez Connect to app pour vous connecter à Factorial (la connexion est automatique si vous êtes déjà connecté dans votre navigateur). Faites-le impérativement avec votre compte administrateur. Assurez-vous que la version de test est active avant votre premier test. 

  • Approuvez l'accès demandé et enregistrez la connexion.

  • Ajoutez ensuite l'autorisation Sage.
  • Saisissez l'URL de l'Agent BrynQ au format suivant : https://[your-customer-slug]-brynq-agent.com
  • Saisissez le jeton de l'Agent BrynQ (BrynQ Agent Token) qui vous a été fourni précédemment et que vous avez indiqué dans le programme d'installation.

Publier et planifier l'interface

  • Publiez l'interface lorsque les onglets requis sont complétés.
  • Ouvrez l'onglet Schedule.
  • Choisissez la fréquence d'exécution.
  • Définissez l'heure de début et le fuseau horaire.
  • Activez la planification et enregistrez-la.
  • Si BrynQ indique que la planification ne peut pas être activée, retournez dans Authorization et complétez d'abord la connexion manquante.

Vérifier la première exécution automatisée

  • Attendez la première exécution planifiée ou lancez un test contrôlé.
  • Sur le serveur Sage, vérifiez qu'un nouveau fichier d'importation Excel a été créé dans le dossier d'importation configuré.
  • Dans Sage, vérifiez que les fiches salariés ont été créées ou mises à jour correctement.

Plus d'informations

Si une application utilisée par le modèle est encore inactive, activez-la d'abord dans Settings > Interfaces > Apps.

Si vous devez consulter ou supprimer une autorisation ultérieurement, ouvrez Settings > Interfaces > Connections.

Si l'importation manuelle dans Sage fonctionne mais pas l'exécution automatisée, vérifiez d'abord l'Agent BrynQ sur http://localhost:7071, puis testez à nouveau l'autorisation Sage depuis l'onglet Authorization dans BrynQ.