Récupérer le contrat sur un logement, un bâtiment ou un équipement

Ce document explique comment un acteur peut utiliser les APIs d’intentPlatform pour récupérer la référence d’un contrat sur un asset afin de l’utiliser pour la publication de ces données sur intentPlatform (interventions, documents, réserves, devis, etc.).
Vous pouvez le faire en réalisant un appel API sur l'élément de patrimoine concerné.

Méthodes

GET /assets/v2/assets/{référence}?ownerId={id}
Vous avez besoin de la référence de l'asset pour lequel vous souhaitez récupérer le ou les contrats et l'id du propriétaire de l'élément de patrimoine.

L’acteur doit au préalable connaître l’id du propriétaire des assets. Chaque propriétaire d’asset à son propre id. L’id est récupérable auprès d’Intent Technologies. Il doit être considéré comme une variable pour s’adapter à plusieurs propriétaires d’assets et donc avoir un connecteur générique avec intentPlatform.

Le contrat ou les contrats sont localisés dans le champ contracts. Ils sont dans un tableau.

Nous récupérons le(s) contrat(s) pour le logement DM-logement-23
GET /api/assets/v2/assets/DM-logement-23?ownerId=5ba2123b582f7860c68de6f6

{
    "category": "Lot",
    "code": "part_23",
    "fullPath": "/lyon_centreest/ag_lyon/site_5/part_23",
    "label": "logement 23",
    "tags": {
        "intent_type": "dwelling",
        "intent_address_way": "41 rue du Souvenir",
        "intent_address_zip": "69009",
        "intent_address_city": "Lyon",
        "intent_latitude": 45.7755341,
        "intent_longitude": 4.7896022,
        "etage": "r+3",
        "porte": "3",
        "typologie": "F2",
        "catégorie_financement": "PLA",
        "note_dpe": "classe_D",
        "temoin_ascenseur": "ascenseur",
        "intent_contacts": "BEGIN:VCARD\r\nVERSION:3.0\r\nFN;CHARSET=UTF-8:COLETTE SPAGNOLI \r\nN;CHARSET=UTF-8:SPAGNOLI ;COLETTE;;;\r\nEMAIL;CHARSET=UTF-8;TYPE=WORK,INTERNET:c.spagnoli@thisisafakemail.com\r\nROLE;CHARSET=UTF-8:Locataire\r\nREV:2023-11-13T15:53:08+01:00\r\nEND:VCARD"
    },
    "type": "building",
    "owner": {
        "id": "5ba2123b582f7860c68de6f6",
        "label": "La Métropole de l'Habitat",
        "entityRoles": [
            {
                "name": "client"
            },
            {
                "name": "developer"
            },
            {
                "name": "assetOwner"
            }
        ],
        "logoUrl": "https://hubintent.com/intent/entities/logos/6b98a47a-64ad-4362-9ae8-a9a332be3d1f.png"
    },
    "contracts": [
        "Multiservice_Ag_Lyon",
        "Bon_de_commande",
        "Diagnostic_amiante",
        "Comptage_Ag_Lyon",
        "Multiservice_BDC",
        "EV2023",
        "TEST_IDEX",
        "123456"
    ],
    "metadata": {
        "position": {
            "type": "Point",
            "coordinates": [
                4.7896022,
                45.7755341
            ]
        }
    },
    "reference": "DM-logement-23",
    "parentPath": "/lyon_centreest/ag_lyon/site_5",
    "lastUpdateDate": "2024-05-28T16:10:39+02:00",
    "creationDate": "2018-09-24T17:16:26+02:00",
    "_links": {
        "self": {
            "href": "https://api.hubintent.com/api/assets/v2/assets/DM-logement-23?ownerId=5ba2123b582f7860c68de6f6"
        },
        "operations:list": {
            "href": "https://api.hubintent.com/api/operations/v2/operations?ancestorAssetReference=DM-logement-23&ancestorAssetOwnerId=5ba2123b582f7860c68de6f6"
        },
        "streams:list": {
            "href": "https://api.hubintent.com/api/data/v1/streams?ancestorAssetReference=DM-logement-23&ancestorAssetOwnerId=5ba2123b582f7860c68de6f6"
        },
        "documents:list": {
            "href": "https://api.hubintent.com/api/documents/v1/documents?ancestorAssetReference=DM-logement-23&ancestorAssetOwnerId=5ba2123b582f7860c68de6f6"
        },
        "share": {
            "href": "https://api.hubintent.com/api/assets/v1/assets/DM-logement-23?ownerId=5ba2123b582f7860c68de6f6"
        },
        "update:installation_path": {
            "href": "https://api.hubintent.com/api/assets/v1/assets/DM-logement-23?ownerId=5ba2123b582f7860c68de6f6"
        },
        "migrate": {
            "href": "https://api.hubintent.com/api/assets/v1/assets/DM-logement-23?ownerId=5ba2123b582f7860c68de6f6"
        }
    }
}
Le logement DM-logement-23 est partagé sur les contrats suivants:
"contracts": [
  "Multiservice_Ag_Lyon",
  "Bon_de_commande",
  "Diagnostic_amiante",
  "Comptage_Ag_Lyon",
  "Multiservice_BDC",
  "EV2023",
  "TEST_IDEX",
  "123456"
 ],
Les contrats actifs et inactifs sont retournés.