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

Modificado el Mar, 2 Dic a 11:26 A. M.

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). Esta integración

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

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
}]

3. Caso de uso: Reescribir registros

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

OverwriteStretch

si tu por ejemplo, me pones fecha referencia 25/11/2025

Y tenía los tramos

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

26/11/2025 02:00 - 04:00 ---> Este va a ser de la fecha referencia 25/11/2025

Y borraría ambos