kvk wijzigingen alert
KvK wijzigingen alert voor de bedrijven die je volgt
Je hoeft de KvK niet te openen om te weten of een bedrijf is veranderd. KVKBase vergelijkt elke dag de gegevens en stuurt een alert met de oude en de nieuwe waarde, per mail, als dagelijkse samenvatting of als webhook naar je eigen systeem.
Wat een alert bevat
Elke wijziging is een eigen melding: het bedrijf, het KvK-nummer, welk veld is veranderd, wat het was en wat het nu is. Verandert er op één dag meer dan één ding, dan zie je ze bij elkaar in één mail.
Een veld dat in de bron even niet beschikbaar is, geldt niet als wijziging. Een tijdelijk lege of onvolledige respons veroorzaakt dus geen valse melding.
Kies hoe je het ontvangt
Standaard krijg je een mail zodra een wijziging is gevonden. Houd je liever overzicht, kies dan de dagelijkse digest: één mail per dag, gegroepeerd per bedrijf. Bij veel wijzigingen op een dag gaat het overschot automatisch naar de digest, zodat je inbox niet volloopt.
Een webhook ontvangt elke wijziging als JSON via HTTPS. Elk bericht is ondertekend, zodat je kunt controleren dat het van ons komt. De handtekening is een HMAC-SHA256 over de tijdstempel en de body, met een geheim dat alleen jij kent.
- E-mail per wijziging of als dagelijkse digest
- Webhook met HMAC-SHA256 handtekening en tijdstempel
- Nieuwe pogingen als je endpoint even niet bereikbaar is
- Kies zelf welke velden een melding mogen geven
Een alert in je eigen systeem verwerken
De webhook past bij een ticket in je helpdesk, een taak in je CRM of een vlag in je boekhouding. Controleer de handtekening, verwerk het bericht en antwoord met een 2xx. Alleen HTTPS-adressen werken, en redirects volgen we niet.
De details staan in de monitoring-documentatie. Wil je het eerst rustig lezen: webhooks en polling voor bedrijfsdata legt de achterliggende afwegingen uit.
Wat we volgen
Elk bewaakt bedrijf wordt één keer per dag vergeleken met de vorige stand. Dit zijn de velden die een alert kunnen geven:
- Naam
- Statutaire naam en handelsnaam
- Adres
- Straat, postcode en plaats
- Rechtsvorm
- Bijvoorbeeld van eenmanszaak naar BV
- Status
- Actief of opgeheven
- Insolventie
- Faillissement of surseance van betaling, zoals de bron het meldt
- SBI-codes
- De geregistreerde activiteiten
- Bestuurders
- Alleen als de bron ze voor dat bedrijf levert
- BTW-nummer
- Geldig of ongeldig bij VIES, als er een BTW-nummer bekend is
Zo komen alerts bij je binnen
- Eén mail per wijziging, meteen. Of kies een dagelijkse digest, gegroepeerd per bedrijf.
- Getekende webhook
- Elke wijziging als JSON via HTTPS, met een tijdstempel en een HMAC-SHA256 handtekening die je kunt controleren.
- API
- Lees je lijst en de meldingsgeschiedenis met je API-key, en exporteer ze als CSV vanuit het dashboard.
Controles lopen dagelijks, niet realtime. De eerste controle van een bedrijf is een nulmeting en geeft geen alert.
Voor wie is dit
- Teams die al een lijst klanten of leveranciers hebben en daar een signaal bij willen
- Ontwikkelaars die wijzigingen in hun eigen software willen verwerken
- Wie zijn relaties wil bewaken zonder zelf te zoeken
Inbegrepen in de betaalde abonnementen
Monitoring zit in je abonnement als bewakingsplekken. Een controle kost nooit lookup-tokens.
- Gratis
- Geen monitoring
- Starter
- 10 bedrijven
- Pro
- 100 bedrijven
- Business
- 1.000 bedrijven
Zakt je abonnement, dan worden bewakingen boven de nieuwe limiet gepauzeerd, niet verwijderd.
Veelgestelde vragen
Hoe snel krijg ik een alert?
Welke wijzigingen worden gemeld?
Kan ik de handtekening van de webhook controleren?
Kan ik maar een deel van de velden volgen?
Wat als mijn webhook uitvalt?
Meer over monitoring
- Bedrijf monitoren: wijzigingen in het Handelsregister volgen
- Debiteurenrisico monitoren met KvK-wijzigingen
- Leverancier monitoren: tijdig weten als een leverancier wegvalt
- Zoek je één bedrijf op? Lees dan de uitleg over de KVK API
Verder lezen
Begin met de bedrijven die er toe doen
Maak een account, kies een betaald abonnement en voeg je eerste bedrijven toe op KvK-nummer.