Integració de dades bàsica (via API)

Important: aquest article està dirigit a usuaris d'Endalia HR amb perfil d'Administrador.

L'article següent té com a objectiu descriure la seqüència de trucades API necessària per a la integració d'Endalia amb altres sistemes d'informació. Aquests sistemes actuaran com a màster per proporcionar dades a Endalia. L'escenari descrit està dirigit a abastos de mòduls bàsics (principalment escenaris d'integració amb Registre Horari i Vacances i Absències). Per a altres escenaris, consulta l'apartat de Integracions

TAULA DE CONTINGUTS

• 1. Dades mínimes
• 2. Dades addicionals (opcional)
• 3. Mapeig de paràmetres
• 4. Generació d'estructura organitzativa
• 5.Definició de rols d'usuari (opcional)
• 6. Procés de creació de l'empleat
• 7. Procés d'actualització de dades d'empleat

1. Dades mínimes

Si l'escenari d'integració desitjat, únicament requereix de les dades més bàsiques possibles. Haurem de tenir present les dades mínimes a incorporar en el sistema:

• Codi de l'empleat
• Nom
• Cognom1
• Número de document
• Tipus de document > Si aquesta dada no es gestiona a l'origen, integrar valor "DNI".
• Gènere
• Estat > Si únicament aboquem empleats actius, utilitzar valor "Actiu"
• Empresa
• Centre de treball
• Tipus de contracte
• Motiu d'alta
• % de jornada

Addicionalment, si es farà ús de Registre horari i/o vacances, és necessari afegir:

•  Convenio

A més, per a la gestió de visibilitats i l'escalat dels processos d'aprovació, és necessari definir l'estructura organitzativa. Assignant un lloc a cada empleat  (Més endavant es descriu el procés de creació d'estructura i assignació de treballadors a llocs)

2. Dades addicionals (opcional)

Endalia és un sistema modular que permet incorporar nous mòduls en funció de les necessitats del client final. Tots els processos d'aquests mòduls estan basats en la gestió de les persones. Per això, si es detecten necessitats addicionals, el primer pas és definir quines dades necessitarem per a la gestió d'aquestes.

Des de l'apartat de configuració > Persones > Dades de l'empleat, és possible definir l'obligatorietat dels camps en la fitxa de l'empleat. Aquests camps seran els requerits per a la creació de nous empleats en el sistema.

Un exemple:

A la imatge podem veure que el camp Nacionalitat 1 està definit com a obligatori. Si aquest camp no és requerit per a la nostra gestió, podem configurar que no sigui obligatori.

Cal tenir present que, si es defineixen noves dades addicionals, aquestes s'hauran de sumar a la integració de manera addicional als apartats de l'apartat 1 "Dades mínimes".

3. Mapeig de paràmetres

L'integrador ha de proporcionar un mapeig amb els paràmetres mestres d'Endalia requerits per a la integració. Aquestes dades poden aportar-se per integració, o bé, manualment a través d'Endalia. En funció de la variabilitat de parametritzacions, es podrà optar per un escenari o un altre. En cas que s'intenti integrar un empleat amb parametritzacions que prèviament no estiguin carregades a Endalia, les APIS generaran un error, i s'haurà d'invocar la creació d'aquest paràmetre, o bé, realitzar una càrrega manual i posteriorment tornar a reintegrar.

Les APIs de outbound d'aquests paràmetres són: 

• Empresa - APIs: Details - Endalia HR API 
• Centre de treball - APIs: Details - Endalia HR API 
• Convenio - APIs: Details - Endalia HR API 

4. Generació d'estructura organitzativa

Per a la gestió de visibilitats al sistema (qui té permisos per veure informació d'altres empleats) així com per als processos d'aprovació (per exemple, qui ha d'aprovar les vacances d'un empleat) és necessària la càrrega d'una estructura organitzativa.

L'estructura organitzativa, consta d'un conjunt de llocs amb una estructura jeràrquica de dependència.

Per a la creació de l'estructura organitzativa, és necessari utilitzar la següent crida:

1. Creació i actualització de llocs: APIs: Details - Endalia HR API

5.Definició de rols d'usuari (opcional)

Si l'escenari d'integració requereix que els usuaris accedeixin al portal de l'empleat, serà necessària la creació de usuaris per als empleats carregats en el sistema.

L'usuari requerirà de les dades següents:

• Nom d'usuari
• Contrasenya (opcional, si l'escenari de configuració és amb contrasenyes delegades)
• Idioma (Per defecte, Espanyol)
• Rol 1
• Rol 2 i successius (opcional)

Per això, el primer pas és definir els rols d'ús en el sistema. Aquests rols, permeten definir a quines seccions i operatives podran accedir els usuaris al sistema.

Un cop creats els rols, ja estem en disposició per poder crear els usuaris.

6. Procés de creació de l'empleat

Definits els paràmetres i l'estructura organitzativa, una vegada generade les parametritzacions bàsiques en el sistema, ja estem en disposició per a poder generar els empleats en el sistema.

Per a la creació d'un empleat cal seguir els passos següents, amb totes les dades que es volen integrar:

1. Creació de l'empleat - APIs: Details - Endalia HR API
2. Associació d'empleats a llocs - APIs: Details - Endalia HR API 
3. Creació de l'usuari - APIs: Details - Endalia HR API

7. Procés d'actualització de dades de l'empleat

Una vegada creat l'empleat, per a l'actualització de dades (per variacions en el master de dades) caldrà cridar les següents APIs:

1. Càrrega de dades de l'empleat: per a completar o canviar certs camps de la fitxa de l'empleat - APIs: Details - Endalia HR API 
2. Càrrega de contracte: per crear o actualitzar el contracte - APIs: Details - Endalia HR API 
3. Modificació de variacions: cada variació es modifica amb la seva pròpia API:

1. Empreses - APIs: Details - Endalia HR API
2. Centres de treball - APIs: Details - Endalia HR API 
3. Percentatge de jornada - APIs: Details - Endalia HR API 
4. Convenio - APIs: Details - Endalia HR API