Factorial - Sage 100 France | Absences : Mise en place de l'interface

Factorial - Sage 100 France | Absences : Mise en place de l'interface

📌 Ce guide concerne : Modèle absences 2.x · Agent BrynQ 3.10 ou plus récent · Sage 100 France v9. Une autre version ? Voir Commencer ici – choisissez votre version.

Ce que c'est

Le modèle Factorial - Sage 100 France | Congés & Absences Payés envoie automatiquement les congés et absences approuvés de Factorial vers Sage 100 France (v9). BrynQ lit les absences approuvées dans Factorial, les compare avec ce qui est déjà dans Sage et n'envoie que les changements, dans un fichier d'import par société Sage, <dossier>_ABSENCES.xlsx. L'Agent BrynQ sur votre serveur Sage l'importe avec ConnectImport.

Comment ça marche

Sage ne peut qu'ajouter des événements par import. Il ne peut ni les modifier ni les supprimer. BrynQ ne modifie donc jamais Sage : à chaque exécution, il compte chaque absence dans Factorial et dans Sage, et n'envoie que les événements nécessaires pour que les deux décomptes soient égaux. Pour retirer une absence, il envoie un événement d'annulation.

1. Ce que BrynQ compare

  • Factorial : toutes les absences approuvées, quelles que soient leurs dates. Les demandes encore en attente, et les types d'absence absents du mapping, ne sont pas pris en compte.
  • Sage : tous les événements d'absence des salariés qui ont au moins une absence approuvée dans Factorial. Les événements importés par BrynQ comme ceux saisis à la main comptent. Les événements marqués comme annulés dans Sage sont ignorés.
  • Une absence, c'est : le même matricule, Code nature événement, Motif d'absence, date de début et date de fin. La demi-journée, le Nombre et la date de validité ne sont pas comparés. Si Sage a enregistré un événement sans motif, le motif est ignoré pour cette absence.

2. Le décompte

Pour chaque absence, BrynQ compte combien de fois elle se trouve dans Sage. Chaque événement compte +1. Chaque événement d'annulation du même code (le code de son champ Nature d'annulation, par exemple 9950 pour 0950) compte −1. Une absence importée puis annulée compte donc 0 : pour BrynQ, elle n'est plus dans Sage. Ensuite :

  • Nouvelles absences à envoyer = le nombre dans Factorial moins le nombre dans Sage, en comptant les événements de toutes les dates de validité. BrynQ n'envoie jamais une absence déjà présente dans Sage, même d'un mois précédent.
  • Annulations à envoyer = le nombre dans Sage moins le nombre dans Factorial, en comptant uniquement les événements ayant la date de validité de cette exécution (voir 3). BrynQ n'annule jamais un événement d'un cycle de paie précédent.

Exemples, pour un salarié et une absence :

SituationFactorialSageBrynQ envoie
Une nouvelle absence est approuvée10L'absence
L'exécution suivante, rien n'a changé11Rien
L'absence est supprimée ou refusée dans Factorial. Elle a été importée dans ce cycle01 (ce cycle)Un événement d'annulation (par exemple 9950)
Idem, mais elle a été importée dans un cycle précédent01 (cycle précédent)Rien. Voir Au quotidien.
Les dates, le type d'absence ou le motif changent. L'ancienne version a été importée dans ce cyclenouvelle 1, ancienne 0nouvelle 0, ancienne 1La nouvelle absence et l'annulation de l'ancienne, dans le même fichier
Même changement, mais l'ancienne version date d'un cycle précédentnouvelle 1, ancienne 0nouvelle 0, ancienne 1 (cycle précédent)Uniquement la nouvelle absence. Voir Au quotidien.
Seule la demi-journée change11Rien. Voir Au quotidien.
Une absence annulée auparavant par BrynQ est de nouveau approuvée11 − 1 = 0De nouveau l'absence
L'absence est deux fois dans Sage, les deux dans ce cycle12Un événement d'annulation
L'absence a été saisie à la main dans Sage (même matricule, code, motif et dates)11Rien : pas de doublon
Un événement saisi à la main dans Sage avec la date de validité de cette exécution n'est pas dans Factorial01 (ce cycle)Un événement d'annulation. Si le code de cet événement n'a pas de Nature d'annulation, l'exécution s'arrête à la place.
L'absence supprimée était la dernière absence approuvée du salarié dans Factorial01Rien : BrynQ ne vérifie plus ce salarié. Voir Au quotidien.

3. Ce que signifie « ce cycle »

Chaque événement envoyé par BrynQ reçoit une date de validité : votre réponse dans l'onglet Configuration, calculée à partir du jour de l'exécution. Les événements qui ont la date de validité de l'exécution en cours forment ce cycle. Exemple avec Premier jour du mois suivant : toutes les exécutions d'octobre utilisent le 01/11, donc en octobre BrynQ peut encore annuler et corriger ce qu'il a envoyé en octobre. À partir du 1er novembre, les exécutions utilisent le 01/12. Ce qui a été envoyé en octobre appartient alors à un cycle précédent, et BrynQ ne l'annule plus.

4. Les codes d'annulation

  • Un événement d'annulation utilise le code d'annulation du code d'origine : le code sélectionné dans le champ Nature d'annulation de ce code dans Sage. C'est une copie du code d'origine avec le Sens opposé, pour retirer de nouveau les jours. Par convention, son numéro commence par 9 (0950 → 9950) et son intitulé se termine par [N].
  • Au début de chaque exécution, BrynQ vérifie que chaque code événement de votre mapping a une Nature d'annulation. S'il en manque une, l'exécution s'arrête avant tout envoi et liste les codes. Voir l'étape 5.
  • Un événement d'annulation a aussi besoin du Nombre. BrynQ le prend dans votre mapping, pour ce code événement et ce motif. Si le mapping ne le contient plus, par exemple parce que vous avez retiré un type d'absence, l'exécution s'arrête. Voir Au quotidien.

Ce qu'il faut faire

Savoir où vous êtes

Les étapes passent d'un endroit à l'autre. Chaque étape commence par un repère 📍 Où :

📍 RepèreCe que c'est
BrynQLa plateforme BrynQ dans votre navigateur (https://votre-slug.app.brynq.com).
FactorialFactorial dans votre navigateur.
Sage 100 FranceL'application Sage, ouverte sur le serveur Windows, dans le dossier (fichier PRH) qui reçoit les absences.
Serveur WindowsL'ordinateur sur lequel Sage 100 France et l'Agent BrynQ sont installés.

Le parcours en un coup d'œil

ÉtapeCe que vous faites📍 OùQui
1Créer l'interface à partir du modèleBrynQAdministrateur BrynQ
2Remplir la configurationBrynQ, onglet ConfigurationAdministrateur BrynQ, avec la paie pour la date de validité
3Commencer en mode test (dry mode)BrynQ, interface > SettingsAdministrateur BrynQ
4Compléter le scénarioBrynQ, onglet Scenarios, avec Sage 100 France ouvert pour retrouver les codesAdministrateur BrynQ, avec la paie
5Créer les codes d'annulation dans SageSage 100 FrancePaie (administrateur Sage)
6Ajouter les autorisationsBrynQ, AuthorizationsAdministrateur BrynQ et administrateur Factorial
7Exécuter et vérifierBrynQ, puis le serveur Windows et Sage 100 FranceAdministrateur BrynQ et paie

Avant de commencer

  • ☐ Les salariés sont dans Sage. Les absences sont rattachées à un salarié par le matricule : le numéro de salarié (company identifier) dans Factorial doit être identique au matricule dans Sage. Mettez d'abord en place le modèle Factorial - Sage 100 France | Salariés. Les nouveaux salariés doivent être embauchés dans Sage (et ne plus figurer dans Salariés en attente) avant que leurs absences puissent être importées.
  • ☐ L'Agent BrynQ 3.10 ou plus récent avec le module Sage 100 France, et le modèle d'import vide BrynQ Absences dans Sage. Voir l'étape 5 de Configurer une interface de données automatisée entre Factorial et Sage.
  • ☐ Un code d'annulation pour chaque code Sage utilisé. Dans Sage, chaque nature d'événement que vous mappez (par exemple 0950) a besoin d'une nature d'annulation correspondante, renseignée dans son champ Nature d'annulation. Sans elle, BrynQ ne peut ni annuler ni corriger une absence dans Sage, et l'exécution s'arrête avec des instructions. Voir l'étape 5.
  • ☐ Un compte administrateur Factorial. BrynQ ne voit que les absences des salariés visibles par ce compte.

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

📍 Où : BrynQ.
Objectif : Créer l'interface à partir du modèle.
Qui : Administrateur BrynQ.

  1. Dans BrynQ, allez dans Interfaces > New interface > Use our templates.
  2. Recherchez Sage et sélectionnez Factorial - Sage 100 France | Congés & Absences Payés.
  3. Vérifiez que les applications Factorial et Sage sont actives.

Étape 2 : Remplir la configuration

📍 Où : BrynQ, onglet Configuration.
Objectif : Choisir vos salariés de test et la date de validité.
Qui : Administrateur BrynQ, avec la paie pour la date de validité.

Ouvrez l'onglet Configuration :

  1. FACULTATIF (recommandé). Pendant les tests : quels sont les numéros de matricule des employés test ? Saisissez quelques matricules, séparés par des virgules. Vos premières exécutions ne traitent alors que les absences de ces salariés. Retirez-les une fois les tests terminés.
  2. Obligatoire. Quelle est la date de validation ? Choisissez la date de validité que Sage donne aux événements importés, calculée à partir du moment où l'interface s'exécute : Premier jour du mois suivant, Premier jour du mois en cours ou Dernier jour du mois en cours. Choisissez l'option qui correspond à la façon dont votre paie traite les absences. Sans réponse, l'exécution s'arrête.

À partir de la version 2.1.0 du modèle, l'interface a aussi deux variables (onglet Variables) :

VariableValeurCe qu'elle fait
Enable Data Validationtrue ou false (par défaut false)Avec true, chaque exécution produit un rapport HTML avec le taux de remplissage de chaque champ, côté Factorial et dans le fichier d'import Sage.
Send Report toAdresses e-mail, séparées par des virgulesCes adresses reçoivent les rapports d'exécution. Vide : aucun e-mail n'est envoyé.

Étape 3 : Commencer en mode test (dry mode)

📍 Où : BrynQ, interface > Settings.
Objectif : Faire de vos premières exécutions des tests sans risque.
Qui : Administrateur BrynQ.

Dans BrynQ, allez dans Interfaces, cliquez sur l'interface et ouvrez l'onglet Settings. Le Dry mode décide si BrynQ envoie réellement des fichiers à Sage :

Dry modeCe qui se passe
ActivéExécution de test. BrynQ compare Factorial avec Sage et indique dans le journal d'exécution combien d'absences et d'annulations il enverrait, mais n'envoie rien.
DésactivéBrynQ envoie les changements à Sage.
💡 Astuce : mettez le dry mode sur Activé pour votre première exécution et consultez le journal d'exécution. Quand les chiffres sont corrects, mettez-le sur Désactivé.

Étape 4 : Compléter le scénario

📍 Où : BrynQ, onglet Scenarios, avec Sage 100 France ouvert pour retrouver les codes.
Objectif : Indiquer à BrynQ quels codes Sage utilise chaque type d'absence Factorial.
Qui : Administrateur BrynQ, avec la paie.

Ouvrez l'onglet Scenarios et le scénario Congés & Absences Payés. Complétez chaque élément marqué d'un point d'exclamation (!) :

CorrespondanceQue faire
Entité juridique → DossierAssociez chaque entité juridique Factorial à sa société Sage (dossier). Le dossier doit correspondre au dossier de la société dans le dossier d'import Sage, c'est-à-dire au nom de société du fichier PRH.
Entité juridique + type de congé → codes SagePour chaque type de congé Factorial, par entité juridique, saisissez trois valeurs Sage : le Code nature événement, le Motif d'absence (code motif pour la DSN) et Nombre (la constante Sage qui compte la durée, par exemple en jours ouvrés ou en jours calendaires). Saisissez le nom du type de congé exactement comme dans Factorial.
Numéro de salarié → MatriculePrérempli. Le company identifier de Factorial sert de matricule Sage.
Date de début et de finPrérempli.
Date de validitéRemplie automatiquement à partir de votre réponse dans l'onglet Configuration.
Demi-journéePrérempli. Une demi-journée en fin de premier jour devient une absence l'après-midi du premier jour dans Sage ; une demi-journée en début de dernier jour devient une absence le matin du dernier jour. À vérifier seulement.

Exemple de correspondance des types de congé (utilisez les codes de votre propre dossier Sage) :

Entité juridique FactorialType de congé FactorialCode nature événementMotif d'absenceNombre
Votre entité juridiqueCongés payés0950CPSTOTJRSOUV
Votre entité juridiqueMaladie2000MAMAL_NBH
⚠ Un type de congé sans correspondance n'est pas envoyé. Quand vous ajoutez un nouveau type de congé dans Factorial, ajoutez-le aussi à cette correspondance. Et vérifiez que le code d'événement a une Nature d'annulation dans Sage (voir l'étape 5).

Étape 5 : Créer les codes d'annulation dans Sage

📍 Où : Sage 100 France.
Objectif : Un code d'annulation pour chaque code événement de votre mapping.
Qui : Paie (administrateur Sage).

BrynQ annule et corrige les absences avec des codes d'annulation (voir Comment ça marche). Chaque Code nature événement de votre mapping a besoin de son propre code d'annulation dans Sage. Vous le faites une fois par code, dans chaque dossier Sage qui reçoit les absences. L'exemple ci-dessous crée le code d'annulation de 0950 Absence congés.

🎬 Vidéo : regardez une fois les étapes ci-dessous, puis suivez le texte pour les détails.
  1. Dans BrynQ, regardez les colonnes Sage de votre mapping (étape 4) et notez chaque Code nature événement différent. Dans cet exemple : 0950, 0955 et 2000. Trois codes, donc trois codes d'annulation.
  2. Dans Sage 100 France, ouvrez le dossier (le fichier PRH de la société). Allez dans Listes > Natures d'évènements.
  3. La liste affiche toutes les natures d'événement avec leur code et leur intitulé. Sélectionnez le code, ici 0950 Absence congés, et cliquez sur le bouton copier.
  4. Une copie s'ouvre avec un Code vide. Saisissez le nouveau code. Règle pratique : le même code avec le premier chiffre remplacé par 9, donc 0950 devient 9950. Seulement si ce code n'est pas déjà utilisé par une autre nature d'événement. Sinon, choisissez un autre code libre.
  5. Ajoutez [N] (pour négation) à l'Intitulé : Absence congés [N].
  6. Important : sous A cumuler dans les constantes, mettez chaque Sens au signe opposé. Un (+) du code d'origine devient (−), un (−) devient (+).
  7. Comparez les deux codes côte à côte : les mêmes constantes, avec le Sens opposé. Le code d'origine à gauche, le code d'annulation à droite.
  8. Dans l'onglet Bulletin du nouveau code, vérifiez que Nature d'annulation est vide. Cliquez sur Ok.
  9. Important, sinon l'interface s'arrête : ouvrez le code d'origine (0950), allez dans l'onglet Bulletin et sélectionnez le nouveau code (9950) dans Nature d'annulation. Faites-le uniquement sur le code d'origine, jamais sur le code d'annulation. Cliquez sur Ok.
  10. Répétez les étapes 3 à 9 pour chaque autre code de l'étape 1.
✅ Point de contrôle : chaque code de votre mapping a un code d'annulation avec le Sens opposé, et le code d'origine y renvoie dans Nature d'annulation. Le journal de la prochaine exécution confirme que tous les codes mappés ont un code d'annulation.

⚠ Si une étape est oubliée ou mal faite, voici ce qui se passe :

Ce qui ne va pasCe que vous voyezQue faire
Le code d'origine n'a pas de Nature d'annulation, ou un code du mapping a été oubliéL'exécution s'arrête avant tout envoi et liste les codes.Faites l'étape 9 pour chaque code listé, puis relancez.
Le Sens n'a pas été inversé sur le code d'annulationRien dans BrynQ : l'exécution indique que Sage est à jour. Mais dans Sage, une annulation ajoute de nouveau les jours au lieu de les retirer, et les compteurs comme les congés pris sont faux.Corrigez le Sens du code d'annulation. Vérifiez et corrigez ensuite à la main dans Sage les compteurs des salariés dont des absences ont été annulées.
La Nature d'annulation est aussi renseignée sur le code d'annulation (par exemple en copiant un code qui en avait déjà une)Dès que la première annulation est dans Sage, BrynQ confond les deux codes et renvoie les mêmes absences à chaque exécution.Videz la Nature d'annulation du code d'annulation, puis annulez à la main dans Sage les absences en double.
Le nouveau code était déjà utilisé par une autre nature d'événementLes événements de cette autre nature comptent comme des annulations : des absences sont envoyées deux fois, ou ne sont pas annulées.Créez un code d'annulation avec un numéro libre, sélectionnez-le dans la Nature d'annulation du code d'origine, et vérifiez les absences des salariés concernés dans Sage.

Étape 6 : Ajouter les autorisations

📍 Où : BrynQ, Authorizations.
Objectif : Connecter Factorial et Sage.
Qui : Administrateur BrynQ et administrateur Factorial.

  • Factorial : connectez-vous avec un compte administrateur Factorial.
  • Sage : saisissez l'URL de l'Agent BrynQ (https://[votre-slug-client].brynq-agent.com) et le jeton de l'Agent, comme pour l'interface salariés.

Étape 7 : Exécuter et vérifier

📍 Où : BrynQ, puis le serveur Windows et Sage 100 France.
Objectif : Vérifier que les premières absences arrivent correctement.
Qui : Administrateur BrynQ et paie.

  1. Exécutez l'interface avec le dry mode activé et lisez le journal d'exécution. Il indique combien de nouvelles absences et d'annulations seraient envoyées, ou que Sage est déjà à jour.
  2. Mettez le dry mode sur Désactivé et relancez.
  3. 📍 Serveur Windows : un fichier <dossier>_ABSENCES.xlsx apparaît dans le dossier d'import de la société. L'Agent l'importe lors de sa prochaine recherche de nouveaux fichiers d'import (toutes les 15 minutes par défaut ; vous pouvez modifier ce délai sur la page d'administration de l'Agent, sous SAGE 100 France > Service. C'est la fréquence à laquelle l'Agent cherche un nouveau fichier, pas la fréquence d'exécution de l'interface), puis le déplace dans un sous-dossier nommé importe le <date et heure>.
  4. 📍 Sage 100 France : vérifiez les événements d'absence de vos salariés de test.
✅ Point de contrôle : les absences de vos salariés de test sont dans Sage, et une deuxième exécution indique qu'il n'y a rien de nouveau à envoyer.

Au quotidien : garder Factorial et Sage alignés

Une fois l'interface en service, les RH travaillent dans Factorial et BrynQ met Sage à jour. Quelques situations demandent une correction à la main dans Sage (voir Comment ça marche pour la raison). Quand c'est possible, faites les corrections dans Factorial avant le changement de cycle.

SituationQue faire📍 OùQui
Une demande d'absence arriveApprouvez-la. Seules les absences approuvées sont envoyées.FactorialManager ou RH
Une absence doit être modifiée ou annulée, et elle a été envoyée dans le cycle en coursModifiez-la ou supprimez-la dans Factorial. L'exécution suivante corrige Sage.FactorialRH
Idem, mais elle a été envoyée dans un cycle précédentModifiez-la ou supprimez-la dans Factorial, et annulez l'ancien événement à la main dans Sage. BrynQ envoie la nouvelle version, mais n'annule pas l'ancienne.Factorial et Sage 100 FranceRH et paie
Seule la demi-journée changeModifiez-la dans Factorial et corrigez l'événement à la main dans Sage. BrynQ ne compare pas les demi-journées.Factorial et Sage 100 FranceRH et paie
La dernière absence approuvée d'un salarié dans Factorial est suppriméeAnnulez l'événement à la main dans Sage. BrynQ ne vérifie plus ce salarié.Sage 100 FrancePaie
Vous voulez saisir une absence directement dans SageSaisissez-la plutôt dans Factorial. Un événement saisi à la main dans Sage avec la date de validité en cours, et absent de Factorial, est annulé par l'exécution suivante.FactorialRH
Un nouveau type d'absence est ajouté dans FactorialAjoutez-le au mapping (étape 4). S'il utilise un nouveau Code nature événement, créez d'abord son code d'annulation (étape 5).BrynQ et Sage 100 FranceAdministrateur BrynQ et paie
Un type d'absence est retiré du mappingVérifiez d'abord que Sage n'a pas d'événements de ce type dans le cycle en cours. Sinon, l'exécution suivante s'arrête, car elle ne peut pas les annuler sans le mapping.Sage 100 France, puis BrynQPaie et administrateur BrynQ

Besoin d'aide ?

  • Voir Absences : Dépannage.
  • Des problèmes avec l'Agent ou l'import Sage lui-même ? Voir Module Sage 100 France et Dépannage de l'Agent BrynQ.
  • Vous contactez le support BrynQ ? Joignez le fichier de support et le nom de l'interface dans BrynQ. Pour obtenir le fichier de support, ouvrez http://127.0.0.1:7071/admin sur le serveur Sage, allez dans SAGE 100 France > Dépannage et cliquez sur Télécharger le fichier de support.