Mettre en place une interface de données automatisée entre Factorial et Sage

À quoi sert ce guide ? Ce guide vous accompagne dans la mise en place d'une interface de données automatisée entre Factorial et Sage 100. Une fois la configuration terminée, les données des employés seront transférées de Factorial vers Sage automatiquement — sans exports manuels, sans copier-coller, sans mises à jour oubliées. Le flux de données fonctionne ainsi : BrynQ lit les données des employés depuis Factorial, les convertit en un fichier Excel compréhensible par Sage, l'envoie vers votre serveur, puis l'importe dans Sage — le tout de manière entièrement automatisée.

Avant de commencer — lisez ceci

Sauvegardez votre travail en permanence. Sage ne sauvegarde pas automatiquement de manière fiable. Après chaque 3 à 5 champs ajoutés, cliquez sur Enregistrer. Cette seule habitude vous évitera de perdre votre travail et de devoir recommencer des étapes.
Vous avez besoin des bonnes personnes. Les parties 1 et 2 requièrent quelqu'un ayant accès à Sage. La partie 3 nécessite quelqu'un ayant accès au serveur. La partie 4 peut être effectuée par toute personne disposant d'un accès administrateur à la fois à Factorial et à BrynQ.
Les droits d'accès dans Factorial sont importants. La personne qui autorise Factorial dans la partie 4 doit avoir un accès complet à toutes les données des employés. Si cet utilisateur ne peut voir qu'une partie des employés, l'interface ne synchronisera que cette partie. Assurez-vous que l'utilisateur autorisant l'accès dispose d'un accès à l'ensemble de l'entreprise.
Cette configuration prend du temps — et c'est normal. La partie 1 seule implique d'ajouter environ 50 champs un par un. Ne vous précipitez pas. Suivez les vidéos étape par étape et vous en viendrez à bout.

Besoin d'aide ? Si vous êtes bloqué à un moment quelconque, envoyez votre question (avec une capture d'écran si possible) à support@brynq.com ou cliquez sur le bouton « Ajouter un ticket » en haut de cette page.

Partie 1 – Créer la définition d'importation dans Sage

Avant de pouvoir importer des données dans Sage, vous devez créer un format d'importation. Ce format contient tous les champs (colonnes) que Sage attend.

Ouvrez votre environnement Sage.
Ouvrez le menu G.A. et sélectionnez Format d'Importation.
C'est ici que les formats d'importation sont créés.
Consultez les formats exemples.
Votre système peut afficher un ou plusieurs exemples existants.
Créez un nouveau format d'importation.

Cliquez sur Plus (+).
Sélectionnez Fiche Salarié.
Confirmez avec OK.

Ajoutez des colonnes pour l'importation.

Cliquez sur Plus (+) dans le Guide d'importation.
Recherchez le nom du champ.
Sélectionnez OK.
Dans la vidéo d'exemple, trois champs ont été ajoutés :
• Matricule
• Sexe
• Adresse

Fermez l'écran pour confirmer les colonnes ajoutées.
Vous voyez maintenant les nouvelles colonnes dans le format d'importation.
Définissez Colonne = Oui pour chaque colonne.
Ceci est obligatoire pour que l'importation fonctionne.

Ouvrez le Mode Éditeur.
Sélectionnez une colonne.
Cliquez sur l'icône en bas.
Une ligne rouge apparaît.
Répétez cette opération pour chaque colonne.

Donnez un titre au format.
Exemple : brynq_factorial_import
Sauvegardez et fermez le format.
Confirmez les modifications lorsque Sage le demande.
Rouvrez le format pour ajouter d'autres champs.
Vous pouvez ajouter la totalité des ±50 champs un par un. Voici la liste avec les noms de champs exacts :

Matricule
Sexe
Adresse
Adresse 2
Code postal
Commune
Téléphone
Téléphone 2
Nom
Nom de famile
Prénom
Code INSEE Commune
Code pays
Etablissement payeur
Numéro de Sécurité Sociale
Date de naissance
Situation familiale
Nationalité (code)
Civilité
Date de début de contrat
Date de Fin de contrat
Nature du contrat
Modalité d'exercice du travail
Date d'entrée dans la profession
Ancienneté dans la profession
Date d'embauche société
Date entrée établissement
Type d'entrée établissement
Date d'ancienneté
Dernier jour travaillé et payé
Motif de départ
Date de rupture conventionnelle
Date de départ société
Date de sortie établissement
Salaire de base du salarié
Type de salaire
Salaire de base annuel
Salaire horaire du salarié
Horaire hebdomadaire du salarié
Horaire de base du salarié
Périodicité de paiement
Unité du temps de travail
Modalité de l'activité
Code banque 1
Numéro de compte 1
Code BIC 1
Libellé du compte 1
Nom guichet 1
Code guichet 1
Mode de paiement
Quotité de travail mensuel

Ajoutez les champs dans le bon ordre.
Sage insère les nouveaux champs directement après le champ sélectionné.

Si un champ apparaît à la mauvaise position, supprimez-le.
Sélectionnez le champ précédent correct.
Ajoutez à nouveau le champ.

Répétez l'opération pour tous les champs requis.
Chaque champ doit être défini sur Colonne = Oui.

Partie 2 – Tester le format d'importation

Une fois le format d'importation prêt, vous pouvez importer le fichier de données réel (par exemple, des données exportées depuis Factorial). Cette partie de l'article explique comment démarrer l'importation, sélectionner le bon format et générer un rapport d'erreurs.

Procédure :

Ouvrez Sage et chargez votre environnement employés. Dans Liste du Personnel, vous pouvez voir tous les employés existants.
Démarrez l'importation.
- Cliquez sur la petite flèche à côté de Créer.
- Sélectionnez Importer.
- Choisissez Excel.
Choisissez le format d'importation.
- Sous Format Personnalisé, cliquez sur les trois points.
- Sélectionnez le format d'importation créé précédemment (par exemple, brynq_factorial_import).
- Dans la vidéo d'exemple, Scenario Template est choisi car il est déjà complet.
Définissez l'option correcte pour la modification des enregistrements. Sage vous demande si les enregistrements existants peuvent être modifiés.
- Cette option doit être définie sur Oui.
- Confirmez lorsque le système affiche la valeur.
Confirmez le format et continuez. Cliquez sur OK pour poursuivre.
Sélectionnez le fichier à importer.
- Naviguez jusqu'au dossier où votre fichier Excel est stocké.
- Sélectionnez le fichier de données employés qui vous a été envoyé ou préparé précédemment.
Choisissez le type de rapport d'erreurs.
- Sélectionnez PDF comme format de rapport.
- Confirmez avec OK.
Enregistrez le fichier PDF. Saisissez un nom tel que Résultat–11Décembre25.pdf. Sage traite alors l'importation.
Examinez les résultats.
- Accédez au dossier où le PDF a été enregistré.
- Ouvrez le rapport.
- Vous verrez le nombre d'erreurs (le cas échéant). Dans l'exemple, trois erreurs ont été incluses intentionnellement pour montrer le fonctionnement du rapport.
Corrigez les problèmes si nécessaire. Vous pouvez :
- Corriger les données dans votre fichier et relancer l'importation, ou
- Envoyer le rapport PDF à l'équipe support pour examen.
Validez les nouveaux employés. Lorsque l'importation est réussie, vous verrez les employés nouvellement importés dans Liste du Personnel.

Vérifiez toujours votre rapport d'erreurs après chaque importation. Même de petits problèmes (formats incorrects, valeurs manquantes) peuvent provoquer des erreurs. Si le format d'importation est correct et que le fichier de données est complet, l'importation créera ou mettra à jour tous les dossiers employés comme prévu.

Ceci conclut la configuration et le processus d'importation. Bonne chance pour l'importation de vos données dans Sage !

Partie 3 – Mettre en place l'importation entièrement automatisée

Ce guide vous accompagne dans l'installation de l'Agent BrynQ sur votre serveur local et dans sa configuration pour importer automatiquement les données de paie dans Sage 100. Une fois terminé, les importations s'exécuteront automatiquement — sans manipulation manuelle de fichiers.

Avant de commencer — ayez ces 2 éléments à portée de main

L'installateur de l'Agent BrynQ — Connectez-vous à https://app.brynq.com, allez dans Organisation → Agent, et téléchargez la dernière version. Elle se trouvera dans votre dossier Téléchargements.
Un token API (clé ngrok) — Demandez-le à support@brynq.com. Conservez-le dans un fichier texte ; vous le collerez pendant l'installation.

Étapes d'installation

1. Lancez l'installateur et acceptez le contrat de licence Ouvrez l'installateur depuis votre dossier Téléchargements. Le premier écran présente le contrat de licence. Acceptez-le pour continuer.

2. Saisissez votre clé API ngrok et le sous-domaine client L'installateur vous demande deux identifiants :

Clé API ngrok — Ouvrez le fichier de token demandé au support, copiez la clé et collez-la dans le champ.
Sous-domaine client — Il s'agit du sous-domaine affiché dans votre URL BrynQ. Par exemple, si vous vous connectez à https://demo.app.brynq.com, le sous-domaine est demo.

3. Configurez le port de l'Agent L'Agent s'exécute localement sur votre réseau. Le port par défaut convient à la plupart des installations — laissez-le tel quel et cliquez sur Suivant.

Si une autre application utilise déjà ce port, vous pouvez en sélectionner un autre. Notez-le pour la dernière étape de ce manuel d'installation.

4. Sélectionnez les trois services requis Cochez les trois services suivants — chacun est nécessaire pour que l'automatisation complète fonctionne :

File endpoint — Permet l'envoi automatique du fichier Excel d'importation vers votre serveur.
SQL endpoint — Permet la lecture des données depuis la base de données Sage (Sage stocke ses données en SQL).
Sage 100 France — Le composant d'intégration principal de Sage 100.

Cliquez sur Suivant.

5. Connectez-vous à votre serveur SQL Cette étape relie l'Agent à la base de données où Sage stocke ses données. Renseignez les champs suivants :

Pilote ODBC — Sélectionnez « ODBC Driver <numéro> for SQL Server » avec le numéro de version le plus élevé disponible sur votre serveur (ex. 18, 17, 16). Choisissez toujours le plus élevé.
Nom du serveur SQL — Si vous ne le connaissez pas : ouvrez SQL Server Management Studio (cliquez sur Démarrer → recherchez-le). À l'ouverture, le nom du serveur est pré-rempli dans la boîte de connexion. Copiez-le avec Ctrl+C et collez-le dans le champ de l'installateur.
Authentification — Choisissez Authentification Windows. Cela fonctionne dans neuf installations sur dix. N'utilisez l'authentification SQL Server que si votre configuration spécifique l'exige.

Cliquez sur Suivant. L'installateur testera automatiquement la connexion. En cas d'échec, un message d'erreur s'affiche — vérifiez le nom du serveur et réessayez.

Saisir intentionnellement un mauvais nom de serveur est un bon moyen de vérifier que la validation fonctionne. Vous verrez une erreur, que vous pouvez ignorer, corriger le nom, puis continuer.

6. Sélectionnez les bases de données L'installateur affiche toutes les bases de données accessibles sur votre serveur SQL. Sage crée généralement une base de données par entreprise. Sélectionnez la ou les bases de données auxquelles l'Agent doit avoir accès, puis cliquez sur Suivant.

7. Sélectionnez le(s) fichier(s) PRH de Sage Le fichier PRH est le fichier société que Sage utilise lors de l'ouverture d'une entreprise. Vous devez indiquer à l'installateur l'emplacement de ce fichier. Si vous gérez plusieurs entreprises, ajoutez un fichier PRH par entreprise. Cliquez sur Suivant une fois terminé.

8. Configurez le dossier d'export des bulletins de paie Si vous souhaitez exporter les bulletins de paie depuis Sage pour les téléverser dans Factorial, activez cette option à l'écran suivant. L'installateur créera automatiquement une structure de dossiers dédiée. Cliquez sur Parcourir et sélectionnez un emplacement — par exemple, un dossier appelé Sage sur votre lecteur C. L'installateur y crée un dossier principal d'export des bulletins, avec un sous-dossier distinct pour chaque entreprise automatiquement.

Les bulletins de paie doivent être exportés manuellement depuis Sage chaque mois et placés dans le bon sous-dossier de l'entreprise. L'Agent se charge de les téléverser depuis cet emplacement — mais l'export depuis Sage lui-même est une étape manuelle.

Cliquez sur Suivant.

9. Créez un utilisateur de service dédié dans Sage L'importation automatisée s'exécutera sous un compte utilisateur Sage dédié. Vous devez créer ce compte maintenant. Placez les fenêtres de Sage et de l'installateur côte à côte pour cette étape :

Ouvrez Sage ;
Accédez à la gestion des utilisateurs et créez un nouvel utilisateur ;
Donnez-lui un nom reconnaissable (ex. « Utilisateur service BrynQ ») ;
Assurez-vous que le token est défini sur Actif ;
Cliquez sur Générer le token ;
Sélectionnez et copiez le token généré ;
Collez le token dans le champ correspondant de l'installateur ;
Saisissez le même nom d'utilisateur dans l'installateur ;
Cliquez sur OK dans Sage pour enregistrer l'utilisateur.

Une fois le nouvel utilisateur enregistré, fermez complètement Sage (à la fois la société et l'application elle-même — cela est requis pour l'étape suivante). Cliquez sur Suivant dans l'installateur.

10. Configurez la définition d'importation dans ConnectImport Il s'agit de la dernière étape de configuration. L'installateur fournit des instructions numérotées à l'écran — suivez-les dans l'ordre :

Cliquez sur Ouvrir ConnectImport (le bouton dans l'installateur).
Connectez-vous avec vos identifiants Sage habituels (votre utilisateur administrateur standard — pas l'utilisateur de service créé à l'étape précédente).
Dans ConnectImport, définissez le Répertoire Importé sur le chemin indiqué à l'étape 4 des instructions à l'écran. Vous pouvez copier-coller le chemin directement.
Faites défiler vers le bas et cochez la première case dans les paramètres d'importation.
Enregistrez cette configuration en lui donnant un nom — par exemple : Factorial import
Copiez le code de configuration affiché et collez-le dans le champ correspondant de l'installateur.
Fermez ConnectImport.

Cliquez sur Suivant dans l'installateur.

11. Finalisez l'installation Ignorez l'invite de raccourci bureau si vous n'en avez pas besoin, puis cliquez sur Suivant et Installer. L'installateur configurera tous les services sélectionnés. Cela peut prendre quelques minutes.

Vérification de l'installation

Ouvrez un navigateur sur le serveur et accédez à localhost:7071. Vous devriez voir le tableau de bord de l'Agent avec tous vos paramètres configurés :

Paramètres de connexion SQL (vous pouvez les ajuster ici ultérieurement si nécessaire).
Paramètres Sage 100 France — vérifiez qu'ils semblent corrects.
Sections LDAP, REST et SOAP — elles ne sont pas pertinentes pour cette configuration ; vous pouvez les ignorer.

Vous avez maintenant installé avec succès le plugin pour importer des données automatiquement dans Sage. La prochaine et dernière étape de ce tutoriel vous montrera comment faire fonctionner réellement l'interface entre Factorial et Sage.

Partie 4 – Connecter Sage avec Factorial

Dans cette dernière étape, vous allez créer l'interface dans BrynQ qui connecte Factorial à Sage 100. Cette interface extraira automatiquement les données des employés depuis Factorial et les enverra vers Sage selon un calendrier que vous définissez.

Étape 1 – Créer une nouvelle interface à partir d'un modèle

Accédez à la plateforme BrynQ et cliquez sur Nouvelle interface.
Choisissez Utiliser nos modèles.
Recherchez Sage et sélectionnez le modèle Factorial Sage 100 France Master Data.
Cliquez sur Utiliser le modèle.

BrynQ pré-remplira l'interface avec tous les mappings de champs et la logique associée. Il vous suffit de compléter quelques étapes de configuration avant qu'elle soit prête à fonctionner.

Étape 2 – Compléter l'onglet Configuration

Accédez à l'onglet Configuration.
Définissez la fréquence de paiement de l'entreprise (ex. Mensuelle).
Optionnellement, saisissez quelques identifiants d'employés à utiliser pour les tests. Ceci est recommandé avant d'exécuter l'interface sur l'ensemble des employés.

✅ Une fois rempli, le point d'interrogation sur cet onglet disparaît.

Étape 3 – Examiner et compléter l'onglet Scénarios

L'onglet Scénarios affiche tous les sujets de données (Entreprise, Matricule, etc.) ainsi que les mappings de champs entre Factorial et Sage. La plupart des mappings sont pré-remplis. Vous devez uniquement compléter ceux marqués d'un point d'interrogation.

Mapping de l'entité légale (obligatoire) Il s'agit du mapping le plus important. Vous devez indiquer à BrynQ quelle entité légale dans Factorial correspond à quel dossier dans Sage.

Recherchez l'identifiant et le nom de l'entité légale dans Factorial.
Recherchez le nom du dossier correspondant (Raison Sociale) dans votre fichier PRH Sage — saisissez-le en majuscules exactement tel qu'il apparaît dans Sage.
Saisissez le mapping dans BrynQ.
Cochez la case pour confirmer que le mapping est complet et cliquez sur Enregistrer.

Répétez cette opération pour chaque scénario comportant un point d'interrogation. Certains mappings sont pré-remplis mais nécessitent tout de même votre confirmation. Examinez chacun d'eux, confirmez qu'il est correct, cochez la case et enregistrez.

Prenez le temps nécessaire pour les mappings. Si un mapping est incorrect, de mauvaises valeurs seront transmises dans Sage. Il n'existe pas de validation automatique après coup.

Étape 4 – Autoriser Factorial et Sage

Accédez à l'onglet Autorisation. C'est ici que vous connectez BrynQ aux deux systèmes afin que l'interface puisse lire les données depuis Factorial et les écrire dans Sage.

Connecter Factorial

Cliquez sur Ajouter une autorisation et donnez à la connexion un nom reconnaissable (ex. votre propre nom).
Cliquez sur Se connecter à l'application.
Si vous n'êtes pas encore connecté, connectez-vous avec vos identifiants Factorial.
Factorial vous demandera d'accorder à BrynQ l'accès aux données de l'entreprise (contrats, données bancaires, congés, etc.). Cliquez sur Autoriser.
L'écran se ferme automatiquement. Cliquez sur Enregistrer.

Connecter Sage

Ajoutez une nouvelle autorisation pour Sage.
Dans le champ URL, saisissez l'URL de l'Agent de l'étape précédente au format suivant :

https://[votre-nom-client]-brynq.ngrok.app

Il s'agit du même domaine ngrok que vous avez configuré lors de l'installation de l'Agent Sage à la Partie 3.

Cliquez sur Enregistrer, puis sur Tester pour confirmer que la connexion fonctionne.

Étape 5 – Publier et planifier l'interface

Cliquez sur Publier pour activer l'interface.
Après la publication, configurez une planification :
- Choisissez la fréquence (ex. Quotidienne)
- Définissez l'heure de démarrage (ex. 20h00)
- Sélectionnez votre fuseau horaire
- Activez la planification
Cliquez sur Enregistrer.

L'interface s'exécutera désormais automatiquement à l'heure planifiée — aucune action manuelle n'est requise.

Étape 6 – Vérifier le résultat dans Sage

Après l'exécution de l'interface, vous pouvez vérifier le résultat :

Sur votre serveur Sage, naviguez jusqu'au dossier où les fichiers d'importation sont stockés.
Un nouveau fichier Excel apparaîtra avec les dernières données issues de Factorial.
Dans Sage, vous trouverez les dossiers employés mis à jour avec les données de Factorial.

🎉 Vous avez terminé. La configuration est complète. À partir de maintenant, les données de référence des employés transiteront automatiquement de Factorial vers Sage 100 France selon le calendrier que vous avez défini.