Report Soci Attivi Azienda

Home

Business Information

Report Soci Attivi Azienda

: Immediata
a partire da € 2,10 + iva

Tutte le informazioni sui soci attivi di un’azienda in tempo reale tramite API.

Ottieni i dati sui singoli soci di un’azienda come nominativo e residenza, a partire dal codice fiscale, partita IVA o ID dell'azienda.

Vai alla Documentazione

Il servizio Soci Attivi Azienda permette di ottenere, a partire da un'unico parametro (codice fiscale, partita IVA o ID) dell'impresa:

informazioni sull'azienda quali CCIAA, REA, natura giuridica, codice ateco, stato attività, sede legale, capitale sociale
informazioni sui singoli soci quali nominativo, codice fiscale, luogo e data di nascita, residenza, quote

Su Openapi è possibile richiedere i Report Soci attraverso 2 API differenti:
1) Visure Camerali
2) Visengine

RICHIESTA REPORT SOCI ATTIVI CON API VISURE CAMERALI

Il vantaggio di utilizzare l'API Visure Camerali è che permette di effettuare richieste dirette. Non sono necessarie ulteriori richieste per ottenere hash o parametri.

1) Richiedere report POST /soci-attivi

Con un'unica richiesta ad esempio all'endpoint POST /soci-attivi sarà possibile completare la richiesta del report, a partire da uno dei seguenti dati:

Partita IVA / Codice Fiscale dell'Azienda
ID azienda

ESEMPIO DI RICHIESTA POST /soci-attivi

Nel nostro caso abbiamo scelto di passare nel body della richiesta il codice fiscale

{
  "cf_piva_id":"12485671007",
  "callback": {
    "url":"https://www.your_url.it/callback", 
    "method":"POST",
    "field":"data" 
  }
}

L'ID azienda è ottenibile tramite i due servizi di ricerca commerciale a partire dal nome (o da alcuni criteri come codice ateco e fatturato) oppure dalla partita IVA / codice fiscale. Si può anche scegliere di impostare una callback per essere aggiornati su quando il documento è disponibile, senza dover chiamare l'endpoint GET /soci-attivi/{id} per verificarne lo stato.

ESEMPIO RISPOSTA POST /soci-attivi

Nella risposta viene restituito lo stato, il timestamp della richiesta, eventuale url callback impostata e l'id della richiesta che sarà necessario per le prossime richieste e per ottenere i dati.

{
    "data": {
      "cf_piva_id": "12485671007",
      "tipo": "soci-attivi",
      "stato_richiesta": "In erogazione",
      "timestamp_creation": 1703852089,
      "timestamp_last_update": 1703852236,
      "allegati": [
      "65671d1c207bbf56a50aa122.pdf"
      ],
      "callback": {
        "url": "https://www.your_url.it/callback",
        "method": "POST",
        "field": "data",
        "data": {}
      },
      "owner": "[email protected]",
      "id": "658eb839e5a329399f6bffb2"
    },
    "success": true,
    "message": "",
    "error":  
  }

2) Verificare lo stato della richiesta GET /soci-attivi/{id}

È possibile verificare lo stato di una richiesta di Soci Attivi tramite l'endpoint GET /soci-attivi/{id}. Come indicato anche precedente suggeriamo di impostare in fase di richiesta la callback per essere aggiornati quando il documento è disponibile e può essere scaricato.

ESEMPIO RICHIESTA GET /soci-attivi/{id}

L'id è quello ottenuto e disponibile nella risposta dopo la richiesta all'endpoint POST /soci-attivi:

https://visurecamerali.openapi.it/soci-attivi/{id}/allegati

ESEMPIO RISPOSTA GET /soci-attivi/{id}

La risposta include tutti i dati indicati precedentemente sull'azienda e sui soci con il timestamp della richiesta e dell'ultimo aggiornamento, eventuale url di callback.

{
    "data": {
      "cf_piva_id": "12485671007",
      "tipo": "soci-attivi",
      "stato_richiesta": "In erogazione",
      "timestamp_creation": 1703852089,
      "timestamp_last_update": 1703852236,
      "allegati": [
      "65671d1c207bbf56a50aa122.pdf"
      "cf_piva_id": "12485671007",
      "json_soci": {
        "azienda": {
          "cciaa": "RM",
          "numero_rea": "1378273",
          "denominazione": "OPENAPI S.R.L.",
          "codice_fiscale": "12485671007",
          "partita_iva": "12485671007",
          "codice_natura_giuridica": "SR",
          "natura_giuridica": "SOCIETA' A RESPONSABILITA' LIMITATA",
          "indirizzo": {
            "codice_toponimo": "VLE",
            "toponimo": "VIALE",
            "denominazione": "F TOMMASO MARINETTI",
            "civico": "221",
            "cap": "00143",
            "codice_comune": "RM091",
            "codice_comune_istat": "H501",
            "comune": "ROMA",
            "frazione": null,
            "provincia": "RM",
            "nazione": "ITALIA"
          },
          "codice_ateco": [
            {
              "codice_ateco": "6201",
              "ateco": "Produzione di software non connesso all'edizione"
            }
          ],
          "stato_attivita": "ATTIVA",
          "data_inizio_attivita": "2013-10-20",
          "data_cessazione_attivita": null,
          "capitale_sociale": null,
          "presenza_diritti_non_determinati": null,
          "quota_diritti_non_determinati": null,
          "quote": []
        },
        "soci": [
          {
            "denominazione": "SCXXXXX XXXA",
            "persona_fisica": true,
            "codice_fiscale": "SCRXXXXXH501H",
            "data_nascita": "1973-10-02",
            "provincia_nascita": "RM",
            "comune_nascita": "ROMA",
            "codice_comune_nascita": "RM091",
            "codice_istat_comune_nascita": "H501",
            "stato_nascita": "ITALIA",
            "sesso": "MASCHILE",
            "quote": [
              {
                "data_atto": "2021-09-10",
                "data_deposito": "2021-09-15",
                "data_protocollo": "2021-09-15",
                "codice_tipo_diritto": "01",
                "descrizione_tipo_diritto": "PROPRIETA'",
                "diritto_reale": true,
                "numero_azioni_possedute": null,
                "codice_tipo_azioni": null,
                "descrizione_tipo_azioni": null,
                "valore_quota": 30000,
                "percentuale_possesso": 60,
                "quota_non_determinata": false
              }
            ],
            "altre_aziende_con_quote": null,
            "cognome": "SCXXXXX",
            "nome": "XXXA"
          },
          {
            "denominazione": "XXXXIA SXXN",
            "persona_fisica": true,
            "codice_fiscale": "DLCXXXXX9Z114J",
            "data_nascita": "1977-11-29",
            "provincia_nascita": null,
            "comune_nascita": null,
            "codice_comune_nascita": null,
            "codice_istat_comune_nascita": "Z114",
            "stato_nascita": "REGNO UNITO",
            "sesso": "MASCHILE",
            "quote": [
              {
                "data_atto": "2021-09-10",
                "data_deposito": "2021-09-15",
                "data_protocollo": "2021-09-15",
                "codice_tipo_diritto": "01",
                "descrizione_tipo_diritto": "PROPRIETA'",
                "diritto_reale": true,
                "numero_azioni_possedute": null,
                "codice_tipo_azioni": null,
                "descrizione_tipo_azioni": null,
                "valore_quota": 10000,
                "percentuale_possesso": 20,
                "quota_non_determinata": false
              }
            ],
            "altre_aziende_con_quote": null,
            "cognome": "XXXXIA",
            "nome": "SXXN"
          },
          {
            "denominazione": "DXXXS SXXXE",
            "persona_fisica": true,
            "codice_fiscale": "DSNXXXXX117F",
            "data_nascita": "1980-08-11",
            "provincia_nascita": "TR",
            "comune_nascita": "TERNI",
            "codice_comune_nascita": "TR032",
            "codice_istat_comune_nascita": "L117",
            "stato_nascita": "ITALIA",
            "sesso": "MASCHILE",
            "quote": [
              {
                "data_atto": "2021-09-10",
                "data_deposito": "2021-09-15",
                "data_protocollo": "2021-09-15",
                "codice_tipo_diritto": "01",
                "descrizione_tipo_diritto": "PROPRIETA'",
                "diritto_reale": true,
                "numero_azioni_possedute": null,
                "codice_tipo_azioni": null,
                "descrizione_tipo_azioni": null,
                "valore_quota": 10000,
                "percentuale_possesso": 20,
                "quota_non_determinata": false
              }
            ],
            "altre_aziende_con_quote": null,
            "cognome": "DXXXS",
            "nome": "SXXXE"
          }
        ]
      },
      "tipo": "soci-attivi",
      "stato_richiesta": "Visura evasa",
      "timestamp_creation": 1700582150,
      "timestamp_last_update": 1700607890,
      "allegati": [
        "658eb8397e995e5d3602df7a.xml",
        "658eb8397e995e5d3602df7a.pdf",
        "658eb8397e995e5d3602df7a.json"
      ],
      "callback": {
        "url": "https://www.your_url.it/callback",
        "method": "POST",
        "field": "data",
        "data": {}
      },
      "owner": "[email protected]",
      "id": "658eb839e5a329399f6bffb2"
    },

3) Scaricare Report Soci Attivi GET /soci-attivi/{id}/allegati

E' inoltre possibile ottenere tutti i dati anche in formati XML e PDF tramite l'endpoint GET /soci-attivi/{id}/allegati

ESEMPIO RICHIESTA GET /soci-attivi/{id}/allegati

La richiesta dovrà essere effettuata con l'id ottenuto nella risposta dell'endpoint POST /soci-attivi.

https://visurecamerali.openapi.it/soci-attivi/5f2829ce065afc21cc60ad0e/allegati/

ESEMPIO RISPOSTA GET /soci-attivi/{id}/allegati

La risposta indicherà nome del file, dimensione e file.

{ "data": 
    {
    "nome": "6564a673ccfa313352066377.zip",
    "dimensione": 1728,
    "file": "UEsDBBQAAAAlNnVTBs6lJ1vIIAJthCQAcABwANjI2OTFjNGY5N2UwOTQ0NzU0MDI3ADU/HOUbc+WLQqnnTtt27Zt27Zt25k7bdu2bdvcadv5fnXOqapz655qt9p93x/vW62tFjHnGmv2HiMiZvQxY7RJIi8sSsNAywxFcnA4uwjFgE+Pb2doCcXNTSdqYe1s4kgnam3gbCJsYmRnbEInbWJr5"
      }

RICHIESTA REPORT SOCI ATTIVI CON API VISENGINE

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 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/fab482bf67a418f00d596b7296750a9a

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": "Soci 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": "70a1b5d29d8efaae6ef9616841fd6f72",
    "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": "70a1b5d29d8efaae6ef9616841fd6f72",
    "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": "70a1b5d29d8efaae6ef9616841fd6f72",
    "nome": "Soci Attivi ",
    "ricerca": false,
    "id_ricerca": null,
    "prezzo_visura": 2.3,
    "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 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.

Le nostre tariffe

Listino prezzi a chiamata

Report Soci Attivi Azienda € 2,10 + iva
Registrati gratis