Suivant le compteur dont vous souhaitez obtenir les résultats, il est nécessaire d’utiliser la bonne méthode. Il est possible d’utiliser les méthodes qui renvoient les résultats du compte jour par jour ou sommés sur la période demandée.
Liste des méthodes de lecture des résultats avec détail des résultats jour par jour sur la période demandée
Liste des méthodes de lecture des résultats avec la somme des résultats sur la période demandée
Lecture de l’«Effectif » jour par jour sur la période du 01/09/2024 au 03/09/2024
L’identifient du compte = « -5 »
Lien vers le : https://sandbox-ws.kelio.io/open/services/AccountTotalService?wsdl
Web Service : AccountTotalService
Méthode : exportDailyAccountTotalsList
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
|
archivedEmployee
|
Salarié archivé
|
boolean (false / true)
|
calculationMode
|
Mode de calcul
|
int
Valeurs possibles :
0Réalisé
1Planifié
2Prévisionnel
3Prévisionnel avec demandes d'absence |
dateMode
|
Mode de saisie des dates
|
int
Valeurs possibles :
0 Date à date
1Jour
2Semaine
3Période
4Année |
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)
|
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
|
transferEmptyAccount
|
Transférer les cumuls à zéro
|
boolean (false / true)
|
typeKey
|
Clé de motif
|
Int
|
|
Données en sortie
Code
|
Description
|
Type de classe
|
archivedEmployee
|
Salarié archivé
|
boolean (false / true)
|
days
|
Jours
|
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)
|
errorMessage
|
Message d'erreur
|
String
|
hours
|
Heures
|
Double
|
number
|
Nombre
|
Double
|
physicalHours
|
Heures 0-24
|
Double
|
sectionAbbreviation
|
Abrégé de service
|
String (max: 40)
|
sectionDescription
|
Libellé de service
|
String (max: 50)
|
sectionKey
|
Clé de service
|
Int
|
startDate
|
Date de début
|
Date (format : yyyy-MM-dd)
|
technicalString
|
Clé technique
|
String
|
typeAbbreviation
|
Abrégé de motif
|
String
|
typeDescription
|
Libellé de motif
|
String
|
typeKey
|
Clé de motif
|
Int
|
|
Exemple de requête
Nom
|
Copier
|
AccountTotalService
|
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:exportDailyAccountTotalsList>
<!--Optional:-->
<ech:accountFilter>
<!--Zero or more repetitions:-->
<ech:AccountFilter>
<ech:employeeIdentificationNumber>00001001</ech:employeeIdentificationNumber>
<ech:startDate>2024-09-01</ech:startDate>
<ech:endDate>2024-09-03</ech:endDate>
<ech:populationMode>1</ech:populationMode>
<ech:dateMode>0</ech:dateMode>
<ech:calculationMode>2</ech:calculationMode>
<ech:typeKey>-5</ech:typeKey>
</ech:AccountFilter>
</ech:accountFilter>
</ech:exportDailyAccountTotalsList>
</soapenv:Body>
</soapenv:Envelope>
|
|
Réponse
Code Sample
|
Copier Code
|
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns1:exportDailyAccountTotalsListResponse xmlns:ns1="http://echange.service.open.bodet.com">
<ns1:exportedDailyAccountTotals>
<ns1:DailyTotal>
<ns1:number xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:physicalHours>5.70</ns1:physicalHours>
<ns1:days xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:hours>5.70</ns1:hours>
<ns1:date>2024-09-01</ns1:date>
<ns1:sectionKey>150</ns1:sectionKey>
<ns1:sectionDescription>Comptabilité</ns1:sectionDescription>
<ns1:sectionAbbreviation xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:typeKey>-5</ns1:typeKey>
<ns1:typeAbbreviation>Eff.</ns1:typeAbbreviation>
<ns1:typeDescription>Effectif</ns1:typeDescription>
<ns1:employeeKey>310</ns1:employeeKey>
<ns1:employeeSurname>ANDIVEAU</ns1:employeeSurname>
<ns1:employeeFirstName>Loïc</ns1:employeeFirstName>
<ns1:employeeIdentificationCode>GD</ns1:employeeIdentificationCode>
<ns1:archivedEmployee xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:employeeIdentificationNumber>00001001</ns1:employeeIdentificationNumber>
<ns1:employeeBadgeCode 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 xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
</ns1:DailyTotal>
<ns1:DailyTotal>
<ns1:number xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:physicalHours>5.70</ns1:physicalHours>
<ns1:days xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:hours>5.70</ns1:hours>
<ns1:date>2024-09-03</ns1:date>
<ns1:sectionKey>150</ns1:sectionKey>
<ns1:sectionDescription>Comptabilité</ns1:sectionDescription>
<ns1:sectionAbbreviation xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:typeKey>-5</ns1:typeKey>
<ns1:typeAbbreviation>Eff.</ns1:typeAbbreviation>
<ns1:typeDescription>Effectif</ns1:typeDescription>
<ns1:employeeKey>310</ns1:employeeKey>
<ns1:employeeSurname>ANDIVEAU</ns1:employeeSurname>
<ns1:employeeFirstName>Loïc</ns1:employeeFirstName>
<ns1:employeeIdentificationCode>GD</ns1:employeeIdentificationCode>
<ns1:archivedEmployee xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:employeeIdentificationNumber>00001001</ns1:employeeIdentificationNumber>
<ns1:employeeBadgeCode 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 xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
</ns1:DailyTotal>
</ns1:exportedDailyAccountTotals>
</ns1:exportDailyAccountTotalsListResponse>
</soap:Body>
</soap:Envelope>
|
|
Filtre sur les périodes des données à extraire
