Entreprises

Le point de terminaison Get /advance vous permet de trouver des entreprises sur la base de paramètres qui peuvent être le numéro de chiffre d'affaires, les employés, le code ATECO, les coordonnées et le rayon.

Une ou plusieurs entreprises peuvent être incluses dans la réponse en fonction des paramètres utilisés dans la demande. Pour chaque entreprise, les données suivantes sont disponibles

• code fiscal
• nom
• numéro de TVA
• toponyme
• rue
• numéro de rue
• adresse complète
• commune
• hameau
• province
• statut de l'activité
• date de mise à jour
• code postal
• numéro d'identification de la ferme
• longitude
• latitude
• code nature juridique
• date d'enregistrement auprès de la chambre de commerce

Le Get /advance{piva_cf_or_id} requiert à la place l'une des valeurs suivantes en tant que paramètre:

• numéro de TVA
• code fiscal
• numéro d'identification de l'entreprise

La réponse ne concernera qu'une seule entreprise et renverra les données suivantes :

• code fiscal
• nom de l'entreprise
• numéro de TVA
• toponyme
• rue
• numéro de rue
• adresse complète
• commune
• hameau
• province
• statut de l'activité
• date de mise à jour
• code postal
• code du destinataire
• numéro d'identification de l'entreprise
• longitude
• latitude
• date d'enregistrement à la chambre de commerce
• REA
• PEC
• Code de la nature juridique
• Code ATECO et description
• Date de début
• Date de clôture Bilan, chiffre d'affaires, bénéfices (avec historique jusqu'à 5 ans)
• Employés
• Capital social
• Groupe TVA
• Statut de l'entreprise auprès de l'Agence des impôts
• Actionnaires (nom / nom, code fiscal / pourcentage d'actions)

GET Advance vous permet d'obtenir une liste d'entreprises avec une série d'informations. Une limite maximale de 100 résultats est fixée par défaut pour chaque requête individuelle.
Si plus de 100 résultats sont disponibles, vous pouvez utiliser le paramètre SKIP pour définir le nombre d'enregistrements que vous souhaitez ignorer dans l'ensemble des résultats.

Les paramètres Dry Run, Skip et Limit sont des paramètres facultatifs qui peuvent être insérés dans une demande à GET Advance.

Dry Run permet de simuler une requête en ne renvoyant que le nombre d'enregistrements trouvés et le prix. En pratique, cela indique combien d'entreprises sont compatibles avec les paramètres utilisés dans la requête.

Skip vous permet de définir le nombre d'enregistrements que vous souhaitez ignorer dans l'ensemble des résultats.

Limiter indique le nombre maximum de résultats que vous souhaitez obtenir dans la réponse. Veuillez noter que, par défaut, la réponse comprend un maximum de 100 résultats.

Il n'y a pas de limite au rayon donné en paramètre, mais veuillez noter que le nombre maximum de résultats par requête est de 100.

Dans la réponse à Get Advance, le siège social de l'entreprise est disponible.

Les informations sur les membres sont disponibles via le point d'accès Get /soci ou sont également disponibles dans l'ensemble de données de réponse pour le point d'accès Get Advance/{piva_or_cf}.

La réponse est renvoyée en temps réel et comprend le nom ou la désignation, le code fiscal et la part en pourcentage.

Les actionnaires figurant dans la liste sont ceux qui détiennent une part de 10 % ou plus (les mêmes informations peuvent également être obtenues à partir du bilan déposé, s'il a été déposé au cours des quatre dernières années).

Pour des données plus actualisées et enrichies, vous pouvez également utiliser le point de terminaison GET /stakeholders de l'API Entreprise, où vous pouvez obtenir plus d'informations sur les rôles de l'entreprise, les actionnaires et l'entreprise en général.

Non, l'API Entreprises n'a pas de limites de débit journalier.

Le coût des requêtes individuelles dépend du point final et varie de 0,001€ à 0,10€. Tous les prix pour les demandes individuelles (prix de base) sont disponibles dans la section Tarification, où il est également indiqué si des abonnements sont disponibles et le pourcentage d'économies.

Vous pouvez activer votre abonnement dans la section abonnement en indiquant la durée de l'abonnement (mois/année), en sélectionnant le nombre de demandes et la date de début. Une fois le paiement effectué, les demandes seront disponibles immédiatement (vous pouvez également décider de commencer un abonnement à une date ultérieure). En cas de paiement par virement bancaire, les demandes seront disponibles dès que le montant aura été crédité.

Oui, il y a 30 demandes par mois pour les endpoints Get pec, base, closed et soci. Pour plus d'informations, veuillez consulter la section Tarification.

Dans la section Utilisation, vous pouvez suivre vos demandes gratuites et vos demandes d'abonnement ou de recharge. Elles sont disponibles à la fois en mode graphique (période, mois et année) et avec un résumé textuel.

Toutes les données figurant dans les réponses de l'API Entreprise proviennent de sources officielles et certifiées et de bases de données publiques via la licence TULPS, par exemple la Chambre de commerce, l'INPS (Institut national pour la prévoyance sociale), le Service du revenu interne.

Oui, il est possible d'accéder à d'autres informations par l'intermédiaire de l'API Entreprise, où plus de 400 données individuelles sur les entreprises, les employés et le marketing sont disponibles.

Entreprises et Company offrent toutes deux des informations sur les entreprises italiennes.

Entreprises permet une vérification rapide d'une entreprise et offre l'ensemble des données essentielles pour une facturation sans problème. Il présente des informations telles que le statut de l'activité (CCIAA), le statut auprès de l'administration fiscale, le chiffre d'affaires, les bénéfices, les employés, etc. Il fournit également un certain nombre de points de terminaison pour obtenir des données spécifiques, telles que le code du destinataire, le PEC, le groupe de TVA (=codice destinatario, PEC, gruppo IVA).

Avec Company, en revanche, vous avez accès à un ensemble de données beaucoup plus vaste, jusqu'à 400 points de données, pour effectuer une analyse détaillée de l'entreprise et de ses parties prenantes et pour accéder à tous les contacts et à toutes les informations afin de planifier des activités de marketing.

La mise à jour dépend du type de données et du endpoint.

Les données des endpoints Cessate (=cessations d'activité) et SdI sont mises à jour quotidiennement. Les nouvelles entreprises et celles qui ont cessé leur activité sont mises à jour dans les 24 heures. Les données telles que le chiffre d'affaires, le bénéfice et le PEC (=turnover, profit and PEC) sont mises à jour en moyenne chaque semaine, avec un retard pouvant aller jusqu'à un mois. Les données Dipendenti (=salariés) sont mises à jour tous les trimestres.

Il s'agit de deux informations différentes qui proviennent de sources officielles différentes.

Le champ Stato Attività (=Statut d'Activité) indique le statut de l'entreprise selon la Chambre de commerce italienne. Les valeurs qui peuvent être présentes dans la réponse sont les suivantes:

• Attiva (=Actif)
• Registrata (=Enregistrée)
• Inattiva (=Inactive)
• Sospesa (=Suspendue)
• In Iscrizione (=Enrôlé)
• Cessata (=Cessé)

Le champ Cessata (=Cessé) indique plutôt le statut de l'entreprise auprès de l'Internal Revenue Service. Dans ce cas, les valeurs disponibles sont:

• True
• False

Le paramètre dépend du point de terminaison pour lequel la demande doit être faite.

Pour les Get /base, /advance, /closed, /gruppoiva, /pec, /soci, le paramètre à utiliser est l'un des suivants:

• numéro de tva
• code fiscal
• id (uniquement pour base et advance)

Pour le point de terminaison GET Advance, un ou plusieurs des paramètres suivants peuvent être transmis:

• nom ou partie (dans ce cas, le nom doit toujours être un entier) du nom de l'entreprise
• province
• code ATECO
• CCIAA
• REA
• chiffre d'affaires minimum et/ou maximum
• nombre minimum et/ou maximum d'employés

Pour le point de terminaison GET /Autocomplete, le paramètre peut être une chaîne (également avec le caractère générique "*") et, éventuellement, la latitude, la longitude et le rayon.

Pour le point de terminaison GET /forma_giuridica/, aucun paramètre n'est nécessaire; pour Get /forma_giuridica/, il s'agit du code de nature juridique.

Pour le point d'accès GET /updates, les paramètres, tous facultatifs, sont la latitude, la longitude et le rayon. Pour le point d'accès /updates/{timestamp}, un paramètre obligatoire doit être ajouté aux points d'accès précédents: timestamp (c'est-à-dire la date à partir de laquelle la recherche doit commencer).

API Entreprises offre des informations sur tout type d'entreprise italienne. L'ensemble des données disponibles dans la réponse peut dépendre de l'inscription ou non de l'entreprise à la chambre de commerce. Pour les indépendants non inscrits à la chambre de commerce, nous suggérons d'utiliser l'endpoint risk anagrafica (risque registre) pour obtenir des informations telles que la localisation, le nom, le code Ateco et la description, le domicile fiscal et les informations personnelles.

 La réponse est renvoyée en temps réel pour tous les points d'extrémité.

Les paramètres pour effectuer une demande aux deux points finaux sont les mêmes :

• numéro de TVA
• code fiscal
• id

La différence réside dans les données présentes dans la réponse.

La réponse GET Base contient les données suivantes:

• code fiscal
• nom
• numéro de TVA
• toponyme
• rue
• numéro de rue
• adresse complète
• commune
• hameau
• province
• statut de l'activité
• date de mise à jour
• code postal
• code du destinataire
• numéro d'identification de l'entreprise
• longitude
• latitude
• date d'enregistrement à la chambre de commerce

Dans la réponse GET Advance, en plus de toutes les données de la base, il y a les données suivantes

• REA
• PEC
• Code de la nature juridique
• Code ATECO et description
• Date de début de l'activité
• Date de clôture Bilan, chiffre d'affaires, bénéfices (avec historique jusqu'à 5 ans)
• Employés
• Capital social
• Groupe TVA
• Statut de l'entreprise auprès de l'administration fiscale
• Actionnaires (nom / nom, code fiscal / pourcentage d'actions)

L'obligation de s'identifier à l'aide du document d'identité de la personne ou de l'entreprise demandant le service n'est prévue que pour certains services soumis au TULPS et à sa licence correspondante (article 6 de la licence TULPS).

Pour certains services, la réglementation TULPS exige l'identification de l'utilisateur du service. Dans le cas des entreprises, il est donc nécessaire de télécharger un document d'identité (permis de conduire, passeport, carte d'identité) appartenant soit au représentant légal, soit à une personne ayant des pouvoirs de signature, soit à un délégué pour la fourniture et l'utilisation du service spécifique (par exemple, responsable informatique ou bureau administratif).