Il servizio Cariche Attive Persona permette di ottenere, a partire dell'inserimento del codice fiscale del soggetto:

• informazioni sulla persona quali nome, cognome, codice fiscale, data e luogo di nascita, residenza
• informazioni sull'azienda quali CCIAA, REA, natura giuridica, codice ATECO e stato attività
• informazioni sulle cariche quali codice, descrizione, data inizio, durata

I dati sono disponibili in tempo reale attraverso l’API di Openapi Visengine e possono essere scaricati in formato PDF, JSON o XML.

Ecco i passaggi per l’ottenimento del report.

1) Richiedere Hash Report (GET /visure)

Per la richiesta dei report con Visengine bisogna innanzitutto individuare l'hash che identifica univocamente ogni documento o pratica.

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

Ciò è possibile attraverso l'endpoint GET /visure che non necessita di parametri e restituirà l'elenco completo dei documenti e pratiche richiedibili tramite Visengine e rispetto hash.

2) Verificare dati e costi richiesta Report (GET /visure/{hash_visura})

Se si vuole fare una verifica delle informazioni, dei documenti necessari e dei costi del report bisogna effettuare una richiesta tramite l'endpoint GET /visure/{hash_visura} e passare l'hash del report ottenuto precedentemente.

ESEMPIO RICHIESTA GET /visure/{hash_visura}

Al fine di verificare campi e costi per completare la richiesta è necessario utilizzare l'hash ottenuto nella precedente richiesta.

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

ESEMPIO RISPOSTA GET /visure/{hash_visura}

Nella risposta saranno indicate tutte le informazioni necessarie per completare la richiesta, come ad esempio i campi obbligatori.

{
  "data": {
    "hash_visura": "f3a0979f15915b337aafabcd89c5ee70",
    "json_struttura": {
      "campi": {
        "$0": {
          "nome": "Codice Fiscale",
          "tipo": "codice_fiscale_persona_fisica",
          "null": false,
          "istruzioni": "Inserire il Codice Fiscale dell`Azienda",
        }
      },
      "validazione": "$0",
      "istruzioni": "",
      "istruzioni_ricerca": ""
    },
    "nome_categoria": "Camerali",
    "nome_visura": "Cariche Attive Persona",
    "prezzo_visura": 2.1,
    "prezzo_ricerca": 0,
    "ricerca": false,
    "sincrona": false,
    "fornitori": []
  },
  "success": true,
  "message": "",
  "error": null
}

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

3) Richiedere Report POST /richiesta

Per effettuare la richiesta del report viene passato come valoreil codice fiscale del soggetto.

ESEMPIO RICHIESTA POST /richiesta

{
    "hash_visura": "f3a0979f15915b337aafabcd89c5ee70",
    "json_visura": {
      "$0": 12485671007
      }
  }

ESEMPIO RISPOSTA POST /richiesta

La risposta restituisce diverse informazioni tra cui lo stato, la callback (se impostata) e l'ID della richiesta che ci servirà successivamente per scaricare il documento.

{ "data": 
    {
      "_id": "5f2829ce065afc21cc60ad0e",
    "state": 1,
    "hash_visura": "f3a0979f15915b337aafabcd89c5ee70",
    "nome": "Cariche Attive Persona",
    "ricerca": false,
    "id_ricerca": null,
    "prezzo_visura": 2.1,
    "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": "{\"$1\":\"12485671007\"}",
        "json_mappato": {
          "NRea": "1378273",
          "Cciaa": "RM"
        },
        "json_risultato": null
      }
    ],
    "esito": {
      "codice": "0",
      "info": "OK"
    }

4) Scaricare Report GET /documento/{_id}

Quando lo stato della richiesta è "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
  }

Il documento da scaricare è disponibile all'interno di uno zip, contenente il file in PDF, JSON o XML.