CompanyBelgium

Surveiller les changements d'entreprises : monitoring et alertes

Comment surveiller les modifications de vos partenaires commerciaux ? Configurez des alertes automatiques pour les changements de statut, d'adresse ou d'activité.

3 avril 20266 min de lecture

En bref

Les données d'entreprises belges enregistrées dans la BCE/KBO changent quotidiennement : statuts, adresses, formes juridiques, dénominations. Pour détecter ces changements sans exploser votre quota API, préférez les webhooks de Company Belgium au polling régulier. Un webhook suffit pour couvrir 1 000 entreprises là où le polling consommerait 96 000 requêtes par jour.

Pourquoi surveiller vos partenaires ?

Les données d'entreprises évoluent constamment :

  • Changement de statut : une entreprise active peut être radiée ou mise en liquidation
  • Déménagement : changement d'adresse du siège social
  • Modification d'activité : ajout ou suppression de codes NACE
  • Changement de forme juridique : transformation de SRL en SA, par exemple
  • Changement de dénomination : nouveau nom commercial

Ne pas détecter ces changements peut entraîner :

  • Facturer une entreprise radiée
  • Livrer à une mauvaise adresse
  • Travailler avec un partenaire en difficulté financière

Solution 1 : Polling régulier

Interrogez régulièrement l'API pour détecter les changements :

TypeScript
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
interface MonitoredCompany {
  bceNumber: string;
  lastKnownStatus: string;
  lastKnownAddress: string;
  lastKnownName: string;
  lastChecked: Date;
}

async function checkForChanges(companies: MonitoredCompany[]) {
  const changes = [];

  for (const company of companies) {
    const response = await fetch(
      class="code-string">`https:class="code-comment">//companybelgium.be/api/companies/${company.bceNumber}`,
      { headers: { class="code-string">'X-API-Key': apiKey, class="code-string">'X-API-Secret': apiSecret } }
    );

    const current = await response.json();

    class="code-comment">// Détecter les changements
    if (current.status !== company.lastKnownStatus) {
      changes.push({
        bceNumber: company.bceNumber,
        type: class="code-string">'status',
        old: company.lastKnownStatus,
        new: current.status,
      });
    }

    if (current.address !== company.lastKnownAddress) {
      changes.push({
        bceNumber: company.bceNumber,
        type: class="code-string">'address',
        old: company.lastKnownAddress,
        new: current.address,
      });
    }

    if (current.name !== company.lastKnownName) {
      changes.push({
        bceNumber: company.bceNumber,
        type: class="code-string">'name',
        old: company.lastKnownName,
        new: current.name,
      });
    }

    class="code-comment">// Mettre à jour les données connues
    company.lastKnownStatus = current.status;
    company.lastKnownAddress = current.address;
    company.lastKnownName = current.name;
    company.lastChecked = new Date();
  }

  return changes;
}

Solution 2 : Webhooks (recommandé)

Configurez des webhooks pour recevoir des notifications automatiques :

TypeScript
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
import express from class="code-string">'express';

const app = express();
app.use(express.json());

class="code-comment">// Endpoint pour recevoir les notifications
app.post(class="code-string">'/webhooks/company-changes', (req, res) => {
  const { event, data } = req.body;

  switch (event) {
    case class="code-string">'company.status_changed':
      console.log(class="code-string">`Statut modifié : ${data.bceNumber} → ${data.newStatus}`);
      class="code-comment">// Envoyer une alerte email/Slack
      notifyTeam(data);
      break;

    case class="code-string">'company.address_changed':
      console.log(class="code-string">`Adresse modifiée : ${data.bceNumber}`);
      updateCRM(data);
      break;

    case class="code-string">'company.name_changed':
      console.log(class="code-string">`Nom modifié : ${data.bceNumber}`);
      updateRecords(data);
      break;
  }

  res.status(200).json({ received: true });
});

Solution 3 : Dashboard de monitoring

Créez un tableau de bord interne pour visualiser l'état de vos partenaires :

EntrepriseBCEStatutDernière vérificationAlertes
ACME SA0123.456.789✅ ActiveIl y a 2h-
Beta SPRL0987.654.321⚠️ En liquidationIl y a 1hStatut changé
Gamma SRL0456.789.123✅ ActiveIl y a 3hAdresse changée

Fréquence de vérification recommandée

Type de partenaireFréquence
Clients majeursQuotidienne
Fournisseurs critiquesQuotidienne
Partenaires réguliersHebdomadaire
ProspectsAvant chaque interaction
Base complèteMensuelle

Notifications

Intégrez les alertes dans vos outils existants :

  • Email : résumé quotidien des changements
  • Slack/Teams : notification immédiate pour les changements critiques
  • CRM : mise à jour automatique des fiches

Ressources complémentaires

Pour aller plus loin dans la surveillance des entreprises belges, consultez le guide d'intégration de l'API BCE/KBO pour démarrer rapidement, et l'architecture rate limits et caching pour maintenir la latence sous 50 ms même en volume. Si votre processus de surveillance inclut une vérification KYC, lisez aussi le guide sur la vérification KYC automatisée. Pour les développeurs Python, le tutoriel FastAPI montre comment implémenter un endpoint de réception de webhooks.

Conclusion

Surveiller les changements de vos partenaires commerciaux est essentiel pour la gestion des risques. Notre API, combinée à des webhooks ou du polling régulier, vous permet d'automatiser cette surveillance.

Questions fréquentes

Comment detecter automatiquement qu'une entreprise belge a change de statut dans la BCE ?

La méthode la plus efficace est de configurer un webhook Company Belgium qui envoie un événement company.status_changed dès qu'un changement est enregistré dans la BCE/KBO. En alternative, vous pouvez interroger régulièrement l'endpoint GET /api/companies/{numero} et comparer le champ status avec votre dernière valeur connue. Le webhook est préférable car il élimine le polling inutile et réduit votre consommation API d'un facteur 4 800.

Quelle est la frequence de mise a jour des donnees d'entreprises dans la BCE/KBO belge ?

La BCE/KBO est mise à jour quotidiennement via les imports Open Data du SPF Économie. Les fichiers Full et Update sont publiés chaque jour sur le serveur FTP du gouvernement belge. Company Belgium synchronise ces données tous les jours, ce qui signifie que les changements de statut, d'adresse et de dénomination sont généralement reflétés dans l'API en moins de 24 heures après leur enregistrement officiel.

Quels types de changements peut-on surveiller sur une entreprise belge via l'API ?

Via l'API Company Belgium, vous pouvez surveiller les changements de statut (actif, radié, en liquidation, en faillite), les changements d'adresse du siège social, les modifications de dénomination ou de nom commercial, les ajouts ou suppressions de codes NACE (secteur d'activité), et les changements de forme juridique. Les webhooks supportent 9 types d'événements distincts pour couvrir l'ensemble de ces cas.

Vaut-il mieux utiliser des webhooks ou du polling pour surveiller des entreprises belges ?

Les webhooks sont recommandés dans presque tous les cas. Avec du polling toutes les 15 minutes sur 1 000 entreprises, vous consommez environ 96 000 requêtes par jour, ce qui nécessite un plan Pro. Avec des webhooks, vous ne recevez que les événements réels, soit environ 20 notifications par jour pour la même couverture. La différence de consommation est de 4 800 fois, et le plan gratuit suffit souvent pour les petits portefeuilles.

Prêt à commencer ?

Créez votre compte gratuitement et obtenez vos clés API en quelques minutes.

Commentaires

Chargement des commentaires…

Laisser un commentaire

Non publié — sert uniquement à vous notifier.

Les commentaires sont modérés avant publication.

Articles similaires

    Surveiller changements entreprises BCE/KBO : alertes 2026 | CompanyBelgium