L’intégralité du déroulé d’une intervention sera transmis sur un unique objet intervention, peu importe le nombre de passages réalisés. Un nouvel objet intervention ne sera donc pas créé à chaque passage.
En revanche si une intervention combine deux prestations (par exemple préventif, curatif) il faudra créer deux objets intervention pour le bon fonctionnement des différents rapports et indicateurs.
Lorsque le prestataire récupère une demande d’intervention depuis intentPlatform, il utilisera la référence du demandeur pour publier l’intégralité des étapes du traitement de la demande.
Statuts d’une intervention
IntentPlatform propose une logique événementielle avec des dates qui sont contextualisées en fonction des événements.
Tous les statuts disponibles sur intentPlatform d’une intervention sont détaillés dans notre documentation en ligne.
Dates
Le champ eventDate sera contextualisé en fonction du couple status/event que vous transmettrez.
Les scénarios dérivés
Les scénarios dérivés sont l’ensemble des scénarios représentant un déroulement d’intervention en dehors du cadre optimal.
Les scénarios dérivés sont à ranger dans plusieurs catégories :
les interventions “interrompues” : dans ce cas, la raison de l’interruption est à placer dans l’événement lié à un statut “HOLD”. Suite à ce statut, on peut avoir une nouvelle planification, un nouveau déplacement, ou une fermeture. Dans tous les cas, le statut “hold” n’est pas un statut final et ne correspond qu’à un blocage momentané du déroulement de l’intervention.
les interventions stoppées : dans ce cas, la raison de l’arrêt ou du refus est à placer dans l’événement associé à un statut “DENIED”. Comme le statut “CLOSED”, le DENIED est un statut final. Une fois que l’intervention est stoppée, elle ne peut plus faire l’objet de nouvel événement.
les passages multiples : dans le cadre d’une intervention, il est possible de devoir effectuer plusieurs passages. Dans ce cadre, on ajoutera, dans le même ticket, de nouveaux logs :
replanification (OPEN/PLANNED) - optionnelle
début d’intervention (PENDING/START)
fin d’intervention (PENDING/END)
Intervention pendant laquelle plusieurs prestations sont réalisées : dans ce cas, il faudra clôturer la première intervention et créer une deuxième intervention avec un code de prestation correspondant à la deuxième prestation réalisée. Note : dans le cas d’une intervention avec plusieurs déplacements, on pourra placer le compte rendu de chaque intervention comme commentaire de l’événement “PENDING/END” ou “HOLD/…” plutôt qu’attendre le compte rendu d’intervention dans l’événement CLOSED/DONE.
Si une intervention est supprimée dans votre outil, vous devez transmettre un log d'annulation sur intentPlatform (denied / cancelled)
Commentaires sur une intervention
Vous pouvez commenter une intervention par API tant qu'elle n'est pas clôturée.
Pour cela il faut utiliser l'event "commented" associé au statut en cours de l'intervention (open/pending ou hold)
Documents
intentPlatform offre la possibilité aux utilisateurs de partager tous types de documents à n’importe quelle étape d’une intervention (création, planification, mise en attente, clôture, etc.).
La transmission de documents s’effectue par l’utilisation d’une API dédiée : API Documents.
La transmission des photos liées à une intervention se réalise avec l’API Operations. Les photos sont incluses dans les logs postées pour une intervention.
La transmission des photos via l’API Operations se réalise en utilisant, dans le Header de la requête, un "Content-Type: multipart/form-data"
Si vous êtes amené à transmettre des photos, nous vous recommandons de transmettre tous vos logs d’intervention avec un Header ; “Content-Type: multipart/form-data”
En résumé :
.1Je transmets des photos avec toutes ou certaines de mes interventions → j’effectue tous mes envois en Form-Data
.2Je ne transmets jamais de photos avec mes interventions → J’ai le choix entre effectuer tous mes envois en Json ou en Form-Data
.3A l’avenir, je peux être amené à transmettre des photos avec mes interventions → J’anticipe l’avenir et j’effectue tous mes envois en Form-Data