Enrichissement des données des entreprises françaises avec l'API Pappers
by ZENPILOTE https://zenpilote.fr
Odoo
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Contacts (contacts)
• Discuss (mail) |
| Lines of code | 605 |
| Technical Name |
l10n_fr_partner_enrich_pappers |
| License | LGPL-3 |
| Website | https://zenpilote.fr |
Documentation Fonctionnelle - Module l10n_fr_partner_enrich_pappers
Description
Le module l10n_fr_partner_enrich_pappers est une extension Odoo qui permet l'enrichissement
automatique des données des entreprises françaises en utilisant l'API Pappers. Il facilite la
récupération et la mise à jour des informations légales et administratives des partenaires commerciaux
français.
Fonctionnalités Principales
1. Enrichissement Automatique des Données
- Enrichissement automatique des fiches partenaires lors de la création
- Détection automatique des numéros SIRET/SIREN dans le nom du partenaire
- Mise à jour des informations légales et administratives via l'API Pappers
2. Informations Disponibles
Le module ajoute les champs suivants aux fiches partenaires :
Identification
- SIRET
- SIREN
- Numéro RCS (Registre du Commerce et des Sociétés)
- Type juridique (Personne morale/Personne physique)
Informations Légales
- Forme juridique
- Date de création
- Date d'immatriculation RCS
- Statut RCS (Inscrit/Non inscrit/Radié)
- Montant du capital
- Devise du capital
Informations Commerciales
- Description de l'activité
- Effectif
- Siège social (oui/non)
- État de l'entreprise (active/fermée)
- Date de fermeture (si applicable)
3. Filtres et Regroupements
Le module ajoute de nouveaux filtres dans la vue liste des partenaires :
- Sièges sociaux
- Entreprises actives
- Entreprises fermées
- Regroupement par type juridique
- Regroupement par forme juridique
- Regroupement par statut RCS
4. Configuration
Dans les paramètres de configuration (Settings > Général > Pappers API) :
- Activation/désactivation du module
- Configuration de la clé API Pappers
- Configuration de l'URL de l'API
- Suivi des jetons pay-as-you-go restants
- Option pour masquer l'onglet Pappers dans la fiche partenaire
5. Mapping des Champs
Le module intègre un système de mapping des champs personnalisable :
- Mapping par défaut des champs Pappers vers les champs Odoo
- Possibilité de personnaliser les mappings via l'interface d'administration
- Validation automatique des champs Odoo existants
6. Suivi des Jetons API
Le module intègre un système automatique de suivi des jetons API :
- Mise à jour automatique toutes les heures du nombre de jetons pay-as-you-go restants
- Affichage du solde dans les paramètres de configuration
- Possibilité de rafraîchir manuellement le compteur via un bouton dédié
- Journalisation des mises à jour et des erreurs éventuelles
Prérequis
- Une clé API Pappers valide (disponible sur https://www.pappers.fr/api)
- Connexion Internet pour accéder à l'API Pappers
Utilisation
Configuration Initiale
- Installer le module
- Aller dans Configuration > Paramètres généraux
- Dans la section "Pappers API", activer l'option "Enrichissement des données des entreprises françaises"
- Saisir la clé API Pappers
- Configurer l'URL de l'API (par défaut : https://api.pappers.fr/v2)
- Optionnel : Configurer les mappings de champs dans Contacts > Configuration > Pappers Field Mapping
Configuration des Mappings de Champs
- Accéder à Contacts > Configuration > Pappers Field Mapping
- Les mappings par défaut sont automatiquement créés
- Pour chaque mapping :
- Champ Odoo : nom technique du champ dans Odoo (ex: name, street, siret_pappers)
- Champ Pappers : chemin du champ dans l'API Pappers (ex: siren, siege.code_postal)
- Actif : permet d'activer/désactiver le mapping
- Les modifications sont appliquées immédiatement
Création d'un Nouveau Partenaire
- Créer un nouveau partenaire
- Si un numéro SIRET ou SIREN est saisi dans le nom, les informations sont automatiquement récupérées
- Les données sont automatiquement remplies dans l'onglet "Informations légales"
Consultation des Informations
Les informations légales sont accessibles dans un nouvel onglet "Pappers Data" de la fiche partenaire :
Sécurité et Confidentialité
- Les clés API sont stockées de manière sécurisée
- Les informations sensibles sont masquées dans l'interface
- Les accès aux données techniques sont restreints aux administrateurs
Support et Maintenance
- Le module vérifie automatiquement la validité de la clé API
- Les erreurs d'API sont gérées et notifiées à l'utilisateur
- Un système de logging permet de tracer les appels API et les erreurs éventuelles
Limitations
- Le module ne fonctionne qu'avec les entreprises françaises
- Certaines informations peuvent ne pas être disponibles selon le niveau d'accès de l'API Pappers
- Les mises à jour des données ne sont pas automatiques après la création initiale
- Le compteur de jetons n'affiche que les jetons pay-as-you-go restants, et non les jetons inclus dans l'abonnement
- La mise à jour du compteur de jetons est effectuée toutes les heures, il peut donc y avoir un léger décalage avec l'utilisation réelle
- Les mappings de champs ne peuvent être configurés que par les administrateurs
- Les champs Odoo référencés dans les mappings doivent exister dans le modèle res.partner
- Les champs imbriqués dans l'API Pappers doivent être référencés avec la notation point (ex: siege.code_postal)
Please log in to comment on this module