CRA - Compte rendu d'anomalies
Scénario
L'entité relevant une anomalie, généralement le prestataire de maintenance, va transmettre une anomalie sur intentPlatform en utilisant le workflow d'une réserve.
L'entité ayant la responsabilité de traiter cette anomalie, généralement le gestionnaire immobilier, pourra être notifiée par mail et webhooks.
Une fois l'anomalie traitée, le gestionnaire pourra venir la clôturer.
Une notification mail et webhook pourra être transmise au prestataire afin qu'il soit notifié de la levée de l'anomalie et qu'il puisse mettre à jour son état dans son outil. Le prestataire pourra également récupérer les mises à jour par un polling sur l'API.
violet = prestataire
bleu = gestionnaire
Spécification d'envoi des données
API à utiliser
- API Operations v2
- objet "reservation"
Création de l'anomalie
{"reference": "Anomalie_001","description": "Anomalie sur le flexible de gaz identifié dans la salle à manger","contractReference": "contract1","status": "open","event": "requested","eventDate": "2020-09-25T17:00:00","logDate": "2020-09-25T17:00:00","serviceCode": "DGI-1","location": {"assetReference": "LOGEMENT_005"},"parentReference": "inter_005_CRA","workType": "corrective","contacts": ["BEGIN:VCARD\n\nVERSION:3\r\nFN;CHARSET=UTF-8:Pierre DUPONT\r\nN;CHARSET=UTF-8:DUPONT ;Pierre\r\nTEL;TYPE=WORK,VOICE:0734220902\r\nTEL;TYPE=HOME,VOICE:0685874445\r\nADR;TYPE=WORK:165 Avenue de Bretagne;59000;LILLE;France\r\nROLE;CHARSET=UTF-8:Technicien\r\nEMAIL;CHARSET=UTF-8;TYPE=WORK,INTERNET:p.dupont@internet.fr\r\nEND:VCARD"],"origin": "sp","warning": true,"criticalLevel": 3}
L'anomalie est liée à l'intervention durant laquelle elle a été identifiée par le champ
parentReference.Mise à jour de l'anomalie
Ajout d'un complément d'information dans la description + changement de la criticité de 3 ⟶ 5
{"reference": "Anomalie_001","description": "Anomalie sur le flexible de gaz identifié dans la salle à manger + flexible usé","contractReference": "contract1","status": "open","event": "updated","eventDate": "2020-09-24T14:00:00","logDate": "2020-09-24T14:00:00","serviceCode": "DGI-1","location": {"assetReference": "LOGEMENT_005",},"parentReference": "inter_005_CRA","workType": "corrective","contacts": ["BEGIN:VCARD\n\nVERSION:3\r\nFN;CHARSET=UTF-8:Pierre DUPONT\r\nN;CHARSET=UTF-8:DUPONT ;Pierre\r\nTEL;TYPE=WORK,VOICE:0734220902\r\nTEL;TYPE=HOME,VOICE:0685874445\r\nADR;TYPE=WORK:165 Avenue de Bretagne;59000;LILLE;France\r\nROLE;CHARSET=UTF-8:Technicien\r\nEMAIL;CHARSET=UTF-8;TYPE=WORK,INTERNET:p.dupont@internet.fr\r\nEND:VCARD"],"origin": "sp","warning": true,"criticalLevel": 5}
Clôture de l'anomalie
La clôture de l'anomalie sera faite par le gestionnaire immobilier directement sur les interfaces web et mobile d'intentPlatform ou bien par API.
Récupération de la clôture par le prestataire
intentPlatform offre 2 possibilités au prestataire pour récupérer les actions de mises à jour et clôture faites par le gestionnaire :
- webhook
- polling
- notification mail
Webhook
Si le prestataire souhaite récupérer l'information lorsque l'anomalie est mise à jour ou clôturée par le gestionnaire, il peut paramétrer la réception d'un webhook lors de la mise à jour de l'état d'une réserve.
Le prestataire recevra un webhook lui indiquant directement la requête api à effectuer (champ
operation_url) pour récupérer la mise à jour de la réserve.Polling
Le prestataire peut réaliser un polling régulier sur l'API operations afin de récupérer les mises à jour et clôture des réserves. La requête à utiliser est la suivante :
GET
/api/operations/v2/operations?type=reservation&fields=logs&since=2021-12-09T00:00:00
Les paramètres de la requête
- type = reservation, pour ne récupérer que les objets de type réserve
- since = Date, pour récupérer toutes les nouveautés depuis la date indiquée
- fields = logs, pour récupérer toutes les étapes de la réserve
Notifications mail
Le prestataire peut paramétrer la réception d'un mail lors de la mise à jour et clôture de la réserve par le gestionnaire.
Rendu visuel intentPlatform
