Intervention réglementaire

Scénario

Le prestataire va réaliser une intervention de contrôle réglementaire dans un immeuble et émettre un rapport d'intervention.
Son intervention concerne les étapes 1 à 5 sur le schéma ci-dessous :

https://slite.com/api/files/PZa1B7dsv/diagrammes%2520de%2520se%25CC%2581quence%2520interventions%2520(14).jpg?apiToken=eyJhbGciOiJIUzI1NiIsImtpZCI6IjIwMjMtMDUtMDQifQ.eyJzY29wZSI6Im5vdGUtZXhwb3J0IiwibmlkIjoiMTNxZTM5dTBVayIsImlhdCI6MTcyOTA5OTAxMywiaXNzIjoiaHR0cHM6Ly9zbGl0ZS5jb20iLCJqdGkiOiJiWl92dm1pck01dWFOSiIsImV4cCI6MTczMTY5MTAxM30.ChkLn174utmNP0tDGA56DnXrg4iJcM2xGjjac9VRPco

Ouverture intervention (1)

Le prestataire va créer une intervention sur intentPlatform en indiquant la date d'échéance/anniversaire de l'intervention ou planning prévisionnel. (status=open ; event = due)

Planification de l'intervention (2)

Le prestataire va indiquer la date et heure à laquelle il a prévu de réaliser l'intervention. (status = open ; event = planned)

Début d'intervention et fin d'intervention (3) (4)

Le prestataire va indiquer la date et l'heure à laquelle il a débuté et terminé son intervention sur site. (status = pending ; event = start et status = pending ; event = end)

Clôture de l'intervention (5)

Le prestataire indique qu'il clôture son intervention de contrôle. (status = closed ; event = done). Il y ajoute son rapport d'intervention.
Les étapes (1) et (2) sont importantes pour les indicateurs et le suivi du contrat par le gestionnaire sur intentPlatform.

Lors d'une vérification périodique, il arrive que certains points de contrôle ne peuvent pas être vérifiés (locataire absent par exemple), ces points non vérifiés doivent être signalés par la création d'une réserve.

Spécifications d'envoi des données

API à utiliser

  • API Operations v2
  • objet "intervention"
  • API Documents v1
  • objet "document"

Pour une intervention de contrôle réglementaire, le champ workType = regulatory

Création de l'intervention avec date d'échéance (1)

POST  https://apisandbox.hubintent.com/api/operations/v2/interventions/logs 
{
  "reference": "reglementaire_001",
  "description": "Sécurité incendie - vérification des équipements",
  "contractReference": "contract1",
  "status": "open",
  "event": "due",
  "eventDate": "2020-12-12T00:00:00",
  "logDate": "2020-10-07T15:18:00",
  "serviceCode": "SECU-CP-9",
  "location": {
    "assetReference": "01-ALT-01"
  },
  "workType": "regulatory",
  "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:Responsable sécurité\r\nEMAIL;CHARSET=UTF-8;TYPE=WORK,INTERNET:p.dupont@internet.fr\r\nEND:VCARD\r\n"
  ],
  "criticalLevel": 3
}

Planification de l’intervention (2)

POST  https://apisandbox.hubintent.com/api/operations/v2/interventions/logs 
{
  "reference": "reglementaire_001",
  "description": "Planification de l'intervention au 10/12/2020 - 10h",
  "contractReference": "contract1",
  "status": "open",
  "event": "planned",
  "eventDate": "2020-12-10T10:00:00",
  "logDate": "2020-10-07T15:21:00",
  "serviceCode": "SECU-CP-9",
  "location": {
    "assetReference": "01-ALT-01"
  },
  "workType": "regulatory",
  "criticalLevel": 3,
  "visitAttempt": 1
}

Réalisation de l’intervention (3) puis (4)

POST  https://apisandbox.hubintent.com/api/operations/v2/interventions/logs 
{
  "reference": "reglementaire_001",
  "description": "Début de l'intervention",
  "contractReference": "contract1",
  "status": "pending",
  "event": "start",
  "eventDate": "2020-12-10T09:30:00",
  "logDate": "2020-12-10T09:30:00",
  "serviceCode": "SECU-CP-9",
  "location": {
    "assetReference": "01-ALT-01"
  },
  "workType": "regulatory",
  "criticalLevel": 3,
  "visitAttempt": 1
}

… puis … 

POST  https://apisandbox.hubintent.com/api/operations/v2/interventions/logs 
{
  "reference": "reglementaire_001",
  "description": "Fin de l'intervention",
  "contractReference": "contract1",
  "status": "pending",
  "event": "end",
  "eventDate": "2020-12-10T12:30:00",
  "logDate": "2020-12-10T12:30:00",
  "serviceCode": "SECU-CP-9",
  "location": {
    "assetReference": "01-ALT-01"
  },
  "workType": "regulatory",
  "criticalLevel": 3,
  "visitAttempt": 1
}

Clôture de l’intervention par le prestataire (5)

POST  https://apisandbox.hubintent.com/api/operations/v2/interventions/logs 
{
  "reference": "reglementaire_001",
  "description": "Tous les équipements ont été vérifiées.",
  "contractReference": "contract1",
  "status": "closed",
  "event": "done",
  "eventDate": "2020-12-10T12:35:00",
  "logDate": "2020-12-10T12:35:00",
  "serviceCode": "SECU-CP-9",
  "location": {
    "assetReference": "01-ALT-01"
  },
  "workType": "regulatory",
  "criticalLevel": 3,
  "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:Responsable sécurité\r\nEMAIL;CHARSET=UTF-8;TYPE=WORK,INTERNET:p.dupont@internet.fr\r\nEND:VCARD\r\n"
  ],
  "visitAttempt": 1
}

Publication d’un document par le prestataire
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=Rapport d'intervention sécurité" -F "elementType=intervention" -F "elementReference=reglementaire_001" -F "description=Rapport de l'intervention reglementaire_001 sur la vérification des équipements de sécurité incendie" -F "intent_contractReference=contract1"

Plus d’informations : Notice raccordement Documents

Rendu visuel

 Accès intervention 

https://slite.com/api/files/XMjEgiAhEA/Capture%20d%E2%80%99e%CC%81cran%202020-12-09%20a%CC%80%2016.35.00.png?apiToken=eyJhbGciOiJIUzI1NiIsImtpZCI6IjIwMjMtMDUtMDQifQ.eyJzY29wZSI6Im5vdGUtZXhwb3J0IiwibmlkIjoiMTNxZTM5dTBVayIsImlhdCI6MTcyOTA5OTAxMywiaXNzIjoiaHR0cHM6Ly9zbGl0ZS5jb20iLCJqdGkiOiJiWl92dm1pck01dWFOSiIsImV4cCI6MTczMTY5MTAxM30.ChkLn174utmNP0tDGA56DnXrg4iJcM2xGjjac9VRPco

https://slite.com/api/files/WRSwk7yeCy/Capture%20d%E2%80%99e%CC%81cran%202020-12-09%20a%CC%80%2016.35.09.png?apiToken=eyJhbGciOiJIUzI1NiIsImtpZCI6IjIwMjMtMDUtMDQifQ.eyJzY29wZSI6Im5vdGUtZXhwb3J0IiwibmlkIjoiMTNxZTM5dTBVayIsImlhdCI6MTcyOTA5OTAxMywiaXNzIjoiaHR0cHM6Ly9zbGl0ZS5jb20iLCJqdGkiOiJiWl92dm1pck01dWFOSiIsImV4cCI6MTczMTY5MTAxM30.ChkLn174utmNP0tDGA56DnXrg4iJcM2xGjjac9VRPco