Visura Proprietari PRA - Italia

La visura proprietari, o denominata anche nominativa, PRA permette di conoscere tutti i veicoli, auto, moto e rimorchi, di proprietà di una persona fisica o di persona giuridica (società, consorzio, cooperativa, associazione, ente non commerciale).

La visura proprietari include l'elenco veicoli intestati con informazioni quali Provincia di Competenza, Serie Targa, Codice Ruolo, Descrizione Ruolo, Data Riferimento Ruolo, Formalità (Data e descrizione), Dati Tecnici (telaio, Targa, Classe, Data prima immatricolazione).

Il servizio prevede la consegna dei dati completi fino ad un numero massimo di 20 veicoli. Oltre quel numero verrà consegnato l'elenco degli altri veicoli solo con il dato targa e tipologia del veicolo.

Le informazioni presenti nel documento sono :

Alcuni dati come Modello, Telaio e Cilindrata potrebbero non essere disponibili in tutti i documenti

Come anticipato la visura proprietari è disponibile sia per privati che per imprese ed in base alla tipogia di soggetto saranno necessarie per effettuare la richiesta i seguenti dati:

• Nome, Cognome e Codice Fiscale per privati
• Denominazione Sociale e Partita IVA per impresa

Richiedere Hash documento

GET /visure

Per procedere alla richiesta della Visura Proprietari PRA 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 Visura Proprietari PRA

GET /visure/{hash_visura}

Per verificare le informazioni, i documenti necessari ed i costi della Visura Proprietari PRA è necessario effettuare una richiesta tramite l'endpoint GET /visure/{hash_visura} e passare l'hash della Visura Proprietari PRA 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/89031e957e9cebc4f6e64948f2353727

ESEMPIO RISPOSTA

GET /visure/{hash_visura}

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

{ 
  "data": {
    "hash_visura": "89031e957e9cebc4f6e64948f2353727",
    "json_struttura": {
      "campi": {
         ""$0": {
            "nome": "Nome e Cognome o Denominazione Azienda",
            "tipo": "denominazione",
            "null": false,
            "opzioni": null,
            "istruzioni": "Selezionare la tipologia del veicolo per il quale si richiede la visura"
          },
          "$1": {
            "nome": "Codice Fiscale / Partita IVA",
            "tipo": "codice_fiscale",
            "null": false,
            "istruzioni": "Inserire il Codice Fiscale o la Partita IVA del soggetto"
          }
        },
        "validazione": "$0 && $1",
        "istruzioni": "PHA+UGVyIG90dGVuZXJlIGxhIHZpc3VyYSBjb21waWxhcmUgdHV0dGkgaSBkYXRpIHJpY2hpZXN0aTwvcD4NCg==",
        "istruzioni_ricerca": ""
       },
        "nome_categoria": "Patronato",
        "nome_visura": "Visura Proprietari PRA",
        "opzioni": [
            {
            "tipo": urgenza,
            "prezzo": 4,
            "nome": opzione_0
            }
        null,
        "prezzo_ricerca": 0,
        "prezzo_visura": 29.9,
        "ricerca": false,
        "sincrona": false,
  },
  "success": true,
  "message": "",
  "error": null
}

In validazione sono indicati i dati obbligatori per completare la richiesta con successo.

Richiedere la Visura Proprietari PRA

POST /richiesta

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

{
      "hash_visura": "3cbbb9c833f1c94af35494820cda3370",
      "json_visura": {
        "$0": xxxxxxxxxxx,
        "$1": 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": "89031e957e9cebc4f6e64948f2353727",
    "nome": "Visura Proprietari PRA",
    "ricerca": false,
    "id_ricerca": null,
    "prezzo_visura": 29.9,
    "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
  }

I tempi di consegna della visura Proprietari Pra sono 5 giorni lavorativi.