Integració registre de trams (via API)

L'article següent té com a objectiu descriure la seqüència de trucades API necessària per a la integració de registres de trams a Endalia. L'escenari descrit està destinat a registres de trams provinents de dispositius de fitxatge. Per a altres escenaris, consulta la secció de Integracions

TAULA DE CONTINGUTS

• 1. Dades de sortida
• 2. Dades d'entrada
• 3. Cas d'ús: Reescriure registres

1. Dades de sortida

RRHH utilitza Endalia per donar d'alta els empleats i usuaris associats. En aquest cas, es proposa que el proveïdor de dispositius reculli aquestes dades des d'Endalia i les carregui en el seu sistema via API. 

Si es requereixen dades mínimes per crear l'empleat, es recomana acudir al punt d'accés d'usuaris  APIs: Detalls - Endalia HR API

[{

    "EmpID": 1,

    "EmpCode": "123456",

    "EmpFullName": "John Doe",

    "CardID": "38571428Z",

    "Username": "john.doe",

    "ID": "00000000-0000-0000-0000-000000000001",

    "RoleKey": "Admin; Employee; etc",

    "Rolename": "Rol 1"

}]

El proveïdor integra aquestes dades, mitjançant sincronització periòdica (diària o amb la periodicitat estimada). 

Si requereix obtenir alguna dada addicional. Es pot acudir a la API de sortida d'empleats, que conté més dades de l'empleat (com per exemple, els contractes APIs: Detalls - Endalia HR API )

2. Dades d'entrada

El proveïdor ha d'integrar els registres de trams a Endalia. Els trams han d'estar complets (amb hora d'inici i hora de finalització). 

Aquest punt d'accés registra trams i no esdeveniments, per la qual cosa la integració ha de produir-se un cop les dades han estat consolidades a l'origen.

3. Cas d'ús: Reescriure registres

Si necessites esborrar els registres d'un dia, i tornar a carregar trams:

A Endalia , APIs: Detalls - Endalia HR API (https://api.endaliahr.com/inbound/time/api/inbound/v1/stretches/employees)

El punt d'accés disposa de OverwriteStretch

[{

    "Errors": [{

        "ErrorMessage": "string",

        "PropertyName": "string",

        "ErrorType": "string"

    }],

    "RowID": 0,

    "CardID": "38571428Z",

    "EmpCode": "00154",

    "Employee": "John Doe",

    "EmpID": 0,

    "Day": "2021-01-01T12:00:00Z",

    "TimeZone": "(UTC+01:00) Brussel·les, Copenhaguen, Madrid, París",

    "Start": "2021-01-01T08:00:00Z",

    "End": "2021-01-01T05:00:00Z",

    "StretchType": "Treball",

    "OverwriteStretch": "Sí",

    "StretchTypeID": 0

}]

Si necessites fer una reescriptura d'un dia, per exemple el dia 25/11/2025 i l'empleat tenia els següents trams: 

25/11/2025 22:00 - 02:00 

26/11/2025 02:00 - 04:00   ---> Aquest és un registre nocturn amb data de referència 25/11/2025 

 I esborraria ambdós trams.