Intégration de données basique (via API)

Important: cet article est destiné aux utilisateurs d'Endalia RH avec un profil Administrateur.

L'article suivant a pour objectif de décrire la séquence des appels API nécessaire pour l'intégration d'Endalia avec d'autres systèmes d'information. Ces systèmes agiront comme maîtres pour fournir des données à Endalia. Le scénario décrit est destiné à des portées de modules de base (principalement des scénarios d'intégration avec le suivi du temps & les congés et absences). Pour d'autres scénarios, consultez la section des Intégrations

TABLE DES MATIÈRES

• 1. Données minimales
• 2. Données supplémentaires (optionnel)
• 3. Cartographie des paramètres
• 4. Génération de structure organisationnelle
• 5.Définition des rôles utilisateur (optionnel)
• 6. Processus de création de l'employé
• 7. Processus de mise à jour des données de l'employé

1. Données minimales

Si le scénario d'intégration souhaité ne nécessite que les données les plus basiques possibles. Nous devons garder à l'esprit les données minimales à intégrer dans le système:

• Code de l'employé
• Nom
• Nom de famille 1
• Numéro de document
• Type de document > Si ce fichier n'est pas géré à la source, intégrer la valeur "DNI".
• Genre
• Statut > Si nous ne chargeons que les employés actifs, utilisez la valeur "Actif"
• Entreprise
• Centre de travail
• Type de contrat
• Motif d'embauche
• % du temps de travail

De plus, si l'on prévoit d'utiliser le suivi du temps et/ou les congés, il est nécessaire d'ajouter :

•  Convention

De plus, pour la gestion des visibilités et l'escalade des processus d'approbation, il est nécessaire de définir la structure organisationnelle. Attribuer un poste à chaque employé  (Le processus de création de la structure et d'attribution des employés aux postes est décrit plus tard)

2. Données supplémentaires (optionnel)

Endalia est un système modulaire qui permet d'intégrer de nouveaux modules en fonction des besoins du client final. Tous les processus de ces modules sont basés sur la gestion des personnes. Par conséquent, si des besoins supplémentaires sont détectés, la première étape consiste à définir quelles données seront nécessaires pour leur gestion.

Depuis la section de configuration > Personnes > Données de l'employé, il est possible de définir le caractère obligatoire des champs dans le dossier de l'employé. Ces champs seront requis pour la création de nouveaux employés dans le système.

Un exemple :

Dans l'image, nous pouvons voir que le champ Nationalité 1 est défini comme obligatoire. Si ce champ n'est pas requis pour notre gestion, nous pouvons configurer qu'il ne soit pas obligatoire.

Il convient de garder à l'esprit que si de nouvelles données supplémentaires sont définies, elles devront être ajoutées à l'intégration, outre les sections au point 1 "Données minimales".

3. Cartographie des paramètres

L'intégrateur doit fournir une cartographie avec les paramètres principaux d'Endalia requis pour l'intégration. Ces données peuvent être fournies par intégration ou manuellement via Endalia. En fonction de la variabilité des paramétrages, il sera possible d'opter pour un scénario ou un autre. Dans le cas où l'on tente d'intégrer un employé avec des paramétrages qui ne sont pas encore chargés dans Endalia, les APIs généreront une erreur et il faudra invoquer la création de ce paramètre, ou effectuer un chargement manuel et ensuite réintégrer.

Les APIs de sortant de ces paramètres sont : 

• Entreprise - APIs: Détails - Endalia HR API 
• Centre de travail - APIs: Détails - Endalia HR API 
• Convention - APIs: Détails - Endalia HR API 

4. Génération de la structure organisationnelle

Pour la gestion des visibilités dans le système (qui a les droits pour voir les informations des autres employés) ainsi que pour les processus d'approbation (par exemple, qui doit approuver les congés d'un employé), le chargement d'une structure organisationnelle est nécessaire.

La structure organisationnelle consiste en un ensemble de postes avec une structure hiérarchique de dépendance.

Pour la création de la structure organisationnelle, il est nécessaire d'utiliser l'appel suivant :

1. Création et mise à jour des postes : APIs: Détails - Endalia HR API

5.Définition des rôles utilisateur (optionnel)

Si le scénario d'intégration exige que les utilisateurs accèdent au portail des employés, il sera nécessaire de créer des utilisateurs pour les employés chargés dans le système.

L'utilisateur peut exiger les données suivantes :

• Nom d'utilisateur
• Mot de passe (optionnel, si le scénario de configuration est avec des mots de passe délégués)
• Langue (par défaut, Espagnol)
• Rôle 1
• Rôle 2 et suivants (optionnel)

Par conséquent, la première étape est de définir les rôles d'utilisation dans le système. Ces rôles permettent de définir les sections et opérations que les utilisateurs pourront effectuer dans le système.

Une fois les rôles créés, nous sommes en mesure de créer les utilisateurs.

6. Processus de création d'employé

Une fois les paramètres et la structure organisationnelle définis, et après avoir créé les paramétrages de base dans le système, nous sommes prêts à générer les employés dans le système.

Pour la création d'un employé, les étapes suivantes doivent être suivies, avec toutes les données que l'on souhaite intégrer :

1. Création de l'employé - APIs: Détails - Endalia HR API
2. Association des employés à des postes  - APIs: Détails - Endalia HR API 
3. Création de l'utilisateur - APIs: Détails - Endalia HR API

7. Processus de mise à jour des données de l'employé

Une fois l'employé créé, pour mettre à jour les données (en raison de variations dans le master de données), les APIs suivantes doivent être appelées :

1. Chargement des données de l'employé: pour remplir ou modifier certains champs du dossier de l'employé - APIs: Détails - Endalia HR API 
2. Chargement du contrat : pour créer ou mettre à jour le contrat - APIs: Détails - Endalia HR API 
3. Modification des variations : chaque variation est modifiée avec sa propre API :

1. Entreprises - APIs: Détails - Endalia HR API
2. Centres de travail - APIs: Détails - Endalia HR API 
3. Pourcentage de temps de travail - APIs: Détails - Endalia HR API 
4. Convention - APIs: Détails - Endalia HR API