Taxe Automobile

La Taxe Automobile est le service qui permet d'accéder à l'état des droits de timbre déjà payés et des montants impayés ou en retard relatifs à une plaque et à un propriétaire donnés.

S'INSCRIRE GRATUITEMENT DOCUMENTATION

Livraison

En 3 jours ouvrables

API

Visengine

Disponible pour

La Taxe Automobile est un document obtenu à partir de la base de données en ligne du Registre Public Automobile (PRA) et fournit des informations concernant les taxes payées au fil des ans.

En particulier, les données disponibles dans la Taxe Automobile sont:

Date de Versement
Montant
Point de Service (ex. Numéro d'Agence ACI ou numéro de Tabac)
Date d'Expiration
Type de versement (ex. ordinaire)
État

Pour demander la Taxe Automobile, il est nécessaire de fournir la plaque d'immatriculation, le type de véhicule et la région.

Le document n'est pas disponible pour les catégories de véhicules suivantes car ils ne sont pas enregistrés dans la base de données du PRA: les cyclomoteurs (50cc), les véhicules agricoles et les plaques d'immatriculation anciennes (avec sigle de la province) immatriculées avant 1993.

Demander l'Hash du document

GET /visure

Pour procéder à la demande via l'API Visengine, il est d'abord nécessaire d'identifier l'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 respectant l'hash.

Vérifier les données et les coûts de la demande de Taxe Automobile

GET /visure/{hash_visura}

Pour vérifier les informations, les documents nécessaires et les coûts du Visura Bolli, il est nécessaire de faire une demande via l'endpoint GET /visure/{hash_visura} et de passer l'hash du Taxe Automobile précédemment obtenu.

EXEMPLE DE REQUÊTE

GET /visure/{hash_visura}

Pour vérifier les champs et les coûts pour compléter la requête, nous devrons utiliser l'hash que nous avons obtenu dans la demande précédente.

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

EXEMPLE DE RÉPONSE

GET /visure/{hash_visura}

La réponse indiquera toutes les informations nécessaires pour compléter la requête, telles que les champs obligatoires.

{ 
  "data": {
    "hash_visura": "2800b5f326a8f298761cde42da9f6c53",
    "json_struttura": {
      "campi": {
         ""$0": {
            "nome": "Targa veicolo",
            "tipo": "testo",
            "null": false,
            "istruzioni": "Inserire il numero di targa del veicolo"
            "ordine": "1",
          },
          "$1": {
            "nome": "Tipo veicolo",
            "tipo": "radio",
            "null": false,
            "opzioni": {
              "@A": "Autoveicolo",
              "M": "Motoveicolo",
              "AC": "Autocarro",
              "R": "Rimorchio"
            },
            "istruzioni": "Selezionare la tipologia del veicolo per il quale si richiede la visura",
            "ordine": "2"
          },
          "$2": {
            "nome": "Regione residenza",
            "tipo": "testo",
            "null": false,
            "istruzioni": "Inserire la regione di residenza del proprietario del veicolo",
            "ordine": "3"
          }
        "validazione": "$0 && $1 && $2",
        "istruzioni": "PHA+UGVyIG90dGVuZXJlIGxhIHZpc3VyYSBpbnNlcmlyZSB0dXR0aSBpIGRhdGkgcmljaGllc3RpPC9wPg0K",
        "istruzioni_ricerca": ""
       },
        "nome_categoria": "Patronato",
        "nome_visura": "Visura Bolli",
        "opzioni": [
            {
            "tipo": urgenza,
            "prezzo": 4,
            "nome": opzione_0
            }
        null,
        "prezzo_ricerca": 0,
        "prezzo_visura": 21.7,
        "ricerca": false,
        "sincrona": false,
  },
  "success": true,
  "message": "",
  "error": null
}

En validation, les données obligatoires pour compléter la requête avec succès sont indiquées.

Demander la Taxe Automobile

POST /richiesta

Dans le payload de la requête, nous devons passer 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 renvoie plusieurs informations, y compris l'état, si le callback est configuré et l'ID de la requête qui sera nécessaire ultérieurement pour télécharger le document.

{ "data": 
    {
    "_id": "5f2829ce065afc21cc60ad0e",
    "state": 1,
    "hash_visura": "2800b5f326a8f298761cde42da9f6c53",
    "nome": "Visura Bolli",
    "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 "evasa" (="évadé), il est possible de télécharger le document via la méthode GET /documento/{_id}

EXEMPLE DE REQUÊTE

GET /documento/{_id}

Ceci est 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 Taxe Automobile sont de 3 jours ouvrables.

Inscription

Avez-vous besoin d'aide ?

Vous n'avez pas trouvé la réponse que vous cherchiez?

Remplissez tous les détails, nous vous contacterons dès que possible!

Contactez-nous