Home ProduitsRapport Membres Actifs

EXEMPLE DE DOCUMENT

Rapport Membres Actifs

Name: Rapport Membres Actifs
Brand: Openapi
SKU: Da definire
Price: 10000 EUR
Availability: InStock

EXEMPLE DE DOCUMENT

Obtenez les données des membres individuels d'une entreprise, telles que le nom et la résidence, à partir du code fiscal, du numéro de TVA ou de l'ID de l'entreprise.

S'INSCRIRE GRATUITEMENT DOCUMENTATION

Livraison

En temps réel

API

Visengine

Disponible pour

Le service Soci Attivi Azienda permet de récupérer, à partir d'un seul paramètre (code fiscal, numéro de TVA ou ID) de l'entreprise :

informations sur l'entreprise telles que CCIAA, REA, nature juridique, code APE, état de l'activité, siège social, capital social
informations sur les associés individuels telles que nom, code fiscal, lieu et date de naissance, résidence, parts sociales

Sur Openapi, il est possible de demander les rapports sur les associés via 2 API différentes :

Visure Camerali
Visengine

DEMANDE DE RAPPORT D'ASSOCIÉS ACTIFS AVEC L'API VISURE CAMERALI

L'avantage d'utiliser l'API Visure Camerali est qu'elle permet de faire des demandes directes. Aucune autre demande n'est nécessaire pour obtenir un hash ou des paramètres.

Demander un rapport

POST /soci-attivi

Avec une seule demande, par exemple à l'endpoint POST /soci-attivi, il est possible de compléter la demande de rapport, à partir de l'une des données suivantes :

Numéro de TVA / Code Fiscal de l'Entreprise
ID de l'entreprise

EXEMPLE DE DEMANDE

POST /soci-attivi

Dans notre cas, nous avons choisi de passer dans le corps de la demande le code fiscal

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

L'ID de l'entreprise peut être obtenu via les deux services de recherche commerciale à partir du nom (ou de certains critères tels que le code APE et le chiffre d'affaires) ou du numéro de TVA / code fiscal. Vous pouvez également choisir de définir un callback pour être informé lorsque le document est disponible, sans avoir à appeler l'endpoint GET/soci-attivi/{id} pour vérifier son statut.

EXEMPLE DE RÉPONSE

POST /soci-attivi

La réponse renvoie l'état, le timestamp de la demande, l'éventuelle URL de callback définie et l'ID de la demande qui sera nécessaire pour les prochaines demandes et pour obtenir les données.

{
    "data": {
      "cf_piva_id": "12485671007",
      "tipo": "soci-attivi",
      "stato_richiesta": "En cours",
      "timestamp_creation": 1703852089,
      "timestamp_last_update": 1703852236,
      "allegati": [
      "65671d1c207bbf56a50aa122.pdf"
      ],
      "callback": {
        "url": "https://www.your_url.fr/callback",
        "method": "POST",
        "field": "data",
        "data": {}
      },
      "owner": "gcloud-tests@openapi.fr",
      "id": "658eb839e5a329399f6bffb2"
    },
    "success": true,
    "message": "",
    "error":  
  }

Vérifier l'état de la demande

GET/soci-attivi/{id}

Il est possible de vérifier l'état d'une demande d'Associés Actifs via l'endpoint GET/soci-attivi/{id}. Comme indiqué précédemment, nous suggérons de définir un callback lors de la demande pour être informé lorsque le document est disponible et peut être téléchargé.

EXEMPLE DE DEMANDE

GET/soci-attivi/{id}

L'identifiant est celui obtenu et disponible dans la réponse après la demande à l'endpoint POST /soci-attivi :

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

EXEMPLE DE RÉPONSE

GET/soci-attivi/{id}

La réponse inclut toutes les données précédemment indiquées sur l'entreprise et les associés, avec le timestamp de la demande et de la dernière mise à jour, et une éventuelle URL de callback.

{
    "data": {
      "cf_piva_id": "12485671007",
      "tipo": "soci-attivi",
      "stato_richiesta": "En cours de traitement",
      "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": "SOCIETE À RESPONSABILITÉ LIMITÉE",
          "indirizzo": {
            "codice_toponimo": "VLE",
            "toponimo": "VIALE",
            "denominazione": "F TOMMASO MARINETTI",
            "civico": "221",
            "cap": "00143",
            "codice_comune": "RM091",
            "codice_comune_istat": "H501",
            "comune": "ROME",
            "frazione": null,
            "provincia": "RM",
            "nazione": "ITALIE"
          },
          "codice_ateco": [
            {
              "codice_ateco": "6201",
              "ateco": "Production de logiciels non liés à l'édition"
            }
          ],
          "stato_attivita": "ACTIVE",
          "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": "ROME",
            "codice_comune_nascita": "RM091",
            "codice_istat_comune_nascita": "H501",
            "stato_nascita": "ITALIE",
            "sesso": "MASCULIN",
            "quote": [
              {
                "data_atto": "2021-09-10",
                "data_deposito": "2021-09-15",
                "data_protocollo": "2021-09-15",
                "codice_tipo_diritto": "01",
                "descrizione_tipo_diritto": "PROPRIÉTÉ",
                "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": "ROYAUME-UNI",
            "sesso": "MASCULIN",
            "quote": [
              {
                "data_atto": "2021-09-10",
                "data_deposito": "2021-09-15",
                "data_protocollo": "2021-09-15",
                "codice_tipo_diritto": "01",
                "descrizione_tipo_diritto": "PROPRIÉTÉ",
                "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": "ITALIE",
            "sesso": "MASCULIN",
            "quote": [
              {
                "data_atto": "2021-09-10",
                "data_deposito": "2021-09-15",
                "data_protocollo": "2021-09-15",
                "codice_tipo_diritto": "01",
                "descrizione_tipo_diritto": "PROPRIÉTÉ",
                "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": "Rapport terminé",
      "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": "gcloud-tests@openapi.it",
      "id": "658eb839e5a329399f6bffb2"
    },

Télécharger le Rapport des Membres Actifs

GET/soci-attivi/{id}/allegati

Il est également possible d'obtenir toutes les données en formats XML et PDF via l'endpoint GET/soci-attivi/{id}/allegati

EXEMPLE DE DEMANDE

GET/soci-attivi/{id}/allegati

La demande doit être effectuée avec l'identifiant obtenu dans la réponse de l'endpoint POST /soci-attivi.

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

EXEMPLE DE RÉPONSE

GET/soci-attivi/{id}/allegati

La réponse indiquera le nom du fichier, sa taille et le fichier.

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

DEMANDE DE RAPPORT SUR LES MEMBRES ACTIFS AVEC API VISENGINE

GET/visure

Pour demander des rapports avec Visengine, il est d'abord nécessaire d'identifier le hash qui identifie de manière unique chaque document ou dossier.

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

Ceci est possible via le point de terminaison GET/visure qui ne nécessite pas de paramètres et retournera la liste complète des documents et dossiers pouvant être demandés via Visengine et selon le hash.

Vérifier les données et les coûts de demande de Rapport

GET/visure/{hash_visura}

Pour vérifier les informations, les documents nécessaires et les coûts du rapport, il faut effectuer une demande via le point de terminaison GET/visure/{hash_visura} et passer le hash du certificat obtenu précédemment.

EXEMPLE DE DEMANDE

GET/visure/{hash_visura}

Pour vérifier les champs et les coûts pour compléter la demande, utilisez le hash obtenu dans la demande précédente.

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

EXEMPLE DE RÉPONSE

GET/visure/{hash_visura}

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

{
  "data": {
    "nome_visura": "Membres Actifs de l'Entreprise",
    "ricerca": false,
    "nome_categoria": "Chambre de Commerce",
    "json_struttura": {
      "campi": {
        "$0": {
          "nome": "Code Fiscal",
          "tipo": "code_fiscal",
          "null": false,
          "istruzioni": "Veuillez entrer le Code Fiscal de l'Entreprise",
          "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
}

La validation indique les données obligatoires pour compléter la demande avec succès.

Demander un Rapport

POST /demande

Pour effectuer la demande du rapport, le code fiscal du sujet est requis.

EXEMPLE DE DEMANDE

POST /demande

{
    "hash_visura": "70a1b5d29d8efaae6ef9616841fd6f72",
    "json_visura": {
      "$1": 12485671007
      }
  }

EXEMPLE DE RÉPONSE

POST /demande

La réponse retourne plusieurs informations, y compris l'état, le callback (s'il est défini) et l'ID de la demande qui sera nécessaire pour télécharger le document par la suite.

{ "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": "En cours de traitement",
    "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": "Recherche complétée",
        "json_ricerca": "{\"$1\":\"12485671007\"}",
        "json_mappato": {
          "NRea": "1378273",
          "Cciaa": "RM"
        },
        "json_risultato": null
      }
    ],
    "esito": {
      "codice": "0",
      "info": "OK"
    }

Télécharger le Rapport

GET/document/{_id}

Lorsque l'état de la demande est "complété", il sera possible de télécharger les données en JSON, PDF et XML via la méthode GET/document/{_id}

EXEMPLE DE DEMANDE

GET/document/{_id}

Ceci est un exemple de demande effectuée en utilisant l'ID obtenu précédemment

https://visengine2.altravia.com/visure/documento/5f2829ce065afc21cc60ad0e

EXEMPLE DE RÉPONSE

GET/document/{_id}

La réponse contiendra le nom, la taille et le fichier.

{
  data{
    "nom":"5f22f5b5065afc21cc60a27a.zip",
    "taille":"10206",
    "fichier":"++6+47433njVP9ZcX1XNtWUsKrTya9FGhwiXgdp5j5OPh0FpaKWVpjP8CUEjFjYzYwYTI3YS5wZGZVVAUAAwhDKF91eAsAAQQhAAAABCEAAABQSwUGAAAAAAEAAQBiAAAAZicAAAAA"
    },
    "success": true,
    "message": "",
    "error": null
  }

Tous les formats (JSON, PDF, XML) seront disponibles dans un fichier zip.

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