Con il servizio Esponenti Attivi Azienda, a partire dell'inserimento del codice fiscale, dell'impresa è possibile ottenere:

• informazioni sull'azienda quali CCIAA, REA, natura giuridica, codice ateco, stato attività, sede legale
• informazioni sugli esponenti quali nominativo, codice fiscale, luogo e data di nascita, residenza, cariche

L'elenco Esponenti Attivi consente di ottenere il blocco esponenti per le Società di Capitali, con l'aggiunta delle quote per le Società di Persone.

Le informazioni sono disponibili in tempo reale tramite l’API di Openapi Visengine e possono essere scaricate 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}

Per verificare campi e costi per completare la richiesta bisogna utilizzare l'hash ottenuto nella precedente richiesta.

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

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": {
    "nome_visura": "Esponenti Attivi Azienda",
    "ricerca": false,
    "nome_categoria": "Camerali",
    "json_struttura": {
      "campi": {
        "$0": {
          "nome": "Codice Fiscale",
          "tipo": "codice_fiscale",
          "null": false,
          "istruzioni": "Inserire il Codice Fiscale dell`Azienda",
          "ordine": "1"
        }
      },
      "validazione": "$0  ",
      "istruzioni": "",
      "istruzioni_ricerca": ""
    },
    "hash_visura": "95cb552053977ca50c9e9b37532edd20",
    "prezzo_visura": 2.1,
    "prezzo_ricerca": 0,
    "sincrona": false,
    "opzioni": null,
    "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 il codice fiscale del soggetto.

ESEMPIO RICHIESTA POST /richiesta

{
    "hash_visura": "95cb552053977ca50c9e9b37532edd20",
    "json_visura": {
      "$1": 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": 95cb552053977ca50c9e9b37532edd20",
    "nome": "Esponenti Attivi Azienda ",
    "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}

Nel momento in cui lo stato della richiesta è "evasa" sarà possibile scaricare il documento tramite metodo GET /documento/{_id}

ESEMPIO RICHIESTA GET /documento/{_id}

Questo è un esempio di richiesta effettuata 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.