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

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

📌 Ce guide concerne : Agent BrynQ 3.10 ou plus récent (captures d'écran : 3.10.1) · Sage 100 France v9. Une autre version ? Voir Commencer ici – choisissez votre version.

Mis à jour pour Sage 100 France v9 et l'Agent BrynQ 3.10.1. Le programme d'installation vérifie votre jeton BrynQ pendant la saisie, présente les étapes du compte de service Sage et des modèles d'import sur des pages dédiées, et crée lui-même le scénario ConnectImport. La page d'administration a un nouveau look et une page Dépannage avec un fichier de support pour le support BrynQ.

* Nouveautés avec Sage v9 et l'Agent 3.10

  • Les nouveaux salariés sont envoyés dans un fichier séparé, <dossier>_EN_ATTENTE.xlsx, que Sage importe dans Salariés en attente (modèle d'import BrynQ Salariés en attente). La paie les embauche ensuite dans Sage : Gestion > Salariés en attente, sélectionnez les lignes avec Tout et cliquez sur Embaucher. Tant qu'ils ne sont pas embauchés, BrynQ les ignore lors des exécutions suivantes.
  • Embaucher n'est disponible que si DPAE envoyée est cochée (d'après la question DPAE de l'onglet Configuration) et que les lignes sont sélectionnées avec Tout.
  • Pour la DPAE, vérifiez que la commune de naissance et la date de fin de période d'essai sont renseignées dans Factorial.
  • Sage v9 exige un matricule d'exactement 4 caractères.
  • Erreur « Code pays inexistant » : le pays doit être le code à 3 lettres (par exemple FRA). La correspondance des pays préremplie s'en charge.
  • L'import indique « Import terminé avec succès » mais le salarié n'apparaît pas : en v9, les nouveaux salariés apparaissent d'abord dans Salariés en attente.
  • Nouvelle étape d'installation : créez trois modèles d'import vides dans Sage, avec exactement les bons titres. Voir l'étape 5.

Ce que vous allez obtenir

À la fin de ce guide, les données de base des salariés circulent automatiquement de Factorial vers Sage 100 France (v9). Plus d'exports manuels ni de copier-coller.

Comment ça fonctionne

Il est utile de visualiser le flux avant de commencer. Chaque exécution suit quatre étapes :

  1. BrynQ lit les données des salariés dans Factorial.
  2. BrynQ convertit ces données en un fichier d'import Excel compréhensible par Sage.
  3. L'Agent BrynQ, un petit programme installé sur votre serveur Sage, reçoit le fichier.
  4. ConnectImport importe le fichier dans la bonne société Sage (fichier PRH).

Vous configurez donc deux choses : l'Agent sur le serveur Sage (partie 1) et l'interface dans BrynQ (partie 2).

Savoir où vous êtes

Ce guide passe d'un endroit à l'autre. Chaque étape commence par une indication 📍 Où pour que vous sachiez toujours où travailler :

📍 IndicationDe quoi s'agit-il
Serveur WindowsL'ordinateur (la machine) sur lequel Sage 100 France est installé. C'est ici que vous installez l'Agent BrynQ.
SQL ServerLe logiciel de base de données qui stocke les données Sage. Il tourne généralement sur le même serveur Windows, mais il peut aussi être installé sur une autre machine. Dans le programme d'installation, vous saisissez uniquement son nom.
Sage 100 FranceL'application Sage elle-même, ouverte sur le serveur Windows.
BrynQLa plateforme BrynQ dans votre navigateur (https://votre-slug.app.brynq.com).
FactorialFactorial dans votre navigateur.

Le parcours en un coup d'œil

PartieCe que vous faites📍 OùQui
1.ATélécharger l'Agent BrynQBrynQ, ouvert sur le serveur WindowsAdministrateur du serveur
1.BInstaller et configurer l'Agent, et créer les modèles d'import BrynQ dans SageServeur Windows + Sage 100 FranceAdministrateur du serveur et administrateur Sage
1.CVérifier que l'Agent fonctionneServeur WindowsAdministrateur du serveur
2Créer, configurer et connecter l'interfaceBrynQ (+ Factorial et Sage pour consulter des valeurs)Administrateur BrynQ et Factorial

Avant de commencer

Commencez par cocher cette liste. Chaque point vous évite une raison fréquente de rester bloqué en cours de route.

  • ☐ 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 (voir l'encadré ci-dessous).
  • ☐ Un administrateur Sage 100 France, ainsi qu'un utilisateur paie capable de vérifier les résultats d'import.
  • ☐ Un accès administrateur au serveur Windows sur lequel tourne Sage, y compris aux fichiers PRH de Sage et aux dossiers programFiles et programData.
  • ☐ Accès à la base de données : le compte utilisé par l'Agent pour se connecter à SQL Server (votre compte Windows ou un identifiant SQL Server) doit avoir accès aux bases de données des sociétés Sage. En cas de doute, vérifiez-le avec votre administrateur informatique avant de commencer.
  • ☐ Le serveur Windows tourne sous Windows Server 2016 ou plus récent. Le programme d'installation ne démarre pas sur les versions plus anciennes.
  • ☐ Un jeton d'API BrynQ pour ce client, à portée de main. Créez-le dans BrynQ sous Admin Portal > API Access > Add API token en sélectionnant un seul client, ou demandez-le au support BrynQ.
    Pourquoi : vous en avez besoin dans la partie 1 et dans la partie 2. Si le jeton a une liste blanche d'adresses IP dans BrynQ, elle doit inclure l'adresse IP publique du serveur Windows.
⚠ Utilisez un compte ADMINISTRATEUR Factorial
BrynQ synchronise uniquement les salariés que l'utilisateur Factorial connecté peut voir.
Avec un compte non administrateur, des salariés manqueront dans Sage.


Regardez d'abord : la vidéo de la partie 1

💡 Astuce : regardez une vidéo pour voir ce qu'il faut faire, puis utilisez les étapes écrites ci-dessous pour le détail de chaque étape.

Vidéo 1 : l'installation complète, expliquée étape par étape (Sage v8, Agent BrynQ 3.9.4). Elle n'inclut pas l'étape 5 (les modèles d'import).


🎬 Vidéo 2 : Sage v9 et Agent 3.10, avec l'étape 5
La même installation que la vidéo 1, plus l'explication de l'étape 5 (créer les trois modèles d'import dans Sage), absente de la vidéo 1. Elle passe plus rapidement sur les autres étapes ; regardez la vidéo 1 si vous les voulez plus en détail.

Cette vidéo montre l'Agent 3.10.0. Depuis la 3.10.1, quelques pages du programme d'installation sont différentes ; ce sont les étapes du texte ci-dessous qui font foi.


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

📍 Où : BrynQ, ouvert dans un navigateur sur le serveur Windows où tourne Sage.
Objectif : placer le programme d'installation de l'Agent sur ce serveur.

  1. Connectez-vous à BrynQ et allez dans Organization > Agent.
  2. Téléchargez la dernière version du programme d'installation de l'Agent BrynQ (brynq-agent-installer-<version>.exe).



ℹ Avertissement de sécurité ? Les fichiers sont signés et publiés sous le nom 'Salure ICT BV'. Votre navigateur ou Windows peut néanmoins les signaler comme non fiables. C'est normal et vous pouvez continuer.

Partie 1.B) Installer et configurer l'Agent

📍 Où : le serveur Windows (programme d'installation), plus Sage 100 France pour les étapes 4 et 5.
Objectif : installer l'Agent et le connecter à SQL Server et à vos sociétés Sage.

💡 Astuce : le programme d'installation remplit lui-même la plupart des valeurs : les fichiers PRH, la connexion SQL (lue dans les fichiers PRH) et l'installation Sage qu'il trouve sur le serveur. Les valeurs proposées conviennent généralement : gardez-les et cliquez sur Suivant, sauf indication contraire dans une étape ci-dessous. Certaines pages ne s'affichent que si elles sont nécessaires ; vous verrez donc peut-être moins de pages que décrit ici.
⚠ Droits Windows
  • Installer en tant qu'administrateur : faites un clic droit sur le programme d'installation et choisissez Exécuter en tant qu'administrateur.
  • Logiciel signé : le programme d'installation est signé numériquement (clic droit > Propriétés > Signatures numériques indique l'éditeur). Windows affiche Windows a protégé votre ordinateur ? Cliquez sur Informations complémentaires > Exécuter quand même. Si votre organisation n'autorise que des éditeurs approuvés (AppLocker, antivirus), demandez à votre service informatique d'autoriser l'Agent comme décrit dans Sécurité de l'Agent BrynQ. Fichier bloqué après le téléchargement ? Clic droit > Propriétés > cochez Débloquer.
  • Pendant le fonctionnement : les services BrynQ s'exécutent sous LocalSystem. Ce compte doit pouvoir lire et écrire dans les dossiers Sage, les fichiers PRH et le dossier d'import. Avec l'authentification Windows, c'est aussi le compte que voit SQL Server : NT AUTHORITY\SYSTEM, ou le compte ordinateur DOMAINE\NOMSERVEUR$ lorsque SQL Server ou les fichiers Sage se trouvent sur un autre serveur.
  • Dossier créé par un autre utilisateur ? L'installation s'arrête lorsqu'un des dossiers de BrynQ (par exemple C:\ProgramData\BrynQ\Agent ou son dossier config) a été créé par un autre utilisateur Windows. Le message indique la commande takeown qui corrige le problème.
  • Est-ce un problème de droits ? Cherchez Access is denied, Permission denied ou Login failed dans le journal du programme d'installation (une copie est conservée dans C:\ProgramData\BrynQ\Agent\logs\installer, sous le nom setup-<date>-<time>.log) ou dans les journaux de l'Agent (C:\ProgramData\BrynQ\Agent\logs\agent et \sage).

Vérifications avancées (pour l'informatique) :

  • Journaux des services et de l'installation : C:\ProgramData\BrynQ\Agent\logs\services (par exemple BrynQAgentService.err.log) indique pourquoi un service s'est arrêté ; logs\installer\install-post.log indique les étapes d'installation et celle qui a échoué.
  • Observateur d'événements (eventvwr.msc) : sous Journaux Windows > Système, les événements du Service Control Manager (Gestionnaire de contrôle des services) indiquent pourquoi un service BrynQ n'a pas démarré ou s'est arrêté. Sous Journaux Windows > Application, un Login failed de SQL Server (événement 18456) signifie que le compte de l'Agent n'a pas accès à SQL.
  • Compte du service : dans services.msc, ouvrez un service BrynQ > Connexion pour voir sous quel compte il s'exécute.
  • Accès aux dossiers : clic droit sur un dossier Sage > Propriétés > Sécurité > Avancé > Accès effectif, sélectionnez SYSTEM (ou le compte ordinateur) et cliquez sur Afficher l'accès effectif.

Étape 1 : Lancer le programme d'installation

  1. Lancez le programme d'installation et choisissez votre langue. Le programme d'installation propose la langue de Windows. Les pages BrynQ sont disponibles en anglais, français, allemand et néerlandais ; le contrat de licence est en anglais, et les noms des écrans Sage restent en français. Les captures d'écran ci-dessous sont en anglais.

    00-language
  2. Lisez attentivement le contrat de licence. Si vous l'acceptez et souhaitez utiliser l'Agent BrynQ, acceptez-le pour continuer.
  3. Conservez le chemin d'installation par défaut (prérempli). Il convient à la plupart des configurations, mais vous pouvez choisir un autre dossier si vous le souhaitez. Cette page ne s'affiche que lors d'une première installation.
  4. Connexion cloud : collez le jeton d'API BrynQ (voir « Avant de commencer »). Le programme d'installation vérifie le jeton auprès de BrynQ pendant la saisie. Suivant devient disponible dès que la page indique BrynQ accepte ce jeton.
    03-cloud-connection
    Jeton refusé ?
    • BrynQ n'accepte pas ce jeton (…) : vérifiez que vous avez copié le jeton en entier. La raison est indiquée entre parenthèses, par exemple TOKEN_NOT_FOUND ou TOKEN_EXPIRED.
    • BrynQ n'accepte ce jeton que depuis d'autres adresses IP : ajoutez l'adresse IP publique de ce serveur au jeton dans BrynQ, puis cliquez sur Vérifier à nouveau.
    • …ce n'est pas un jeton d'agent : un jeton d'agent est lié à un seul client. Utilisez le jeton d'agent de ce client.
    • Impossible de joindre BrynQ ou La plateforme BrynQ ne répond pas : patientez un instant et cliquez sur Vérifier à nouveau.
    Vous réinstallez sur le même serveur ? La page indique que le serveur est déjà connecté. Gardez Garder le jeton d'API existant (recommandé), ou choisissez Le remplacer par un nouveau jeton d'API.
  5. Modules : cochez Sage 100 France (sous Intégrations de paie). Cela active aussi SQL Server et Gestion des fichiers ; ils restent cochés et grisés. Cochez aussi Proxy REST si BrynQ vous l'a demandé. Vous pourrez modifier les modules plus tard en relançant le programme d'installation.
    04-modules

Étape 2 : Choisir vos sociétés Sage

Idée clé : chaque fichier PRH correspond à la base de données d'une société dans Sage. Sélectionner un fichier PRH signifie « BrynQ peut importer dans cette société ».

  1. Le programme d'installation recherche d'abord Sage 100 Paie & RH et les fichiers PRH sur le serveur. Cela peut prendre quelques minutes. Sur la page Sociétés Sage, cochez les fichiers PRH des sociétés que vous voulez relier à l'interface.
    Uniquement si une société manque : ajoutez son fichier PRH avec Ajouter un PRH.... Si cette société est déjà cochée, le programme d'installation demande s'il faut remplacer son fichier. Rechercher à nouveau relance la recherche et conserve les fichiers que vous avez ajoutés.
    07-sage-select-companies

Étape 3 : Se connecter à SQL Server

BrynQ lit la connexion SQL dans les fichiers PRH que vous avez cochés. Lorsque cette connexion fonctionne, le programme d'installation saute cette étape. Cochez Vérifier moi-même la connexion SQL sur la page précédente si vous voulez quand même la voir.

  1. Connexion SQL Server :
    • Serveur : choisissez le serveur proposé, souvent NOMSERVEUR\SQLEXPRESS. Vous ne savez pas ? SQL Server Management Studio affiche le nom du serveur lors de la connexion, ou demandez à votre administrateur informatique.
    • Méthode de connexion : Authentification Windows, ou Authentification SQL Server si votre configuration utilise un identifiant SQL Server. Seule cette dernière demande un Nom d'utilisateur et un Mot de passe. Ce compte doit avoir accès aux bases de données Sage.
    • Cliquez sur Tester la connexion. Le programme affiche Connexion réussie, ou la raison de l'échec.
    • Avancé... affiche le Pilote ODBC et les Options de connexion supplémentaires (par défaut Encrypt=no;TrustServerCertificate=yes). Ne les modifiez que si le test échoue ; prenez le pilote portant le numéro le plus élevé (par exemple ODBC Driver 18 for SQL Server).
    08-sql-connection
  2. Bases de données : gardez Uniquement les bases que je sélectionne (recommandé) et cochez au moins les bases de données de vos sociétés Sage. Une base de données ne figure pas dans la liste ? Cliquez sur Base de données absente de la liste ? et ajoutez son nom. Toutes les bases de données de ce serveur inclut aussi les bases ajoutées par la suite.
    Ce choix enregistre seulement les bases de données utilisées par les interfaces BrynQ. Il ne limite pas l'accès : pour limiter l'accès, ne donnez à l'identifiant SQL des droits que sur ces bases de données.
    09-sql-databases

Étape 4 : Créer un utilisateur de service Sage

📍 Où : Sage 100 France.
Pourquoi : l'Agent a besoin de son propre compte Sage, afin que les imports ne dépendent pas de l'identifiant d'une personne.

La page Compte de service Sage du programme d'installation reprend les mêmes étapes.

  1. Ouvrez Sage 100 France, connectez-vous à un fichier PRH, allez dans Fichier > Droits d'accès > Utilisateurs et cliquez sur +.


  2. Réglez Mode d'authentification sur Compte de service. Saisissez une description reconnaissable (par exemple BrynQ) et laissez la date de validité vide. Cochez Token actif et cliquez sur Générer.
    Exemple :

  3. 📍 De retour dans le programme d'installation, collez le Code de l'utilisateur de service (par exemple AAA, pas le nom de connexion) et le Token.
    10-sage-service-account
  4. 📍 Dans Sage, cliquez sur OK. L'utilisateur n'est créé qu'après cette étape.
🔍 Installation Sage
Ensuite, le programme d'installation choisit le Sage 100 Paie & RH dans lequel BrynQ importe. S'il n'y a qu'une installation, il le fait lui-même. S'il y en a plusieurs, la page Installation Sage les affiche chacune avec sa version et son dossier : choisissez celle que vous utilisez pour la paie. C'est dans celle-ci que vous créez les modèles d'import à l'étape 5. Elle n'est pas dans la liste ? Cliquez sur Parcourir... et sélectionnez son pmsw32.exe ou son ConnectImport.exe. Les versions plus anciennes (v8) ne peuvent être choisies qu'après un avertissement ; une installation sans ConnectImport ou sans dossier de données ne peut pas être choisie.
11-sage-installation

Étape 5 : Créer les trois modèles d'import BrynQ dans Sage (nouveau dans l'Agent 3.10)

📍 Où : Sage 100 France et le programme d'installation, tous deux ouverts sur le serveur Windows.

Titre (Intitulé)Fichier racine
BrynQ SalariésFiche salarié
BrynQ Salariés en attenteSalariés en attente
BrynQ AbsencesBulletin de paie > Evènements

A. Ouvrir l'écran des modèles dans Sage

  1. Le programme d'installation affiche maintenant la page Modèles d'import Sage. En haut, il indique combien des trois modèles il a trouvés ; en dessous figure une ligne par modèle : une coche verte avec le code Sage (trouvé), une croix rouge avec la raison, ou un sablier pendant la vérification. Sélectionnez une ligne pour voir son titre avec un bouton Copier et les huit étapes pour ce modèle. Laissez la page ouverte.
    12-sage-import-models
  2. Ouvrez Sage 100 Paie & RH (l'installation indiquée en haut de la page). Inutile d'ouvrir une société.
  3. Allez dans G.A. > Format d'Importation.

B. Modèle 1 : BrynQ Salariés

  1. Cliquez sur le + en bas de la liste.
  2. Sélectionnez Fiche salarié et cliquez sur Ok.
  3. Un écran pour les champs s'ouvre. Ne modifiez rien : fermez-le avec la croix X en haut à droite.
  4. La fenêtre d'enregistrement s'ouvre. Dans le programme d'installation, sélectionnez la ligne BrynQ Salariés et cliquez sur Copier. Dans Sage, collez le titre dans Intitulé (Ctrl+V) et cliquez sur Ok.
  5. Dans le programme d'installation, cliquez sur Vérifier à nouveau. La ligne BrynQ Salariés a maintenant une coche verte ✔ et son code Sage. Le programme d'installation vérifie aussi de lui-même toutes les quelques secondes.

C. Modèle 2 : BrynQ Salariés en attente

Mêmes étapes, avec un autre fichier racine et un autre titre.

  1. Cliquez sur +.
  2. Faites défiler vers le bas, sélectionnez Salariés en attente et cliquez sur Ok.
  3. Fermez l'écran des champs avec la croix X.
  4. Copiez BrynQ Salariés en attente dans le programme d'installation, collez-le dans Intitulé et cliquez sur Ok.
  5. Cliquez sur Vérifier à nouveau : BrynQ Salariés en attente a une coche verte ✔.

D. Modèle 3 : BrynQ Absences

Encore les mêmes étapes. Le fichier racine se trouve un niveau plus bas, sous Bulletin de paie.

  1. Cliquez sur +.
  2. Sélectionnez Bulletin de paie et cliquez sur Ok.
  3. Sélectionnez Evènements et cliquez sur Ok.
  4. Fermez l'écran des champs avec la croix X.
  5. Copiez BrynQ Absences dans le programme d'installation, collez-le dans Intitulé et cliquez sur Ok.
  6. Cliquez sur Vérifier à nouveau : BrynQ Absences a une coche verte ✔.

E. Fermer Sage et continuer

  1. Tant que Sage est ouvert, la page indique Les 3 modèles sont trouvés. Fermez Sage 100 Paie & RH sur ce serveur (toutes les sessions) pour continuer. Fermez Sage 100 Paie & RH complètement (y compris les autres sessions sur ce serveur).
  2. La page indique maintenant Les 3 modèles sont trouvés. Cliquez sur Suivant pour continuer. Cliquez sur Suivant.
    12b-sage-import-models-done
✖ Une ligne a encore une croix rouge ? Suivant reste indisponible tant que les trois modèles ne sont pas trouvés et que Sage n'est pas fermé. Sélectionnez la ligne : le programme d'installation vous indique quoi faire.
  • Introuvable : le titre n'est pas exactement correct, ou le modèle n'a pas été enregistré. Copiez à nouveau le titre et corrigez-le dans Sage. Les majuscules/minuscules et les espaces autour du titre n'ont pas d'importance.
  • Renommé : le modèle utilisé jusqu'ici par BrynQ a un autre titre dans Sage. Redonnez-lui exactement le titre affiché (utilisez le bouton Copier).
  • En double : plusieurs modèles ont ce titre. Gardez le modèle indiqué par le programme d'installation et supprimez ou renommez les autres dans Sage.
  • Mauvais Fichier racine : le modèle a été créé avec un autre fichier racine. Supprimez-le dans Sage et recréez-le avec le fichier racine du tableau.
  • Ce modèle se trouve dans une autre installation Sage : créez-le dans l'installation Sage indiquée en haut de la page.
  • La liste des modèles de Sage est introuvable : créez d'abord les modèles dans Sage, puis cliquez sur Vérifier à nouveau.
ℹ Bon à savoir
  • Sage attribue un code à chaque modèle (par exemple IMP00012). Vos codes peuvent différer des captures d'écran ; seuls les titres comptent.
  • Ne renommez ni ne modifiez les modèles BrynQ par la suite. BrynQ vérifie leurs titres à chaque cycle d'import : si un titre n'est plus exact, rien n'est importé tant qu'il n'est pas corrigé (les fichiers restent en file d'attente). Les modifications de leurs champs sont annulées par BrynQ.
  • Vous mettez l'Agent à jour plus tard ? Vous ne revoyez cette page que si un modèle n'est pas correct ou si Sage est ouvert. Un signe d'information bleu (champs modifiés dans Sage) ou une note indiquant que les fichiers du modèle manquent ne demande aucune action : BrynQ rétablit le modèle lui-même. Les mises à jour automatiques et les installations silencieuses n'affichent jamais cette page.
  • FACULTATIF : après l'installation, vous retrouvez les trois modèles sous G.A. > Format d'Importation. Sélectionnez-en un et cliquez sur le crayon pour voir les champs remplis par BrynQ. Ne les modifiez pas.

Étape 6 : Terminer l'installation

  1. Scénario ConnectImport : gardez Laisser BrynQ créer le scénario (recommandé) et cliquez sur Suivant. Ne choisissez Utiliser mon propre scénario ConnectImport que si le support BrynQ vous le demande.
    Vous réinstallez ? Gardez Garder le scénario actuel (recommandé). Recréer le scénario à partir des paramètres BrynQ écrase le scénario actuel.
    13-connectimport-scenario
  2. Options supplémentaires :
    • Raccourcis : gardez Créer une icône sur le Bureau (recommandé), et Créer un raccourci dans le menu Démarrer si vous le souhaitez. Tous deux vous mènent ensuite directement à la page d'administration de l'Agent.
    • Support BrynQ : Partager le diagnostic avancé (recommandé) permet au support BrynQ de collecter des informations Windows supplémentaires lorsque les journaux n'expliquent pas un problème. Cliquez sur Que voit le support BrynQ ? pour lire exactement lesquelles. Vous pourrez modifier ce choix plus tard sur la page d'administration, sous Dépannage.
    • FACULTATIF : à ignorer sauf besoin. Utiliser des paramètres réseau locaux personnalisés n'est nécessaire que si un autre programme de ce serveur utilise déjà le port 7070 ou 7071. Vous ne savez pas ? Laissez la case décochée.
    14-additional-options
  3. Cliquez sur Installer. Le programme d'installation affiche chaque étape. Si la dernière étape échoue (par exemple parce que BrynQ ne répond pas pendant un instant), il en indique la raison et propose Réessayer : tous vos choix sont conservés.
  4. FACULTATIF. Laissez Ouvrir le tableau de bord de l'agent BrynQ coché et cliquez sur Terminer, ou utilisez plus tard le raccourci ou ouvrez http://127.0.0.1:7071/admin dans un navigateur sur le serveur Windows (Edge, Chrome ou Firefox ; Internet Explorer ne peut pas l'afficher). La page d'administration est disponible en anglais, français, allemand et néerlandais ; changez de langue en haut de la page.
    01-home

Partie 1.C) Vérifier que l'Agent fonctionne

📍 Où : le serveur Windows.

✅ Point de contrôle 1 : vérifiez ceci avant de passer à la partie 2.
  1. Ouvrez le Gestionnaire des tâches et allez dans l'onglet Services.
  2. Vérifiez que les trois services BrynQ ont le statut En cours d'exécution.
Ou ouvrez la page d'administration (http://127.0.0.1:7071/admin) et allez dans Dépannage : Services BrynQ affiche 3 sur 3 actifs.



20-troubleshooting-all-ok

✖ Un service ne fonctionne pas ?
  1. Faites un clic droit sur le service et choisissez Démarrer.
  2. Patientez un instant et vérifiez que le statut passe à En cours d'exécution.
  3. Le service ne démarre pas ou s'arrête à nouveau ? C'est souvent un problème de droits : vérifiez Droits Windows au début de la partie 1.B et cherchez Access is denied dans les journaux. Toujours bloqué ? Contactez le support BrynQ en joignant une capture d'écran de l'onglet Services et le fichier de support (voir Trouver les fichiers journaux de l'Agent).
💡 À retenir : chaque fois que BrynQ ne parvient pas à joindre l'Agent par la suite, vérifiez d'abord ces trois services.

Partie 2) Créer l'interface dans BrynQ

📍 Où : BrynQ (depuis n'importe quel ordinateur). Vous consultez seulement des valeurs dans Factorial et Sage 100 France.
Objectif : indiquer à BrynQ quoi synchroniser et où l'envoyer.

Étape 1 : Créer l'interface à partir du modèle

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

  4. Cliquez sur Use template.

Étape 2 : Remplir l'onglet Configuration

  1. Ouvrez l'onglet Configuration.


  2. Définissez la fréquence de paie de la société.

  3. FACULTATIF (recommandé). Saisissez quelques identifiants de salariés. Les premières exécutions ne traiteront alors que ces salariés, ce qui vous permet de tester sans risque.

  4. Répondez à la question La DPAE est-elle envoyée en dehors de Sage ? par oui ou non (yes/no, ja/nee, ja/nein et 1/0 fonctionnent aussi). Cette réponse est obligatoire : sans réponse valide, l'exécution s'arrête.

Étape 3 : Compléter les correspondances de valeurs dans l'onglet Scenarios

Idée clé : une correspondance de valeurs (value mapping) traduit une valeur de Factorial en la valeur équivalente dans Sage. Chaque élément marqué d'un point d'exclamation (!) attend encore votre saisie.

À vérifier dans Factorial avant la première exécution

  • Chaque contrat a un type de contrat français. Il détermine la nature du contrat dans Sage ; s'il manque, ce champ reste vide et le journal d'exécution affiche un avertissement.
  • Les heures de travail et leur fréquence sont renseignées. BrynQ les utilise pour la quotité de travail mensuelle (par exemple 35 h/semaine = 151,67).

La plupart des correspondances de valeurs, comme les pays (codes à 3 lettres comme FRA) et la civilité, sont déjà préremplies. Il vous suffit de les vérifier.

  1. Ouvrez l'onglet Scenarios et repérez les éléments marqués d'un point d'exclamation.

Exemple détaillé : 'Legal Entity -> Paying Establishment and Dossier'
Vous trouverez cette correspondance dans le scénario Immatriculation. C'est la correspondance la plus importante : elle détermine quelle entité juridique Factorial est synchronisée vers quelle société Sage. Nous la parcourons pas à pas ; les autres correspondances fonctionnent de la même manière.

  1. Partie gauche (📍 Factorial) : trouvez l'ID et le nom de l'entité juridique sous Paramètres > Informations sur l'entreprise.


  2. 📍 BrynQ : saisissez cette valeur dans la partie gauche de la correspondance. Vous synchronisez plusieurs entités ? Ajoutez une ligne par entité.

  3. Partie droite (📍 Sage 100 France) : trouvez la Raison sociale / le dossier correspondant au fichier PRH de Sage. Dans cet exemple, le dossier est 'BRYNQ.PRH'.
  4. 📍 Sage 100 France : trouvez également l''Etablissement principal' correspondant.

  5. 📍 BrynQ : saisissez ces valeurs dans la partie droite de la correspondance. Le résultat ressemble à ceci :

  6. Confirmez la correspondance et enregistrez-la.

À vous de jouer : complétez les autres correspondances non standard de la même manière (cherchez la valeur de chaque côté, saisissez-la, confirmez, enregistrez) :




Enfin, vérifiez que les correspondances de valeurs standard sont correctes pour votre société :





Étape 4 : Connecter Factorial et Sage (onglet Authorization)

  1. Ouvrez l'onglet Authorization.
  2. D'abord Factorial : cliquez sur Add authorization (TEST and LIVE), saisissez un nom facilement reconnaissable et cliquez sur Connect to app.
    • Connectez-vous avec votre compte ADMINISTRATEUR Factorial.
    • Assurez-vous que la version TEST est active avant votre premier test.
    ⚡ Attention : la connexion peut se faire automatiquement !
    Êtes-vous déjà connecté à Factorial dans ce navigateur, avec une session active (cookie de session) ? Dans ce cas, Connect to app se connecte immédiatement avec ce compte, sans vous demander de vous identifier.
    Donc, avant de cliquer : vérifiez que vous êtes connecté à Factorial avec le compte administrateur. Sinon, déconnectez-vous d'abord de Factorial, ou utilisez une fenêtre de navigation privée.

  3. Approuvez l'accès demandé et enregistrez la connexion.
  4. Ensuite Sage : ajoutez l'autorisation Sage.
  5. Saisissez l'URL de l'Agent BrynQ au format suivant : https://[votre-slug-client].brynq-agent.com
    Où trouver votre slug : c'est la première partie de votre adresse web BrynQ. L'adresse exacte se trouve aussi dans C:\ProgramData\BrynQ\Agent\config\public_url.txt sur le serveur Windows. Si vous vous connectez sur https://acme.app.brynq.com, votre slug est acme et l'URL de l'Agent est https://acme.brynq-agent.com.
  6. Saisissez le BrynQ Agent Token (jeton de l'Agent BrynQ) : le même jeton que vous avez reçu précédemment et saisi dans le programme d'installation.

Vérifier la première exécution

✅ Point de contrôle 2 : après un test contrôlé :
  1. 📍 Serveur Windows : un nouveau fichier d'import Excel apparaît dans le dossier d'import de la société : <dossier>.xlsx pour les salariés existants, et <dossier>_EN_ATTENTE.xlsx s'il y a de nouveaux salariés. Une fois importés, l'Agent déplace les fichiers dans un sous-dossier nommé importe le <date et heure>.
  2. 📍 Sage 100 France : les salariés existants sont mis à jour, et les nouveaux salariés apparaissent sous Gestion > Salariés en attente. Embauchez-les à cet endroit : sélectionnez les lignes avec Tout et cliquez sur Embaucher. Commencez par les identifiants de salariés de test saisis à l'étape 2.
✖ Quelque chose s'est mal passé ?
  • Aucun fichier d'import sur le serveur : lisez d'abord le journal d'exécution de l'interface (interface > Runs). Aucun fichier n'est envoyé lorsque l'interface n'a trouvé aucun salarié nouveau ou modifié, ou lorsqu'ils ont tous été filtrés (droits Factorial, données, correspondances de valeurs). Le journal d'exécution indique qu'un fichier a été envoyé ? Alors BrynQ n'a pas pu le transmettre à l'Agent : vérifiez les trois services BrynQ (partie 1.C) et testez à nouveau l'autorisation Sage.
  • « Import terminé avec succès », mais pas de nouveau salarié : regardez d'abord sous Salariés en attente (Sage v9).
  • Le fichier d'import est présent, mais Sage n'a aucune fiche ou des fiches erronées : vérifiez le journal d'exécution, les données dans Factorial et les correspondances de valeurs dans l'onglet Scenarios, en particulier Immatriculation.
  • Certains salariés manquent : vérifiez le journal d'exécution. Causes fréquentes : droits Factorial (reconnectez-vous avec un compte administrateur), données manquantes ou erronées dans Factorial, ou une correspondance de valeurs non renseignée.
  • Toujours bloqué ? Consultez la section de dépannage ci-dessous, ou contactez le support BrynQ en joignant le fichier de support (page d'administration > Dépannage > Télécharger le fichier de support).

Dépannage

Ce que vous constatezQue faire
Une erreur que vous ne savez pas expliquerOuvrez la page d'administration (http://127.0.0.1:7071/admin) > Dépannage : elle vérifie les services, la connexion avec BrynQ, l'accès aux dossiers et plus encore, et liste les solutions aux problèmes fréquents. Transmettez le fichier de support au support BrynQ (voir Trouver les fichiers journaux de l'Agent ci-dessous).
Une partie de l'installation échoue, ou l'Agent tourne mais ne peut pas lire ou écrire de fichiersVérifiez les droits Windows : lancez le programme d'installation en tant qu'administrateur et assurez-vous que le compte Windows de l'Agent peut lire et écrire dans les dossiers Sage, les fichiers PRH, programFiles et programData. Voir l'avertissement au début de la partie 1.B.
Programme d'installation : Suivant reste indisponible sur Connexion cloudBrynQ n'accepte pas encore le jeton. La page indique pourquoi : copiez le jeton en entier, ajoutez l'adresse IP publique du serveur au jeton dans BrynQ, ou utilisez le jeton d'agent de ce client. Cliquez ensuite sur Vérifier à nouveau. Voir la partie 1.B, étape 1.
Programme d'installation : Suivant reste indisponible sur Modèles d'import SageUne ligne a encore une croix rouge, ou Sage est encore ouvert. Voir l'étape 5 pour la signification de chaque message ; fermez Sage (toutes les sessions) une fois les trois modèles trouvés.
Tous les salariés ne sont pas synchronisésLisez d'abord le journal d'exécution de l'interface (interface > Runs). Causes fréquentes : l'utilisateur Factorial ne voit pas tous les salariés (reconnectez-vous avec un compte administrateur Factorial), des données manquantes ou erronées dans Factorial, une correspondance de valeurs non renseignée, ou des identifiants de salariés de test encore présents dans l'onglet Configuration. Voir Salariés : Dépannage.
'Erreur mot de passe' sur le serveur Sage (cela arrive souvent)Vérifiez d'abord le code et le token du compte de service Sage, puis réinitialisez l'utilisateur ou le dossier dans Sage. Voir Corriger 'Erreur mot de passe' ci-dessous.
BrynQ ne parvient pas à joindre l'AgentVérifiez que les trois services BrynQ sont en cours d'exécution (partie 1.C), puis ouvrez http://127.0.0.1:7071/admin sur le serveur Windows et allez dans Connexion BrynQ : Cet agent se connecte à BrynQ et BrynQ joint cet agent doivent tous deux être OK. Testez ensuite à nouveau l'autorisation Sage depuis l'onglet Authorization.
Le programme d'installation ne parvient pas à se connecter à SQL ServerCliquez sur Tester la connexion et lisez la raison. Vérifiez que le nom du serveur est correct (étape 3), choisissez la bonne méthode de connexion (authentification Windows ou SQL Server), essayez le pilote ODBC portant le numéro le plus élevé sous Avancé... et assurez-vous que le compte a accès aux bases de données Sage.
Une application utilisée par le modèle est inactiveActivez-la dans Settings > Interfaces > Apps.
Un import manuel dans Sage fonctionne, mais pas l'exécution automatiséeVérifiez l'Agent sur la page d'administration (http://127.0.0.1:7071/admin) sous SAGE 100 France > Aperçu et Dépannage, puis testez à nouveau l'autorisation Sage depuis l'onglet Authorization.
Vous devez consulter ou supprimer une autorisationOuvrez Settings > Interfaces > Connections.

Trouver les fichiers journaux de l'Agent

📍 Où : le serveur Windows, dans l'Explorateur de fichiers.
Lorsqu'un problème survient, les fichiers journaux de l'Agent vous indiquent généralement pourquoi, à vous comme au support BrynQ. Il existe deux dossiers de journaux. Celui dont vous avez besoin dépend du problème :

ProblèmeDossier de journaux
L'import des données dans Sage échoue ou donne des résultats erronésC:\ProgramData\BrynQ\Agent\logs\sage
Problèmes généraux de l'Agent, comme des problèmes de connexionC:\ProgramData\BrynQ\Agent\logs\agent

Journaux d'import Sage (par exemple connectimport et connectimport-error) :

Journaux généraux de l'Agent (par exemple application, requests et security) :

Vous pouvez aussi lire les fichiers journaux sur la page d'administration : Dépannage > Fichiers journaux (les plus récents en premier ; cliquez sur un fichier pour le lire).

💡 Vous contactez le support BrynQ ? Joignez le fichier de support : sur la page d'administration, allez dans Dépannage (ou SAGE 100 France > Dépannage) et cliquez sur Télécharger le fichier de support. Il regroupe les journaux, les paramètres et l'état des services dans un seul fichier zip (brynq-agent-support-<customer>-<server>-<date>-<time>.zip), sans les mots de passe ni les jetons. La page d'administration ne s'ouvre pas ? Exécutez "C:\Program Files\BrynQ\Agent\brynq-agent.exe" --support-file dans une invite de commandes en tant qu'administrateur ; le fichier est enregistré sur votre Bureau. Cela évite généralement de nombreux allers-retours.

Vous ne voyez pas le dossier ProgramData ? Il est masqué par défaut. Saisissez directement C:\ProgramData\BrynQ\Agent\logs dans la barre d'adresse de l'Explorateur de fichiers.

Corriger 'Erreur mot de passe'

📍 Où : Sage 100 France, sur le serveur Windows.
L'erreur 'Erreur mot de passe' survient assez souvent sur le serveur Sage. Elle a deux causes fréquentes :

  • Le code ou le token du compte de service Sage utilisé par l'import BrynQ n'est pas correct, ou le token n'est plus actif. C'est la cause probable si aucun import avec ce compte n'a encore fonctionné, ou si quelqu'un a modifié le compte dans Sage.
  • Sage conserve encore une ancienne session du compte. C'est la cause probable si les imports fonctionnaient auparavant. Réinitialisez l'utilisateur ou le dossier (options A et B).

La page d'administration indique la cause probable : ouvrez http://127.0.0.1:7071/admin > SAGE 100 France > Dépannage et lisez le dernier message d'import.

Vérifiez d'abord le compte de service

  1. Dans Sage, allez dans Fichier > Droits d'accès > Utilisateurs et ouvrez le compte de service de l'import BrynQ.
  2. Vérifiez que Mode d'authentification est réglé sur Compte de service et que Token actif est coché. Notez le Code.
  3. Vous n'êtes pas sûr que le token est correct ? Cliquez sur Générer pour obtenir un nouveau token, copiez-le et cliquez sur OK.
  4. Sur le serveur Windows, ouvrez http://127.0.0.1:7071/admin > SAGE 100 France > Service. Vérifiez que le Code utilisateur Sage correspond au Code dans Sage. Si vous avez généré un nouveau token, cliquez sur Remplacer le jeton, collez-le et enregistrez.
  5. Attendez le prochain cycle d'import (15 minutes par défaut) et vérifiez à nouveau le message d'import.

Toujours 'Erreur mot de passe' ? Réinitialisez la session. Commencez par l'option A. N'utilisez l'option B que si l'option A ne suffit pas.

Option A : réinitialiser depuis la société (à essayer en premier)

  1. Ouvrez Sage 100 France et connectez-vous à la société (fichier PRH).
  2. Allez dans Fichier > Droits d'accès > Utilisateurs.
  3. Dans la Liste des utilisateurs, cliquez sur Réinitialisation.
  4. Réessayez la connexion.

Option B : réinitialisation globale du dossier (à vos risques et périls)

⚠ À vos risques et périls. Réinitialiser le dossier déconnecte tous les utilisateurs du dossier. Assurez-vous que personne ne travaille dans la paie avant de l'utiliser.
  1. Allez dans Fichier > Utilitaires > Réinitialisation.
    Vous ne voyez pas cette option ? Elle n'est parfois visible que lorsque vous n'êtes pas connecté à une société. Fermez d'abord la société (Fichier > Fermer) et regardez à nouveau.
  2. L'Assistant réinitialisation de dossier s'ouvre. Cliquez sur Parcourir... et sélectionnez le dossier (fichier PRH) à réinitialiser.
  3. Cliquez sur Réinitialiser le dossier. Pour déconnecter uniquement un utilisateur précis, sélectionnez cet utilisateur et cliquez plutôt sur Réinitialiser l'utilisateur.
  4. Cliquez sur Terminer et réessayez la connexion.

Récapitulatif

  • L'Agent installé sur le serveur Windows reçoit les fichiers d'import et les importe dans les fichiers PRH que vous avez sélectionnés. Il accède aux données Sage via SQL Server.
  • Les correspondances de valeurs déterminent quelle entité Factorial arrive dans quelle société Sage. Soyez particulièrement attentif à 'Legal Entity -> Paying Establishment and Dossier' dans Immatriculation.
  • Les autorisations relient BrynQ à Factorial (compte administrateur !) et à l'Agent.
  • Bloqué ? Vérifiez d'abord les trois services BrynQ, ainsi que la page Dépannage de la page d'administration. Contactez ensuite le support BrynQ en joignant le fichier de support.