Annulation de la demande

Annulation de la demande

Un utilisateur annule la demande d'intervention qu'il a réalisé. Il peut réaliser cette action depuis les interfaces web et mobile d'intentPlatform ou depuis son CRM connecté à intentPlatform.

Réception d'un webhook

Lors de l'annulation d'une demande d'intervention, je reçois un webhook avec "type": "operations:intervention:update"
En tant que prestataire, je réceptionne un webhook m'indiquant qu'un tiers à mis à jour une intervention. Dans le cas de l'annulation, on retrouvera dans le corps du webhook, status = denied et event = canceled
[
  {
    "type": "operations:intervention:update",
    "id": "471b155d-09ac-4ec6-a83a-70b3b8695738",
    "event": {
      "type": "operations",
      "body": {
        "id": "6ca801bb-cae3-43a6-978a-a18216f1f7a8",
        "reference": "contract1_201215191838",
        "contractReference": "contract1",
        "type": "intervention",
        "description": "Problème d'eau chaude logement 1",
        "status": "denied",
        "event": "canceled",
        "serviceCode": "I123",
        "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_201215191838?contractReference=contract1"
      }
    }
  }
]

Je récupère l'intégralité de la demande. 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

L'état de l'intervention est en "Annulée" qui se traduit par status=denied et event=canceled. Ces informations sont visibles à la fois dans le webhook et dans le corps du ticket récupéré par l'appel API.

Je peux récupérer de plus amples informations (commentaire, photos, date et heure) sur le détail de l'annulation dans le log en question (status=denied et event=canceled) dans la rubrique logs .
{
    "_links": {
        "self": {
            "href": "https://apisandbox.hubintent.com/api/operations/v2/operations/contract1_201215191838?contractReference=contract1"
        },
        "documents:list": {
            "href": "https://apisandbox.hubintent.com/api/documents/v1/documents?elementType=intervention&elementReference=contract1_201215191838"
        },
        "actions:reservation:create": {
            "href": "https://apisandbox.hubintent.com/api/operations/v2/reservations/logs"
        }
    },
    "reference": "contract1_201215191838",
    "description": "Problème d'eau chaude logement 1",
    "criticalLevel": 3,
    "suggestedProvisionalDate": "2020-12-15T18:18:38.000Z",
    "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": "371c6829-2b25-40d7-8d2d-8238537ca146",
            "type": "user",
            "name": "serviceclient+gestionnaire@intent.tech"
        }
    },
    "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": "I123",
        "label": "Dépannage ECS",
        "workType": "corrective",
        "sla": {
            "maxTimeToIntervention": {
                "value": 24,
                "unit": "hour"
            },
            "maxTimeToRecovery": {
                "value": 48,
                "unit": "hour"
            }
        },
        "originalCode": "ECS"
    },
    "workType": "corrective",
    "status": "denied",
    "event": "canceled",
    "eventDate": "2020-12-15T19:25:36+01:00",
    "logDate": "2020-12-15T19:25:36+01:00",
    "eventHistory": [
        "requested",
        "canceled"
    ],
    "location": {
        "assetReference": "LOGEMENT_001"
    },
    "dueDate": "2020-12-17T19:18:38+01:00",
    "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\nREV:2020-12-15T19:18:38+01: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": "371c6829-2b25-40d7-8d2d-8238537ca146",
                    "type": "user",
                    "name": "serviceclient+gestionnaire@intent.tech"
                }
            },
            "reference": "contract1_201215191838",
            "description": "Problème d'eau chaude logement 1",
            "contractReference": "contract1",
            "documentUrls": [
                "https://apisandbox.hubintent.com/api/documents/v1/documents/08038704-60b3-4bcc-90f5-022888820c80/download"
            ],
            "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\nREV:2020-12-15T19:18:38+01:00\r\nEND:VCARD"
            ],
            "creationDate": "2020-12-15T19:18:43+01:00",
            "type": "intervention",
            "serviceCode": "I123",
            "workType": "corrective",
            "status": "open",
            "event": "requested",
            "eventDate": "2020-12-15T19:18:38+01:00",
            "logDate": "2020-12-15T19:18:38+01:00",
            "location": {
                "assetReference": "LOGEMENT_001",
                "assetOwner": "gestionnaire.intent"
            },
            "criticalLevel": 3,
            "suggestedProvisionalDate": "2020-12-15T19:18:38+01:00",
            "photos": []
        },
        {
            "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": "371c6829-2b25-40d7-8d2d-8238537ca146",
                    "type": "user",
                    "name": "serviceclient+gestionnaire@intent.tech"
                }
            },
            "reference": "contract1_201215191838",
            "description": "J'annule l'intervention",
            "contractReference": "contract1",
            "creationDate": "2020-12-15T19:25:37+01:00",
            "type": "intervention",
            "serviceCode": "I123",
            "workType": "corrective",
            "status": "denied",
            "event": "canceled",
            "eventDate": "2020-12-15T19:25:36+01:00",
            "logDate": "2020-12-15T19:25:36+01:00",
            "location": {
                "assetReference": "LOGEMENT_001",
                "assetOwner": "gestionnaire.intent"
            },
            "photos": []
        }
    ],
    "creationDate": "2020-12-15T19:18:47+01:00",
    "lastUpdateDate": "2020-12-15T19:25:39+01:00"
}