Integração de registro de segmentos (via API)

O artigo a seguir visa descrever a sequência de chamadas de API que é necessária para a integração de registros de segmentos ao Endalia. O cenário descrito é direcionado a registros de segmentos provenientes de dispositivos de registro de ponto. Para outros cenários, consulte a seção de Integrações

ÍNDICE

• 1. Dados de saída
• 2. Dados de entrada
• 3. Caso de uso: Reescrever registros

1. Dados de saída

RH utiliza Endalia para registrar os empregados e usuários associados. Neste caso, sugere-se que o fornecedor de dispositivos colha esses dados do Endalia e os carregue em seu sistema via API. 

Se são necessários dados mínimos para criar o empregado, recomenda-se acessar o endpoint de usuários  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"

}]

O fornecedor integra esses dados, por meio de sincronização periódica (diária ou conforme a periodicidade estimada). 

Se precisar obter algum dado adicional. Pode aceder à API de outbound de empregados, que contém mais dados do empregado (como, por exemplo, os contratos APIs: Details - Endalia HR API )

2. Dados de entrada

O fornecedor deve integrar os registros de segmentos no Endalia. Os segmentos devem estar completos (com hora de início e hora de término). 

Este endpoint registra segmentos e não eventos, portanto, a integração deve ocorrer uma vez que os dados foram consolidados na origem.

3. Caso de uso: Reescrever registros

Se precisar apagar os registros de um dia e recarregar segmentos:

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

O endpoint dispõe 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) Bruxelas, Copenhague, Madrid, Paris",

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

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

    "StretchType": "Trabalho",

    "OverwriteStretch": "Yes",

    "StretchTypeID": 0

}]

Se você precisar reescrever dados de um dia, por exemplo, o dia 25/11/2025 e o empregado tinha os seguintes segmentos: 

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

26/11/2025 02:00 - 04:00   ---> Este é um registro noturno com data de referência 25/11/2025 

 E apagaria ambos os segmentos.