Traitement de la demande d'intervention

Traitement de la demande d'intervention

Spécifications d'envoi des données

Création de la demande d’intervention par le gestionnaire

{
  "reference": "contract1_201007151812",
  "description": "Demande dépannage pour fuite d’eau dans la salle de bain",
  "contractReference": "contract1",
  "status": "open",
  "event": "requested",
  "eventDate": "2020-10-07T15:18:00",
  "logDate": "2020-10-07T15:18:00",
  "serviceCode": "EAU-CP-9",
  "location": {
    "assetReference": "LOGEMENT_011"
  },
  "workType": "corrective",
  "contacts": [
"BEGIN:VCARD\r\nVERSION:3\r\nFN;CHARSET=UTF-8:Pierre DURAND\r\nN;CHARSET=UTF-8:DURAND;Pierre;;;\r\nEMAIL;CHARSET=UTF-8;HOME;INTERNET:serviceclient+gestionnaire@intent.tech\r\nTEL;TYPE=WORK,VOICE:0786220276\r\nREV:2020-10-07T15:18:12+02:00\r\nEND:VCARD"
  ],
  "equipmentWorkingOrder": "not_operational",
  "criticalLevel": 3
}


Réception du webhook

En tant que prestataire je reçois le webhook suivant :
[
  {
    "type": "operations:intervention:share",
    "id": "471b155d-09ac-4ec6-a83a-70b3b8695738",
    "event": {
      "type": "operations",
      "body": {
        "id": "6ca801bb-cae3-43a6-978a-a18216f1f7a8",
        "reference": "contract1_201007151812",
        "contractReference": "contract1",
        "type": "intervention",
        "description": "Demande dépannage pour fuite d’eau dans la salle de bain",
        "status": "open",
        "event": "requested",
        "serviceCode": "EAU-CP-9",
        "workType": "corrective",
        "criticalLevel": "3",
        "issuer": {
          "entity": {
            "id": "5e78774dfb9f7e3faec804ec",
            "label": "Gestionnaire"
          },
          "user": {
            "id": "371c6829-2b25-40d7-8d2d-8238537ca146",
            "name": "serviceclient+gestionnaire@intent.tech"
          }
        },
        "operation_url": "https://apisandbox.hubintent.com/api/operations/v2/operations/contract1_201007151812?contractReference=contract1"
      }
    }
  }
]

Lancement des actions suivantes :
  • Appel API sur le champ operation_url : GET /operations/{reference}
  • Appel API pour récupérer les photos
  • Appel API pour récupérer les documents

JSON récupéré suite à l'appel sur le champ operation_url
{
    "_links": {
        "self": {
            "href": "https://apisandbox.hubintent.com/api/operations/v2/operations/contract1_201007151813?contractReference=contract1"
        },
        "documents:list": {
            "href": "https://apisandbox.hubintent.com/api/documents/v1/documents?elementType=intervention&elementReference=contract1_201007151813"
        }
    },
    "reference": "contract1_2010071518132",
    "description": "Demande dépannage pour fuite d’eau dans la salle de bain",
    "criticalLevel": 3,
    "issuer": {
        "entity": {
            "id": "5e78774dfb9f7e3faec804ec",
            "label": "Gestionnaire",
            "logoUrl": "https://image.freepik.com/vecteurs-libre/modele-ligne-logo-abstrait-colore-simple-immobilier_143546-15.jpg"
        },
        "user": {
            "id": "aab631d7-d7cf-478f-b463-55e646762946",
            "type": "client",
            "name": "Connecteur Gestionnaire"
        }
    },
    "contract": {
        "reference": "contract1",
        "label": "Maintenance Multitechnique",
        "topic": "Multitechnique",
        "entities": [
            {
                "id": "5e7875e3fb9f7e3faec804eb",
                "label": "MyPrestataire",
                "logoUrl": "https://image.freepik.com/vecteurs-libre/conception-reparation_24908-54569.jpg"
            },
            {
                "id": "5e78774dfb9f7e3faec804ec",
                "label": "Gestionnaire",
                "logoUrl": "https://image.freepik.com/vecteurs-libre/modele-ligne-logo-abstrait-colore-simple-immobilier_143546-15.jpg"
            }
        ]
    },
    "type": "intervention",
    "service": {
        "code": "EAU-CP-9",
        "originalCode": "EAU-CP-9"
    },
    "workType": "corrective",
    "status": "open",
    "event": "requested",
    "eventDate": "2020-10-07T15:18:00+02:00",
    "logDate": "2020-10-07T15:18:00+02:00",
    "eventHistory": [
        "requested"
    ],
    "location": {
        "assetReference": "LOGEMENT_011"
    },
    "contacts": [
        "BEGIN:VCARD\r\nVERSION:3\r\nFN;CHARSET=UTF-8:Pierre DURAND\r\nN;CHARSET=UTF-8:DURAND;Pierre;;;\r\nEMAIL;CHARSET=UTF-8;HOME;INTERNET:serviceclient+gestionnaire@intent.tech\r\nTEL;TYPE=WORK,VOICE:0786220276\r\nREV:2020-10-07T15:18:12+02:00\r\nEND:VCARD"
    ],
    "logs": [
        {
            "issuer": {
                "entity": {
                    "id": "5e78774dfb9f7e3faec804ec",
                    "label": "Gestionnaire",
                    "logoUrl": "https://image.freepik.com/vecteurs-libre/modele-ligne-logo-abstrait-colore-simple-immobilier_143546-15.jpg"
                },
                "user": {
                    "id": "aab631d7-d7cf-478f-b463-55e646762946",
                    "type": "client",
                    "name": "Connecteur Gestionnaire"
                }
            },
            "reference": "contract1_2010071518132",
            "description": "Demande dépannage pour fuite d’eau dans la salle de bain",
            "contractReference": "contract1",
            "contacts": [
                "BEGIN:VCARD\r\nVERSION:3\r\nFN;CHARSET=UTF-8:Pierre DURAND\r\nN;CHARSET=UTF-8:DURAND;Pierre;;;\r\nEMAIL;CHARSET=UTF-8;HOME;INTERNET:serviceclient+gestionnaire@intent.tech\r\nTEL;TYPE=WORK,VOICE:0786220276\r\nREV:2020-10-07T15:18:12+02:00\r\nEND:VCARD"
            ],
            "creationDate": "2020-10-28T18:11:18+01:00",
            "type": "intervention",
            "serviceCode": "EAU-CP-9",
            "workType": "corrective",
            "status": "open",
            "event": "requested",
            "eventDate": "2020-10-07T15:18:00+02:00",
            "logDate": "2020-10-07T15:18:00+02:00",
            "location": {
                "assetReference": "LOGEMENT_011",
                "assetOwner": "gestionnaire.intent"
            },
            "equipmentWorkingOrder": "not_operational",
            "criticalLevel": 3
        }
    ],
    "creationDate": "2020-10-28T18:11:18+01:00",
    "lastUpdateDate": "2020-10-28T18:11:18+01:00"
}

Accusé de réception de la demande d’intervention par le prestataire

{
  "reference": "contract1_201007151812",
  "description": "Nous accusons bonne réception de votre demande de dépannage",
  "contractReference": "contract1",
  "status": "open",
  "event": "acknowledged",
  "eventDate": "2020-10-07T15:19:00",
  "logDate": "2020-10-07T15:19:00",
  "serviceCode": "EAU-CP-9",
  "location": {
    "assetReference": "LOGEMENT_011"
  },
  "workType": "corrective",
  "equipmentWorkingOrder": "not_operational",
  "criticalLevel": 3,
  "visitAttempt": 1
}


Planification de l’intervention par le prestataire

{
  "reference": "contract1_201007151812",
  "description": "Planification de l'intervention au 08/10/2020 - 9h",
  "contractReference": "contract1",
  "status": "open",
  "event": "planned",
  "eventDate": "2020-10-08T09:00:00",
  "logDate": "2020-10-07T15:21:00",
  "serviceCode": "EAU-CP-9",
  "location": {
    "assetReference": "LOGEMENT_011"
  },
  "workType": "corrective",
  "equipmentWorkingOrder": "not_operational",
  "criticalLevel": 3,
  "visitAttempt": 1
}


Réalisation de l’intervention par le prestataire

{
  "reference": "contract1_201007151812",
  "contractReference": "contract1",
  "status": "pending",
  "event": "start",
  "eventDate": "2020-10-08T09:10:00",
  "logDate": "2020-10-08T09:10:00",
  "serviceCode": "EAU-CP-9",
  "location": {
    "assetReference": "LOGEMENT_011"
  },
  "workType": "corrective",
  "equipmentWorkingOrder": "not_operational",
  "criticalLevel": 3,
  "visitAttempt": 1
}

… puis … 

{
  "reference": "contract1_201007151812",
  "contractReference": "contract1",
  "status": "pending",
  "event": "end",
  "eventDate": "2020-10-08T09:50:00",
  "logDate": "2020-10-08T09:50:00",
  "serviceCode": "EAU-CP-9",
  "location": {
    "assetReference": "LOGEMENT_011"
  },
  "workType": "corrective",
  "equipmentWorkingOrder": "operational",
  "criticalLevel": 3,
  "visitAttempt": 1
}


Clôture de l’intervention par le prestataire

{
  "reference": "contract1_201007151812",
  "description":"Résolution du problème. Changement du flexible + joints",
  "contractReference": "contract1",
  "status": "closed",
  "event": "done",
  "eventDate": "2020-10-08T09:55:00",
  "logDate": "2020-10-08T09:55:00",
  "serviceCode": "EAU-CP-9",
  "location": {
    "assetReference": "LOGEMENT_011"
  },
  "workType": "corrective",
  "equipmentWorkingOrder": "operational",
  "criticalLevel": 3,
  "visitAttempt": 1,
  "equipmentStatus": "ok",
  "occupantSignature": "ok"
}

Publication d’un document par le prestataire

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 robinetterie" -F "elementType=intervention" -F "elementReference=contract1_201007151812" -F "description=Quitus" -F "intent_contractReference=contract1"

Plus d’informations : Notice raccordement Documents

Rendu visuel intentPlatform