€8.90 + VAT
Access the official Planimetric Elaborate of any Italian property via API
Openapi allows you to request, with delegation and via API, the official Planimetry of a property.
The Planimetry is a document issued by the Revenue Agency and is a scaled reproduction of a building depicting the perimeter of the building, the division of apartments inside it, common areas (courtyards, service rooms, stairwells and elevators, etc.), private and common open areas, etc.
The planimetry generally includes the following information:
GET /visure
To proceed with requesting the Planimetry through the Visengine API, it is first necessary to identify the hash that uniquely identifies each document or practice.
https://visengine2.altravia.com/visure/
This can be done through the endpoint GET /visure which does not require parameters and will return the complete list of documents and practices available through Visengine along with their hashes.
GET /visure/{hash_visura}
To verify the information, necessary documents, and costs of the Planimetry, you need to make a request through the endpoint GET /visure/{hash_visura} and provide the hash of the Planimetry previously obtained.
GET /visure/{hash_visura}
To check fields and costs for completing the request, you should use the hash obtained from the previous request.
https://visengine2.altravia.com/visure/99d9da7b8fbf8a60054a48217fc5d5a1
GET /visure/{hash_visura}
The response will provide all the necessary information to complete the request, such as required fields.
{
"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
}
In validation, the mandatory data required to successfully complete the request is indicated. In the case of the elaborato, it is possible to pass different combinations of data based on the information available.
POST /richiesta
In the payload of the request, we should pass all the previously indicated information and documents.
{
"hash_visura": "3cbbb9c833f1c94af35494820cda3370",
"json_visura": {
"$0": xxxxxxxxxxx,
"$1": xxxxxxxxxxx,
"$2": xxxxxxxxxxx,
"$3": xxxxxxxxxxx,
"$4": xxxxxxxxxxx
}
POST /richiesta
The response returns various pieces of information, including the status, whether the callback is set, and the request ID, which will be needed later to download the document.
{ "data":
{
"_id": "5f2829ce065afc21cc60ad0e",
"state": 1,
"hash_visura": "99d9da7b8fbf8a60054a48217fc5d5a1",
"nome": "Elaborato Planimetrico",
"ricerca": false,
"id_ricerca": null,
"prezzo_visura": 8.90,
"prezzo_ricerca": 0,
"indice_ricerca": null,
"stato_richiesta": "In process",
"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": "[email protected]",
"sincrona": false,
"ricerche": [
{
"id_ricerca": "5f2829ce065afc21cc60ad0e_0",
"stato_ricerca": "Search completed",
"json_ricerca": "{\"$1\":\12485671007\"}",
"json_mappato": {},
"json_risultato": null
}
],
"esito": {
"codice": "0",
"info": "OK"
}
GET /documento/{_id}
Once the request status is "completed", the document can be downloaded using the GET method /documento/{_id}
GET /documento/{_id}
This is an example of a request using the previously obtained ID
https://visengine2.altravia.com/visure/documento/5f2829ce065afc21cc60ad0e
GET /documento/{_id}
The response will contain the name, size, and file.
{
data{
"nome":"5f22f5b5065afc21cc60a27a.zip",
"dimensione"10206",
"file":"++6+47433njVP9ZcX1XNtWUsKrTya9FGhwiXgdp5j5OPh0FpaKWVpjP8CUEjFjYzYwYTI3YS5wZGZVVAUAAwhDKF91eAsAAQQhAAAABCEAAABQSwUGAAAAAAEAAQBiAAAAZicAAAAA"
},
"success": true,
"message": "",
"error": null
}
The Planimetric Document is necessary in certain specific contexts such as:
Only planimetric documents deposited after 1990, the year of establishment of the Agenzia del Territorio, are available, and they are not available for the provinces of Trento and Bolzano.
Do you need help?
Haven't found the answer you're looking for?
Fill in all the details, we will get back to you as soon as possible!
The Planimetric Document service (in Italian "elaborato planimetrico") provides access to the official document available in the digital archives of the Italian Revenue Agency, which is a scaled drawing (1:500 or 1:200) of a building. It shows the boundaries of the building, the individual units within it, the common areas, and portions of exclusive or common outdoor spaces, indicated according to their subdivision into subunits.
The Planimetric Document service is ideal for those who need to access the official document to identify each real estate unit within the building and verify the perimeter and purpose of the common areas.
Unlike the cadastral plan, the Planimetric Document can be requested by anyone, even if they are not the property owner or an authorized representative.
The service allows access to the Planimetric Document for the entire national territory, except for the Autonomous Provinces of Trento and Bolzano, which independently manage their own cadastral and real estate databases.
Yes, through Openapi’s APIs, you can access over 28 services dedicated to the real estate sector:
These services are available through different APIs: Docuengine, Cadastre, Real Estate.
The document is made available within 2 working hours.
The cost of the service is €8.90 with prepaid charge.