French Company Enricher

SIREN / SIRET / nom → dossier légal complet. Alternative open-data à Pappers.fr / Societe.com pour l'Apify Store. À partir d'un SIREN, SIRET, nom d'entreprise ou URL (annuaire-entreprises.data.gouv.fr, pappers.fr), cet Actor construit un dossier exhaustif par entreprise française en agrégeant quatre sources officielles : DINUM (recherche-entreprises), BODACC (annonces légales), INPI RNE (dirigeants à jour, bénéficiaires effectifs, actes, bilans) et VIES (TVA UE).

Contrairement aux scrapers de masse, cet Actor est orienté profondeur : un dossier complet par entreprise, avec la qualité des données explicite et la modularité tier par tier.

Fonctionnalités

• 4 entrées supportées : SIREN, SIRET, nom libre, URL annuaire-entreprises ou Pappers
• 4 tiers : basic (DINUM) → standard (+ BODACC) → premium (+ INPI RNE) → full (+ PDFs actes/bilans)
• Timeline BODACC complète avec JSON internes parsés (actes, jugements, dépôts comptes, procédures collectives)
• Matrice de 20+ labels (Bio, Qualiopi, RGE, ESS, société à mission, convention collective, etc.)
• Liste des élus pour les collectivités territoriales
• Graphe dirigeants personne morale : commissaires aux comptes, holdings
• Validation TVA intracommunautaire via l'API VIES de l'UE
• Transparence sur la fraîcheur : warning explicite si les données RNE via DINUM sont obsolètes (>365 jours)
• Mode monitoring : surveille une watchlist de SIREN via /diff INPI et remonte uniquement les entreprises modifiées
• Cache KV store : évite les re-fetch des mêmes SIREN en runs successifs
• Persistence d'état : reprise automatique après migration

Cas d'utilisation

• Due diligence légère : vérifier un fournisseur, un partenaire, un investisseur
• KYB informel : conformité B2B, analyse de risque fournisseur
• Enrichissement CRM : dossier légal par compte prospect
• Veille concurrentielle : surveillance d'un portefeuille d'entreprises via le mode monitoring
• Compliance B2B : vérification TVA UE + labels RSE (société à mission, ESS, etc.)

Input

Paramètres principaux

Paramètre	Type	Défaut	Description
queries	array[string]	—	SIREN, SIRET, noms ou URLs à traiter
tier	enum	standard	basic | standard | premium | full
maxItems	int	1000	Nombre max de dossiers
mode	enum	standard	standard | monitor

Paramètres BODACC

Paramètre	Type	Défaut
includeBodacc	bool	true
maxAnnoncesBodacc	int	200

Paramètres INPI (tier ≥ premium)

Paramètre	Type	Défaut
inpiUsername	string (secret)	—
inpiPassword	string (secret)	—
inpiIncludeAttachmentsList	bool	true
inpiDownloadPDFs	bool	false
inpiMaxActesPerCompany	int	10
inpiMaxBilansPerCompany	int	5

Comment obtenir des credentials INPI :

1. Créer un compte sur data.inpi.fr
2. Aller dans « Mon espace → Mes accès API/SFTP → Accès APIs RNE »
3. Activer les rôles : COMPANIES_METADATA, ACTES_PDF, BILANS_PDF, BILANS_SAISIES_PDF
4. Utiliser votre email + mot de passe comme credentials

⚠️ Proxy obligatoire en cloud pour INPI. Les IPs datacenter d'Apify sont régulièrement bloquées par le firewall INPI (ConnectError). Si vous exécutez en tier premium ou full sur la plateforme Apify, activez proxyConfiguration → Apify Proxy Residential FR. L'Actor route automatiquement uniquement INPI via le proxy (DINUM/BODACC/VIES restent en direct pour économiser les crédits proxy).

Paramètres VIES

Paramètre	Type	Défaut
validateTva	bool	false

Paramètres Cache et Résolution

Paramètre	Type	Défaut
cacheMaxAgeDays	int	7
ambiguityThreshold	int	25
emitAllCandidates	bool	false

Exemples d'input

Tier basic — enrichissement simple :

{
  "queries": [
    "356000000",
    "47920546000062",
    "https://www.pappers.fr/entreprise/552120222"
  ],
  "tier": "basic",
  "includeBodacc": false
}

Tier standard — dossier + événements :

{
  "queries": ["356000000", "Michel et Augustin"],
  "tier": "standard",
  "maxAnnoncesBodacc": 100,
  "validateTva": true
}

Tier premium — + données INPI RNE :

{
  "queries": ["479205460"],
  "tier": "premium",
  "inpiUsername": "<votre email INPI>",
  "inpiPassword": "<votre password INPI>",
  "inpiIncludeAttachmentsList": true
}

Tier full — + PDFs téléchargés :

{
  "queries": ["479205460"],
  "tier": "full",
  "inpiUsername": "<...>",
  "inpiPassword": "<...>",
  "inpiDownloadPDFs": true,
  "inpiMaxActesPerCompany": 5,
  "inpiMaxBilansPerCompany": 3
}

Mode monitoring :

{
  "queries": ["placeholder"],
  "mode": "monitor",
  "watchlist": ["356000000", "479205460", "552120222"],
  "since": "2026-04-15",
  "tier": "premium",
  "inpiUsername": "<...>",
  "inpiPassword": "<...>"
}

Output

Chaque item du dataset est un dossier entreprise complet. Les blocs sont omis si la source correspondante n'est pas activée.

Structure principale

{
  "siren": "479205460",
  "inputQuery": "Michel et Augustin",
  "resolutionMethod": "name",
  "resolutionScore": 0.94,
  "sourceUrl": "https://annuaire-entreprises.data.gouv.fr/entreprise/479205460",
  "pappersUrl": "https://www.pappers.fr/entreprise/479205460",
  "tierApplied": "premium",
  "sources": ["dinum", "bodacc", "inpi"],

  "identity": {
    "denomination": "MICHEL ET AUGUSTIN",
    "siren": "479205460",
    "siretSiege": "47920546000062",
    "dateCreation": "2009-04-02",
    "etatAdministratif": "A",
    "natureJuridique": "5710",
    "natureJuridiqueLibelle": "SAS (Société par actions simplifiée)",
    "categorieEntreprise": "PME",
    "capitalSocial": 15236956.0,
    "capitalDevise": "EUR",
    "dureeAnnees": 45,
    "dateClotureExerciceSocial": "3108"
  },

  "activity": {
    "codeNaf": "4638B",
    "codeNaf2025": "46.38A",
    "section": "G",
    "sectionLibelle": "Commerce ; réparation d'automobiles et motocycles",
    "objetSocial": "conception, réalisation, fabrication en sous-traitance..."
  },

  "headcount": {
    "trancheEffectifSalarie": "22",
    "trancheEffectifLibelle": "100 à 199 salariés",
    "anneeEffectif": "2023",
    "nombreEtablissements": 7,
    "nombreEtablissementsOuverts": 5
  },

  "headquarters": {
    "adresse": "70 RUE DU GOUVERNEUR GENERAL EBOUE 92130 ISSY-LES-MOULINEAUX",
    "codePostal": "92130",
    "libelleCommune": "ISSY-LES-MOULINEAUX",
    "departement": "92",
    "region": "11",
    "epci": "200054781",
    "latitude": 48.8221,
    "longitude": 2.2713
  },

  "directors": [
    {
      "type": "personne_physique",
      "nom": "NEUMANN",
      "prenoms": ["CHRISTOPHE", "PIERRE", "MANFRED"],
      "qualite": "Directeur général",
      "dateDeNaissance": "1968-08",
      "source": "inpi"
    },
    {
      "type": "personne_morale",
      "sirenDirigeant": "672006483",
      "denomination": "PRICEWATERHOUSECOOPERS AUDIT",
      "qualite": "Commissaire aux comptes titulaire",
      "source": "inpi"
    }
  ],

  "labels": {
    "estBio": false,
    "estQualiopi": false,
    "estSocieteMission": true,
    "estEss": false,
    "conventionCollectiveRenseignee": true,
    "conventionsIdcc": ["1486"]
  },

  "financials": {
    "dinumSummary": {
      "2023": { "ca": 67000000, "resultat_net": -2100000 }
    }
  },

  "bodaccEvents": [
    {
      "id": "C201901585651",
      "dateParution": "2019-08-18",
      "familleAvis": "dpc",
      "familleAvisLibelle": "Dépôts des comptes",
      "tribunal": "GREFFE DU TRIBUNAL DE COMMERCE DE PARIS",
      "parsedContent": {
        "depot": { "dateCloture": "2018-12-31", "typeDepot": "Comptes annuels et rapports" }
      },
      "urlComplete": "https://www.bodacc.fr/..."
    }
  ],

  "inpiAttachments": {
    "actes": [
      {
        "id": "669f1c0b763f26e3b7027e49",
        "dateDepot": "2024-07-15",
        "numChrono": "30709",
        "typesActes": ["Statuts mis à jour", "Extrait de PV d'AG"],
        "downloadUrl": "https://registre-national-entreprises.inpi.fr/api/actes/669f.../download",
        "downloaded": true,
        "apifyKvsKey": "pdf-acte-669f1c0b763f26e3b7027e49"
      }
    ],
    "bilans": [...]
  },

  "tva": {
    "number": "FR86479205460",
    "valid": true,
    "checkedAt": "2026-04-18T14:23:00Z"
  },

  "dataQuality": {
    "inseeUpdatedAt": "2026-04-16T18:33:23",
    "rneUpdatedAtViaDinum": "2024-05-19T17:01:20",
    "rneStalenessDays": 699,
    "inpiFetched": true,
    "inpiUpdatedAt": "2025-07-11T21:30:26+02:00"
  },

  "warnings": [
    "Tier premium utilisé : données RNE rafraîchies via INPI directement."
  ],

  "fromCache": false,
  "fetchDurationSeconds": 11.3,
  "scrapedAt": "2026-04-18T14:23:45Z"
}

Cas spéciaux

SIREN invalide / inexistant :

{
  "inputQuery": "999999999",
  "error": "SIREN_NOT_FOUND",
  "errorMessage": "Aucune entreprise trouvée pour le SIREN 999999999 dans DINUM (non-diffusible ou inexistant)."
}

Input ambigu (nom libre) :

{
  "inputQuery": "dupont",
  "resolutionMethod": "name",
  "ambiguous": true,
  "candidates": [
    { "siren": "...", "nom": "...", "score": 18.5, "ville": "...", "codePostal": "..." }
  ],
  "errorMessage": "Plusieurs candidats trouvés..."
}

Limitations

Spécifiques à DINUM

• Cap 10 000 résultats sur un filtre (limite page × per_page ≤ 10 000). L'Actor lit le résultat le plus pertinent par SIREN, donc cette limite ne s'applique pas au mode SIREN/SIRET. Pour les noms libres, seuls les 5 premiers candidats sont considérés.
• Entreprises non-diffusibles totales invisibles : si un entrepreneur individuel a refusé la diffusion auprès de l'INSEE, DINUM ne renvoie rien. Message d'erreur SIREN_NOT_FOUND dans ce cas.
• Date de mise à jour RNE parfois stale de 2+ ans. L'Actor remonte explicitement rneStalenessDays et un warning si > 365 jours. Solution : passer au tier premium (INPI directement).

Spécifiques à BODACC

• Les champs listepersonnes, jugement, acte, modificationsgenerales sont des strings JSON sérialisés dans l'API source. L'Actor les parse et les expose dans parsedContent.

Spécifiques à INPI

• Lent (~10s par appel /companies/{siren}) — sémaphore à 10 concurrents pour rester correct.
• Credentials requis pour tier ≥ premium. Création de compte sur data.inpi.fr + activation des rôles API.
• Token valide 24h, refresh automatique pour les runs longs.
• Entreprises non inscrites au RNE (ex: associations loi 1901 sans activité commerciale) → 404 traité en warning non bloquant.
• PDFs volumineux (jusqu'à plusieurs MB). Timeout 90s, downloads séquentiels pour éviter la surcharge mémoire.

Spécifiques à VIES

• Service UE parfois lent/indisponible (503). Timeout 5s. En cas d'échec, valid: null + error: "VIES_TIMEOUT" au lieu de bloquer l'item.

Mode monitoring

• Le /diff INPI est paginé (pageSize=100). L'Actor arrête au cap 200 pages pour éviter les runs infinis. Pour des fenêtres > 1 jour, diviser en plusieurs runs.

Conformité

• Licence des données : les APIs DINUM, BODACC et INPI sont sous licence Etalab 2.0. Réutilisation libre, y compris commerciale.
• RGPD : les dossiers contiennent des données personnelles (dirigeants : nom, date de naissance, nationalité). L'utilisateur de l'Actor est responsable du traitement au sens RGPD Art. 28 : ne pas revendre les données personnelles sans base légale, ne pas les utiliser à des fins de profilage non autorisées, respecter les droits des personnes concernées.
• Attribution : les sources sont citées dans le bloc sources de chaque dossier.

Sources de données

Source	URL	Documentation
DINUM recherche-entreprises	recherche-entreprises.api.gouv.fr	Doc
BODACC v2.1	bodacc-datadila.opendatasoft.com	Doc
INPI RNE	registre-national-entreprises.inpi.fr	Doc
VIES	ec.europa.eu/taxation_customs/vies	Doc

Changelog

Voir ./CHANGELOG.md.

Licence

MIT — voir ./LICENSE.