Report Quote Attive Persona - Italia

Il Report Quote Attive in Società permette di verificare se una persona fisica detenga partecipazioni o quote in una o più società (ad esclusione di quelle quotate in borsa). In caso affermativo, per ciascuna società individuata viene indicata la percentuale di proprietà e il dettaglio completo di ogni singola partecipazione.  Il report è disponibile in tempo reale ed in formato PDF, JSON o XML. 

La partecipazione societaria, secondo quanto previsto dalla legge, si definisce come la quota di capitale sociale detenuta da un soggetto economico. Tale quota può essere rappresentata da azioni (nelle S.p.A. e S.a.p.A.) o da quote (nelle S.r.l.).

Con il servizio Report Quote Attive Persona è possibile avere, a partire dal codice fiscale del soggetto, le seguenti informazioni:

NOTA BENE: Questo report riporta solo le quote in società di capitali, non sono disponibili informazioni su aziende quotate in borsa

Ecco i passaggi per l’ottenimento del report.

RICHIESTA REPORT QUOTE ATTIVE

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.

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 certificato precedentemente ottenuto.

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/367ff20236e836d81470f00ba1d9f703

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": "Quote Attive Persona",
    "ricerca": false,
    "nome_categoria": "Camerali",
    "json_struttura": {
      "campi": {
        "$0": {
          "nome": "Codice Fiscale",
          "tipo": "codice_fiscale_persona_fisica",
          "null": false,
          "istruzioni": "Inserire il codice fiscale della persona fisica",
        }
      },
      "validazione": "$0  ",
      "istruzioni": "",
      "istruzioni_ricerca": ""
    },
    "hash_visura": "367ff20236e836d81470f00ba1d9f703",
    "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.

Richiedere Report

POST /richiesta

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

ESEMPIO RICHIESTA

POST /richiesta

{
    "hash_visura": "367ff20236e836d81470f00ba1d9f703",
    "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": "367ff20236e836d81470f00ba1d9f703",
    "nome": "Quote 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"
    }

Scaricare Report

GET/documento/{_id}

Nel momento in cui lo stato della richiesta è "evasa" sarà possibile scaricare i dati in JSON, PDF e XML 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
  }

Tutti i formati (JSON, PDF, XML) saranno disponibili all'interno di uno zip.