Ce qu'il est utile de surveiller
Une vérification faite à la création d'une fiche ne dit rien de ce qui arrive ensuite. Les changements qui comptent pour un client ou un fournisseur sont peu nombreux :
- le statut : l'entreprise passe de active à fermée ;
- une procédure collective : sauvegarde, redressement ou liquidation (voir Comment savoir si une entreprise est en liquidation judiciaire) ;
- le nom, l'adresse ou la forme juridique, qui changent les mentions à porter sur vos factures ;
- le contrôle des sanctions, dont le statut peut évoluer.
Comment fonctionne la surveillance
Vous ajoutez des entreprises à votre liste. L'état enregistré à l'ajout sert de référence : aucun événement n'est créé pour le passé. Ensuite, chaque différence détectée devient un événement, par exemple company.status_changed ou company.address_changed, avec la valeur avant et après. Vous le lisez avec GET /v2/events ou vous le recevez sur votre webhook.
curl -X PUT "https://api.jsonpage.com/v2/monitors/FR-552032534" \
-H "X-API-Key: $JSONPAGE_API_KEY"La réponse est 201 si l'entreprise est ajoutée, 200 si elle l'était déjà. Pour arrêter, DELETE sur la même adresse.
E-mail, webhook ou tableau de bord
- E-mail : alertes immédiates ou regroupées, configurables dans l'espace client.
- Webhook : une adresse HTTPS par compte reçoit chaque événement en
POST, signé avec un secret que vous gardez. Vérifiez la signature avant de traiter l'événement ; la méthode et des exemples de code sont dans la documentation. - Lecture :
GET /v2/eventsrenvoie les événements du plus ancien au plus récent, avec un curseur pour reprendre là où vous vous êtes arrêté. Ils restent lisibles 90 jours.
Si votre serveur est indisponible, rien n'est perdu : relisez les événements depuis votre dernier curseur.
Les limites par forfait
Le nombre d'entreprises surveillées dépend du forfait : 2 (Découverte), 1 000 (Standard) ou 10 000 (Pro). Au-delà, l'ajout renvoie 403 monitor_limit_reached ; vous êtes prévenu par e-mail à 80 % et à 100 % de la limite, et les entreprises déjà suivies continuent d'être surveillées. L'import d'un fichier dans le tableau de bord ajoute des entreprises jusqu'à la limite et indique combien ont été ignorées.
Une information n'est connue qu'une fois publiée : un changement très récent peut ne pas encore apparaître. La surveillance aide à décider, elle ne remplace ni un conseil juridique ni une analyse de solvabilité.
Questions fréquentes
Faut-il écrire du code pour surveiller des entreprises ?+
Non. Vous pouvez ajouter des entreprises et lire les alertes depuis l'espace client, ou par l'API si vous préférez automatiser.
Suis-je prévenu d'un changement qui a eu lieu avant l'ajout ?+
Non. L'état enregistré à l'ajout sert de référence ; seuls les changements suivants créent des événements.
Les webhooks sont-ils payants ?+
Non, ils sont inclus dans tous les forfaits et leurs livraisons ne comptent pas comme des requêtes.
Que faire si mon serveur ne répond pas ?+
Relisez les événements avec GET /v2/events à partir de votre dernier curseur : ils restent disponibles 90 jours.
Pour aller plus loin
- PROCÉDURES COLLECTIVESComment savoir si une entreprise est en liquidation judiciaireLiquidation, redressement et sauvegarde expliqués, les signaux à suivre et les alertes sur vos clients et fournisseurs.
- STATUTEntreprise radiée, fermée, en sommeil : comment le savoirRadiée, fermée, en sommeil : les définitions, pourquoi vérifier avant de facturer et comment être alerté d'un changement.
- VÉRIFICATIONVérifier qu'une entreprise existe vraiment avant de signerUne checklist en six points : identifiant, statut, nom et adresse, TVA, signaux et listes de sanctions.