Intervention réglementaire

Scénario

Le bureau de contrôle 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 :

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.

Spécifications d'envoi des données

API à utiliser

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

Tags à renseigner

Pour une intervention de contrôle réglementaire, le champ workType = regulatory
Il est indispensable de renseigner des tags suivants afin que les rapports puissent être transmis automatiquement au mainteneur qui en a la responsabilité.
"tags": {
    "intent_topic": "Sécurité incendie",
    "domaine": "SSI"
  },

Les valeurs possibles pour le tag intent_topic sont:
Title
Multi technique
Sécurité incendie
Ascenseur
Portes automatiques
Chauffage individuel
Chauffage collectif
Aire de jeux
Interne
Les valeurs possibles pour le tag Domaine sont:
Title
PIE
SSI
CVC
CFO
ASC
PAU
Client
La liste des valeurs est non exhaustive. S'il manque des valeurs nous pourront éventuellement les ajouter. Nous vous invitons à nous contacter pour tout demande d'ajout de valeur.

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": "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"
  ]
}

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

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=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" -F "ReferenceRapport=N12L0/25/7963" -F "Domaine=SSI"

Plus d’informations : Notice raccordement Documents

Rendu visuel