Ispezione Ipotecaria Nazionale

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

RICHIESTA ISPEZIONE IPOTECARIA NAZIONALE

L'Ispezione Ipotecaria Nazionale consente di effettuare una verifica delle ipoteche a livello nazionale ed è disponibile sia per persona privata che per azienda

>Il documento include una lista degli uffici provinciali delle Conservatorie dove risultano eventuali formalità iscritte a carico del soggetto su cui si è effettuata la ricerca. Nell'Ispezione Nazionale verrà indicato il tipo di formalità registrata per ogni Conservatoria (iscrizione, trascrizione, etc.).

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": 12.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": 12.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": "tester@openapi.com",
    "sincrona": false,
    "ricerche": [
      {
        "id_ricerca": "5f2829ce065afc21cc60ad0e_0",
        "stato_ricerca": "Ricerca evasa",
        "json_ricerca": "{\"$1\":\"12485671007\"}",
        "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.