Planimétrie Cadastrale
Accédez à la planimétrie cadastrale officielle de n'importe quelle propriété italienne via API.
Openapi permet de demander par délégation et via API le plan cadastral officiel d'un bien immobilier.
Le Plan Cadastral est un document délivré par l'Agence des Recettes et permet de vérifier la carte à l'échelle d'un bâtiment spécifique, notamment comment un bien est divisé en interne et la zone où il est situé. De plus, il est possible d'accéder à des informations telles que sa classification cadastrale, ses dimensions et le nombre d'étages dont il est composé.
Il est possible de demander le plan uniquement si la personne indiquée dans la demande est le titulaire du bien ou son délégué.
Demander l'Hash du document
GET /visure
Pour procéder à la demande de Plan Cadastral via l'API Visengine, il est d'abord nécessaire d'identifier l'hash qui identifie de manière unique chaque document ou dossier.
https://visengine2.altravia.com/visure/
Ceci est possible via l'endpoint GET /visure qui ne nécessite pas de paramètres et retournera la liste complète des documents et dossiers pouvant être demandés via Visengine et par rapport à l'hash.
Vérifier les données et les coûts de la demande de Plan Cadastral
GET /visure/{hash_visura}
Pour vérifier les informations, les documents nécessaires et les coûts du Plan, il est nécessaire de faire une demande via l'endpoint GET /visure/{hash_visura} et de fournir l'hash du Plan Cadastral obtenu précédemment.
EXEMPLE DE DEMANDE
GET /visure/{hash_visura}
Pour vérifier les champs et les coûts pour compléter la demande, nous devons utiliser l'hash que nous avons obtenu dans la demande précédente.
https://visengine2.altravia.com/visure/4ff728695eab3ab9eaa6f58b22cd5734EXEMPLE 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": "4ff728695eab3ab9eaa6f58b22cd5734",
"json_struttura": {
"campi": {
"$0": {
"nome": "Tipologia di Proprietario*",
"tipo": "radio",
"opzioni": {
"@P": "Privato",
"A": "Azienda"
},
"istruzioni": "Seleziona se l`immobile è intestato ad un privato o ad una azienda"
},
"$1": {
"nome": "Nome e Cognome o Ragione Sociale (se Azienda) dell`intestatario dell`immobile*",
"tipo": "denominazione",
"istruzioni": "Inserisci Nome e Cognome o Ragione Sociale (in caso di Azienda) del Proprietario dell`Immobile",
"ordine": "1"
},
"$2": {
"nome": "Codice Fiscale/ Partita IVA (se Azienda) dell`intestatario dell`Immobile*",
"tipo": "codice_fiscale",
"istruzioni": "Inserisci Codice Fiscale o Partita IVA (in caso di Azienda) del Proprietario dell`Immobile",
"ordine": "2"
},
"$3": {
"nome": "Provincia*",
"tipo": "cod_provincia",
"istruzioni": "Inserire Provincia dove è presente l`immobile",
"ordine": "5"
},
"$4": {
"nome": "Comune*",
"tipo": "cod_comune",
"istruzioni": "Inserire Comune dove è presente l`immobile",
"ordine": "6"
},
"$6": {
"nome": "Foglio*",
"tipo": "catastale_foglio",
"ordine": "7"
},
"$7": {
"nome": "Particellare/mappale*",
"tipo": "catastale_particella",
"ordine": "8"
},
"$8": {
"nome": "Sub",
"tipo": "catastale_sub",
"null": true,
"ordine": "9"
},
"$9": {
"nome": "Nome e Cognome del Rappresentante Legale dell`Impresa (obbligatorio in caso di immobile intestato ad azienda)",
"tipo": "denominazione",
"null": "1",
"istruzioni": "Inserire Nome e Cognome del Rappresentante Legale dell`azienda",
"ordine": "3"
},
"$10": {
"nome": "Codice fiscale del Rappresentante Legale dell`Impresa (obbligatorio in caso di immobile intestato ad azienda)",
"tipo": "codice_fiscale_persona_fisica",
"null": "1",
"istruzioni": "Inserire Codice Fiscale del Rappresentante Legale dell`Azienda",
"ordine": "4"
},
"$11": {
"nome": "Tipo documento",
"tipo": "radio",
"opzioni": {
"@CI": "Carta d`identità",
"PS": "Passaporto",
"PA": "Patente"
},
"null": "1",
"istruzioni": "Seleziona la tipologia del documento di identità",
"ordine": "11"
},
"$12": {
"nome": "Numero Identificativo Documento di Identità",
"tipo": "testo",
"null": "1",
"istruzioni": "Inserisci il numero identificativo del documento di identità",
"ordine": "12"
},
"$13": {
"nome": "Documento di Riconoscimento Proprietario *",
"tipo": "file",
"null": "0",
"istruzioni": "Allegare documento d`identità del proprietario o del legale rappresentante (in caso di azienda)",
"ordine": "13"
},
"$14": {
"nome": "Delega Obbligatoria Firmata da Proprietario*",
"tipo": "file",
"null": "0",
"istruzioni": "Scarica, compila e allega la delega firmata dal proprietario",
"ordine": "14"
}
},
"validazione": "($0 && $1 && $2 && $3 && $4 && $6 && $7 && $11 && $12 && $13 && $14) || ($0 && $1 && $2 && $3 && $4 && $6 && $7 && $9 && $10 && $11 && $12 && $13 && $14) || ($0 && $1 && $2 && $3 && $4 && $6 && $7 && $8 && $11 && $12 && $13 && $14) || ($0 && $1 && $2 && $3 && $4 && $6 && $7 && $8 && $9 && $10 && $11 && $12 && $13 && $14)",
"nome_categoria": "Catastali",
"nome_visura": "Planimetria Catastale",
"opzioni": null,
"prezzo_ricerca": 0,
"prezzo_visura": 6.9,
"ricerca": false,
"sincrona": false,
},
"success": true,
"message": "",
"error": null
}La validation indique les données obligatoires pour compléter la demande avec succès. Dans le cas du plan cadastral, il est possible de transmettre différentes combinaisons de données en fonction des informations disponibles.
Demander le plan cadastral
POST /richiesta
Dans le payload de la demande, nous devons transmettre 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,
"$6": xxxxxxxxxxx,
"$7": xxxxxxxxxxx,
"$11": xxxxxxxxxxx,
"$12": xxxxxxxxxxx,
"$13": xxxxxxxxxxx,
"$14": xxxxxxxxxxx
}EXEMPLE DE RÉPONSE
POST /richiesta
La réponse renvoie diverses informations, y compris l'état, si le callback est défini et l'ID de la demande dont nous aurons besoin ultérieurement pour télécharger le document.
{ "data":
{
"_id": "5f2829ce065afc21cc60ad0e",
"state": 1,
"hash_visura": "4ff728695eab3ab9eaa6f58b22cd5734",
"nome": "Plan Cadastral",
"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 DEMANDE
GET /documento/{_id}
Ceci est un exemple de demande en utilisant l'ID obtenu précédemment.
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
}Le plan cadastral est un document nécessaire dans certains contextes spécifiques comme l'évaluation d'un prêt hypothécaire, lors d'une vente ou d'une location, ou encore pour effectuer une donation ou une succession.
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!
