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 :

Le parcours en un coup d'œil

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 compte 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.
• ☐ Un compte jeton 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.

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).

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.
   
   
   
   

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.

Étape 1 : Lancer le programme d'installation

1. Lancez le programme d'installation et choisissez votre langue. Les captures d'écran ci-dessous sont en anglais.
   
   
   
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.
4. Saisissez le jeton API BrynQ (voir « Avant de commencer »).
   Cette étape n'est nécessaire que lors de la première installation (complète).
5. Sélectionnez ces modules : SQL Server, File Management, REST Proxy et Sage 100 France.
   

É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é ».

6. Sélectionnez les fichiers PRH détectés que vous voulez relier à l'interface. La recherche des fichiers PRH peut prendre quelques minutes.
   Uniquement si une société manque : ajoutez son fichier PRH manuellement avec le bouton 'Add PRH File...'.
   
   

Étape 3 : Se connecter à SQL Server

7. Database driver : choisissez le pilote proposé. S'il y en a plusieurs, prenez le numéro le plus élevé (par exemple ODBC Driver 18 for SQL Server).
8. Server : 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.
9. Login method : Windows authentication, ou un compte SQL Server (nom d'utilisateur et mot de passe) si votre configuration en utilise un. Ce compte doit avoir accès aux bases de données Sage.
   
10. SQL Server — Database Access : choisissez les bases de données que l'Agent peut interroger : All databases ou Selected databases only. C'est à vous de décider ; si vous limitez l'accès, incluez au moins les bases de données de vos sociétés Sage.
    

É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.

11. Ouvrez Sage 100 France, connectez-vous à un fichier PRH et allez dans Fichier > Droits d'accès > Utilisateurs.
    
    
    
12. Créez un utilisateur de service dédié : saisissez un Code, activez 'Compte de service' et générez un Token. Vérifiez que le token est actif, et gardez le code et le token à portée de main pour le programme d'installation. La description est facultative, mais un nom reconnaissable (par exemple BrynQ) aide par la suite.
    Exemple :
    
    
13. 📍 De retour dans le programme d'installation, collez le code de l'utilisateur de service et le jeton.
    
    

É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.

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

14. Le programme d'installation affiche maintenant la page Sage — Import Models : les trois titres, chacun avec un bouton Copy et son fichier racine. Laissez-la ouverte.
    
15. Ouvrez Sage 100 Paie & RH. Inutile d'ouvrir une société.
16. Allez dans G.A. > Format d'Importation.
    

B. Modèle 1 : BrynQ Salariés

17. Cliquez sur le + en bas de la liste.
    
18. Sélectionnez Fiche salarié et cliquez sur Ok.
    
19. Un écran pour les champs s'ouvre. Ne modifiez rien : fermez-le avec la croix (X) en haut à droite.
    
20. La fenêtre d'enregistrement s'ouvre. Dans le programme d'installation, cliquez sur Copy à côté de BrynQ Salariés. Dans Sage, collez-le dans Intitulé (Ctrl+V) et cliquez sur Ok.
    
21. Dans le programme d'installation, cliquez sur Check Sage models. BrynQ Salariés a maintenant une coche verte ✔.
    La ligne « Sage 100 Paie & RH is still open » garde une croix rouge pour l'instant. C'est normal.
    

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

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

22. Cliquez sur +.
23. Faites défiler vers le bas, sélectionnez Salariés en attente et cliquez sur Ok.
    
24. Fermez l'écran des champs avec la croix (X).
25. Copiez BrynQ Salariés en attente dans le programme d'installation, collez-le dans Intitulé et cliquez sur Ok.
    
26. Cliquez sur Check Sage models : 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.

27. Cliquez sur +.
28. Sélectionnez Bulletin de paie et cliquez sur Ok.
    
29. Sélectionnez Evènements et cliquez sur Ok.
    
30. Fermez l'écran des champs avec la croix (X).
31. Copiez BrynQ Absences dans le programme d'installation, collez-le dans Intitulé et cliquez sur Ok.
    
32. Cliquez sur Check Sage models : BrynQ Absences a une coche verte ✔.
    

E. Fermer Sage et continuer

33. Fermez Sage 100 Paie & RH complètement (y compris les autres sessions sur ce serveur).
34. Cliquez une dernière fois sur Check Sage models. Toutes les lignes ont une coche verte ✔ et le programme d'installation indique All set. Next est maintenant disponible : cliquez dessus.
    

✖ Une ligne a encore une croix rouge ? Next reste indisponible tant qu'une ligne a une croix rouge. Le message indique quoi faire :

• Sage 100 Paie & RH is still open : fermez Sage (toutes les sessions) et vérifiez à nouveau.
• not found. Create it with exactly this title : 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.
• not found. IMP0000x, used until now, is titled '…' : le modèle a été renommé dans Sage. Redonnez-lui exactement le titre (utilisez le bouton Copy).
• more than one model has this title : gardez le modèle indiqué par le programme d'installation (le cas échéant) et supprimez ou renommez les autres dans Sage.
• created with another root file : supprimez ce modèle dans Sage et créez-le à nouveau avec le fichier racine du tableau.
• files are missing from the GA folder : ouvrez le modèle dans Sage et enregistrez-le à nouveau.

Étape 6 : Terminer l'installation

35. Sage — Scenario Code (facultatif) : laissez le champ vide et cliquez sur Next. L'Agent crée lui-même le scénario ConnectImport lors de sa première exécution. Ne le remplissez que si le support BrynQ vous le demande.
    
    
36. FACULTATIF (recommandé). Créez un raccourci sur le bureau. Il vous mènera directement au tableau de bord de l'Agent par la suite.
    
    
37. FACULTATIF : à ignorer sauf besoin. Sur la même page, Use custom local network settings n'est nécessaire que dans des configurations réseau particulières. Vous ne savez pas ? Laissez la case décochée.
    
38. FACULTATIF. Vérifiez la configuration de l'Agent dans le tableau de bord d'administration local. Utilisez le raccourci sur le bureau, ou ouvrez 127.0.0.1:7071/admin (l'adresse IP d'écoute et le port d'administration par défaut) dans votre navigateur sur le serveur Windows. Le tableau de bord est disponible en anglais, français, allemand et néerlandais ; changez de langue en haut de la page.
    
    
    
    

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

📍 Où : le serveur Windows.

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 le BrynQ et allez dans Interfaces.
2. Cliquez sur New interface et choisissez Use our templates.
3. Recherchez Sage en sélectionnant Factorial - Sage 100 France Employees.
   
   
4. Cliquez sur Use template.

Étape 2 : Remplir l'onglet Configuration

5. Ouvrez l'onglet Configuration.
   
   
   
6. Définissez la fréquence de paie.
   
   
7. 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.
   
   
8. 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.

9. 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.

10. Partie gauche (📍 Factorial) : trouvez l'ID et nom de l'entité juridique dans Paramètres > Informations sur l'entreprise.
    
    
    
11. 📍 BrynQ : saisissez cette valeur dans la partie gauche de la correspondance. Vous synchronisez plusieurs entités ? Ajoutez une ligne par entité.
    
    
12. 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'.
    
13. 📍 Sage 100 France : trouvez également l''Etablissement principal'.
    
    
14. 📍 BrynQ : saisissez ces valeurs dans la partie droite de la correspondance. Le résultat ressemble à ceci :
    
    
15. 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)

16. Ouvrez l'onglet Authorization.
17. 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.
    
    
18. Approuvez l'accès demandé et enregistrez la connexion.
19. Ensuite Sage : ajoutez l'autorisation Sage.
20. 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.
21. Saisissez le jeton de l'Agent BrynQ (BrynQ Agent Token) : 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

Dépannage

Trouver les fichiers journaux de l'Agent

📍 Où : le serveur Windows, dans l'Explorateur de fichiers.
Lorsqu'un problème survient, les fichiers journaux (logs) 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 :

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

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

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. Dans la plupart des cas, vous la résolvez en réinitialisant l'utilisateur ou le dossier. 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)

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.
• L'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.
• L'autorisations relient BrynQ à Factorial (compte administrateur !) et à l'Agent.
• Bloqué ? Vérifiez d'abord les trois services BrynQ. Contactez ensuite le support BrynQ en joignant les fichiers journaux de l'Agent (logs\sage pour les problèmes d'import, logs\agent pour les problèmes de connexion).