Visuel des propriétaires PRA

La visure des propriétaires, également appelée nominative, PRA permet de connaître tous les véhicules, voitures, motos et remorques, appartenant à une personne physique ou morale (société, consortium, coopérative, association, organisme non commercial).

Le service prévoit la fourniture des données complètes pour un maximum de 20 véhicules. Au-delà de ce nombre, la liste des autres véhicules sera fournie uniquement avec les informations sur la plaque d'immatriculation et le type de véhicule.

Les informations contenues dans le document sont :

Certaines données comme le Modèle, le Numéro de châssis et la Cylindrée peuvent ne pas être disponibles dans tous les documents.

Comme indiqué, la visure des propriétaires est disponible pour les particuliers comme pour les entreprises et en fonction du type de demandeur, les données suivantes seront nécessaires pour faire la demande :

• Nom, Prénom et Code Fiscal pour les particuliers
• Raison Sociale et Numéro de TVA pour les entreprises

Demander le Hash du document

GET /visure

Pour procéder à la demande de la Visure des Propriétaires PRA 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 disponibles via Visengine et selon le hash.

Vérifier les données et les coûts de la demande de Visure des Propriétaires PRA

GET /visure/{hash_visura}

Pour vérifier les informations, les documents nécessaires et les coûts de la Visure des Propriétaires PRA, il est nécessaire de faire une demande via l'endpoint GET /visure/{hash_visura} en fournissant le hash de la Visure des Propriétaires PRA précédemment obtenu.

EXEMPLE DE REQUÊTE

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/89031e957e9cebc4f6e64948f2353727

EXEMPLE DE RÉPONSE

GET /visure/{hash_visura}

La réponse indiquera toutes les informations nécessaires pour compléter la demande, comme les champs obligatoires.

{
  "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.8,
        "ricerca": false,
        "sincrona": false,
  },
  "success": true,
  "message": "",
  "error": null
}

La validation indique les données obligatoires pour compléter la demande avec succès.

Demander la Visura Proprietari PRA

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
    }

EXEMPLE DE RÉPONSE

POST /richiesta

La réponse retourne plusieurs informations, dont l'état, si le callback est configuré, et l'ID de la demande, qui sera nécessaire par la suite pour télécharger le document.

{ "data":
    {
    "_id": "5f2829ce065afc21cc60ad0e",
    "state": 1,
    "hash_visura": "89031e957e9cebc4f6e64948f2353727",
    "nome": "Visura Proprietari PRA",
    "ricerca": false,
    "id_ricerca": null,
    "prezzo_visura": 16.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"
    }

Télécharger le Document

GET /documento/{_id}

Une fois que l'état de la demande est "réalisée", il est possible de télécharger le document via la méthode GET /documento/{_id}

EXEMPLE DE REQUÊTE

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
  }

Les délais de livraison de la visura Proprietari Pra sont de 5 jours ouvrables.