Le présent document explique les scénarios de raccordement aux APIs d’intentPlatform sur le périmètre des interventions.
Avant de se lancer
Pour bien comprendre et utiliser ce document, il est important d’avoir compris le fonctionnement des API d’intentPlatform. L’utilisation de ce document intervient une fois avoir lu et compris la documentation en ligne.
Informations à transmettre à Intent lors mon 1er raccordement
Etablir les schémas de process des scénarios d’intervention
indiquer l'enchaînement des statuts pour une intervention optimale, une réparation partielle, une annulation, etc.
Réaliser un mapping des champs de mon SI avec les champs de l’API d’Intent.
Réaliser un mapping des évènements des interventions présents dans mon SI avec les possibilités offertes par l’API d’Intent.
Patrimoine
Je dois être en capacité de gérer une correspondance des références patrimoine de mon client. Les gestionnaires immobiliers maîtrisent de plus en plus leur propre référentiel de patrimoine (bâtiments, équipements). Le gestionnaire immobilier attend que vos données soient publiées sur son référentiel de patrimoine portant ses références.
Prestation de service
Des prestations de service (serviceCode) peuvent être définies, permettant l’identification de la prestation réalisée lors de l'intervention. Les prestations de services sont associées au contrat. Des SLA (Convention de Niveau de Service) peuvent être définis pour chaque type de prestation, afin de modéliser les engagements pris par le partenaire.
Afin de garantir un connecteur générique avec intentPlatform pour l’ensemble de ses clients, le prestataire doit transmettre ses propres codes de prestations (serviceCode).
intentPlatform met à disposition un mécanisme de mapping et de regroupement des codes de prestation afin que le gestionnaire puisse rassembler les codes de prestation de son prestataire parmi son catalogue.
La liste des codes de prestations doit être une liste fixe qui sera utilisée chez tous les clients.
Lors de la phase de cadrage du développement, il est important que le prestataire dialogue avec son client gestionnaire pour s’assurer que les codes de prestations transmis vont permettre un regroupement par le gestionnaire.
intentPlatform vous propose 2 méthodes pour automatiser la transmission vos interventions sur la plateforme :
API
FTP
Il vous est également possible de réaliser certaines actions (planification, compte rendu, annulation) directement les interfaces web et mobile d’intentPlatform.