Jsonpage · SIREN- en SIRET-API
KENNISBANK · VOLGEN

Uw klanten en leveranciers automatisch bewaken

Om uw klanten en leveranciers te bewaken zonder handmatig opnieuw te controleren, voegt u hun nummers toe aan een bewakingslijst: elke wijziging (sluiting, collectieve procedure, nieuw adres, nieuwe naam) wordt een gebeurtenis die u per e-mail, op een ondertekende webhook of in het dashboard ontvangt.

Door Devintech · Gepubliceerd op · Bijgewerkt op · 5 min leestijd

01 / WAAROM

Wat de moeite waard is om te bewaken

Een controle bij het aanmaken van een dossier zegt niets over wat daarna gebeurt. De wijzigingen die voor een klant of leverancier tellen, zijn beperkt:

  • de status: het bedrijf gaat van actief naar gesloten;
  • een collectieve procedure: bescherming, herstructurering of vereffening (zie Hoe weet u of een Frans bedrijf in gerechtelijke vereffening is);
  • de naam, het adres of de rechtsvorm, die de vermeldingen op uw facturen veranderen;
  • de sanctiecontrole, waarvan de status kan veranderen.
Bewaking is bij elk abonnement inbegrepen2 bewaakte bedrijven met het abonnement Kennismaking, 1.000 met Standard (19 € excl. btw per maand) en 10.000 met Pro (129 € excl. btw per maand). Zie Prijzen.
02 / WERKING

Hoe bewaking werkt

U voegt bedrijven toe aan uw lijst. De toestand op dat moment is de referentie: er wordt geen gebeurtenis voor het verleden aangemaakt. Daarna wordt elk vastgesteld verschil een gebeurtenis, bijvoorbeeld company.status_changed of company.address_changed, met de waarde ervoor en erna. U leest ze met GET /v2/events of ontvangt ze op uw webhook.

curl -X PUT "https://api.jsonpage.com/v2/monitors/FR-552032534" \
  -H "X-API-Key: $JSONPAGE_API_KEY"

Het antwoord is 201 als het bedrijf wordt toegevoegd, 200 als het al in de lijst stond. Om te stoppen stuurt u DELETE naar hetzelfde adres.

Bewaking: van de bedrijvenlijst tot de meldingUw lijstklanten enleveranciersVergelijkingmet de bewaardetoestandGebeurteniséén verschil= één gebeurtenisMeldinge-mail, webhookof dashboard
Elk verschil dat bij een bewaakt bedrijf wordt vastgesteld, wordt een gebeurtenis en dan een melding.
03 / MELDINGEN

E-mail, webhook of dashboard

  • E-mail: onmiddellijke of gegroepeerde meldingen, in te stellen in het klantengedeelte.
  • Webhook: één HTTPS-adres per account ontvangt elke gebeurtenis als POST, ondertekend met een geheim dat u zelf bewaart. Controleer de handtekening voordat u de gebeurtenis verwerkt; de methode en codevoorbeelden staan in de documentatie.
  • Uitlezen: GET /v2/events geeft de gebeurtenissen van oud naar nieuw, met een cursor om verder te gaan waar u stopte. Ze blijven 90 dagen leesbaar.

Is uw server niet bereikbaar, dan gaat er niets verloren: lees de gebeurtenissen opnieuw vanaf uw laatste cursor.

04 / LIMIETEN

Limieten per abonnement

Het aantal bewaakte bedrijven hangt van het abonnement af: 2 (Kennismaking), 1.000 (Standard) of 10.000 (Pro). Daarboven geeft toevoegen 403 monitor_limit_reached; u krijgt een e-mail bij 80 % en 100 % van de limiet, en de bedrijven die u al volgt blijven bewaakt. Een bestandsimport in het dashboard voegt bedrijven toe tot de limiet en meldt hoeveel er zijn overgeslagen.

Informatie is pas bekend zodra ze is gepubliceerd: een zeer recente wijziging verschijnt mogelijk nog niet. Bewaking helpt bij beslissingen; ze vervangt geen juridisch advies en geen solvabiliteitsanalyse.

05 / VEELGESTELDE VRAGEN

Veelgestelde vragen

Moet ik code schrijven om bedrijven te bewaken?+

Nee. U kunt bedrijven toevoegen en meldingen lezen in het klantengedeelte, of de API gebruiken als u liever automatiseert.

Word ik verwittigd van een wijziging van vóór de toevoeging?+

Nee. De toestand bij het toevoegen is de referentie; alleen latere wijzigingen maken gebeurtenissen aan.

Zijn webhooks betalend?+

Nee, ze zijn bij elk abonnement inbegrepen en hun leveringen tellen niet als verzoeken.

Wat als mijn server niet antwoordt?+

Lees de gebeurtenissen opnieuw met GET /v2/events vanaf uw laatste cursor: ze blijven 90 dagen beschikbaar.

06 / GERELATEERDE ARTIKELEN

Verder lezen

PROBEER HET

Probeer het met uw eigen nummers

Het gratis account geeft toegang tot het bedrijfsdossier, de validatie en zoeken op naam: 100 verzoeken per minuut, zonder bankkaart.