The activity allows you to qualify the employee’s worked time for each day.
Link to : https://sandbox-ws.kelio.io/open/services/JobAssignmentService?wsdl
Reading activities
Allows you to read the employee's activity assignments between 2 dates.
Web Service: JobAssignmentService
Method : exportJobAssignmentsList
Mandatory data
There are two options for reading employee data:
•Either reading an employee's data via one of the employee's identifiers (personnel number, badge no, surname/first name). The is the preferred identifier because it is usually consistent over time.
•Or reading data from a list of employees using filters on and . These concepts can be configured using the Kelio manager (see online help Population and Group).
The tag is used to define this operating mode:
In this case, one of the following identifiers is mandatory:
Employee ID number:
or Badge code:
or Surname First name: and
•or Technical key: (this identifier is used during batch processing after reading employee keys via the Web Service )
In this case, the concepts of Population and Group can be used. This data is not mandatory. If they are not completed, the Web Service returns the data for all employees. On large quantities of data, this type of request can slow down the performance of the Kelio server. We therefore strongly recommend that you use them.
Population:
Group: |
There are two ways of filtering dated data by date range.
•Either by using a real date period: for example, from 14/05/2024 to 25/06/2024.
•Or by using a date range relative to the current date: e.g. -20 days to +10 days.
The tagis used to define this operating mode:
Fields to be completed:
•: start date using actual date
•: end date using actual date
Fields to be completed
•: relative start date. Number of days before or after the current date.
•: relative end date. Number of days before or after the current date. |
|
Input data
Code
|
Description
|
Class type
|
archivedEmployee
|
Archived employee
|
boolean (false / true)
|
calculationMode
|
Calculation mode
|
int
Possible values:
0 Completed
1 Planned
2 Estimated
3 Estimated with absence request
|
dateMode
|
Date entry mode
|
int
Possible values:
0Date to date
1Relative start date to relative end date |
employeeBadgeCode
|
Employee badge code
|
string (max: 16)
|
employeeFirstName
|
Employee first name
|
string (max: 24)
|
employeeIdentificationCode
|
Employee ID number code
|
string (max: 80)
|
employeeIdentificationNumber
|
Employee's ID number
|
string (max: 16)
|
employeeKey
|
Employee key
|
int
|
employeeSurname
|
Employee surname
|
string (max: 24)
|
endDate
|
End date
|
date (format: yyyy-MM-dd)
|
endOffset
|
End offset
|
int
|
errorMessage
|
Error message
|
string
|
groupFilter
|
Filter by public type group
|
string (max: 40)
|
populationEndDate
|
Population end date
|
date (format: yyyy-MM-dd)
|
populationFilter
|
Filter by population
|
string
|
populationMode
|
Population input mode
|
int
Possible values:
0Population / Group
1Employee |
populationStartDate
|
Population start date
|
date (format: yyyy-MM-dd)
|
startDate
|
Start date
|
date (format: yyyy-MM-dd)
|
startOffset
|
Start offset
|
int
|
technicalString
|
Technical key
|
string
|
|
Output data
Code
|
Description
|
Class type
|
applicationDate
|
Application date
|
date (format: yyyy-MM-dd)
|
archivedEmployee
|
Archived employee
|
boolean (false / true)
|
calculationMode
|
Calculation mode
|
int
Possible values:
0Completed
1Planned
2Estimated
3Estimated with absence requests |
costCentreAbbreviation
|
Cost centre abbreviation
|
string (max: 5)
|
costCentreCode
|
Cost centre code
|
string (max: 40)
|
costCentreDescription
|
Cost centre description
|
string (max: 40)
|
costCentreExternalReference
|
External cost centre reference
|
string (max: 40)
|
costCentreKey
|
Cost centre key
|
int
|
customerAbbreviation
|
Customer type abbreviation
|
string (max: 5)
|
customerCode
|
Customer type code
|
string (max: 40)
|
customerDescription
|
Customer description
|
string (max: 40)
|
customerExternalReference
|
External customer reference
|
string (max: 40)
|
customerKey
|
Customer key
|
int
|
durationInHours
|
Duration in hours
|
double
|
durationMode
|
Entry mode
|
int
Possible value:
0Duration
11st half-day
22nd half-day
3Day
4Period
5Percentage |
employeeBadgeCode
|
Employee badge code
|
string (max: 16)
|
employeeFirstName
|
Employee first name
|
string (max: 24)
|
employeeIdentificationCode
|
Employee ID number code
|
string (max: 80)
|
employeeIdentificationNumber
|
Employee's ID number
|
string (max: 16)
|
employeeKey
|
Employee key
|
int
|
employeeSurname
|
Employee surname
|
string (max: 24)
|
errorMessage
|
Error message
|
String
|
geolocationPrecision
|
Geolocation precision
|
int
|
geolocationStatus
|
Geolocation status
|
Short
Possible values:
0Successful
1Failed
2Denied |
jobAbbreviation
|
Job abbreviation
|
string (max: 5)
|
jobAssignmentKey
|
Job assignment key
|
int
|
jobCode
|
Job code
|
string (max: 40)
|
jobDescription
|
Job description
|
string (max: 40)
|
jobExternalReference
|
External job reference
|
string (max: 40)
|
jobKey
|
Job key
|
int
|
Latitude
|
Latitude
|
float
|
Longitude
|
Longitude
|
float
|
Note
|
Note
|
string (max: 500)
|
percentage
|
Percentage
|
double
|
periodEndTime
|
Period end time
|
time (format: HH:mm:ss)
|
periodEndTimePosition
|
Period end time position
|
int
Possible values:
-1 Before 0:00
0The same day
1After midnight |
periodStartTime
|
Period start time
|
time (format: HH:mm:ss)
|
periodStartTimePosition
|
Period start time position
|
int
Possible values:
-1 Before 0:00
0The same day
1After midnight |
quantity
|
Quantity
|
float
|
technicalString
|
Technical key
|
string
|
|
Example of a request
Code Sample
|
Copy Code
|
JobAssignmentService
|
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:exportJobAssignmentsList>
<ech:exportFilter>
<ech:AskedJobAssignments>
<ech:employeeIdentificationNumber>00001054</ech:employeeIdentificationNumber>
<ech:employeeIdentificationCode>GD</ech:employeeIdentificationCode>
<ech:populationMode>1</ech:populationMode>
<ech:dateMode>0</ech:dateMode>
<ech:endDate>2025-03-09</ech:endDate>
<ech:startDate>2025-03-02</ech:startDate>
<ech:calculationMode>0</ech:calculationMode>
</ech:AskedJobAssignments>
</ech:exportFilter>
</ech:exportJobAssignmentsList>
</soapenv:Body>
</soapenv:Envelope>
|
|
Response
Code Sample
|
Copy Code
|
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns1:exportJobAssignmentsListResponse xmlns:ns1="http://echange.service.open.bodet.com">
<ns1:exportedJobAssignments>
<ns1:JobAssignment>
<ns1:jobAssignmentKey xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:durationMode>3</ns1:durationMode>
<ns1:quantity xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:latitude xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:longitude xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:note xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:geolocationStatus xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:geolocationPrecision xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:customerKey xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:jobKey xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:customerCode xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:jobCode xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:customerExternalReference xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:percentage xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:costCentreDescription>Charcuterie Traditionnelle</ns1:costCentreDescription>
<ns1:jobDescription xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:costCentreKey>257</ns1:costCentreKey>
<ns1:costCentreAbbreviation>CT</ns1:costCentreAbbreviation>
<ns1:jobAbbreviation xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:costCentreCode>1296</ns1:costCentreCode>
<ns1:customerDescription xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:periodEndTimePosition xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:periodStartTimePosition xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:jobExternalReference xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:customerAbbreviation xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:costCentreExternalReference/>
<ns1:calculationMode>0</ns1:calculationMode>
<ns1:applicationDate>2025-03-03</ns1:applicationDate>
<ns1:periodEndTime xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:periodStartTime xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:durationInHours>6.00</ns1:durationInHours>
<ns1:employeeFirstName>Salomé</ns1:employeeFirstName>
<ns1:employeeKey>368</ns1:employeeKey>
<ns1:employeeSurname>ADADO</ns1:employeeSurname>
<ns1:archivedEmployee>false</ns1:archivedEmployee>
<ns1:employeeBadgeCode xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:employeeIdentificationCode>GD</ns1:employeeIdentificationCode>
<ns1:employeeIdentificationNumber>00001054</ns1:employeeIdentificationNumber>
<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:JobAssignment>
</ns1:exportedJobAssignments>
</ns1:exportJobAssignmentsListResponse>
</soap:Body>
</soap:Envelope>
|
|
Writing activities
Allows you to assign activities to employees in Kelio.
Several activity levels are available in Kelio to qualify the working time of an employee:
•Jobs
•Cost centres
•Clients
It is not necessary to fill all levels for assigning an activity to an employee; what is more, you might not have access to all levels (depending on your Kelio license).
Web Service: JobAssignmentService
Method: importJobAssignments
Mandatory data
Employee ID:
by identification number:
or by badge:
or by surname/first name: and
or by technical key: (often used in batch processing)
Identifier of activity levels concerned:
Job abreviation or description: or
Cost centre abbreviation or description: or
Client abbreviation or description: or
Application date:
Calculation mode:
Entry mode:
Activity duration depending on entry mode:
Duration in hours:
Percentage:
Period: ,,and
|
The terms in red are compulsory! For the terms in orange, you need to choose data from among that proposed.
|
|
Input data
Code
|
Description
|
Class type
|
applicationDate
|
Application date
|
date (format: yyyy-MM-dd)
|
archivedEmployee
|
Archived employee
|
boolean (false / true)
|
calculationMode
|
Calculation mode
|
int
Possible values:
0Completed
1Planned
2Estimated
3Estimated with absence requests |
costCentreAbbreviation
|
Cost centre abbreviation
|
string (max: 5)
|
costCentreCode
|
Cost centre code
|
string (max: 40)
|
costCentreDescription
|
Cost centre description
|
string (max: 40)
|
costCentreExternalReference
|
External cost centre reference
|
string (max: 40)
|
costCentreKey
|
Cost centre key
|
int
|
customerAbbreviation
|
Customer type abbreviation
|
string (max: 5)
|
customerCode
|
Customer type code
|
string (max: 40)
|
customerDescription
|
Customer description
|
string (max: 40)
|
customerExternalReference
|
External customer reference
|
string (max: 40)
|
customerKey
|
Customer key
|
int
|
durationInHours
|
Duration in hours
|
double
|
durationMode
|
Entry mode
|
int
Possible value:
0Duration
11st half-day
22nd half-day
3Day
4Period
5Percentage |
employeeBadgeCode
|
Employee badge code
|
string (max: 16)
|
employeeFirstName
|
Employee first name
|
string (max: 24)
|
employeeIdentificationCode
|
Employee ID number code
|
string (max: 80)
|
employeeIdentificationNumber
|
Employee's ID number
|
string (max: 16)
|
employeeKey
|
Employee key
|
int
|
employeeSurname
|
Employee surname
|
string (max: 24)
|
errorMessage
|
Error message
|
String
|
geolocationPrecision
|
Geolocation precision
|
int
|
geolocationStatus
|
Geolocation status
|
Short
Possible value:
0Successful
1Failed
2Denied |
jobAbbreviation
|
Job abbreviation
|
string (max: 5)
|
jobAssignmentKey
|
Activity assignment key
|
int
|
jobCode
|
Job code
|
string (max: 40)
|
jobDescription
|
Job description
|
string (max: 40)
|
jobExternalReference
|
External job reference
|
string (max: 40)
|
jobKey
|
Job key
|
int
|
latitude
|
Latitude
|
float
|
longitude
|
Longitude
|
float
|
note
|
Note
|
string (max: 500)
|
percentage
|
Percentage
|
double
|
periodEndTime
|
Period end time
|
time (format: HH:mm:ss)
|
periodEndTimePosition
|
Period end time position
|
int
Possible values:
-1 Before 0:00
0The same day
1After midnight |
periodStartTime
|
Period start time
|
time (format: HH:mm:ss)
|
periodStartTimePosition
|
Period start time position
|
int
Possible values:
-1 Before 0:00
0The same day
1After midnight |
quantity
|
Quantity
|
float
|
technicalString
|
Technical key
|
string
|
|
Output data
Code
|
Description
|
Class type
|
applicationDate
|
Application date
|
date (format: yyyy-MM-dd)
|
archivedEmployee
|
Archived employee
|
boolean (false / true)
|
calculationMode
|
Calculation mode
|
int
Possible values:
0Completed
1Planned
2Estimated
3Estimated with absence requests |
costCentreAbbreviation
|
Cost centre abbreviation
|
string (max: 5)
|
costCentreCode
|
Cost centre code
|
string (max: 40)
|
costCentreDescription
|
Cost centre description
|
string (max: 40)
|
costCentreExternalReference
|
External cost centre reference
|
string (max: 40)
|
costCentreKey
|
Cost centre key
|
int
|
customerAbbreviation
|
Customer type abbreviation
|
string (max: 5)
|
customerCode
|
Customer type code
|
string (max: 40)
|
customerDescription
|
Customer description
|
string (max: 40)
|
customerExternalReference
|
External customer reference
|
string (max: 40)
|
customerKey
|
Customer key
|
int
|
durationInHours
|
Duration in hours
|
double
|
durationMode
|
Entry mode
|
int
Possible value:
0Duration
11st half-day
22nd half-day
3Day
4Period
5Percentage |
employeeBadgeCode
|
Employee badge code
|
string (max: 16)
|
employeeFirstName
|
Employee first name
|
string (max: 24)
|
employeeIdentificationCode
|
Employee ID number code
|
string (max: 80)
|
employeeIdentificationNumber
|
Employee's ID number
|
string (max: 16)
|
employeeKey
|
Employee key
|
int
|
employeeSurname
|
Employee’s surname
|
string (max: 24)
|
errorMessage
|
Error message
|
String
|
geolocationPrecision
|
Geolocation precision
|
int
|
geolocationStatus
|
Geolocation status
|
Short
Possible value:
0Successful
1Failed
2Denied |
jobAbbreviation
|
Job abbreviation
|
string (max: 5)
|
jobAssignmentKey
|
Activity assignment key
|
int
|
jobCode
|
Job code
|
string (max: 40)
|
jobDescription
|
Job description
|
string (max: 40)
|
jobExternalReference
|
External job reference
|
string (max: 40)
|
jobKey
|
Job key
|
int
|
latitude
|
Latitude
|
float
|
longitude
|
Longitude
|
float
|
note
|
Note
|
string (max: 500)
|
percentage
|
Percentage
|
double
|
periodEndTime
|
Period end time
|
time (format: HH:mm:ss)
|
periodEndTimePosition
|
Period end time position
|
int
Possible values:
-1 Before 0:00
0The same day
1After midnight |
periodStartTime
|
Period start time
|
time (format: HH:mm:ss)
|
periodStartTimePosition
|
Period start time position
|
int
Possible values:
-1 Before 0:00
0The same day
1After midnight |
quantity
|
Quantity
|
float
|
technicalString
|
Technical key
|
string
|
|
Example of a request
Code Sample
|
Copy Code
|
JobAssignmentService
|
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:importJobAssignments>
<ech:jobAssignmentsToImport>
<ech:JobAssignment>
<ech:employeeIdentificationNumber>00000015</ech:employeeIdentificationNumber>
<ech:employeeIdentificationCode>A&P</ech:employeeIdentificationCode>
<ech:calculationMode>0</ech:calculationMode>
<ech:jobAbbreviation>T_B</ech:jobAbbreviation>
<ech:costCentreAbbreviation>ATLSB</ech:costCentreAbbreviation>
<ech:durationInHours>2.0</ech:durationInHours>
<ech:applicationDate>2025-01-06</ech:applicationDate>
<ech:durationMode>0</ech:durationMode>
</ech:JobAssignment>
</ech:jobAssignmentsToImport>
</ech:importJobAssignments>
</soapenv:Body>
</soapenv:Envelope>
|
|
Response
Code Sample
|
Copy Code
|
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns1:importJobAssignmentsResponse xmlns:ns1="http://echange.service.open.bodet.com">
<ns1:jobAssignmentsInError>
<ns1:JobAssignment>
<ns1:jobAssignmentKey xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:durationMode>0</ns1:durationMode>
<ns1:quantity xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:latitude xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:longitude xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:note xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:geolocationStatus xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:geolocationPrecision xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:customerKey xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:jobKey xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:customerCode xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:jobCode xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:customerExternalReference xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:percentage xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:costCentreDescription xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:jobDescription xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:costCentreKey xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:costCentreAbbreviation>ATLSB</ns1:costCentreAbbreviation>
<ns1:jobAbbreviation>T_BZ</ns1:jobAbbreviation>
<ns1:costCentreCode xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:customerDescription xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:periodEndTimePosition xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:periodStartTimePosition xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:jobExternalReference xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:customerAbbreviation xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:costCentreExternalReference xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:calculationMode>0</ns1:calculationMode>
<ns1:applicationDate>2025-01-06</ns1:applicationDate>
<ns1:periodEndTime xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:periodStartTime xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:durationInHours>2.00</ns1:durationInHours>
<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 xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:employeeIdentificationNumber>00000015</ns1:employeeIdentificationNumber>
<ns1:technicalString xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:errorMessage>Tâche(s) introuvable</ns1:errorMessage>
</ns1:JobAssignment>
</ns1:jobAssignmentsInError>
</ns1:importJobAssignmentsResponse>
</soap:Body>
</soap:Envelope>
|
|
Deleting activities
Allows you to delete activity assignments from employees in Kelio.
Web Service: JobAssignmentService
Method: deleteJobAssignments
Mandatory data
Employee’s ID:
By identification number:
Or by badge:
Or by Surname/First name: and
Application date:
|
The terms in red are compulsory! For the terms in orange, you need to choose data from among that proposed.
|
|
Input data
Code
|
Description
|
Class type
|
applicationDate
|
Application date
|
date (format: yyyy-MM-dd)
|
archivedEmployee
|
Archived employee
|
boolean (false / true)
|
calculationMode
|
Calculation mode
|
int
Possible values:
0Completed
1Planned
2Estimated
3Estimated with absence requests |
costCentreAbbreviation
|
Cost centre abbreviation
|
string (max: 5)
|
costCentreCode
|
Cost centre code
|
string (max: 40)
|
costCentreDescription
|
Cost centre description
|
string (max: 40)
|
costCentreExternalReference
|
External cost centre reference
|
string (max: 40)
|
costCentreKey
|
Cost centre key
|
int
|
customerAbbreviation
|
Customer type abbreviation
|
string (max: 5)
|
customerCode
|
Customer type code
|
string (max: 40)
|
customerDescription
|
Customer description
|
string (max: 40)
|
customerExternalReference
|
External customer reference
|
string (max: 40)
|
customerKey
|
Customer key
|
int
|
durationInHours
|
Duration in hours
|
double
|
durationMode
|
Entry mode
|
int
Possible value:
0Duration
11st half-day
22nd half-day
3Day
4Period
5Percentage |
employeeBadgeCode
|
Employee's badge code
|
string (max: 16)
|
employeeFirstName
|
Employee’s first name
|
string (max: 24)
|
employeeIdentificationCode
|
Employee ID number code
|
string (max: 80)
|
employeeIdentificationNumber
|
Employee's ID number
|
string (max: 16)
|
employeeKey
|
Employee key
|
int
|
employeeSurname
|
Employee’s surname
|
string (max: 24)
|
errorMessage
|
Error message
|
String
|
geolocationPrecision
|
Geolocation precision
|
int
|
geolocationStatus
|
Geolocation status
|
Short
Possible value:
0Successful
1Failed
2Denied |
jobAbbreviation
|
Job abbreviation
|
string (max: 5)
|
jobAssignmentKey
|
Activity assignment key
|
int
|
jobCode
|
Job code
|
string (max: 40)
|
jobDescription
|
Job description
|
string (max: 40)
|
jobExternalReference
|
External job reference
|
string (max: 40)
|
jobKey
|
Job key
|
int
|
Latitude
|
Latitude
|
float
|
longitude
|
Longitude
|
float
|
note
|
Note
|
string (max: 500)
|
percentage
|
Percentage
|
double
|
periodEndTime
|
Period end time
|
time (format: HH:mm:ss)
|
periodEndTimePosition
|
Period end time position
|
int
Possible values:
-1 Before 0:00
0The same day
1After midnight |
periodStartTime
|
Period start time
|
time (format: HH:mm:ss)
|
periodStartTimePosition
|
Period start time position
|
int
Possible values:
-1 Before 0:00
0The same day
1After midnight |
quantity
|
Quantity
|
float
|
technicalString
|
Technical key
|
string
|
|
Output data
Code
|
Description
|
Class type
|
applicationDate
|
Application date
|
date (format: yyyy-MM-dd)
|
archivedEmployee
|
Archived employee
|
boolean (false / true)
|
calculationMode
|
Calculation mode
|
int
Possible values:
0Completed
1Planned
2Estimated
3Estimated with absence requests |
costCentreAbbreviation
|
Cost centre abbreviation
|
string (max: 5)
|
costCentreCode
|
Cost centre code
|
string (max: 40)
|
costCentreDescription
|
Cost centre description
|
string (max: 40)
|
costCentreExternalReference
|
External cost centre reference
|
string (max: 40)
|
costCentreKey
|
Cost centre key
|
int
|
customerAbbreviation
|
Customer type abbreviation
|
string (max: 5)
|
customerCode
|
Customer type code
|
string (max: 40)
|
customerDescription
|
Customer description
|
string (max: 40)
|
customerExternalReference
|
External customer reference
|
string (max: 40)
|
customerKey
|
Customer key
|
int
|
durationInHours
|
Duration in hours
|
double
|
durationMode
|
Entry mode
|
int
Possible value:
0Duration
11st half-day
22nd half-day
3Day
4Period
5Percentage |
employeeBadgeCode
|
Employee's badge code
|
string (max: 16)
|
employeeFirstName
|
Employee’s first name
|
string (max: 24)
|
employeeIdentificationCode
|
Employee ID number code
|
string (max: 80)
|
employeeIdentificationNumber
|
Employee's ID number
|
string (max: 16)
|
employeeKey
|
Employee key
|
int
|
employeeSurname
|
Employee’s surname
|
string (max: 24)
|
errorMessage
|
Error message
|
String
|
geolocationPrecision
|
Geolocation precision
|
int
|
geolocationStatus
|
Geolocation status
|
Short
Possible value:
0Successful
1Failed
2Denied |
jobAbbreviation
|
Job abbreviation
|
string (max: 5)
|
jobAssignmentKey
|
Activity assignment key
|
int
|
jobCode
|
Job code
|
string (max: 40)
|
jobDescription
|
Job description
|
string (max: 40)
|
jobExternalReference
|
External job reference
|
string (max: 40)
|
jobKey
|
Job key
|
int
|
latitude
|
Latitude
|
float
|
longitude
|
Longitude
|
float
|
note
|
Note
|
string (max: 500)
|
percentage
|
Percentage
|
double
|
periodEndTime
|
Period end time
|
time (format: HH:mm:ss)
|
periodEndTimePosition
|
Period end time position
|
int
Possible values:
-1 Before 0:00
0The same day
1After midnight |
periodStartTime
|
Period start time
|
time (format: HH:mm:ss)
|
periodStartTimePosition
|
Period start time position
|
int
Possible values:
-1 Before 0:00
0The same day
1After midnight |
quantity
|
Quantity
|
float
|
technicalString
|
Technical key
|
string
|
|
Example of a request
Code Sample
|
Copy Code
|
JobAssignmentService
|
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:deleteJobAssignments>
<ech:jobAssignmentsToDelete>
<ech:JobAssignment>
<ech:employeeIdentificationNumber>00000015</ech:employeeIdentificationNumber>
<ech:employeeIdentificationCode>A&P</ech:employeeIdentificationCode>
<ech:calculationMode>0</ech:calculationMode>
<ech:jobAbbreviation>T_B</ech:jobAbbreviation>
<ech:costCentreAbbreviation>ATLSB</ech:costCentreAbbreviation>
<ech:applicationDate>2025-01-06</ech:applicationDate>
</ech:JobAssignment>
</ech:jobAssignmentsToDelete>
</ech:deleteJobAssignments>
</soapenv:Body>
</soapenv:Envelope>
|
|
Response
If a request is made to delete data from Kelio:
•If there is no error, the Web Service returns an empty request with no elements.
•If there are errors when deleting data, the Web Service returns the elements in error and populates the field . The message returned corresponds to the description of the functional error encountered by the Web Service during the data deletion request.
Code Sample
|
Copy Code
|
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns1:deleteJobAssignmentsResponse xmlns:ns1="http://echange.service.open.bodet.com">
<ns1:jobAssignmentsInError>
<ns1:JobAssignment>
<ns1:jobAssignmentKey xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:durationMode xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:quantity xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:latitude xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:longitude xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:note xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:geolocationStatus xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:geolocationPrecision xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:customerKey xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:jobKey xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:customerCode xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:jobCode xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:customerExternalReference xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:percentage xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:costCentreDescription xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:jobDescription xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:costCentreKey xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:costCentreAbbreviation>ATLSB</ns1:costCentreAbbreviation>
<ns1:jobAbbreviation>T_Bz</ns1:jobAbbreviation>
<ns1:costCentreCode xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:customerDescription xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:periodEndTimePosition xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:periodStartTimePosition xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:jobExternalReference xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:customerAbbreviation xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:costCentreExternalReference xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:calculationMode>0</ns1:calculationMode>
<ns1:applicationDate>2025-01-06</ns1:applicationDate>
<ns1:periodEndTime xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:periodStartTime 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: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>A&P</ns1:employeeIdentificationCode>
<ns1:employeeIdentificationNumber>00000015</ns1:employeeIdentificationNumber>
<ns1:technicalString xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<ns1:errorMessage>Tâche(s) introuvable</ns1:errorMessage>
</ns1:JobAssignment>
</ns1:jobAssignmentsInError>
</ns1:deleteJobAssignmentsResponse>
</soap:Body>
</soap:Envelope>
|
|
Filter on the periods of data to be extracted