API SIRENE / Annuaire (mcp-sirene)

Connecteur de référentiel public — enrichissement et validation SIRET, n° TVA intracom, Code Pays.

Connecteur vers les API publiques (SIRENE / Annuaire des entreprises) qui alimente l'enrichissement des fiches tiers (R4-R5). C'est un connecteur transverse : le service referentiel-cleaner s'en sert pour dédoublonner et compléter les bases fournisseurs et clients.

paperasse utilise déjà l'API publique SIRENE (annuaire des entreprises) et documente ses sources dans data/sources.json. Ce connecteur formalise cet accès en outils MCP réutilisables.

Outils MCP

Lecture (uniquement — données publiques)

sirene.lookup — recherche d'un établissement par SIRET / SIREN / raison sociale.
sirene.validate_siret — validité d'un SIRET (clé de Luhn + existence).
sirene.enrich — renvoie raison sociale, adresse, code APE, état actif/cessé.
sirene.find_vat — n° TVA intracom dérivé du SIREN (FR + clé), Code Pays.

Cas d'usage

Exemples de demandes au chat que ce connecteur rend possibles :

« Valide ce SIRET et donne le n° TVA intracom + Code Pays. » — enrichissement à la volée.
« Cette raison sociale correspond à quel établissement actif ? » — résolution depuis un libellé.
« Enrichis la liste des 12 nouveaux clients Immobilier via SIRENE. » — alimente le referentiel-cleaner.
« Le fournisseur X est-il toujours actif ou cessé ? » — contrôle de l'état au répertoire.

Rôle dans la conformité RFE

La RFE exige des fiches tiers complètes : SIRET, n° TVA intracom, Code Pays. Ce connecteur est la source de vérité externe pour :

l'enrichissement des fournisseurs (Sage),
l'enrichissement des clients Immobilier (Bazimo) et Hôtellerie (PMS),
la création réglementaire de tiers (Sage V12 utilise nativement l'API SIRENE).

Garde-fous

Lecture seule, données publiques — aucun secret métier.
Cache local pour limiter les appels et tracer la date d'enrichissement de chaque fiche.
Fournisseurs internationaux : SIRENE ne couvre pas → contrôle Infogreffe / VIES en complément (cf. pratique actuelle).