From b7a3a637612e230be8e27756231af98bcb29b96c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Delmaire=20Lo=C3=AFc?= Date: Fri, 14 Feb 2025 15:44:51 +0100 Subject: [PATCH] Add liens capitalistiques --- .../api_entreprise/liens-capitalistiques.md | 230 ++++++++++++++++++ 1 file changed, 230 insertions(+) create mode 100644 config/blog_posts/api_entreprise/liens-capitalistiques.md diff --git a/config/blog_posts/api_entreprise/liens-capitalistiques.md b/config/blog_posts/api_entreprise/liens-capitalistiques.md new file mode 100644 index 000000000..3d2070fba --- /dev/null +++ b/config/blog_posts/api_entreprise/liens-capitalistiques.md @@ -0,0 +1,230 @@ +Mercredi 14 février 2025 - Publication + +# Liens capitalistiques d'une entreprise + +## Comprendre les informations des liasses fiscales + +Les **liasses fiscales** permettent d’extraire des informations capitalistiques clés sur une entreprise. Elles contiennent des données déclarées aux impôts par les sociétés soumises à l'impôt sur les sociétés (IS) et offrent une **vision précise de la répartition du capital et des participations**. + +Ces informations sont **accessibles via l'API Liasses Fiscales** du portail [API Entreprise](https://entreprise.api.gouv.fr/catalogue/dgfip/liasses_fiscales){:target="_blank"}, permettant aux administrations et organismes habilités de **valoriser ces données** pour divers cas d’usage métier. + +{:.fr-highlight} +**ℹ️ La structure capitalistique d’une entreprise peut être précieuse** pour analyser la gouvernance, identifier les liens entre sociétés et évaluer les risques associés à certaines structures d’actionnariat. + +--- + +## **Les informations clés des liasses fiscales** 📄 + +Les données capitalistiques sont principalement contenues dans deux déclarations fiscales : +- **2059-F** (*Structure du capital - Actionnaires*) → Permet d'identifier les **actionnaires**, aussi bien **personnes morales que personnes physiques**, et leur répartition dans le capital. +- **2059-G** (*Filiales et Participations*) → Permet d'identifier **les sociétés dans lesquelles l'entreprise détient une participation**. + +### **Actionnaires : Qui détient l'entreprise ?** +L’imprimé **2059-F** contient les informations suivantes : +- **Actionnaires personnes morales** : + - **SIREN de l’actionnaire** (code 2005724) + - **Nom de l’actionnaire** (code 2005722) + - **Forme juridique** (code 2008006) + - **Pourcentage de détention** (code 2005726) + - **Nombre de parts détenues** (code 2005725) + - **Adresse** : numéro (2005727), voie (2005729), lieu-dit (2005730), code postal (2005731), ville (2005732), pays (2005733) + +- **Actionnaires personnes physiques** : + - **Nom de l’actionnaire** (code 2005734) + - **Nom marital** (code 2005735) + - **Date de naissance** (code 2005746) + - **Pourcentage de détention** (code 2005738) + - **Nombre de parts détenues** (code 2005737) + - **Adresse** : numéro (2005739), voie (2005741), lieu-dit (2005742), code postal (2015508), ville (2015507), pays (2015509) + +📌 **Cas d'usage** : Permet d’identifier **les actionnaires principaux**, repérer **les structures de contrôle**, et comprendre la **répartition du capital** entre entreprises et individus. + +### **Participations : Dans quelles entreprises l’entreprise investit-elle ?** +L’imprimé **2059-G** liste les sociétés détenues avec : +- **SIREN de la filiale ou participation** (code 2005836) +- **Nom de la société détenue** (code 2005834) +- **Forme juridique** (code 2008007) +- **Pourcentage de détention** (code 2005844) +- **Pays d’implantation** (code 2005843) +- **Adresse** : numéro (2005837), voie (2005839), lieu-dit (2005840), code postal (2005841), ville (2005842), pays (2005843) + +📌 **Cas d'usage** : Cartographier les **filiales et participations** d’une entreprise, analyser son **empreinte économique**, et repérer les **liens capitalistiques intra-groupes**. + +--- + +## **Exploiter ces données avec l'API Liasses Fiscales** +L'[API Liasses Fiscales](https://entreprise.api.gouv.fr/catalogue/dgfip/liasses_fiscales){:target="_blank"} permet d’accéder à ces informations sous forme structurée. + +{:.fr-h5} +### **Exemple de récupération des actionnaires** + +Voici un exemple en ruby: + +```ruby +liasses_fiscales = lookup_data("/v3/dgfip/unites_legales/#{siren}/liasses_fiscales/#{year}") + +actionnaires = [] + +declaration = declarations.find { |d| d['numero_imprime'] == '2059F' } + +sirens = extract_values(declaration, '2005724') +denominations = extract_values(declaration, '2005722') +formes = extract_values(declaration, '2008006') +pourcentages = extract_values(declaration, '2005726') +nombres_parts = extract_values(declaration, '2005725') + +noms_physiques = extract_values(declaration, '2005734') +noms_maritaux = extract_values(declaration, '2005735') +pourcentages_physiques = extract_values(declaration, '2005738') +nombres_parts_physiques = extract_values(declaration, '2005737') +dates_naissance = extract_values(declaration, '2005746') +pays_physiques = extract_values(declaration, '2015509') + +adresse_numero = extract_values(declaration, '2005727') +adresse_voie = extract_values(declaration, '2005729') +adresse_lieu_dit_hameau = extract_values(declaration, '2005730') +adresse_code_postal = extract_values(declaration, '2005731') +adresse_ville = extract_values(declaration, '2005732') +adresse_pays = extract_values(declaration, '2005733') + +adresse_physique_numero = extract_values(declaration, '2005739') +adresse_physique_voie = extract_values(declaration, '2005741') +adresse_physique_lieu_dit_hameau = extract_values(declaration, '2005742') +adresse_physique_code_postal = extract_values(declaration, '2015508') +adresse_physique_ville = extract_values(declaration, '2015507') +adresse_physique_pays = extract_values(declaration, '2015509') + +sirens.each_with_index do |siren, index| + actionnaire = { + type: 'personne_morale', + pourcentage: build_pourcentage(pourcentages[index]), + nombre_parts: nombres_parts[index]&.to_i, + personne_physique_attributs: { + nom: nil, + nom_marital: nil, + date_naissance: nil, + pays: nil, + adresse: {} + }, + personne_morale_attributs: { + siren: siren, + denomination: denominations[index], + forme_juridique: formes[index], + adresse: { + numero: adresse_numero[index], + voie: adresse_voie[index], + lieu_dit_hameau: adresse_lieu_dit_hameau[index], + code_postal: adresse_code_postal[index], + ville: adresse_ville[index], + pays: adresse_pays[index] + } + } + } + actionnaires << actionnaire +end + +noms_physiques.each_with_index do |nom, index| + actionnaire = { + type: 'personne_physique', + pourcentage: build_pourcentage(pourcentages_physiques[index]), + nombre_parts: nombres_parts_physiques[index]&.to_i, + personne_physique_attributs: { + nom: nom, + nom_marital: noms_maritaux[index], + date_naissance: dates_naissance[index], + pays: pays_physiques[index], + adresse: { + numero: adresse_physique_numero[index], + voie: adresse_physique_voie[index], + lieu_dit_hameau: adresse_physique_lieu_dit_hameau[index], + code_postal: adresse_physique_code_postal[index], + ville: adresse_physique_ville[index], + pays: adresse_physique_pays[index] + } + }, + personne_morale_attributs: { + siren: nil, + denomination: nil, + forme_juridique: nil, + adresse: {} + } + } + actionnaires << actionnaire +end + +actionnaires +``` + +{:.fr-h5} +### **Exemple de récupération des participations** + +En ruby + +```ruby +liasses_fiscales = lookup_data("/v3/dgfip/unites_legales/#{siren}/liasses_fiscales/#{year}") + +participations=[] + +sirens = extract_values(declaration, '2005836') +denominations = extract_values(declaration, '2005834') +formes = extract_values(declaration, '2008007') +pourcentages = extract_values(declaration, '2005844') +pays = extract_values(declaration, '2005843') + +adresse_numero = extract_values(declaration, '2005837') +adresse_voie = extract_values(declaration, '2005839') +adresse_lieu_dit_hameau = extract_values(declaration, '2005840') +adresse_code_postal = extract_values(declaration, '2005841') +adresse_ville = extract_values(declaration, '2005842') +adresse_pays = extract_values(declaration, '2005843') + +sirens.each_with_index do |siren, index| + participation = { + siren: siren, + denomination: denominations[index], + forme_juridique: formes[index], + pourcentage: build_pourcentage(pourcentages[index]), + pays: pays[index], + adresse: { + numero: adresse_numero[index], + voie: adresse_voie[index], + lieu_dit_hameau: adresse_lieu_dit_hameau[index], + code_postal: adresse_code_postal[index], + ville: adresse_ville[index], + pays: adresse_pays[index] + } + } + + participations << participation +end +participations +``` + +--- + +## **Quels usages métier ?** +Ces données peuvent être exploitées pour : +- **Cartographier les réseaux d’entreprises** (identification des structures de contrôle). +- **Analyser la gouvernance et la répartition du capital** (investisseurs, holdings…). +- **Faire des contrôles réglementaires et fiscaux** (vérification des bénéficiaires réels, lutte contre la fraude). +- **Compléter des analyses économiques et financières** en croisant avec d'autres API (ex : [API INSEE](https://entreprise.api.gouv.fr/catalogue/insee/unites_legales){:target="_blank"}, [API RNE](https://entreprise.api.gouv.fr/catalogue/rne/entreprises){:target="_blank"}). + +--- + +### **Données déclaratives : attention à la qualité des informations** +Il est important de noter que les **adresses renseignées dans les liasses fiscales sont déclaratives**, ce qui peut engendrer des **erreurs ou incohérences** : +- Certaines entreprises **ne renseignent pas toutes les informations**, laissant des champs vides. +- Le **pays peut être inscrit dans la voie** par erreur, ou l’adresse peut être **partiellement renseignée**. +- Les **personnes physiques peuvent omettre certains détails** (ex : absence de numéro de rue, informations erronées sur la ville). + +Ainsi, lors de l’exploitation des données d’adresse, il est recommandé de **croiser avec d’autres sources (ex : API INSEE, RNE) et de prévoir des contrôles de cohérence**. + +--- + +## **Conclusion** +L’intégration des données des liasses fiscales via API Entreprise permet aux **administrations et acteurs habilités** d’exploiter **une information fiable et déclarative** pour mieux comprendre **les structures capitalistiques et les liens entre entreprises**. + +💡 **Envie d’exploiter ces données ?** Découvrez l'[API Liasses Fiscales](https://entreprise.api.gouv.fr/catalogue/dgfip/liasses_fiscales){:target="_blank"} et testez-la dès maintenant ! + +--- +[Toutes les API du catalogue API Entreprise](https://entreprise.api.gouv.fr/catalogue){:.fr-btn .fr-btn--secondary fr-btn--icon-right fr-icon-arrow-right-fill}