€8.90 + TVA
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 Plan de Masse officiel d’un bien immobilier
Le Plan de Masse est un document délivré par l’Agence des Revenus et constitue une reproduction à l’échelle d’un bâtiment représentant le périmètre de l’immeuble, la subdivision des appartements à l’intérieur, les parties communes (cours, locaux de service, cage d’escalier et ascenseur, etc.), les espaces découverts privés et communs, etc.
Le plan de masse contient généralement les informations suivantes :
GET /documents
Pour demander le Plan de Masse avec Docuengine, il est d’abord nécessaire de vérifier tous les paramètres afin de compléter correctement la demande.
https://docuengine.openapi.com/documents
Ceci est possible via l’endpoint GET /documents qui ne nécessite aucun paramètre et renverra la liste complète des documents et démarches disponibles via Docuengine.
GET /documents
La réponse indiquera non seulement la liste mais aussi toutes les informations nécessaires pour compléter la demande de documents et les coûts correspondants disponibles via l’API Docuengine. Dans notre cas, seuls les données pour le Plan de Masse nous intéresseront :
{
"data": [
{
"requestStructure": {
"fields": {
"field0": {
"name": "province",
"nameIT": "provincia immobile",
"type": "cadastralProvince",
"required": true,
"options": null,
"help": "Inserire la provincia dove e' presente l'immobile"
},
"field1": {
"name": "municipality",
"nameIT": "comune immobile",
"type": "string",
"required": true,
"options": null,
"help": "Inserire il comune dove e' presente l'immobile"
},
"field2": {
"name": "section",
"nameIT": "sezione amministrativa",
"type": "string",
"required": false,
"options": null,
"help": "Inserire la sezione amministrativa"
},
"field3": {
"name": "cadastralSheet",
"nameIT": "foglio catastale",
"type": "cadastralSheet",
"required": true,
"options": null,
"help": "Inserire il foglio catastale dell'immobile"
},
"field4": {
"name": "cadastralParcel",
"nameIT": "particella catastale",
"type": "cadastralParcel",
"required": true,
"options": null,
"help": "Inserire la particella catastale dell'immobile"
},
"field5": {
"name": "cadastralSub",
"nameIT": "subalterno catastale",
"type": "cadastralSub",
"required": false,
"options": null,
"help": "Inserire il subalterno catastale dell'immobile"
}
},
"validation": "(field0 && field1 && field2 && field3 && field4 && field5) || (field0 && field1 && field3 && field4) || (field0 && field1 && field2 && field3 && field4) || (field0 && field1 && field3 && field4 && field5)",
"help": null,
"searchHelp": null
},
"category": "Catastali",
"name": "Elaborato Planimetrico",
"options": null,
"hasSearch": false,
"isSync": false,
"id": "68adca957a0be68c265a74b5",
"searchPrice": 0,
"documentPrice": 8.9,
"totalPrice": 8.9
}
],
"success": true,
"message": "",
"error": null
}
En validation, sont indiquées les données obligatoires pour compléter la demande avec succès.
Les données utiles pour la demande sont :
Pour demander le Plan de Masse, il est nécessaire d’effectuer une requête à l’endpoint POST /requests, en fournissant les données indiquées précédemment : Province, Commune, Feuille et Parcelle cadastrale du bien.
POST /requests
{
"documentId": "68adca957a0be68c265a74b5"
"search": {
"field0": "provincia immobile",
"field1": "comune immobile",
"field3": "foglio catastale",
"field4": "particella catastale"
}
}
POST /requests
La réponse renvoie diverses informations, notamment l’état, si le callback est défini, et l’ID de la demande qui sera nécessaire ultérieurement pour télécharger le document.
{
"documentId": "68adca957a0be68c265a74b5"
"search": {
"field0": "provincia immobile",
"field1": "comune immobile",
"field3": "foglio catastale",
"field4": "particella catastale"
},
"data": {}
},
"timestamps": {
"creation": 1724416377,
"WAIT": 1724416377,
"lastUpdate": 1724416393
},
"state": "WAIT",
"readableSearch": {},
"optionsPrice": 0,
"selectedOptions": null,
"notifyEmail": null,
"name": "Elaborato Planimetrico",
"hasSearch": false,
"searchPrice": 0,
"documentPrice": 8.9,
"totalPrice": 8.9,
"documents": null,
"resultId": null,
"results": null,
"id": "68adca957a0be68c265a74b5"
},
"success": true,
"message": "",
"error": null
}
PATCH /requests/{_id}
Par défaut, si le champ "STATE" n’est pas renseigné, la transaction est considérée comme immédiatement clôturée et votre demande sera traitée et exécutée. Si en revanche il est défini, la transaction est lancée mais reste ouverte, et vous pouvez alors mettre à jour la demande via l’endpoint PATCH /requests/{_id}.
Lorsque la demande est en état « exécuté », il est possible de télécharger le document au format PDF. L’endpoint qui permet de télécharger les documents générés par la demande est : GET /documents
La réponse indiquera le nom du fichier, la taille et l’URL de téléchargement du fichier.
{
data{
"fileName": "5f22f5b5065afc21cc60a27a_0.pdf",
"mimeType": application/pdf",
"fileSize": "34144",
"md5":" application/pdf",
"urlExpire": "1724505599",
"downloadUrl": "https://storage.googleapis.com/test-docuengine-openapi-com/documents/5f22f5b5065afc21cc60a27a_0.pdf",
},
"success": true,
"message": "",
"error": null
}
Le fichier PDF est fourni en format encodé base64.
Le Plan de Masse est un document nécessaire dans certains contextes spécifiques, par exemple :
Sont disponibles uniquement les plans de masse déposés après 1990, année de création de l’Agence du Territoire, 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!
Le service Document Planimétrique (en italien "elaborato planimetrico") permet d'accéder au document officiel disponible dans les archives numériques de l'Agence italienne des Revenus, à savoir le dessin à l'échelle (1:500 ou 1:200) d'un bâtiment. Il montre les limites du bâtiment, les unités immobilières qu'il comprend, les parties communes et les portions d'espaces extérieurs exclusifs ou communs, indiqués selon leur subdivision en sous-unités.
Le service Document Planimétrique est idéal pour ceux qui ont besoin d'accéder au document officiel pour identifier chaque unité immobilière à l'intérieur du bâtiment et vérifier le périmètre et la destination des parties communes.
Contrairement au plan cadastral, le Document Planimétrique peut être demandé par quiconque, même s'il n'est pas le propriétaire du bien ou un représentant autorisé.
Le service permet d'accéder au Document Planimétrique pour l'ensemble du territoire national, à l'exception des Provinces Autonomes de Trente et Bolzano, qui gèrent indépendamment leurs propres bases de données cadastrales et immobilières.
Oui, via les API d'Openapi, vous pouvez accéder à plus de 28 services dédiés au secteur immobilier :
Ces services sont disponibles via différentes API : Docuengine, Cadastre, Immobilier.
Le document est disponible dans un délai de 2 heures ouvrables.
Le coût du service est de 8,90 € avec un paiement prépayé.