Avant d'utiliser l'intégration avec votre compte réel, nous vous recommandons de la tester d'abord sur un compte de démonstration. Si vous souhaitez procéder, veuillez contacter votre interlocuteur chez Factorial pour connaître la marche à suivre.
Pour ce faire, vous devez d'abord configurer l'intégration dans votre environnement de démonstration Silae et effectuer les tests. Une fois l'intégration validée, elle sera déployée sur votre compte en production.
Pas à pas
1. Vérifier la cohérence des données entre Factorial et Silae
Vérifiez que les données provenant de Factorial et de Silae sont cohérentes avant d'activer le connecteur.
 2. Installez l'intégration de Silae sur la Marketplace Factorial
 Dans votre barre latérale, allez dans Découvrir → Intégration → Connecteur API Silae → Cliquez sur « Installer ». 

.png)
.png)
3. Complétez les paramètres en fonction des informations que votre comptable vous a communiquées de la part de Silae :
-  Les numéros de dossier (correspondant aux entités juridiques) 
.png)
 -  Les codes d'établissement (correspondant aux lieux de travail) 
.png)
 - Les codes d'absence que l'utilisateur souhaite synchroniser
 - Les codes des compteurs que l'utilisateur souhaite ajuster dans Factorial
 
C’est ici que vous devez compléter le code via les paramètres :
.png)
Les numéros de dossier et les codes d'établissement sont obligatoires pour que l'intégration fonctionne.
4. Fournir les informations requises sur Silae et Factorial
Collectez toutes les informations nécessaires depuis vos comptes Silae et Factorial et partagez-les avec notre partenaire Fortify :
support@fortifydigital.zendesk.com
-  Extrait de Silae (Votre comptable pourrait avoir besoin de vous aider à les créer dans Silae) :
- Identifiant client - Clé de domaine Silae
 - Clé secrète du client - Clé du modèle API Silae
 - Clé de configuration d'accès à l'API (également appelée clé d'abonnement ou clé principale) - Clé du ou des dossiers Silae liés à un compte utilisateur
 - Numéro de fichier SILAE (pour la connexion à Factorial )
 
 
Pour plus d'informations, consultez le Guide d'utilisation de l'activation de l'API Silae . Si vous souhaitez tester d'abord l'intégration dans l'environnement de démonstration de Silae, demandez les deux (environnement de démonstration et environnement de production) en même temps.
-  De Factorial :
- Clé API (vous devez la copier une fois générée, car elle n'est affichée qu'une seule fois dans Factorial ). Pour plus d'informations, consultez l' article du Centre d'aide Factorial .
 
 
5. L'intégration est prête à être utilisée !
Une fois que vous aurez reçu la confirmation de votre point de contact chez Factorial , l'intégration sera prête à être utilisée !
Comment tirer parti de cette intégration ?
Procédure générale d'envoi de données à Silae
Les données sont transférées de Factorial vers Silae via notre section « Mises à jour de la paie des employés » . Toute action effectuée dans Factorial ayant un impact sur la paie générera une mise à jour concernant l'employé concerné.
Pour garantir la synchronisation correcte des mises à jour, il est important d'activer les mises à jour relatives aux employés dans Factorial . Cela peut inclure les nouvelles embauches, les modifications de contrat, les mises à jour des données personnelles et les absences. Pour ce faire, accédez à Paramètres > Paie > Mises à jour des employés et activez toutes les mises à jour que vous souhaitez synchroniser avec Silae.

Lorsqu'une mise à jour concernant un employé est générée, vous pouvez la consulter et l'envoyer à Silae en la marquant comme « Terminée ». Les délais de transmission peuvent varier selon la période. Par exemple, si un grand nombre de mises à jour sont envoyées en fin de mois lors de la clôture de la paie, le traitement peut prendre jusqu'à 5 à 10 minutes.
Il est possible de modifier en masse le statut des mises à jour des employés dans Factorial , mais cette fonctionnalité n'est pas compatible avec l'intégration. Lorsque plusieurs mises à jour d'employés sont marquées comme terminées dans Factorial , ces occurrences ne seront PAS synchronisées avec Silae.

Il n'est pas possible de vérifier dans Factorial si les données ont bien été envoyées à Silae. Pour ce faire, vous devrez consulter la fiche de l'employé dans Silae ou l'e-mail quotidien récapitulant les données envoyées et signalant les éventuelles erreurs.
Synchronisation des nouvelles recrues
Lorsqu'un nouvel employé est créé dans Factorial , une mise à jour de son profil est générée. Vous pouvez l'ouvrir, vérifier l'exactitude des données, puis la marquer comme « Terminée » pour synchroniser la modification avec Silae.
Le numéro de sécurité sociale et le type de contrat sont des champs obligatoires . S'ils sont vides, le nouvel employé ne sera pas créé dans Silae.
Autres points importants à prendre en compte :
- Lors de la création du profil de l'employé et du chargement des informations contractuelles, assurez-vous que la DATE DU CONTRAT soit identique dans SILAE. Dans le cas contraire, SILAE créera un nouveau contrat, entraînant un doublon.
 - Pour les employés sans numéro de sécurité sociale : vous devez d’abord créer l’employé dans Silae afin d’obtenir un numéro provisoire (après la première paie), puis l’importer dans Factorial . Vous pourrez ensuite synchroniser les modifications de cet employé entre Factorial et Silae.
 - La date de naissance et le sexe indiqués doivent correspondre au numéro de sécurité sociale .
 - Le nom de naissance est obligatoire. S'il est laissé vide, le nom de famille indiqué sera considéré comme le nom de naissance afin de ne pas bloquer la création du compte.
 - Il n'est pas nécessaire d'ajouter le matricule dans Factorial . Lors de la synchronisation du nouvel employé, le champ « Matricule » sera automatiquement renseigné dans Factorial . Vous pouvez activer une option dans Silae pour garantir l'unicité du numéro de personnel dans plusieurs fichiers ou groupes de fichiers, si besoin.
 - Le motif de début d'emploi sera par défaut codé 001 : embauche, début d'activité, recrutement direct ou par concours (fonction publique), début de détachement, début d'une activité culturelle (religions). Vous pouvez le modifier dans Silae, si nécessaire.
 
.png)
Le nouvel employé sera ajouté à Silae avec un code employé qui suit séquentiellement le code le plus élevé existant dans le compte Silae du client.
Des champs sont envoyés à Silae
-  Données des employés
- Prénom
 - Nom de famille
 - Numéro de sécurité sociale (le client doit sélectionner son numéro de sécurité sociale dans le champ du numéro d'identification)
 - Nom de jeune fille (si ce champ est laissé vide dans Factorial , le prénom sera également synchronisé ici)
 - Genre
 - Courriel professionnel
 - Adresse électronique personnelle (si ce champ est laissé vide dans Factorial , l'adresse électronique personnelle sera remplacée par l'adresse électronique professionnelle).
 - Téléphone mobile
 - Adresse du domicile (ville, pays, état/province, rue, numéro et code postal)
 - Code communal INSEE
 - Date de naissance
 - Service des naissances (il récupère l'information à partir du numéro de sécurité sociale et, si la naissance a lieu hors de France, elle est envoyée sous le code « 99 » et l'utilisateur doit la modifier manuellement dans Silae).
 - Code du pays de naissance (il est tiré du numéro de sécurité sociale)
 - Nationalité
 - IBAN
 - BIC
 
 -  Données contractuelles
- Date d'entrée (basée sur le champ Date de début du contrat de Factorial )
 - Date de début du contrat (basée sur la date d'entrée en vigueur du contrat de Factorial )
 - Version du contrat Date de début (basée sur la date d'entrée en vigueur du contrat de Factorial )
 - Date de fin
 - Raison de démarrage (par défaut, raison de synchronisation : 001)
 - Établissement
 - Intitulé du poste - sous « autre intitulé de poste »
 - Code du contrat de travail (doit être un type de contrat disponible par défaut dans Factorial )
 - Salaire de base (doit être mensuel ou annuel)
 - Pour les employés horaires → Heures de travail contractuelles (mensuelles ou hebdomadaires). Ces informations rempliront les champs « Heures mensuelles normales » et « Heures supplémentaires mensuelles » dans Silae.
 - Pour les salariés en contrat journalier → Nombre de jours
 
 
Synchronisation des modifications des données relatives aux employés et aux contrats
Lorsqu'une information relative au profil ou au contrat d'un employé est mise à jour dans Factorial , une mise à jour est créée. Vous pouvez l'ouvrir, vérifier l'exactitude des données, puis la marquer comme « Terminée » pour synchroniser la modification avec Silae.
Les champs suivants généreront une mise à jour des informations de l'employé qui pourra être synchronisée avec Silae :
-  Données des employés
- Nom de famille
 - Prénom
 - Courriel professionnel
 - Téléphone mobile
 - Adresse du domicile (ville, pays, état/province, rue, numéro et code postal)
 - Nationalité (seul le code est modifié, le texte doit être modifié manuellement à partir de Silae)
 - IBAN
 - BIC
 
 -  Données contractuelles
- date de début d'emploi
 - date de début du contrat
 - Date d'entrée
 - Date de fin
 - Établissement
 - Intitulé du poste (sous « autre intitulé de poste »)
 - Code du contrat de travail (doit être un type de contrat disponible par défaut dans Factorial )
 - Salaire de base (doit être le salaire mensuel ou le salaire annuel)
 -  Pour les employés horaires :
- Les heures contractuelles (mensuelles ou hebdomadaires) doivent être saisies (elles rempliront les champs « Heures mensuelles normales » et « Heures supplémentaires mensuelles » dans Silae).
 
 -  Pour les employés sous contrat journalier :
- Nombre de jours
 
 
 
Important : Lorsque vous souhaitez envoyer des modifications de contrat pour un employé existant dans votre entreprise, veillez à vérifier attentivement les dates du contrat dans Factorial et Silae afin d’éviter de créer accidentellement une nouvelle fiche employé dans Silae.
Comment créer un avenant ou simplement modifier un contrat
- Créer un avenant : lorsqu’une modification de contrat survient, si vous souhaitez créer un nouvel emploi dans Silae, accédez à l’onglet Contrat dans le profil de votre employé sur Factorial , cliquez sur Nouvelles conditions et saisissez la date de la modification.
 - Modifier un contrat : Si vous souhaitez apporter une modification sans créer un nouvel emploi dans Silae, cliquez sur les trois points et sélectionnez Corriger les conditions .
 
Assurez-vous que la date d'effet corresponde à la date de fin de la tâche précédente dans Silae. Dans le cas contraire, une nouvelle tâche sera automatiquement créée dans Silae.

Synchronisation des absences
Lorsqu'une absence d'un employé est approuvée dans Factorial , une mise à jour de la paie est créée. Vous pouvez vérifier l'exactitude des données, puis marquer l'incident comme « Terminé » pour synchroniser les données avec Silae.

Vérifiez que les absences que vous souhaitez envoyer sont activées dans la page Paramètres des mises à jour des employés et que le code Silae est bien mappé dans la page Paramètres d'intégration (avec uniquement le code à 3 chiffres, sans inclure le « AB- »).
Types d'absences pouvant être synchronisées
Les absences d'une demi-journée, d'une journée complète et à l'heure peuvent être synchronisées. Les absences soumises à des règles complexes (telles que les délais de carence, les allocations de sécurité sociale, les compléments de salaire de l'employeur ou les seuils) sont transmises par Factorial , mais calculées par Silae , qui fait alors office de système maître . Silae détermine la durée indemnisée et les montants à verser.
Les autres absences, généralement plus simples, sont gérées directement dans Factorial , qui fait office de système maître — aucun traitement supplémentaire n'est requis du côté de Silae.
- Les congés payés et les RTT doivent toujours être envoyés en jours ou demi-journées .
 - Les congés maladie sont calculés par Silae. S'ils sont exprimés en jours, ils sont traités automatiquement.
 - Les absences horaires doivent avoir leurs compteurs correctement configurés en heures (par exemple, formation, congé de conversion, jours fériés, congé compensatoire, congé payé/non payé).
 
Si plusieurs jours d'absences horaires sont signalés, le total des heures peut ne pas s'afficher immédiatement , mais le calcul est reflété avec précision dans le bulletin de paie .
Modification et suppression d'une absence synchronisée
Si une absence déjà synchronisée avec Silae est modifiée ou supprimée ultérieurement, elle doit également être mise à jour ou supprimée manuellement dans Silae. Vous pouvez exporter un fichier delta depuis Factorial pour effectuer des mises à jour groupées. Nous travaillons actuellement à l'amélioration de ce processus.
Ajustement des soldes de congés accumulés
L'intégration récupère régulièrement les compteurs de congés de Silae vers Factorial en calculant le cumul des congés. Ces compteurs sont mis à jour mensuellement, au début du mois suivant. Après cette mise à jour, les compteurs de congés payés (CP) et de temps de repos (RTT) sont automatiquement complétés. Pour les CP, le total des jours cumulés l'année précédente (N-1) et des jours cumulés l'année en cours (N) est pris en compte. Pour la synchronisation des soldes de congés, les identifiants des employés Silae doivent être présents et identiques dans Factorial .
Comment récupérer les compteurs de congés accumulés de SILAE pour les convertir en Factorial ?
- Avant d'activer les compteurs, vous devez paramétrer les compteurs de congés pour toutes les politiques de congés à 0 jour disponible.
 -  Vous devez également configurer les compteurs de congés dans les paramètres de Marketplace. Chaque ligne correspond à un compteur différent, lié à une politique de congés. 
 
.png)
- Une fois activés et les codes de comptage renseignés, les compteurs cumulés Factorial seront ajustés 5 jours après la clôture du cycle de paie dans Silae. Après l'ajustement, l'utilisateur verra la mention « Mise à jour automatique par Silae + un code » dans le compteur. L'employé, quant à lui, ne recevra aucune notification.
 - Les jours disponibles doivent être ajustés manuellement par l'administrateur en exportant les données de Silae et en les important dans Factorial .
 
Si vous ne souhaitez pas modifier le compteur dans Factorial , vous pouvez simplement laisser le code vide sur la page Paramètres d'intégration.
Si Silae vient de commencer le calcul des bulletins de paie, il est normal que les compteurs ne soient pas encore à jour. Les compteurs mensuels ne sont pris en compte qu'une fois tous les bulletins de paie validés et imprimés .
Par exemple, si les bulletins de paie ont été calculés mais pas encore vérifiés ni imprimés , la bulle en haut reste jaune . Une fois qu'elle deviendra verte , les informations seront correctement mises à jour.
Liste des compteurs et de leurs codes associés en Silae :
| Code | Description | 
|---|---|
| cpnAcquis | Nombre de jours acquis l'année précédente (N-1) et nombre de jours actuellement acquis pour cette année (N) | 
| rttAcquis | Nombre de RTT acquis | 
Foire aux questions
Comment pouvez-vous confirmer si les données ont été synchronisées avec succès avec Silae ou s'il y a eu une erreur ?
En cas d'erreur de synchronisation, un rapport d'erreur sera envoyé au client par courriel. Le client devra indiquer l'adresse courriel à laquelle il souhaite recevoir ce rapport.
Ces rapports fourniront un résumé détaillé de toutes les données envoyées à Silae, ainsi que l'état de leur mise à jour, permettant à l'utilisateur de :
- Vérifiez que toutes les données ont été transmises correctement.
 - Identifier et résoudre tout problème lié aux données qui n'ont pas été transférées avec succès.
 
Voici un exemple de rapport d'erreur :
.png)
Que se passe-t-il si une nouvelle recrue est synchronisée avec une matrice spécifique qui n'existe pas dans Silae ?
Le nouvel employé ne sera PAS synchronisé (une erreur s'affichera).
Que se passe-t-il si une nouvelle recrue est synchronisée avec une matrice spécifique qui existe déjà dans Silae ?
Les données du nouvel employé recruté dans Factorial écraseront les données de l'employé déjà en poste dans Silae.
L'intégration est-elle bidirectionnelle ?
La plupart des données sont synchronisées de Factorial vers Silae. Cependant, deux points de données spécifiques sont synchronisés de Silae vers Factorial :
- Matricule - synchronisée avec Factorial une fois l'employé créé dans Silae
 - Les compteurs de congés sont ajustés automatiquement dans Factorial 5 jours après le calcul de la paie dans Silae.
 
Que se passe-t-il lorsqu'un nouvel employé n'a pas de numéro de sécurité sociale ?
Pour créer un employé dans Silae, son numéro de sécurité sociale (SSN) doit être renseigné. Si l'employé n'en possède pas, il doit être créé manuellement dans Silae et Factorial . Une fois le SSN temporaire attribué dans Silae, vous devrez le copier-coller dans Factorial .
Quelles sont les erreurs les plus fréquentes ?
- Les données de naissance et le numéro de sécurité sociale ne sont pas cohérents.
 - Les codes ne sont pas renseignés sur la page Factorial Marketplace.
 - Accès API impossible pour certains dossiers clients.