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.
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.
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/eventsgeeft 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.
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.
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.
Verder lezen
- INSOLVENTIEPROCEDURESControleren of een Frans bedrijf in liquidatie isLiquidation, redressement en sauvegarde uitgelegd, de signalen om op te letten en meldingen over uw klanten en leveranciers.
- STATUSGeschrapt, gesloten of slapend Frans bedrijf: hoe herkent u hetGeschrapt, gesloten, slapend: de definities, waarom u vóór het factureren controleert en hoe u een wijziging gemeld krijgt.
- CONTROLEBestaat dit bedrijf echt? Controles vóór het tekenenEen checklist van zes punten: identificatienummer, status, naam en adres, btw, signalen en sanctielijsten.