Add liens capitalistiques

config/blog_posts/api_entreprise/liens-capitalistiques.md

@@ -0,0 +1,162 @@
+Mercredi 14 février 2025 - Publication
+
+# Valoriser les données des liasses fiscales avec API 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** 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 :
+- **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)
+
+📌 **Cas d'usage** : Permet d’identifier **les actionnaires principaux**, repérer **les structures de contrôle** et comprendre la **répartition du capital**.
+
+### **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)
+
+📌 **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**
+
+En pseudo code:
+
+```pseudo
+actionnaires = []
+
+si liasse contient 2059-F alors
+    pour chaque valeur dans la liste d'actionnaires
+        récupérer SIREN (2005724), Nom (2005722), Forme (2008006)
+        récupérer Pourcentage (2005726) et diviser par 100
+        stocker dans liste actionnaires
+fin si
+```
+
+Voici un exemple en ruby:
+
+```ruby
+liasses_fiscales = lookup_data("/v3/dgfip/unites_legales/#{siren}/liasses_fiscales/#{year}")
+
+actionnaires = []
+
+declaration = liasses_fiscales['data']['declarations'].find { |d| d['numero_imprime'] == '2059F' }
+
+sirens = declaration['donnees'].find { |d| d['code_absolu'] == "2005724" }&.dig('valeurs') || []
+denominations = declaration['donnees'].find { |d| d['code_absolu'] == "2005722" }&.dig('valeurs') || []
+formes = declaration['donnees'].find { |d| d['code_absolu'] == "2008006" }&.dig('valeurs') || []
+pourcentages = declaration['donnees'].find { |d| d['code_absolu'] == "2005726" }&.dig('valeurs') || []
+nombres_parts = declaration['donnees'].find { |d| d['code_absolu'] == "2005725" }&.dig('valeurs') || []
+
+sirens.each_with_index do |siren, index|
+  pourcentage = pourcentages[index]&.to_f
+
+  actionnaire = {
+    siren: siren,
+    denomination: denominations[index],
+    forme_juridique: formes[index],
+    pourcentage: pourcentage.nil? ? nil : pourcentage / 100,
+    nombre_parts: nombres_parts[index]&.to_i
+  }
+
+  actionnaires << actionnaire
+end
+
+actionnaires
+```
+
+{:.fr-h5}
+### **Exemple de récupération des participations**
+
+En pseudo code:
+
+```pseudo
+participations = []
+
+si liasse contient 2059-G alors
+    pour chaque valeur dans la liste des participations
+        récupérer SIREN (2005836), Nom (2005834), Forme (2008007)
+        récupérer Pourcentage (2005844) et diviser par 100
+        récupérer Pays (2005843)
+        stocker dans liste participations
+fin si
+```
+
+En ruby
+
+```ruby
+liasses_fiscales = lookup_data("/v3/dgfip/unites_legales/#{siren}/liasses_fiscales/#{year}")
+
+actionnaires = []
+
+declaration = liasses_fiscales['data']['declarations'].find { |d| d['numero_imprime'] == '2059G' }
+
+sirens = declaration['donnees'].find { |d| d['code_absolu'] == "2005836" }&.dig('valeurs') || []
+denominations = declaration['donnees'].find { |d| d['code_absolu'] == "2005834" }&.dig('valeurs') || []
+formes = declaration['donnees'].find { |d| d['code_absolu'] == "2008007" }&.dig('valeurs') || []
+pourcentages = declaration['donnees'].find { |d| d['code_absolu'] == "2005844" }&.dig('valeurs') || []
+pays = declaration['donnees'].find { |d| d['code_absolu'] == "2005843" }&.dig('valeurs') || []
+
+sirens.each_with_index do |siren, index|
+  pourcentage = pourcentages[index]&.to_f
+
+  participation = {
+    siren: siren,
+    denomination: denominations[index],
+    forme_juridique: formes[index],
+    pourcentage: pourcentage.nil? ? nil : pourcentage / 100,
+    pays: 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"}).
+
+---
+
+## **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}