Intervention réglementaire

Scénario

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

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 clôture son intervention de contrôle réglementaire (closed / done) et y ajoute son rapport réglementaire. L'étape de clôture modélise l'édition et mise à disposition du rapport réglementaire.
Les étapes (1) et (2) sont importantes pour les indicateurs et le suivi du contrat par le gestionnaire sur intentPlatform.

Tags

Afin d'être conforme avec la fonctionnalité de transfert automatique, il est impératif de transmettre les tags:
"tags":{
    "domaine":"CFO", //PIE, SSI, CVC, CFO, ASC, PAU
    "intent_topic":"Multi technique"
  }

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)

{
  "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": "SSI",
  "location": {
    "assetReference": "01-ALT-01"
  },
  "tags":{
    "domaine":"SSI",
    "intent_topic":"Sécurité incendie"
  },
  "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": 0
}

Planification de l’intervention (2)

{
  "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": "SSI",
  "location": {
    "assetReference": "01-ALT-01"
  },
  "tags":{
    "domaine":"SSI",
    "intent_topic":"Sécurité incendie"
  },
  "workType": "regulatory",
  "criticalLevel": 0,
  "visitAttempt": 1
}

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

{
  "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": "SSI",
  "location": {
    "assetReference": "01-ALT-01"
  },
  "tags":{
    "domaine":"SSI",
    "intent_topic":"Sécurité incendie"
  },
  "workType": "regulatory",
  "criticalLevel": 0,
  "visitAttempt": 1
}

… puis … 

{
  "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": "SSI",
  "location": {
    "assetReference": "01-ALT-01"
  },
  "tags":{
    "domaine":"SSI",
    "intent_topic":"Sécurité incendie"
  },
  "workType": "regulatory",
  "criticalLevel": 0,
  "visitAttempt": 1
}

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

{
  "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": "SSI",
  "location": {
    "assetReference": "01-ALT-01"
  },
  "tags":{
    "domaine":"SSI",
    "intent_topic":"Sécurité incendie"
  },
  "workType": "regulatory",
  "criticalLevel": 0,
  "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 du document rapport réglementaire

Les rapports réglementaires sont obligatoirement publiés sur une intervention qui est clôturée. Ils ne doivent pas être publiés si une intervention est toujours planifiée ou en cours.

POST  https://apisandbox.hubintent.com/api/documents/v1/documents 
curl -L -X POST ' https://apisandbox.hubintent.com/api/documents/v1/documents ' -H 'Authorization: Bearer ..........'
-H "Content-Type: multipart/form-data"-F 'title="Rapport d'''intervention sécurité"' -F 'file=@"/path/to/file"' -F 'elementType="intervention"' -F 'elementReference="reglementaire_001"' -F 'intent_contractReference="contract1"' -F 'intent_creationDate="2018-03-05"' -F 'description="Rapport de l'''intervention reglementaire_001 sur la vérification des équipements de sécurité incendie"' -F 'ReferenceRapport="GC101-25-4477"'

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

Annule et remplace

Il peut arriver qu'un nouveau rapport réglementaire doive se substituer à une version précédente, que ce soit pour une correction, une mise à jour ou un complément d'information.
Pour gérer ce cas de figure de manière propre et traçable, le processus est simple : lors de la publication de votre nouveau rapport, il vous suffit d'ajouter le champ annule_remplace. La valeur de ce champ doit correspondre à la référence unique (l'identifiant) du rapport que vous souhaitez invalider.
ReferenceRapport="GC101-25-4477_v2"
annule_remplace="GC101-25-4477"

Rendu visuel