Integración registro de tramos (vía API)

El siguiente artículo tiene por objetivo describir la secuencia de llamadas API que es necesaria para la integración de registros de tramos a Endalia. El escenario descrito está dirigido a registros de tramos provenientes de dispositivos de fichaje. Para otros escenarios, consulta el apartado de Integraciones

TABLA DE CONTENIDOS

• 1. Datos de salida
• 2. Datos de entrada
• 3. Caso de uso: Reescribir registros

1. Datos de salida

RRHH utiliza Endalia para dar de alta los empleados y usuarios asociados. En este caso, se propone que el proveedor de dispositivos, recoja estos datos desde Endalia y los cargue en su sistema vía API. 

Si se requieren datos mínimos para crear el empleado, ser recomienda acudir al endpoint de usuarios  APIs: Details - 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": "Role 1"

}]

El proveedor integra estos datos, mediante sincronización periódica (diaria o con la periodicidad estimada). 

Si requiere obtener algún dato adicional. Puede acudirse a la API de outbound de empleados, que contiene más datos del empleado (como por ejemplo, los contratos APIs: Details - Endalia HR API )

2. Datos de entrada

El proveedor debe integrar los registros de tramos en Endalia. Los tramos deben estar completos (con hora inicio y hora fin). 

Este endpoint registra tramos y no eventos, por lo que la integración debe producirse una vez los datos han sido consolidados en origen.

3. Caso de uso: Reescribir registros

Si necesitas borrar los registros de un día, y volver a cargar tramos:

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

El endpoint dispone 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) Bruselas, Copenhague, Madrid, París",

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

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

    "StretchType": "Trabajo",

    "OverwriteStretch": "Yes",

    "StretchTypeID": 0

}]

Si necesitas hacer una reescritura de un día, por ejemplo el día 25/11/2025 y el empleado tenía los siguientes tramos: 

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

26/11/2025 02:00 - 04:00   ---> Este es un registro nocturno con fecha de referncia 25/11/2025 

 Y borraría ambos tramos.