Lecture des fiches d'absences
Permet de lire les fiches d’absence des salariés entre 2 dates. Le Web Service renvoie toutes les fiches d’absence du salarié ayant une période de date commune avec la période demandée.
Lien vers le : https://sandbox-ws.kelio.io/open/services/AbsenceFileService?wsdl
Web Service : AbsenceFileService
Méthode : exportAbsenceFilesList
Données obligatoires
Les méthodes de lecture des données liées aux salariés proposent deux options de lecture :
•Soit la lecture des données d’un salarié via un des identifiants du salarié (Matricule, n° de badge, nom/prénom). Le est l’identifiant à privilégier car il est le plus souvent invariant dans le temps.
•Soit la lecture des données d’une liste de salariés via des filtres par et . Ces notions sont paramétrables par le gestionnaire de Kelio (voir aide en ligne Population et Groupe).
La balise permet de définir ce mode de fonctionnement :
Dans ce cas, l’un des identifiants suivants est obligatoire :
Matricule du salarié :
ou Code du badge :
ou Nom/Prénom : et
•ou Clé technique : (cet identifiant est à utiliser lors du traitement par lot après avoir lu les clés des salariés via le Web Service )
Dans ce cas, les notions de Population et Groupe peuvent être utilisées. Elles ne sont pas obligatoires. Si elles ne sont pas renseignées, le Web Service renvoie les données de tous les salariés. Sur des gros volumes de base, ce type de demande peut ralentir les performances du serveur Kelio. Il est donc fortement recommandé de les utiliser.
Population :
Groupe : |
Il existe deux façons de filtrer les données datées en fonction de plage de date.
•Soit en utilisant une période de date réelle : exemple du 14/05/2024 au 25/06/2024.
•Soit en utilisant une plage de date relative par rapport à la date du jour : exemple -20 jours à +10 jours.
La balise permet de définir le mode de fonctionnement :
Champs à renseigner :
• : date de début en date réelle
• : date de fin en date réelle
Champs à renseigner
• : date de début en relatif. Nombre de jours en plus ou en moins par rapport à la date du jour.
• : date de fin en relatif. Nombre de jours en plus ou en moins par rapport à la date du jour. |
|
Données en entrée
Code
|
Description
|
Type de classe
|
absenceFileKey
|
Clé de fiche d'absence
|
int
|
archivedEmployee
|
Salarié archivé
|
boolean (false / true)
|
dateMode
|
Mode de saisie des dates
|
int
Valeurs possibles :
0Date à date
1Date relative de début à date relative de fin |
employeeBadgeCode
|
Code du badge du salarié
|
string (max: 16)
|
employeeFirstName
|
Prénom du salarié
|
string (max: 24)
|
employeeIdentificationCode
|
Code matricule du salarié
|
string (max: 80)
|
employeeIdentificationNumber
|
Matricule du salarié
|
string (max: 16)
|
employeeKey
|
Clé de salarié
|
Int
|
employeeSurname
|
Nom du salarié
|
string (max: 24)
|
endDate
|
Date de fin
|
date (format : yyyy-MM-dd)
|
endOffset
|
Offset de fin
|
Int
|
errorMessage
|
Message d'erreur
|
string
|
groupFilter
|
Filtre par groupe de type public
|
string (max: 40)
|
limitedToAPeriod
|
Limiter les fiches d'absences à la période exportée
|
boolean (false / true)
|
populationEndDate
|
Date de fin d'appartenance à la population
|
date (format : yyyy-MM-dd)
|
populationFilter
|
Filtre par population
|
string
|
populationMode
|
Mode de saisie de la population
|
int
Valeurs possibles :
0Population / Groupe
1Salarié |
populationStartDate
|
Date de début d'appartenance à la population
|
date (format : yyyy-MM-dd)
|
startDate
|
Date de début
|
date (format : yyyy-MM-dd)
|
startOffset
|
Offset de départ
|
Int
|
technicalString
|
Clé technique
|
string
|
|
Données en sortie
Code
|
Description
|
Type de classe
|
absenceFileKey
|
Clé de fiche d'absence
|
int
|
absenceTypeAbbreviation
|
Abrégé de motif d'absence / mission
|
String (max: 5)
|
absenceTypeDescription
|
Libellé motif d'absence / mission
|
String (max: 40)
|
absenceTypeKey
|
Clé de motif d'absence / mission
|
Int
|
archivedEmployee
|
Salarié archivé
|
boolean (false / true)
|
comment
|
Commentaire
|
String (max: 2000)
|
creationDate
|
Date de création
|
Date (format : yyyy-MM-dd)
|
durationInDays
|
Durée en jours
|
double
|
durationInHours
|
Durée en heures
|
double
|
employeeBadgeCode
|
Code du badge du salarié
|
String (max: 16)
|
employeeFirstName
|
Prénom du salarié
|
String (max: 24)
|
employeeIdentificationCode
|
Code matricule du salarié
|
String (max: 80)
|
employeeIdentificationNumber
|
Matricule du salarié
|
String (max: 16)
|
employeeKey
|
Clé de salarié
|
Int
|
employeeSurname
|
Nom du salarié
|
String (max: 24)
|
endDate
|
Date de fin
|
Date (format : yyyy-MM-dd)
|
endingTheAfternoon
|
Termine l'après-midi
|
boolean (false / true)
|
errorMessage
|
Message d'erreur
|
String
|
eventObservingDate
|
Date de constatation de l'événement
|
Date (format : yyyy-MM-dd)
|
existRelatedDocument
|
Présence d'un document lié
|
boolean (false / true)
|
firstEndTime
|
Heure de fin de la première période d'absence
|
Time (format : HH:mm:ss)
|
firstEndTimePosition
|
Position de l'heure de fin de la première période d'absence dans la journée logique
|
int
Valeurs possibles :
-1 Avant 0:00
0Le jour même
1Après minuit |
firstStartTime
|
Heure de début de la première période d'absence
|
Time (format : HH:mm:ss)
|
firstStartTimePosition
|
Position de l'heure de début de la première période d'absence dans la journée logique
|
int
Valeurs possibles :
-1 Avant 0:00
0Le jour même
1Après minuit |
initialNoticeCessationWorkDate
|
Date de début de l'arrêt initial
|
Date (format : yyyy-MM-dd)
|
lastModificationDate
|
Date de dernière modification
|
dateTime (format : yyyy-MM-dd'T'HH:mm:ss)
|
lastWorkingDayDate
|
Date du dernier jour de travail
|
Date (format : yyyy-MM-dd)
|
limitedToAPeriod
|
Limiter les fiches d'absences à la période exportée
|
boolean (false / true)
|
noticeCessationWorkExtension
|
Prolongation d'un arrêt de travail
|
boolean (false / true)
|
numberOfAbsenceDays
|
Nombre de jours d'absence
|
Int
|
prescribedEndDate
|
Date de fin prescrite
|
Date (format : yyyy-MM-dd)
|
repetitiveAbsencePeriod
|
Période d'absence répétitive
|
Int
|
resumptionWorkDate
|
Date de reprise du travail
|
Date (format : yyyy-MM-dd)
|
resumptionWorkEarlyDate
|
Date de reprise du travail anticipée
|
Date (format : yyyy-MM-dd)
|
secondEndTime
|
Heure de fin de la deuxième période d'absence
|
Time (format : HH:mm:ss)
|
secondEndTimePosition
|
Position de l'heure de fin de la deuxième période d'absence dans la journée logique
|
int
Valeurs possibles :
-1 Avant 0:00
0Le jour même
1Après minuit |
secondStartTime
|
Heure de début de la deuxième période d'absence
|
Time (format : HH:mm:ss)
|
secondStartTimePosition
|
Position de l'heure de début de la deuxième période d'absence dans la journée logique
|
int
Valeurs possibles :
-1 Avant 0:00
0Le jour même
1Après minuit |
splitHolidaysWaiver
|
Renonciation au fractionnement
|
short
Valeurs possibles :
0Non concerné
1Accepté
2Refusé |
startDate
|
Date de début
|
Date (format : yyyy-MM-dd)
|
startInTheMorning
|
Commence le matin
|
boolean (false / true)
|
technicalString
|
Clé technique
|
String
|
totalInDays
|
Cumul en jours
|
double
|
totalInHours
|
Cumul en heures
|
double
|
|
Exemple de requête
Nom
|
Copier
|
AbsenceFileService
|
Code Sample
|
Copier Code
|
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ech="http://echange.service.open.bodet.com">
<soapenv:Header/>
<soapenv:Body>
<ech:exportAbsenceFilesList>
<ech:exportFilter>
<ech:AskedAbsence>
<ech:employeeIdentificationNumber>00001065</ech:employeeIdentificationNumber>
<ech:populationMode>1</ech:populationMode>
<ech:startDate>2024-09-01</ech:startDate>
<ech:endDate>2024-09-30</ech:endDate>
<ech:dateMode>0</ech:dateMode>
</ech:AskedAbsence>
</ech:exportFilter>
</ech:exportAbsenceFilesList>
</soapenv:Body>
</soapenv:Envelope>
|
|
Réponse
Code Sample
|
Copier Code
|
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns1:exportAbsenceFilesListResponse xmlns:ns1="http://echange.service.open.bodet.com">
<ns1:exportedAbsenceFiles>
<ns1:AbsenceFile>
<ns1:comment xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:startDate>2024-09-16</ns1:startDate>
<ns1:endDate>2024-09-22</ns1:endDate>
<ns1:firstEndTime xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:secondEndTime xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:creationDate>2024-09-13</ns1:creationDate>
<ns1:lastModificationDate>2024-09-13T15:48:02</ns1:lastModificationDate>
<ns1:eventObservingDate xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:prescribedEndDate xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:initialNoticeCessationWorkDate xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:resumptionWorkEarlyDate xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:lastWorkingDayDate xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:resumptionWorkDate xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:absenceTypeAbbreviation>CP</ns1:absenceTypeAbbreviation>
<ns1:absenceTypeDescription>Congés Payés</ns1:absenceTypeDescription>
<ns1:firstStartTime xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:noticeCessationWorkExtension xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:secondStartTime xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:numberOfAbsenceDays xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:fromClockings>false</ns1:fromClockings>
<ns1:totalInHours>36.75</ns1:totalInHours>
<ns1:totalInDays>6.0</ns1:totalInDays>
<ns1:durationInHours>0.00</ns1:durationInHours>
<ns1:absenceFileKey>4391</ns1:absenceFileKey>
<ns1:durationInDays>0.0</ns1:durationInDays>
<ns1:startInTheMorning>true</ns1:startInTheMorning>
<ns1:splitHolidaysWaiver>0</ns1:splitHolidaysWaiver>
<ns1:limitedToAPeriod>false</ns1:limitedToAPeriod>
<ns1:secondEndTimePosition xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:secondStartTimePosition xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:firstStartTimePosition xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:repetitiveAbsencePeriod>0</ns1:repetitiveAbsencePeriod>
<ns1:endingTheAfternoon>true</ns1:endingTheAfternoon>
<ns1:existRelatedDocument>false</ns1:existRelatedDocument>
<ns1:firstEndTimePosition xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:absenceTypeKey>12</ns1:absenceTypeKey>
<ns1:employeeKey>332</ns1:employeeKey>
<ns1:employeeIdentificationCode>GD</ns1:employeeIdentificationCode>
<ns1:employeeBadgeCode xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:employeeIdentificationNumber>00001065</ns1:employeeIdentificationNumber>
<ns1:archivedEmployee>false</ns1:archivedEmployee>
<ns1:employeeSurname>BLUSSEAU</ns1:employeeSurname>
<ns1:employeeFirstName>Tanguy</ns1:employeeFirstName>
<ns1:technicalString xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:errorMessage xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
</ns1:AbsenceFile>
</ns1:exportedAbsenceFiles>
</ns1:exportAbsenceFilesListResponse>
</soap:Body>
</soap:Envelope>
|
|
Écriture des fiches d'absence
Permet d’écrire des fiches d’absences des salariés dans Kelio.
Il existe plusieurs méthodes d’écriture des fiches d’absence dans Kelio. Les absences peuvent être écrites :
•De date à date (absence du 26/04 au 12/05)
•De date à date avec gestion des demi-journée (absence du 25/04 après-midi au 28/04)
•D’heure à heure sur une journée partielle (Date de début= date de fin ex : absence le 30/04 de 10h à 12h)
•Avec un temps imputé sur une journée partielle (Date de début= date de fin ex :absence le 05/05 d’1 heure)
Chaque mode de saisie mobilise des champs de saisie différents.
Lien vers le : https://sandbox-ws.kelio.io/open/services/AbsenceFileService?wsdl
Web Service : AbsenceFileService
Méthode : importAbsenceFiles
Données obligatoires
Identifiant du salarié :
Par matricule :
Ou par badge :
Ou par nom/prénom : et
Identifiant de l’absence :
Abrégé du motif de l’absence :
Ou Libellé du motif de l’absence :
Période de l’absence
•Date de début : startDate
•Date de fin : endDate
Suivant le mode de saisie
Date à date : pas de paramètre supplémentaire
Date à date avec demi-journée : et
D’heure à heure : et
Temps imputé :
|
Les notions en rouge sont obligatoires ! Pour les notions en orange, il faut choisir une données parmi celles proposées.
|
|
Données en entrée
Code
|
Description
|
Type de classe
|
absenceFileKey
|
Clé de fiche d'absence
|
int
|
absenceTypeAbbreviation
|
Abrégé de motif d'absence / mission
|
string (max: 5)
|
absenceTypeDescription
|
Libellé motif d'absence / mission
|
string (max: 40)
|
absenceTypeKey
|
Clé de motif d'absence / mission
|
int
|
archivedEmployee
|
Salarié archivé
|
boolean (false / true)
|
comment
|
Commentaire
|
string (max: 2000)
|
creationDate
|
Date de création
|
date (format : yyyy-MM-dd)
|
durationInDays
|
Durée en jours
|
double
|
durationInHours
|
Durée en heures
|
double
|
employeeBadgeCode
|
Code du badge du salarié
|
string (max: 16)
|
employeeFirstName
|
Prénom du salarié
|
string (max: 24)
|
employeeIdentificationCode
|
Code matricule du salarié
|
string (max: 80)
|
employeeIdentificationNumber
|
Matricule du salarié
|
String (max: 16)
|
employeeKey
|
Clé de salarié
|
Int
|
employeeSurname
|
Nom du salarié
|
String (max: 24)
|
endDate
|
Date de fin
|
date (format : yyyy-MM-dd)
|
endingTheAfternoon
|
Termine l'après-midi
|
boolean (false / true)
|
errorMessage
|
Message d'erreur
|
String
|
eventObservingDate
|
Date de constatation de l'événement
|
Date (format : yyyy-MM-dd)
|
existRelatedDocument
|
Présence d'un document lié
|
boolean (false / true)
|
firstEndTime
|
Heure de fin de la première période d'absence
|
Time (format : HH:mm:ss)
|
firstEndTimePosition
|
Position de l'heure de fin de la première période d'absence dans la journée logique
|
int
Valeurs possibles :
-1 Avant 0:00
0Le jour même
1Après minuit |
firstStartTime
|
Heure de début de la première période d'absence
|
Time (format : HH:mm:ss)
|
firstStartTimePosition
|
Position de l'heure de début de la première période d'absence dans la journée logique
|
int
Valeurs possibles :
-1 Avant 0:00
0Le jour même
1Après minuit |
initialNoticeCessationWorkDate
|
Date de début de l'arrêt initial
|
Date (format : yyyy-MM-dd)
|
lastModificationDate
|
Date de dernière modification
|
dateTime (format : yyyy-MM-dd'T'HH:mm:ss)
|
lastWorkingDayDate
|
Date du dernier jour de travail
|
Date (format : yyyy-MM-dd)
|
limitedToAPeriod
|
Limiter les fiches d'absences à la période exportée
|
boolean (false / true)
|
noticeCessationWorkExtension
|
Prolongation d'un arrêt de travail
|
boolean (false / true)
|
numberOfAbsenceDays
|
Nombre de jours d'absence
|
Int
|
prescribedEndDate
|
Date de fin prescrite
|
Date (format : yyyy-MM-dd)
|
repetitiveAbsencePeriod
|
Période d'absence répétitive
|
Int
|
resumptionWorkDate
|
Date de reprise du travail
|
Date (format : yyyy-MM-dd)
|
resumptionWorkEarlyDate
|
Date de reprise du travail anticipée
|
Date (format : yyyy-MM-dd)
|
secondEndTime
|
Heure de fin de la deuxième période d'absence
|
Time (format : HH:mm:ss)
|
secondEndTimePosition
|
Position de l'heure de fin de la deuxième période d'absence dans la journée logique
|
int
Valeurs possibles :
-1 Avant 0:00
0Le jour même
1Après minuit |
secondStartTime
|
Heure de début de la deuxième période d'absence
|
Time (format : HH:mm:ss)
|
secondStartTimePosition
|
Position de l'heure de début de la deuxième période d'absence dans la journée logique
|
int
Valeurs possibles :
-1 Avant 0:00
0Le jour même
1Après minuit |
splitHolidaysWaiver
|
Renonciation au fractionnement
|
short
Valeurs possibles :
0Non concerné
1Accepté
2Refusé |
startDate
|
Date de début
|
date (format : yyyy-MM-dd)
|
startInTheMorning
|
Commence le matin
|
boolean (false / true)
|
technicalString
|
Clé technique
|
String
|
totalInDays
|
Cumul en jours
|
double
|
totalInHours
|
Cumul en heures
|
double
|
|
Exemple de requête
Nom
|
Copier
|
AbsenceFileService
|
Code Sample
|
Copier Code
|
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ech="http://echange.service.open.bodet.com">
<soapenv:Header/>
<soapenv:Body>
<ech:importAbsenceFiles>
<!--Optional:-->
<ech:absenceFilesToImport>
<!--Zero or more repetitions:-->
<ech:AbsenceFile>
<!--Optional:-->
<ech:employeeIdentificationNumber>00001057</ech:employeeIdentificationNumber>
<ech:endDate>2024-06-15</ech:endDate>
<!--Optional:-->
<ech:startDate>2024-06-02</ech:startDate>
<!--Optional:-->
<ech:absenceTypeAbbreviation>CP</ech:absenceTypeAbbreviation>
</ech:AbsenceFile>
</ech:absenceFilesToImport>
</ech:importAbsenceFiles>
</soapenv:Body>
</soapenv:Envelope>
|
Si le système vous renvoie dans le message d’erreur , c’est que cette absence a déjà été créée. Dans ce cas, vous pouvez modifier les dates et faire une nouvelle demande de création.
|
Réponse
En cas de demande d’écriture de données dans Kelio :
•S’il n’y a pas d’erreur, le Web Service rend la main avec une requête vide sans élément.
•S’il y a des erreurs lors de l'écriture de données, le Web Service renvoie les éléments en erreur et alimente le champ . Le message renvoyé correspond à la description de l’erreur fonctionnelle rencontrée par le Web Service lors de la demande d’écriture de la donnée.
Code Sample
|
Copier Code
|
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns1:importAbsenceFilesResponse xmlns:ns1="http://echange.service.open.bodet.com">
<ns1:absenceFilesInError></ns1:absenceFilesInError>
</ns1:importAbsenceFilesResponse>
</soap:Body>
</soap:Envelope>
|
Code Sample
|
Copier Code
|
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns1:importAbsenceFilesResponse xmlns:ns1="http://echange.service.open.bodet.com">
<ns1:absenceFilesInError>
<ns1:AbsenceFile>
<ns1:comment xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:startDate>2024-07-01</ns1:startDate>
<ns1:endDate>2024-07-15</ns1:endDate>
<ns1:firstEndTime xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:secondEndTime xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:creationDate xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:lastModificationDate xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:eventObservingDate xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:prescribedEndDate xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:initialNoticeCessationWorkDate xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:resumptionWorkEarlyDate xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:lastWorkingDayDate xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:resumptionWorkDate xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:absenceTypeAbbreviation>CPH</ns1:absenceTypeAbbreviation>
<ns1:absenceTypeDescription xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:firstStartTime xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:noticeCessationWorkExtension xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:secondStartTime xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:numberOfAbsenceDays xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:fromClockings xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:totalInHours xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:totalInDays xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:durationInHours xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:absenceFileKey xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:durationInDays xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:startInTheMorning xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:splitHolidaysWaiver xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:limitedToAPeriod xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:secondEndTimePosition xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:secondStartTimePosition xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:firstStartTimePosition xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:repetitiveAbsencePeriod xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:endingTheAfternoon xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:existRelatedDocument xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:firstEndTimePosition xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:absenceTypeKey xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:employeeKey xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:employeeIdentificationCode xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:employeeBadgeCode xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:employeeIdentificationNumber>00001057</ns1:employeeIdentificationNumber>
<ns1:archivedEmployee xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:employeeSurname xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:employeeFirstName xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:technicalString xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:errorMessage>L'objet a été modifié ou supprimé entre temps par un autre utilisateur (motifAbsence)</ns1:errorMessage>
</ns1:AbsenceFile>
</ns1:absenceFilesInError>
</ns1:importAbsenceFilesResponse>
</soap:Body>
</soap:Envelope</soap:Envelope>
|
Le Web Services retourne la liste des éléments en erreur avec le champ alimenté. ErrorMessage indique : L'objet a été modifié ou supprimé entre temps par un autre utilisateur (motifAbsence). Ce type d’erreur est renvoyé quand un élément n’a pas pu être trouvé par son identifiant dans la base Kelio. Ici le motif d’absence n’existe pas dans la liste des motifs d’absences.
|
Suppression des fiches d’absences
Permet de supprimer une fiche d’absence dans Kelio pour un salarié
Lien vers le : https://sandbox-ws.kelio.io/open/services/AbsenceFileService?wsdl
Web service : AbsenceFileService
Méthode : deleteAbsenceFiles
Données obligatoires
Identifiant du salarié :
Par matricule :
Ou par badge :
Ou par nom/prénom : et
Ou clé technique :
Identifiant de l’absence :
Abrégé du motif de l’absence :
Ou Libellé du motif de l’absence :
Période de l’absence
•Date de début : startDate
•Date de fin : endDate
|
Les notions en rouge sont obligatoires ! Pour les notions en orange, il faut choisir une données parmi celles proposées.
|
|
Données en entrée
Code
|
Description
|
Type de classe
|
absenceFileKey
|
Clé de fiche d'absence
|
int
|
absenceTypeAbbreviation
|
Abrégé de motif d'absence / mission
|
string (max: 5)
|
absenceTypeDescription
|
Libellé motif d'absence / mission
|
string (max: 40)
|
absenceTypeKey
|
Clé de motif d'absence / mission
|
int
|
archivedEmployee
|
Salarié archivé
|
boolean (false / true)
|
comment
|
Commentaire
|
string (max: 2000)
|
creationDate
|
Date de création
|
date (format : yyyy-MM-dd)
|
durationInDays
|
Durée en jours
|
double
|
durationInHours
|
Durée en heures
|
double
|
employeeBadgeCode
|
Code du badge du salarié
|
string (max: 16)
|
employeeFirstName
|
Prénom du salarié
|
string (max: 24)
|
employeeIdentificationCode
|
Code matricule du salarié
|
string (max: 80)
|
employeeIdentificationNumber
|
Matricule du salarié
|
String (max: 16)
|
employeeKey
|
Clé de salarié
|
Int
|
employeeSurname
|
Nom du salarié
|
String (max: 24)
|
endDate
|
Date de fin
|
date (format : yyyy-MM-dd)
|
endingTheAfternoon
|
Termine l'après-midi
|
boolean (false / true)
|
errorMessage
|
Message d'erreur
|
String
|
eventObservingDate
|
Date de constatation de l'événement
|
Date (format : yyyy-MM-dd)
|
existRelatedDocument
|
Présence d'un document lié
|
boolean (false / true)
|
firstEndTime
|
Heure de fin de la première période d'absence
|
Time (format : HH:mm:ss)
|
firstEndTimePosition
|
Position de l'heure de fin de la première période d'absence dans la journée logique
|
int
Valeurs possibles :
-1 Avant 0:00
0Le jour même
1Après minuit |
firstStartTime
|
Heure de début de la première période d'absence
|
Time (format : HH:mm:ss)
|
firstStartTimePosition
|
Position de l'heure de début de la première période d'absence dans la journée logique
|
int
Valeurs possibles :
-1 Avant 0:00
0Le jour même
1Après minuit |
initialNoticeCessationWorkDate
|
Date de début de l'arrêt initial
|
Date (format : yyyy-MM-dd)
|
lastModificationDate
|
Date de dernière modification
|
dateTime (format : yyyy-MM-dd'T'HH:mm:ss)
|
lastWorkingDayDate
|
Date du dernier jour de travail
|
Date (format : yyyy-MM-dd)
|
limitedToAPeriod
|
Limiter les fiches d'absences à la période exportée
|
boolean (false / true)
|
noticeCessationWorkExtension
|
Prolongation d'un arrêt de travail
|
boolean (false / true)
|
numberOfAbsenceDays
|
Nombre de jours d'absence
|
Int
|
prescribedEndDate
|
Date de fin prescrite
|
Date (format : yyyy-MM-dd)
|
repetitiveAbsencePeriod
|
Période d'absence répétitive
|
Int
|
resumptionWorkDate
|
Date de reprise du travail
|
Date (format : yyyy-MM-dd)
|
resumptionWorkEarlyDate
|
Date de reprise du travail anticipée
|
Date (format : yyyy-MM-dd)
|
secondEndTime
|
Heure de fin de la deuxième période d'absence
|
Time (format : HH:mm:ss)
|
secondEndTimePosition
|
Position de l'heure de fin de la deuxième période d'absence dans la journée logique
|
int
Valeurs possibles :
-1 Avant 0:00
0Le jour même
1Après minuit |
secondStartTime
|
Heure de début de la deuxième période d'absence
|
Time (format : HH:mm:ss)
|
secondStartTimePosition
|
Position de l'heure de début de la deuxième période d'absence dans la journée logique
|
int
Valeurs possibles :
-1 Avant 0:00
0Le jour même
1Après minuit |
splitHolidaysWaiver
|
Renonciation au fractionnement
|
short
Valeurs possibles :
0Non concerné
1Accepté
2Refusé |
startDate
|
Date de début
|
date (format : yyyy-MM-dd)
|
startInTheMorning
|
Commence le matin
|
boolean (false / true)
|
technicalString
|
Clé technique
|
String
|
totalInDays
|
Cumul en jours
|
double
|
totalInHours
|
Cumul en heures
|
double
|
|
Exemple de requête
Nom
|
Copier
|
AbsenceFileService
|
Code Sample
|
Copy Code
|
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ech="http://echange.service.open.bodet.com">
<soapenv:Header/>
<soapenv:Body>
<ech:deleteAbsenceFiles>
<ech:absenceFilesToDelete>
<ech:AbsenceFile>
<ech:employeeIdentificationNumber>00002110</ech:employeeIdentificationNumber>
<ech:employeeIdentificationCode>Retail</ech:employeeIdentificationCode>
<ech:endDate>2025-03-28</ech:endDate>
<ech:startDate>2025-03-28</ech:startDate>
<ech:absenceTypeAbbreviation>RTT</ech:absenceTypeAbbreviation>
</ech:AbsenceFile>
</ech:absenceFilesToDelete>
</ech:deleteAbsenceFiles>
</soapenv:Body>
</soapenv:Envelope>
|
|
Réponse
En cas de demande de suppression de données dans Kelio :
•S’il n’y a pas d’erreur, le Web Service rend la main avec une requête vide sans élément.
•S’il y a des erreurs lors de la suppression de données, le Web Service renvoie les éléments en erreur et alimente le champ . Le message renvoyé correspond à la description de l’erreur fonctionnelle rencontrée par le Web Service lors de la demande de suppression de la donnée.
Code Sample
|
Copy Code
|
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns1:deleteAbsenceFilesResponse xmlns:ns1="http://echange.service.open.bodet.com">
<ns1:absenceFilesInError></ns1:absenceFilesInError>
</ns1:deleteAbsenceFilesResponse>
</soap:Body>
</soap:Envelope>
|
Code Sample
|
Copy Code
|
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns1:deleteAbsenceFilesResponse xmlns:ns1="http://echange.service.open.bodet.com">
<ns1:absenceFilesInError>
<ns1:AbsenceFile>
<ns1:absenceTypeKey xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:absenceFileKey xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:startInTheMorning xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:totalInHours xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:totalInDays xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:fromClockings xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:firstStartTime xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:durationInDays xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:numberOfAbsenceDays xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:noticeCessationWorkExtension xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:durationInHours xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:secondStartTime xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:resumptionWorkDate xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:splitHolidaysWaiver xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:absenceTypeAbbreviation>RTT</ns1:absenceTypeAbbreviation>
<ns1:limitedToAPeriod xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:absenceTypeDescription xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:firstEndTimePosition xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:repetitiveAbsencePeriod xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:secondStartTimePosition xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:firstStartTimePosition xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:secondEndTimePosition xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:existRelatedDocument xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:endingTheAfternoon xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:creationDate xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:firstEndTime xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:secondEndTime xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:lastModificationDate xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:comment xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:resumptionWorkEarlyDate xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:lastWorkingDayDate xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:initialNoticeCessationWorkDate xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:prescribedEndDate xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:eventObservingDate xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:endDate>2025-02-27</ns1:endDate>
<ns1:startDate>2025-02-27</ns1:startDate>
<ns1:employeeFirstName xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:employeeKey xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:employeeSurname xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:archivedEmployee xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:employeeBadgeCode xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:employeeIdentificationCode>Retails</ns1:employeeIdentificationCode>
<ns1:employeeIdentificationNumber>00002110</ns1:employeeIdentificationNumber>
<ns1:technicalString xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:errorMessage>Salarié introuvable</ns1:errorMessage>
</ns1:AbsenceFile>
</ns1:absenceFilesInError>
</ns1:deleteAbsenceFilesResponse>
</soap:Body>
</soap:Envelope>
|
|
Filtre sur les périodes des données à extraire
