Élaboration planimétrique
Accéder via API à l'élaboration planimétrique officiel de n'importe quelle propriété italienne.
Openapi permet de demander, avec délégation et via API, le Document Planimétrique officiel d'un bien immobilier
Le Document Planimétrique est un document délivré par l'Agence des Revenus et est une reproduction à l'échelle d'un bâtiment représentant le périmètre du bâtiment, la répartition des appartements à l'intérieur, des espaces communs (cours, locaux de service, cage d'escalier et ascenseur, etc.), des espaces extérieurs privés et communs, etc.
Le document planimétrique contient généralement les informations suivantes :
- périmètre du bâtiment concerné ;
- parties couvertes et découvertes sur chaque étage du bâtiment ;
- périmètre de chaque unité immobilière ; points d'accès ;
- numéro de chaque portion/unité ;
- dénomination des rues et/ou des eaux limitrophes du bâtiment.
Demander le Hash du document
GET /visure
Pour demander le Document Planimétrique via l'API Visengine, il est d'abord nécessaire d'identifier le hash qui identifie de manière unique chaque document ou dossier.
https://visengine2.altravia.com/visure/
Cela est possible via l'endpoint GET /visure qui ne nécessite pas de paramètres et renverra la liste complète des documents et dossiers demandables via Visengine et leur hash respectif.
Vérifier les données et les coûts de la demande de Élaboration planimétrique
GET /visure/{hash_visura}
Pour vérifier les informations, les documents requis et les coûts du document planimétrique, vous devez effectuer une demande via l'endpoint GET /visure/{hash_visura} et fournir le hachage du document précédemment obtenu.
EXEMPLE DE REQUÊTE
GET /visure/{hash_visura}
Pour vérifier les champs et les coûts afin de compléter la demande, vous devez utiliser le hash obtenu lors de la demande précédente.
https://visengine2.altravia.com/visure/99d9da7b8fbf8a60054a48217fc5d5a1EXEMPLE DE RÉPONSE
GET /visure/{hash_visura}
La réponse indiquera toutes les informations nécessaires pour compléter la demande, telles que les champs obligatoires.
{
"data": {
"hash_visura": "99d9da7b8fbf8a60054a48217fc5d5a1",
"json_struttura": {
"campi": {
"$0": {
"nome": "Provincia immobile *",
"tipo": "cod_provincia"
},
"$1": {
"nome": "Comune *",
"tipo": "cod_comune"
},
"$2": {
"nome": "Foglio *",
"tipo": "catastale_foglio"
},
"$3": {
"nome": "Particella *",
"tipo": "catastale_particella"
},
"$4": {
"nome": "Sub",
"tipo": "catastale_sub",
"null": "0"
},
"$5": {
"nome": "Sezione amministrativa",
"tipo": "testo",
"null": true,
"istruzioni": "Campo facoltativo, obbligatorio nella provincia di Genova."
}
},
"validazione": "($0 && $1 && $2 && $3 && $4) || ($0 && $1 && $2 && $3 && $4 && $5) || ($0 && $1 && $2 && $3) || ($0 && $1 && $2 && $3 && $5)",
"istruzioni": "PHA+Q29tcGlsYSBpbCBmb3JtIHBlciBhdmVyZSBsJiMzOTtlbGFib3JhdG8gcGxhbmltZXRyaWNvLjwvcD4NCg0KPHA+Jm5ic3A7PC9wPg0K",
"istruzioni_ricerca": "PHA+TGEgcmljaGllc3RhICZlZ3JhdmU7IDxzdHJvbmc+Y29tcGlsYXRhIGNvcnJldHRhbWVudGUsPC9zdHJvbmc+IGEgYnJldmUgdHJvdmVyJmFncmF2ZTsgaW4gcXVlc3RhIHBhZ2luYSBsYSBwbGFuaW1ldHJpYSByaWNoaWVzdGEuPC9wPg0K"
},
"nome_categoria": "Catastali",
"nome_visura": "Elaborato Planimetrico",
"opzioni": null,
"prezzo_ricerca": 0,
"prezzo_visura": 8.9,
"ricerca": false,
"sincrona": false,
},
"success": true,
"message": "",
"error": null
}En validation, sont indiquées les données obligatoires pour compléter la demande avec succès. Dans le cas de l'élaboré, il est possible de passer différentes combinaisons de données en fonction des informations en possession.
Demander l'Élaboré Planimétrique
POST /richiesta
Dans le payload de la demande, nous devons passer toutes les informations et les documents indiqués précédemment.
{ "hash_visura": "3cbbb9c833f1c94af35494820cda3370", "json_visura": { "$0": xxxxxxxxxxx, "$1": xxxxxxxxxxx, "$2": xxxxxxxxxxx, "$3": xxxxxxxxxxx, "$4": xxxxxxxxxxx }EXEMPLE DE RÉPONSE
POST /richiesta
La réponse renvoie diverses informations, y compris l'état, si le callback est configuré, et l'ID de la demande qui sera nécessaire pour télécharger le document ultérieurement.
{ "data": { "_id": "5f2829ce065afc21cc60ad0e", "state": 1, "hash_visura": "99d9da7b8fbf8a60054a48217fc5d5a1", "nome": "Élaboré Planimétrique", "ricerca": false, "id_ricerca": null, "prezzo_visura": 12.7, "prezzo_ricerca": 0, "indice_ricerca": null, "stato_richiesta": "En cours de traitement", "email_target": null, "allegati": [], "timestamp_creation": 1596467662, "timestamp_last_update": 1596467663, "timestamp_stati": { "in_ricerca": 1596467663, "in_erogazione": 1596467663 }, "callback_data": false, "opzioni": null, "owner": "tester@openapi.com", "sincrona": false, "ricerche": [ { "id_ricerca": "5f2829ce065afc21cc60ad0e_0", "stato_ricerca": "Recherche effectuée", "json_ricerca": "{\"$1\":\"
12485671007
\"}", "json_mappato": {}, "json_risultato": null } ], "esito": { "codice": "0", "info": "OK" }Télécharger le Document
GET /documento/{_id}
Une fois que l'état de la demande est "effectuée", il est possible de télécharger le document via la méthode GET /documento/{_id}
EXEMPLE DE REQUÊTE
GET /documento/{_id}
Ceci est un exemple de demande en utilisant l'ID précédemment obtenu
https://visengine2.altravia.com/visure/documento/5f2829ce065afc21cc60ad0e EXEMPLE DE RÉPONSE
GET /documento/{_id}
La réponse contiendra le nom, la taille et le fichier.
{ data{ "nome":"5f22f5b5065afc21cc60a27a.zip", "dimensione"10206", "file":"++6+47433njVP9ZcX1XNtWUsKrTya9FGhwiXgdp5j5OPh0FpaKWVpjP8CUEjFjYzYwYTI3YS5wZGZVVAUAAwhDKF91eAsAAQQhAAAABCEAAABQSwUGAAAAAAEAAQBiAAAAZicAAAAA" }, "success": true, "message": "", "error": null }L'Élaboré Planimétrique est un document nécessaire dans certains contextes spécifiques, comme par exemple :
- pour certifier l'achèvement d'une nouvelle construction composée de deux ou plusieurs unités immobilières et zones communes
- pour certifier les travaux en cours pour la construction de nouvelles unités immobilières à l'intérieur d'un bâtiment
- pour certifier les éventuelles modifications de l'élaboré déjà présent dans les bureaux du Cadastre
Seuls les élaborés planimétriques déposés après 1990, année de création de l'Agence du Territoire, sont disponibles et ils ne sont pas disponibles pour les provinces de Trente et Bolzano.
Avez-vous besoin d'aide ?
Vous n'avez pas trouvé la réponse que vous cherchiez?
Remplissez tous les détails, nous vous contacterons dès que possible!
