Préventif
Une intervention préventive est caractérisée par le champ workType = preventive.
Diagramme de séquence
.1planification (OPEN/PLANNED) : événement de planification initiale du ticket.
.2début de l'intervention (pending/start) : date et heure de début de l'intervention de l'opérateur
.3fin de l’intervention (pending/end) : date et heure de fin d'intervention de l’opérateur.
.4clôture “normale”(closed/done) : compte rendu d’intervention détaillant les opérations effectuées
A : problématiques d’accès : scénarios dérivés pour cause de problèmes d’accès ou d’impossibilité d’intervenir (hold).
B : problématiques d’intervention : scénarios dérivés pour cause de problèmes après première intervention (réparation partielle, problème de sécurité, de salubrité, etc.) (hold).
C : clôture pour refus ou impossibilité : fermeture de l’intervention suite à une impossibilité d’intervenir ou un refus d’intervention de la part du partenaire (closed).
Planification macro / Date anniversaire / Date limite de prestation préventive
Il vous est également possible de transmettre en 1er log, la planification macro de l'intervention ou sa date limite contractuelle pour intervenir. Ce log se matérialise par un status = open et un event = due.
Par exemple, nous sommes le 10 janvier et vous devez réaliser l'intervention préventive du logement 12 durant cette année. Vous pouvez transmettre un log "open/due" avec une eventDate = 2021-12-31 pour indiquer que vous devez faire l'intervention préventive avant le 31 décembre 2021.
Autre exemple, nous sommes le 10 janvier et vous réaliser votre planning macro d'intervention préventive. Vous prévoyez d'intervenir dans le logement durant le mois de Juin. Vous pouvez transmettre un log "open/due" avec une eventDate = 2021-06-31 pour indiquer que vous passerez faire l'intervention préventive durant la mois de Juin.
Transmission des données
Planification d’une intervention préventive
{"reference": "VE-1234","description": "Visite préventive annuelle de l'extincteur","contractReference": "contract1","status": "open","event": "planned","eventDate": "2020-03-12T09:00:00","logDate": "2020-01-03T14:34:21","serviceCode": "va-ext","location": {"assetReference": "EXT_001"},"workType": "preventive"}
Début de l'intervention
{"reference": "VE-123","contractReference": "contract1","status": "pending","event": "start","eventDate": "2020-02-12T09:02:00","logDate": "2020-02-12T09:05:00","serviceCode": "102CTA","location": {"assetReference": "LOGEMENT_001",},"workType": "preventive"}
Fin de l'intervention
{"reference": "VE-1234","contractReference": "contract1","status": "pending","event": "end","eventDate": "2020-03-12T09:40:00","logDate": "2020-03-12T09:41:00","serviceCode": "va-ext","location": {"assetReference": "EXT_001"},"workType": "preventive"}
Clôture de l'intervention
{"reference": "VE-1234","description": "Entretien annuel de l'extincteur effectué - RAS","contractReference": "contract1","status": "closed","event": "done","eventDate": "2020-03-12T09:45:00","logDate": "2020-03-12T09:46:00","serviceCode": "va-ext","location": {"assetReference": "EXT_001"},"workType": "preventive","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:Locataire\r\nEMAIL;CHARSET=UTF-8;TYPE=WORK,INTERNET:p.dupont@internet.fr\r\nEND:VCARD"],"visitAttempt": 1,"equipmentStatus": "ok","equipmentWorkingOrder": "operational","occupantSignature": "na"}
Publication d’un document
curl -X POST " https://apisandbox.hubintent.com/api/documents/v1/documents " -H "accept: application/json" -H "Content-Type: multipart/form-data" -F "file=@quitus1.pdf;type=application/pdf" -F "title=quitus d'intervention" -F "elementType=intervention" -F "elementReference=VE-1234" -F "description=Quitus" -F "intent_contractReference=contract1"
Rendu visuel