Intervention chapeau

intentPlatform va générer une intervention "chapeau", qui sera un objet operation de type intervention. Cette intervention modélise le rapport à traiter suite au passage du bureau de contrôle. Elle arrivera dans un statut ouvert (open/requested) et le prestataire viendra la clôturer une fois qu'il aura traité l'intégralité du rapport.

L'intervention chapeau aura le propriétaire de l'asset comme émetteur.
Si aucune réserve n'est associée à l'intervention rapport du bureau de contrôle, une intervention chapeau est tout de même envoyée au prestataire pour qu'il puisse bénéficier du rapport du bureau de contrôle.

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

Webhook

{
    "type": "operations:intervention:share",
    "event": {
        "type": "operations",
        "body": {
            "id": "a22228e0-7cb6-4277-8907-ec2cc76bc3c3",
            "reference": "bureaudecontrole_mappingserviceCode_v3-d23f31",
            "contractReference": "LPI_MTK",
            "type": "intervention",
            "description": "Intervention du bureau de contrôle",
            "status": "open",
            "event": "requested",
            "serviceCode": "HGAI",
            "workType": "regulatory",
            "criticalLevel": "-1",
            "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/bureaudecontrole_mappingserviceCode_v3-d23f31?contractReference=LPI_MTK"
        }
    }
}

GET operations by ref

{
    "_links": {
        "self": {
            "href": "https://api.hubintent.com/api/operations/v2/operations/bureaudecontrole_mappingserviceCode_v3-d23f31?contractReference=LPI_MTK"
        },
        "documents:list": {
            "href": "https://api.hubintent.com/api/documents/v1/documents?elementType=intervention&elementReference=bureaudecontrole_mappingserviceCode_v3-d23f31"
        }
    },
    "reference": "bureaudecontrole_mappingserviceCode_v3-d23f31",
    "description": "Intervention du bureau de contrôle",
    "criticalLevel": -1,
    "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": {
        "domaine": "CFO",
        "intent_topic": "Multi technique",
        "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",
    "service": {
        "code": "HGAI",
        "originalCode": "HGAI"
    },
    "workType": "regulatory",
    "status": "open",
    "event": "requested",
    "eventDate": "2024-03-01T15:20:00+01:00",
    "logDate": "2024-03-01T15:20: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-01T14:20: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": "bureaudecontrole_mappingserviceCode_v3-d23f31",
            "description": "Intervention du bureau de contrôle",
            "tags": {
                "domaine": "CFO",
                "intent_topic": "Multi technique",
                "intent_origin_operation_issuer": "BUREAU DE CONTROLE LPI"
            },
            "contractReference": "LPI_MTK",
            "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"
            ],
            "creationDate": "2024-03-01T15:20:37+01:00",
            "type": "intervention",
            "serviceCode": "HGAI",
            "workType": "regulatory",
            "status": "open",
            "event": "requested",
            "eventDate": "2024-03-01T15:20:00+01:00",
            "logDate": "2024-03-01T15:20: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": -1
        }
    ],
    "creationDate": "2024-03-01T15:20:37+01:00",
    "lastUpdateDate": "2024-03-01T15:20:37+01:00"
}


Informations importantes

"reference":"bureaudecontrole_mappingserviceCode_v3-d23f31" // Référence générée à partir de la précédente. "{referenceSource}-xxxxxx"
"status":"open"
"event":"requested"
"worktype":"regulatory" // Indique qu'il s'agit d'un sujet réglementaire
"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
    },
"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

Le champ worktype=regulatory vous permet de savoir que cette demande concerne le sujet du réglementaire. A la différence du dépannage forfaitaire (worktype=corrective) ou d'un bon de commande (worktype=work_order).

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

Les documents émis par le bureau de contrôle seront joints à l'intervention chapeau. Vous pouvez les récupérer par API avec un GET Documents v1 ou via un webhook.
 ⁠⁠Récupération des pièces jointes⁠ 

Le bureau de contrôle doit clôturer l'intervention après qu'il ait publié les documents. Si les documents sont publiés après la clôture, ils ne seront pas transférée au prestataire.

Traitement de l'intervention chapeau

Accusé de réception

Lors de la réception de l'intervention chapeau dans votre système, vous devez transmettre un log d'accusé de réception pour indiquer que vous avez bien récupéré les informations.

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

Traitement du dossier

Le prestataire indique que le dossier est en cours de traitement en transmettant un log pending/start sur l'intervention chapeau.

Devis en cours

Si un devis est nécessaire pour lever 1 ou plusieurs réserves, le prestataire devra envoyer un log hold/quote_request sur l'intervention chapeau et publier un devis sur intentPlatform (objet quotation).

Clôture de l'intervention

Une fois que le prestataire a traité l'ensemble des observations/réserves du rapport, il transmet un log de clôture de l'intervention closed/done
L'intervention chapeau peut uniquement avoir 1 état de clôture closed/done. Il indique que l'ensemble du dossier a été traité.

Hors contrat

Si jamais l'intervention chapeau ne fait pas partie du périmètre contractuel du prestataire alors le prestataire envoie un log denied/not_contractual.
Il faut que tout le dossier réglementaire soit hors contrat.