Intervention enfant

intentPlatform va générer automatiquement une demande d'intervention, qui sera un objet operation de type intervention. Elle sera liée à l'intervention chapeau. Cette intervention enfant est une demande d'intervention pour résoudre l'observation du rapport du bureau de contrôle. Elle arrivera dans un statut ouvert.

Récupération de l'intervention enfant par le prestataire

Webhook

{
    "type": "operations:intervention:share",
    "event": {
        "type": "operations",
        "body": {
            "id": "c5cd12a5-89a5-4a38-9133-6fc50bbe40a4",
            "reference": "observation_parentReferenceOKAY-03f6a7",
            "contractReference": "LPI_MTK",
            "type": "intervention",
            "description": "Réserve n°1",
            "status": "open",
            "event": "requested",
            "serviceCode": "HGAI",
            "workType": "corrective",
            "criticalLevel": "5",
            "assetReference": "925097",
            "assetPath": "/DRID/75/925097",
            "assetAddress": {
                "way": "9 RUE DU COLONEL PIERRE AVIA",
                "city": "PARIS",
                "country": "",
                "zip": "75015",
                "complement": ""
            },
            "issuer": {
                "entity": {
                    "id": "65d898eda0529e5bfd611aa3",
                    "label": "LA POSTE IMMOBILIER PREPROD"
                },
                "user": {
                    "id": "automatic-actions@intent",
                    "name": ""
                }
            },
            "operation_url": "https://api.hubintent.com/api/operations/v2/operations/observation_parentReferenceOKAY-03f6a7?contractReference=LPI_MTK"
        }
    }
}

GET operations by ref

{
  "_links": {
    "self": {
      "href": "https://api.hubintent.com/api/operations/v2/operations/observation_parentReferenceOKAY-03f6a7?contractReference=LPI_MTK"
    },
    "documents:list": {
      "href": "https://api.hubintent.com/api/documents/v1/documents?elementType=intervention&elementReference=observation_parentReferenceOKAY-03f6a7"
    }
  },
  "reference": "observation_parentReferenceOKAY-03f6a7",
  "description": "Réserve n°1",
  "criticalLevel": 5,
  "reminderComment": "19/02/2024 00:00:00",
  "issuer": {
    "entity": {
      "id": "65d898eda0529e5bfd611aa3",
      "label": "LA POSTE IMMOBILIER PREPROD",
      "logoUrl": "https://hubintent.com/intent/entities/logos/af787182-7e16-457b-9570-9f12472333a1.png"
    },
    "user": {
      "id": "automatic-actions@intent",
      "type": "user"
    }
  },
  "tags": {
    "EquipementConcerne": "CENTRE DE TRI/SOUS-SOL/",
    "NumeroObservation": "2",
    "ReferenceRapport": "206E0/24/702",
    "intent_topic": "Multi technique",
    "domaine": "CFO",
    "intent_origin_operation_issuer": "BUREAU DE CONTROLE LPI"
  },
  "contract": {
    "reference": "LPI_MTK",
    "label": "Contrat LPI - Multi technique",
    "topic": "Multi technique",
    "entities": [
      {
        "id": "65d89b04a0529e5bfd611b23",
        "label": "MTK LPI",
        "logoUrl": "https://hubintent.com/intent/entities/logos/02e625f4-31bf-465f-a561-a48bcbbcad08.png"
      },
      {
        "id": "65d898eda0529e5bfd611aa3",
        "label": "LA POSTE IMMOBILIER PREPROD",
        "logoUrl": "https://hubintent.com/intent/entities/logos/af787182-7e16-457b-9570-9f12472333a1.png"
      }
    ]
  },
  "type": "intervention",
  "parentReference": "bureaudecontrole_chapeau-75838a",
  "service": {
    "code": "HGAI",
    "originalCode": "HGAI"
  },
  "workType": "corrective",
  "status": "open",
  "event": "requested",
  "eventDate": "2024-03-13T11:30:00+01:00",
  "logDate": "2024-03-13T11:30:00+01:00",
  "eventHistory": ["requested"],
  "location": {
    "assetReference": "925097",
    "address": {
      "way": "9 RUE DU COLONEL PIERRE AVIA",
      "zip": "75015",
      "city": "PARIS"
    },
    "geo": {},
    "owner": {
      "id": "65d898eda0529e5bfd611aa3",
      "label": "LA POSTE IMMOBILIER PREPROD",
      "entityRoles": [
        {
          "name": "assetOwner"
        },
        {
          "name": "client"
        }
      ],
      "logoUrl": "https://hubintent.com/intent/entities/logos/af787182-7e16-457b-9570-9f12472333a1.png"
    }
  },
  "firstEventDate": "2024-03-13T10:30:00.000Z",
  "logs": [
    {
      "issuer": {
        "entity": {
          "id": "65d898eda0529e5bfd611aa3",
          "label": "LA POSTE IMMOBILIER PREPROD",
          "logoUrl": "https://hubintent.com/intent/entities/logos/af787182-7e16-457b-9570-9f12472333a1.png"
        },
        "user": {
          "id": "automatic-actions@intent",
          "type": "user"
        }
      },
      "reference": "observation_parentReferenceOKAY-03f6a7",
      "description": "Réserve n°1",
      "tags": {
        "EquipementConcerne": "CENTRE DE TRI/SOUS-SOL/",
        "NumeroObservation": "2",
        "ReferenceRapport": "206E0/24/702",
        "intent_topic": "Multi technique",
        "domaine": "CFO",
        "intent_origin_operation_issuer": "BUREAU DE CONTROLE LPI"
      },
      "contractReference": "LPI_MTK",
      "documentUrls": [],
      "creationDate": "2024-03-13T12:08:51+01:00",
      "type": "intervention",
      "parentReference": "bureaudecontrole_chapeau-75838a",
      "serviceCode": "HGAI",
      "workType": "corrective",
      "status": "open",
      "event": "requested",
      "eventDate": "2024-03-13T11:30:00+01:00",
      "logDate": "2024-03-13T11:30:00+01:00",
      "location": {
        "assetLabel": "LE LEMNYS",
        "assetAlgoliaId": "65d8a2564794512d75f575df",
        "address": {
          "way": "9 RUE DU COLONEL PIERRE AVIA",
          "zip": "75015",
          "city": "PARIS"
        },
        "assetReference": "925097",
        "assetOwner": "lpipreprod.intent",
        "geo": {}
      },
      "criticalLevel": 5,
      "reminderComment": "19/02/2024 00:00:00"
    }
  ],
  "creationDate": "2024-03-13T12:08:51+01:00",
  "lastUpdateDate": "2024-03-13T12:08:51+01:00"
}


Informations importantes

"reference":"observation_parentReferenceOKAY-03f6a7" // Référence générée à partir de la précédente. "{referenceSource}-xxxxxx"
"parentReference": "bureaudecontrole_chapeau-75838a" // Référence de l'intervention chapeau
"status":"open"
"event":"requested"
"worktype":"corrective" // Indique qu'il s'agit d'une demande d'intervention corrective
"serviceCode":"HGAI" //il aura la valeur convenu dans le mapping si un mapping est mis en place
"intent_topic":"Multi technique" //Indique le métier
"tags": {
 "domaine": "CFO", //indique le domaine responsable de l'intervention chapeau
 "intent_topic": "Multi technique", //indique le métier responsable de l'intervention chapeau
 "intent_origin_operation_issuer": "BUREAU DE CONTROLE LPI" //indique l'acteur source du transfert automatique
 "ReferenceRapport": "206E0/24/702" // référence du rapport du bureau de contrôle
 },
"documentUrls": [
 "https://api.hubintent.com/api/documents/v1/documents/af52d65f-27fb-4895-bf9b-7de1b3097276/download",
 "https://api.hubintent.com/api/documents/v1/documents/ca995227-be2a-42b3-8bfb-91f7d7a5c137/download"
 ], //indique les url pour directement télécharger les documents de l'intervention chapeau

Pour les ascensoristes, la référence de l'ascenseur concerné par la réserve sera indiquée au début du champ EquipementConcerne et jusqu'au |.

EquipementConcerne:44445643|1ER ETAGE BATIMENT B/Câble 5G16mm² sur chemin de câble

EquipementConcerne:11115643

La référence de l'intervention chapeau est construite à partir de la référence de l'objet qui a permis sa création et son transfert.
"reference":"{referenceSource}-xxxxxx"

Plus d'informations sur comment récupérer et traiter une intervention:
 ⁠⁠Demande d'intervention⁠ 

Documents

Si des documents sont joints par le bureau de contrôle aux réserves, ils seront transférés. Vous pouvez les récupérer par API avec un GET Documents v1 ou via un webhook.
 ⁠⁠Récupération des pièces jointes⁠ 

Traitement de l'intervention enfant

 ⁠⁠Demande d'intervention⁠ 

Clôture

Si vous avez traité avec succès l'observation du bureau de contrôle, vous devez clôturer l'intervention enfant avec un status:closed et event:done

Hors contrat

Si l'observation ne vous concerne pas car non comprise dans votre contrat, vous devez clôturer l'intervention avec un status:denied et event:non_contractual

Refus

Si vous refusez le traitement de l'observation, vous devez clôturer l'intervention avec un status:denied et event:canceled