Intégration de l'enregistrement de segments (via API)

L'article suivant vise à décrire la séquence d'appels API nécessaire pour l'intégration des enregistrements de segments à Endalia. Le scénario décrit est destiné aux enregistrements de segments provenant de dispositifs de pointage. Pour d'autres scénarios, consultez la section Intégrations

TABLE DES MATIÈRES

• 1. Données de sortie
• 2. Données d'entrée
• 3. Cas d'utilisation : Réécriture des enregistrements

1. Données de sortie

Les RH utilisent Endalia pour enregistrer les employés et les utilisateurs associés. Dans ce cas, il est proposé que le fournisseur de dispositifs collecte ces données depuis Endalia et les charge dans son système via API. 

Si des données minimales sont requises pour créer l'employé, il est recommandé de consulter l'endpoint des utilisateurs APIs : Détails - 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"

}]

Le fournisseur intègre ces données, par synchronisation périodique (quotidienne ou à la périodicité estimée). 

Si vous avez besoin d'obtenir des données supplémentaires. Vous pouvez consulter l'API outbound des employés, qui contient plus de données sur l'employé (comme par exemple, les contrats APIs : Détails - Endalia HR API)

2. Données d'entrée

Le fournisseur doit intégrer les enregistrements de segments dans Endalia. Les segments doivent être complets (avec l'heure de début et l'heure de fin). 

Cet endpoint enregistre des segments et non des événements, l'intégration doit donc se faire une fois les données consolidées à l'origine.

3. Cas d'utilisation : Réécriture des enregistrements

Si vous avez besoin de supprimer les enregistrements d'une journée, et de recharger les segments :

Dans Endalia, APIs: Détails - Endalia HR API (https://api.endaliahr.com/inbound/time/api/inbound/v1/stretches/employees)

L'endpoint propose 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) Bruxelles, Copenhague, Madrid, Paris",

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

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

    "StretchType": "Travail",

    "OverwriteStretch": "Yes",

    "StretchTypeID": 0

}]

Si vous devez réécrire un jour, par exemple le 25/11/2025 et que l'employé avait les segments suivants : 

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

26/11/2025 02:00 - 04:00   ---> Ceci est un enregistrement nocturne avec date de référence 25/11/2025 

 Et supprimerait les deux segments.