Que peut-on faire avec le web service ?

07Déc, 2020

0Réaction(s)

Kizeo Forms, une application connectable.

Kizeo Forms n’est pas une application fermée. On  entend par là, que vous avez la possibilité de l’ouvrir à d’autres logiciels métiers déjà en votre possession.

Comment ? En utilisant notre Web Service.

En effet, Kizeo Forms étant une application de remontée d’informations terrain,  il est souvent nécessaire de partager ces données avec d’autres systèmes d’information.

Afin de vous faciliter le développement, nous mettons à votre disposition un Swagger pour vous permettre de tester les réponses. Vous trouverez l’aide sur l’utilisation de chacune des requêtes citées dans ce tutoriel.

Voici quelques exemples de ce que vous pourriez réaliser.

1 – Puis-je mettre à jour automatiquement mes listes externes ?

Oui, il est possible de faire en sorte que votre liste externe soit mise à jour en fonction des saisies sur un ou des formulaires. Vous avez par exemple un formulaire dans lequel vous saisissez les informations des nouveaux clients, cette fonctionnalité vous permettra d’implémenter automatiquement votre liste externe. Pour réaliser cela, voici la méthode à suivre :

1. Appelez la requête https://www.kizeoforms.com/rest/v3/lists/:listId. Vous récupérez la définition de la liste que vous souhaitez mettre à jour.
2. Appelez la requête https://www.kizeoforms.com/rest/v3/forms/:formId/data/unread/test/100?includeupdated. Vous récupérez ainsi toutes les informations des données qui ont été saisies ou modifiées sur le formulaire :formId depuis le dernier appel de la fonction. 
3. Modifiez le json de votre liste externe.
4. Exécutez la requête https://www.kizeoforms.com/rest/v3/lists/:listId en passant dans le body, votre fichier json.
5. Votre liste externe est désormais à jour.

Attention : Chaque mise à jour d’une liste externe écrase la précédente définition. Il est donc impératif de renvoyer la liste complète et pas uniquement les ajouts ou modifications. Cela nécessite aussi que les utilisateurs les rechargent sur leurs mobiles. Selon la taille, le temps peut être plus ou moins long. C’est pour cette raison que nous préconisons d’espacer les mises à jour au maximum. Par exemple 1 à 2 fois par jour.

2 – Puis-je gérer mes stocks ?

Oui vous pouvez gérer vos stocks. La méthode est identique à l’exemple précédent.

3 – Puis-je synchroniser mon ERP / CRM avec Kizeo Forms ?

Il est possible de mettre en place une synchronisation entre votre application métier et Kizeo Forms. Cela vous permettrait, par exemple, de maintenir à jour vos informations commerciales (nom de la société, adresse, CA, interlocuteurs, …) dans une liste externe référentielle. Pour que cela soit réalisable, il faut que votre logiciel possède une API afin de pouvoir réaliser une connexion avec Kizeo Forms.

Il est également possible de réaliser des envois automatiques de planning d’intervention. Je prendrai pour exemple une société de dépannages multiservice qui reçoit toute la journée des demandes d’intervention. Les rendez-vous sont saisis dans l’ERP. Le soir, une « moulinette » est exécutée qui génère et réalise, en automatique, l’ensemble des Push. Ainsi le lendemain matin chaque technicien sur le terrain, à son planning d’intervention dans son mobile/tablette.

4 – Je possède un grand nombre d’utilisateurs et les équipes changent souvent. Est-il possible de pouvoir gérer cela plus rapidement que par l’interface ?

Bien sûr. Le WebService vous permet de faire de la création/modification en masse d’utilisateurs et de groupes. Nous allons prendre l’exemple du démarrage d’un nouveau chantier. Voici les requêtes que vous pouvez utiliser :

1. https://www.kizeoforms.com/rest/v3/group pour créer votre groupe correspondant au chantier.
2. https://www.kizeoforms.com/rest/v3/group/{groupId}/users pour ajouter l’ensemble des utilisateurs
3. https://www.kizeoforms.com/rest/v3/group/{groupId}/leaders pour ajouter les chefs de groupe

Il est également possible d’ajouter ou enlever des utilisateurs et des chefs de groupe, avec les requêtes suivantes :

• https://www.kizeoforms.com/rest/v3/group/{groupId}/user/{userId} en POST pour ajouter, en DELETE pour la suppression.
• https://www.kizeoforms.com/rest/v3/group/{groupId}/leader/{leaderId} en POST pour ajouter, en DELETE pour la suppression.

Nous avons vu dans cet article, une infime partie des possibilités qu’offre le Web Services Kizeo Forms.

N’hésitez pas à contacter le service support par mail à support@kizeo.com ou par téléphone au 04.90.23.67.74