L'API BODACC en Node.js — avis d'entreprises françaises

La France publie ses avis d'entreprises en open data, procédures collectives comprises. Le BODACC est servi par la DILA via une instance Opendatasoft — pas de clé, pas d'inscription — mais le langage de requête est celui d'Opendatasoft et non un langage maison, ce qui est le principal point à apprendre.

Les familles d'avis

Le champ familleavis indique le type d'événement : collective pour les procédures collectives (le signal de risque), creation pour les immatriculations, modification pour les changements, radiation pour les radiations, vente pour les cessions de fonds de commerce, et depot pour le dépôt des comptes annuels — le fait du dépôt, pas les comptes eux-mêmes. Filtrer sur ce champ est indispensable, sinon une immatriculation se mélange avec une liquidation.

Deux pièges

Le champ jugement est souvent une chaîne encodée en JSON plutôt qu'un objet, et sa forme n'est pas stable d'une année sur l'autre — il faut le parser avec prudence. Et [ND] signifie « non disponible », une protection de la vie privée appliquée à la source : c'est une valeur légitime, pas une donnée manquante ni un flux cassé.

Ne pas traiter chaque avis collectif comme un échec

Sauvegarde signifie que l'entreprise n'est PAS en cessation des paiements et agit par anticipation — y voir de l'insolvabilité est simplement une erreur. Redressement judiciaire signifie cessation des paiements constatée avec une perspective de redressement. Liquidation judiciaire signifie que le redressement est jugé impossible. Un simple indicateur booléen « avis d'insolvabilité » écrase ces trois régimes et fausse l'évaluation du risque dans les deux sens.

Là où une couche multi-pays aide

Le BODACC est gratuit et fait autorité ; si la France est votre seul marché, interrogez-le directement. Ce que vous prenez en charge vous-même : les familles d'avis et leur dérive historique, les changements de forme du champ jugement, le rattachement au SIREN, et une intégration distincte par pays. Prometiam sert la même insolvabilité française sous un format normalisé, aux côtés de huit autres marchés — corporate uniquement, jamais personnel.

Lire le guide complet · Obtenir une clé gratuite

Les familles d'avis

ValeurSignification
collectiveProcédures collectives — sauvegarde, redressement, liquidation. Le signal de risque.
creationImmatriculations — nouvelles inscriptions.
modificationChangements sur une immatriculation existante.
radiationRadiation du registre.
venteVentes et cessions de fonds de commerce.
depotDépôt des comptes annuels — le FAIT du dépôt, pas les comptes eux-mêmes.

Frequently asked questions

L'API BODACC est-elle gratuite ?
Oui. Le BODACC est publié en open data par la DILA via une instance Opendatasoft, sans clé d'API ni inscription. Le langage de requête est celui d'Opendatasoft, pas un langage maison.
Que signifie familleavis dans le BODACC ?
C'est la catégorie de l'avis : collective pour les procédures collectives (insolvabilité), creation pour les nouvelles immatriculations, modification pour les changements, radiation pour les radiations, vente pour les cessions de fonds de commerce, et depot pour le dépôt des comptes annuels. Filtrer sur ce champ est indispensable, sinon les types d'événements se mélangent.
Que signifie [ND] dans un avis BODACC ?
Non disponible — une protection de la vie privée appliquée à la source par le publicateur. C'est une valeur légitime plutôt qu'une donnée manquante ou un flux cassé, et les avis qui la contiennent ne doivent pas être simplement écartés.
Un avis de sauvegarde équivaut-il à une faillite ?
Non. Sauvegarde signifie que l'entreprise n'est pas en cessation des paiements et agit par anticipation pour traiter ses difficultés. Redressement judiciaire signifie cessation des paiements constatée avec une perspective de redressement, et liquidation judiciaire signifie que le redressement est jugé impossible. Regrouper les trois sous un seul indicateur d'insolvabilité fausse l'évaluation du risque.