Ispezione Ipotecaria Nazionale - Italia

Openapi consente di accedere a tutti i principali servizi di ricerca in Conservatoria dei registri immobiliari e dell'ufficio dell'Agenzia del Territorio, tramite API ed in tempo reale:

L'Ispezione Ipotecaria Nazionale in particolare consente di effettuare una verifica delle ipoteche a livello nazionale (ad eccezione di quelle delle Province autonome di Trieste, Trento e Bolzano, per le quali vige il Catasto Tavolare)  ed ottenere l'elenco di tutti gli uffici provinciali della Conservatoria dove sono registrate formalità a carico di un determinato soggetto. 

Nel documento verrà indicato la conservatoria ed il tipo di formalità registrata per ogni Conservatoria (iscrizione, trascrizione, etc.).  L'ispezione può essere richiesta sia per persona privata che per azienda.

RICHIESTA ISPEZIONE IPOTECARIA NAZIONALE

Richiedere Hash documento

GET /visure

Per procedere alla richiesta di Ispezione Ipotecaria Nazionale tramite l'API Visengine prima di tutto è necessario individuare l'hash che identifica univocamente ogni documento o pratica.

https://visengine2.altravia.com/visure/

Questo è possibile tramite l'endpoint GET /visure che non necessita di parametri e restituirà l'elenco completo dei documenti e pratiche richiedibili tramite Visengine e rispetto hash.

Verificare dati e costi richiesta Ispezione Ipotecaria Nazionale

GET /visure/{hash_visura}

Per verificare le informazioni, i documenti necessari ed i costi del documento è necessario effettuare una richiesta tramite l'endpoint GET /visure/{hash_visura} e passare l'hash della Ispezione Ipotecaria Nazionale precedentemente ottenuta.

ESEMPIO RICHIESTA

GET /visure/{hash_visura}

Per verificare campi e costi per completare la richiesta dovremmo utilizzare l'hash che abbiamo ottenuto nella richiesta precedente.

https://visengine2.altravia.com/visure/5c7ac7018245b6262803f75d6aa58a90

ESEMPIO RISPOSTA

GET /visure/{hash_visura}

La risposta indicherà tutti le informazioni necessarie per completare la richiesta di Ispezione Ipotecaria Nazionale come ad esempio i campi obbligatori.

{ 
  "data": {
    "hash_visura": "5c7ac7018245b6262803f75d6aa58a90",
    "json_struttura": {
      "campi": {
        "$0": {
          "nome": "Codice Fiscale Persona","
          "tipo": "codice_fiscale_persona_fisica",
          "null": true,
          "istruzioni": "Inserisci il codice fiscale del privato per cui stai richiedendo la visura ipocatastale"
        },
        "$1": {
          "nome": "Codice Fiscale Azienda",
          "tipo": "codice_fiscale_persona_giuridica",
          "null": true,
          "istruzioni": "Inserisci il codice fiscale dell`azienda per cui stai richiedendo la visura ipocatastale",
          "ordine": "1"
        },
        "$2": {
          "nome": "Telefono o Email per Essere Ricontattati in Caso di Problemi*",
          "tipo": "testo",
          "null": false,
          "ordine": "2"
        }
      },
      "validazione": "($0 || $1) && $2",
    "nome_categoria": "Catastali",
    "nome_visura": "Visura Ipocatastale per Immobile",
    "opzioni": null,
    "prezzo_ricerca": 0,
    "prezzo_visura": 23.7,
    "ricerca": false,
    "sincrona": false,
  },
  "success": true,
  "message": "",
  "error": null
}

In validazione sono indicati i dati obbligatori per completare la richiesta con successo. Nel caso dell'Ispezione Ipotecaria Nazionale è possibile passare combinazioni di dati differenti in base alle informazioni in possesso.

Richiedere l'Ispezione Ipotecaria Nazionale

POST /richiesta

Nel payload della richiesta dovremmo passare tutte le informazioni ed i documenti indicati precedentemente.

{
      "hash_visura": "3cbbb9c833f1c94af35494820cda3370",
      "json_visura": {
        "$0": xxxxxxxxxxx,
        "$2": xxxxxxxxxxx
    }

ESEMPIO RISPOSTA

POST /richiesta

La risposta restituisce diverse informazioni tra cui lo stato, se impostata la callback e l'ID della richiesta che ci servirà successivamente per scaricare il documento.

{ "data": 
    {
    "_id": "5f2829ce065afc21cc60ad0e",
    "state": 1,
    "hash_visura": "5c7ac7018245b6262803f75d6aa58a90",
    "nome": "Visura Ipocatastale Nazionale Agenzia Entrate",
    "ricerca": false,
    "id_ricerca": null,
    "prezzo_visura": 23.7,
    "prezzo_ricerca": 0,
    "indice_ricerca": null,
    "stato_richiesta": "In erogazione",
    "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": "Ricerca evasa",
        "json_ricerca": "{}",
        "json_mappato": {},
        "json_risultato": null
      }
    ],
    "esito": {
      "codice": "0",
      "info": "OK"
    }

Scaricare Documento

GET /documento/{_id}

Una volta che lo stato della richiesta è in stato "evasa" è possibile scaricare il documento tramite metodo GET /documento/{_id}

ESEMPIO RICHIESTA

GET /documento/{_id}

Questo è un esempio di richiesta utilizzando l'ID precedentemente ottenuto

https://visengine2.altravia.com/visure/documento/5f2829ce065afc21cc60ad0e

ESEMPIO RISPOSTA

GET /documento/{_id}

La risposta conterrà il nome, la dimensione e il file.

{
  data{
    "nome":"5f22f5b5065afc21cc60a27a.zip",
    "dimensione"10206",
    "file":"++6+47433njVP9ZcX1XNtWUsKrTya9FGhwiXgdp5j5OPh0FpaKWVpjP8CUEjFjYzYwYTI3YS5wZGZVVAUAAwhDKF91eAsAAQQhAAAABCEAAABQSwUGAAAAAAEAAQBiAAAAZicAAAAA"
    },
    "success": true,
    "message": "",
    "error": null
  }

La visura ipocatastale può essere richiesta da qualsiasi persona, anche se non detentrice dei diritti reali sugli immobili.