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é.
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 :
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 :
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 :
| Entreprise | BCE | Statut | Dernière vérification | Alertes |
|---|---|---|---|---|
| ACME SA | 0123.456.789 | ✅ Active | Il y a 2h | - |
| Beta SPRL | 0987.654.321 | ⚠️ En liquidation | Il y a 1h | Statut changé |
| Gamma SRL | 0456.789.123 | ✅ Active | Il y a 3h | Adresse changée |
Fréquence de vérification recommandée
| Type de partenaire | Fréquence |
|---|---|
| Clients majeurs | Quotidienne |
| Fournisseurs critiques | Quotidienne |
| Partenaires réguliers | Hebdomadaire |
| Prospects | Avant chaque interaction |
| Base complète | Mensuelle |
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.
Commentaires
Articles similaires

Belgian Crossroads Bank for Enterprises (BCE/KBO) API : documentation développeur complète en anglais
Documentation développeur en anglais pour l'API de la Banque-Carrefour des Entreprises belge. Vue d'ensemble du registre BCE/KBO, contexte légal, options d'accès, démarrage rapide avec exemples cURL et patterns d'intégration pour les développeurs internationaux.

Rate limits, quotas et caching pour scaler une application BCE/KBO : architecture de référence
Votre app interroge l'API BCE/KBO en volume — comment éviter les 429, maîtriser les coûts et garantir la latence ? Architecture de référence avec cache à plusieurs niveaux, file de requêtes, observabilité et webhooks. Patterns concrets et chiffres à viser.

BCE API endpoints reference : liste complète des routes REST (companies, addresses, NACE, UBO, établissements, Peppol)
Référence technique exhaustive des endpoints REST de l'API Company Belgium : recherche, fiche entreprise, adresses, activités NACE, établissements, dirigeants, UBO, vérification Peppol. Avec schémas de réponse, paramètres et codes d'erreur.
