Gaz Electricité

Documents

Le document "diagnostic" est transmis sur l'élément de patrimoine concerné, par exemple le logement ou le bâtiment.
Nous aurons 1 document pour le diag gaz et 1 document pour le diag élec.

Méthodes

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 "title=Diag gaz logement 001" -F "elementType=asset" -F "elementReference=logement_001" -F "intent_creationDate=2020-01-19" -F "intent_expirationDate=2030-01-19" -F "intent_contractReference=contract1" -F "Nature du diagnostic=Gaz" -F "file=@Diag_gaz.pdf;type=application/pdf"

Plus d’informations :  ⁠⁠Document sur un élément de patrimoine⁠ 

Métadonnées

  • Date de réalisation du diagnostic
  • Date de fin de validité
  • Nature du diagnostic (Gaz ou Electricité)
  • Type de rapport (Etat de l'installation intérieure ou Attestation de conformité)
  • Anomalie (oui ou non)
  • Référence du diagnostiqueur

Données à transmettre

Title
Title
Title
Champ
Description
Valeur
title
Titre du document
Diagnostic plomb du logement 001
intent_contractReference
Référence du contrat sur lequel le document est rattaché
contract_001
elementType
Ressource sur laquelle le document est lié
"asset"
elementReference
Référence de l'asset correspondant au diagnostic
"logement_001"
intent_creationDate
Date de réalisation du diagnostic
"2019-03-01"
intent_expirationDate
Date de fin de validité du diagnostic
"2021-03-01"
Nature du diagnostic
La nature du diagnostic
"Gaz" ou "Electricité"
Anomalie

Présence ou non d'au moins 1 anomalie

"oui" / "non"
Reference du diagnostiqueur
La référence du diagnostic chez le diagnostiqueur
"DPE_20213ZB"
Reference intervention
Référence de l'intervention au cours de laquelle le diag a été réalisé
"1234HTX"
Si au moins une anomalie est présente dans le diagnositc, il faut mettre oui dans le champ Anomalie. Si aucune anomalie alors Anomalie=non

Vous pouvez ajouter en information complémentaire les codes d'anomalies ("_B1_3a":"oui"). Ne transmettre que les codes étant en anomalie.

Anomalies

Les anomalies sont remontées par le prestataire lors de son diagnostic. Il fait remonter les anomalies au gestionnaire. Le gestionnaire doit ensuite mener les actions pour rectifier la ou les situations.

Scénario

L'entité relevant une anomalie, généralement le prestataire de maintenance, va transmettre une anomalie sur intentPlatform en utilisant le workflow d'une réserve.
L'entité ayant la responsabilité de traiter cette anomalie, généralement le gestionnaire immobilier, pourra être notifiée par mail et/ou webhooks.
Une fois l'anomalie traitée, le gestionnaire pourra venir la clôturer.
Une notification mail et/ou webhook pourra être transmise au prestataire afin qu'il soit notifié de la levée de l'anomalie et qu'il puisse mettre à jour son outil.

https://slite.com/api/files/bduiyNxgpD/Capture%252520d%2525u2019e%2525u0301cran%2525202020-09-29%252520a%2525u0300%25252010.11.44.png?apiToken=eyJhbGciOiJIUzI1NiIsImtpZCI6IjIwMjMtMDUtMDQifQ.eyJzY29wZSI6Im5vdGUtZXhwb3J0IiwibmlkIjoiZUlEeWl4TFJ5aCIsImlhdCI6MTcyOTA3NzkwNywiaXNzIjoiaHR0cHM6Ly9zbGl0ZS5jb20iLCJqdGkiOiJlOGdCNEVhSVB4QWhVeCIsImV4cCI6MTczMTY2OTkwN30.JAdJztNKUev8SUIdl8GM75UvTBB7p_m06jP-MZVROVY
Le gestionnaire pourra, s'il le souhaite, lier ses interventions correctives aux réserves transmises par le prestataire.

Spécification d'envoi des données

 Réserves - CRA⁠ 

API à utiliser

  • API Operations v2
  • objet "reservation"


Création de l'anomalie

POST  https://api.hubintent.com/api/operations/v2/reservations/logs 
{
  "reference": "Anomalie_001",
  "description": "Anomalie sur le flexible de gaz identifié dans la salle à manger",
  "contractReference": "contract1",
  "status": "open",
  "event": "requested",
  "eventDate": "2020-09-25T17:00:00",
  "logDate": "2020-09-25T17:00:00",
  "serviceCode": "_B1_3a",
  "location": {
    "assetReference": "LOGEMENT_005"
  },
  "workType": "corrective",
  "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:Technicien\r\nEMAIL;CHARSET=UTF-8;TYPE=WORK,INTERNET:p.dupont@internet.fr\r\nEND:VCARD"
  ],
  "origin": "sp",
  "warning": true,
  "criticalLevel": 3
}

Le champ serviceCode prend le code de l'anomalie.

Métadonnées complémentaires

Il peut arriver que le gestionnaire immobilier souhaite avoir certaines informations du diagnostic directement sur ses éléments de patrimoine et pas uniquement sur le document.
A valider avec le gestionnaire si c'est une exigence de sa part.

Les métadonnées complémentaires identifiées sont :
  • Date de réalisation du diagnostic

Il est demandé de transmettre cette métadonnée sur l'élément de patrimoine concerné par le diagnostic, par exemple le logement ou le bâtiment.

Méthodes

Pour transmettre les métadonnées directement sur un élément de patrimoine, il faut utiliser l'API Assets v1 et réaliser un PATCH, donc une modification d'un élément de patrimoine.
 Modification d'un équipement par un tiers⁠ 

PATCH /api/assets/v1/assets/{reference}

Ajout ou modification d'informations pour un asset
  {
    "tags": [
      {
        "operation": "add",
        "name": "Date diag electricite",
        "value":"2020-10-09"
      },
      {
        "operation": "add",
        "name": "Date diag gaz",
        "value":"2018-04-09"
      }
    ]
  }