Diagnostics

Une intervention de diagnostic est caractérisée par le champ workType = diagnosis.
Le scénario détaillé ci-dessous concerne un dépannage où vous recevez en direct la demande d'intervention :
- via votre centre d'appel
- via votre extranet
- par mail

Le scénario où vous recevez la demande d'intervention par intentPlatform est décrit dans un autre document :  ⁠⁠Demande d'intervention⁠ 

Diagramme de séquence


https://slite.com/api/files/WfcoohQtoFrBYI/diagrammes%20de%20se%CC%81quence%20interventions%20(1).jpg?apiToken=eyJhbGciOiJIUzI1NiIsImtpZCI6IjIwMjMtMDUtMDQifQ.eyJzY29wZSI6Im5vdGUtZXhwb3J0IiwibmlkIjoiWTFGUnVscWpoT3dMZGYiLCJpYXQiOjE3MjkwOTIyMjAsImlzcyI6Imh0dHBzOi8vc2xpdGUuY29tIiwianRpIjoiWklVN1hYUjN5aVloZTQiLCJleHAiOjE3MzE2ODQyMjB9.1rZtPA7xtEpFOYe9ISrPilgTnzCFSfeJ5lJe68dkRPU
    .1ouverture de la demande (open/acknowledged) : correspond à la matérialisation de l’appel reçu, événement initial du ticket et communication aux autres parties.
    .2planification (open/planned) : événement de planification initiale du ticket
    .3début de l'intervention (pending/start) : date et heure de début de l'intervention de l'opérateur
    .4fin de l’intervention (pending/end) : date et heure de fin d'intervention de l’opérateur.
    .5clô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).

L’intégralité des logs d’intervention seront publiés par le prestataire qui prend en charge la demande d’intervention et réalise l’intervention.

Transmission des données

Réception d'une réclamation par le prestataire

POST  https://apisandbox.hubintent.com/api/operations/v2/interventions/logs 
{
  "reference": "INTER-0506",
  "description": "Demande de diagnostics amiante",
  "contractReference": "contract1",
  "status": "open",
  "event": "acknowledged",
  "eventDate": "2020-03-06T10:45:23",
  "logDate": "2020-03-06T10:45:26",
  "serviceCode": "diagnostic_amiante",
  "location": {
    "assetReference": "LOGEMENT_002"
  },
  "workType": "diagnosis",
  "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"
  ],
  "criticalLevel": 3,
  "visitAttempt": 1,
  "equipmentWorkingOrder": "not_operational"
}


Planification de l'intervention

POST  https://apisandbox.hubintent.com/api/operations/v2/interventions/logs 

{
  "reference": "INTER-0506",
  "description": "planification de l’intervention de diagnostics amiante",
  "contractReference": "contract1",
  "status": "open",
  "event": "planned",
  "eventDate": "2020-03-06T14:00:00",
  "logDate": "2020-03-06T10:47:26",
  "serviceCode": "diagnostic_amiante",
  "location": {
    "assetReference": "LOGEMENT_002"
  },
  "workType": "diagnosis",
  "criticalLevel": 3,
  "visitAttempt": 1,
  "equipmentWorkingOrder": "not_operational"
}


Début de l'intervention

POST  https://apisandbox.hubintent.com/api/operations/v2/interventions/logs 
{
  "reference": "INTER-0506",
  "description": "Début de l’intervention par le technicien",
  "contractReference": "contract1",
  "status": "pending",
  "event": "start",
  "eventDate": "2020-03-06T14:10:00",
  "logDate": "2020-03-06T14:10:21",
  "serviceCode": "diagnostic_amiante",
  "location": {
    "assetReference": "LOGEMENT_002"
  },
  "workType": "diagnosis",
  "criticalLevel": 3,
  "visitAttempt": 1,
  "equipmentWorkingOrder": "not_operational"
}


Fin de l'intervention

POST  https://apisandbox.hubintent.com/api/operations/v2/interventions/logs 
{
  "reference": "INTER-0506",
  "description": "Fin d'intervention",
  "contractReference": "contract1",
  "status": "pending",
  "event": "end",
  "eventDate": "2020-03-06T15:30:00",
  "logDate": "2020-03-06T15:32:21",
  "serviceCode": "diagnostic_amiante",
  "location": {
    "assetReference": "LOGEMENT_002"
    },
  "workType": "diagnosis",
  "criticalLevel": 3,
  "visitAttempt": 1,
  "equipmentWorkingOrder": "operational"
}

Clôture de l'intervention

POST  https://apisandbox.hubintent.com/api/operations/v2/interventions/logs 
{
  "reference": "INTER-0506",
  "description": "Diagnostic réalisé",
  "contractReference": "contract1",
  "status": "closed",
  "event": "done",
  "eventDate": "2020-03-06T15:35:00",
  "logDate": "2020-03-06T15:35:26",
  "serviceCode": "diagnostic_amiante",
  "location": {
    "assetReference": "LOGEMENT_002"
  },
  "workType": "diagnosis",
  "criticalLevel": 3,
  "visitAttempt": 1,
  "equipmentWorkingOrder": "operational",
  "equipmentStatus": "ok",
  "occupantSignature": "ok"
}

Publication d’un document

POST  https://apisandbox.hubintent.com/api/documents/v1/documents 

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"

Plus d’informations :  ⁠⁠Document sur une opération⁠