This site is designed for people with a basic understanding of programming.
Its goal is to help you implement Kelio Web Services developed by Kelio.
What is a Web Service?
Pre-requisites
Kelio provides you with APIs (Web services) enabling you to exchange data between applications. Using Web Services requires functional knowledge of the Kelio application. If you do not have this knowledge, you should contact the Kelio application manager. They will be able to check the elements extracted or integrated. They will also be able to provide you with the configuration you need to build your queries.
The client or their service provider must be able to program "SOAP" type Web Services.
Limits of use
In the event of misuse, Kelio reserves the right to cut off access to the Web Services. The concept of misuse of APIs is assessed by Kelio according to the frequency of use and the volume of data exchanged, and their impact on the performance of the solution. Kelio reserves the right, at any time and without prior notice, to set limits on the number of calls per minute per API group.
SaaS availability
|
There is a 5-minute timeout for calls to Web Services. They are prohibited in certain slots for our clients, depending on each hosting time zone:
Hosting time zones: •Europe zone (Blue/Celeste/VTX): GMT+1 Europe •West Indies zone (Exodata): GMT-4 •Reunion/South Africa zone (Exodata): GMT+4 |
Limits on filtering access to employee data by population
In Kelio, the Administrator - Data Exchange profile (use of the data exchange module and use of Web Services) is assigned to a population of employees. This population restricts access to the data of employees authorised for this user. This operating mode is used for the data exchange module. However, when using Web Services, this filtering is not applied. A user can therefore access all employees via Web Services. Our design section is currently investigating the possibility of integrating this filtering.
Batch processing
For reading large volumes of data, it is preferable to split the request into several requests (batch processing). To carry out this batch processing, you can use the method exportLightEmployeesList of the Web Service LightEmployeeService (simplified employee). It will enable you to obtain the identifiers of Kelio employees with a restricted set of data. You can then create queries for batches of employees using the employee X identifiers on the Web Service corresponding to the data you want to use (for example: the first 100 employees, then the next 100, etc.).
|
We do not recommend the use of data import Web Services (in particular the creation/update of employee records), which are likely to cause irreversible damage to data integrity. We will not be able to provide assistance in this case! |
Assistance
Kelio provides a Web Services library, but is not able to provide assistance for the electronic developments made by its clients or their service providers. The provision of Web Services by the Kelio company does not imply that Kelio will provide the customer with assistance on using the Web Services or development.
An optional consulting service for using the Web Services may be offered by Kelio. This service will enable answers to be provided to functional questions and will provide advice on using Web Services according to the customer's requirements. In this case, the client must provide Kelio with a set of specifications for the different exchanges to be put in place with a file on the data to be exchanged (flow diagram). Depending on the complexity of the exchanges and the level of advice to be provided, Kelio will draft a proposal to provide consulting time adapted to the customer's requirements. This service is limited to functional advice on the use of Web Services and is in no way intended as programming assistance in the language and tools chosen by the client.
Web Service evolution
The Kelio company reserves the right to upgrade the Web Services with each change of software version. These evolutions are used to respond to the functional progress related to the version. These evolutions may be translated into WSDL modifications, the addition of new methods to existing services or even the addition of new Web Services. The Kelio company will not guarantee compatibility with applications developed by third parties.
