Inspection nationale des hypothèques

Openapi permet d'accéder via API et en temps réel à tous les principaux services de recherche en Conservatoire des registres immobiliers et au bureau de l'Agenzia del Territorio.

DEMANDE D'INSPECTION HYPOTHÉCAIRE NATIONALE

L'Inspection Hypothécaire Nationale permet de vérifier les hypothèques à l'échelle nationale et est disponible pour les personnes privées ainsi que pour les entreprises.

Le document inclut une liste des bureaux provinciaux des Conservatoires où figurent les formalités éventuelles enregistrées à la charge du sujet sur lequel la recherche a été effectuée. Dans l'Inspection Nationale sera indiqué le type de formalité enregistrée pour chaque Conservatoire (inscription, transcription, etc.).

Demander le Hash du document

GET /visure

Pour procéder à la demande d'Inspection Hypothécaire Nationale via l'API Visengine, il est d'abord nécessaire de localiser le hash qui identifie de manière unique chaque document ou dossier.

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

Cela est possible via l'endpoint GET /visure qui ne nécessite pas de paramètres et renverra la liste complète des documents et dossiers pouvant être demandés via Visengine et par hash.

Vérifier les données et les coûts de la demande d'Inspection Hypothécaire Nationale

GET /visure/{hash_visura}

Pour vérifier les informations, les documents nécessaires et les coûts de l'inspection nationale, il est nécessaire de faire une demande via l'endpoint GET /visure/{hash_visura} et de passer le hash de l'Inspection Hypothécaire Nationale obtenu précédemment.

EXEMPLE DE DEMANDE

GET /visure/{hash_visura}

Pour vérifier les champs et les coûts afin de compléter la demande, nous devons utiliser le hash que nous avons obtenu dans la demande précédente.

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

EXEMPLE DE RÉPONSE

GET /visure/{hash_visura}

La réponse indiquera toutes les informations nécessaires pour compléter la demande d'Inspection Hypothécaire Nationale, comme par exemple les champs obligatoires.

{
  "data": {
    "hash_visura": "5c7ac7018245b6262803f75d6aa58a90",
    "json_struttura": {
      "campi": {
        "$0": {
          "nome": "Code Fiscal Personne",
          "tipo": "code_fiscal_personne_physique",
          "null": true,
          "istruzioni": "Entrez le code fiscal de la personne pour laquelle vous demandez l'inspection hypothécaire"
        },
        "$1": {
          "nome": "Code Fiscal Entreprise",
          "tipo": "code_fiscal_personne_morale",
          "null": true,
          "istruzioni": "Entrez le code fiscal de l'entreprise pour laquelle vous demandez l'inspection hypothécaire",
          "ordine": "1"
        },
        "$2": {
          "nome": "Téléphone ou Email pour Être Recontacté en Cas de Problèmes*",
          "tipo": "texte",
          "null": false,
          "ordine": "2"
        }
      },
      "validazione": "($0 || $1) && $2",
    "nome_categoria": "Catastaux",
    "nome_visura": "Inspection Hypothécaire par Bien",
    "opzioni": null,
    "prezzo_ricerca": 0,
    "prezzo_visura": 12.7,
    "ricerca": false,
    "sincrona": false,
  },
  "success": true,
  "message": "",
  "error": null
}

En validation sont indiquées les données obligatoires pour compléter la demande avec succès.

Dans le cas de l'Inspection Hypothécaire Nationale, il est possible de passer différentes combinaisons de données en fonction des informations en votre possession.

Demander l'Inspection Hypothécaire Nationale

POST /richiesta

Dans le payload de la demande, nous devons passer toutes les informations et les documents indiqués précédemment.

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

    }

EXEMPLE DE RÉPONSE

POST /richiesta

La réponse renverra plusieurs informations, y compris l'état, si le callback est défini et l'ID de la demande qui nous sera nécessaire par la suite pour télécharger le document.

{ "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": "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}

Voici un exemple de demande en utilisant l'ID précédemment obtenu

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
  }

La recherche hypothécaire peut être demandée par toute personne, même si elle ne détient pas de droits réels sur les biens immobiliers.