Was sich zu überwachen lohnt
Eine Prüfung beim Anlegen eines Datensatzes sagt nichts darüber, was danach geschieht. Die Änderungen, die für einen Kunden oder Lieferanten zählen, sind überschaubar:
- der Status: Das Unternehmen wechselt von aktiv zu geschlossen;
- ein Insolvenzverfahren: Sicherungs-, Sanierungs- oder Liquidationsverfahren (siehe So erfahren Sie, ob ein französisches Unternehmen in gerichtlicher Liquidation ist);
- Name, Adresse oder Rechtsform, die die Angaben auf Ihren Rechnungen ändern;
- die Sanktionsprüfung, deren Status sich ändern kann.
So funktioniert die Überwachung
Sie nehmen Unternehmen in Ihre Liste auf. Der Stand zu diesem Zeitpunkt ist die Referenz: Für die Vergangenheit entsteht kein Ereignis. Danach wird jeder erkannte Unterschied zu einem Ereignis, etwa company.status_changed oder company.address_changed, mit dem Wert davor und danach. Sie lesen es mit GET /v2/events oder erhalten es auf Ihrem Webhook.
curl -X PUT "https://api.jsonpage.com/v2/monitors/FR-552032534" \
-H "X-API-Key: $JSONPAGE_API_KEY"
Die Antwort lautet 201, wenn das Unternehmen hinzugefügt wird, und 200, wenn es schon in der Liste war. Zum Beenden senden Sie DELETE an dieselbe Adresse.
E-Mail, Webhook oder Dashboard
- E-Mail: sofortige oder gebündelte Meldungen, im Kundenbereich einstellbar.
- Webhook: Eine HTTPS-Adresse pro Konto erhält jedes Ereignis als
POST, signiert mit einem Geheimnis, das Sie selbst aufbewahren. Prüfen Sie die Signatur, bevor Sie das Ereignis verarbeiten; Methode und Codebeispiele stehen in der Dokumentation. - Abruf:
GET /v2/eventsliefert die Ereignisse vom ältesten zum neuesten, mit einem Cursor, um dort weiterzumachen, wo Sie aufgehört haben. Sie bleiben 90 Tage lesbar.
Ist Ihr Server nicht erreichbar, geht nichts verloren: Lesen Sie die Ereignisse ab Ihrem letzten Cursor erneut.
Grenzen je Tarif
Die Zahl der überwachten Unternehmen hängt vom Tarif ab: 2 (Kennismaking), 1.000 (Standard) oder 10.000 (Pro). Darüber liefert das Hinzufügen 403 monitor_limit_reached; Sie werden bei 80 % und 100 % der Grenze per E-Mail gewarnt, und bereits verfolgte Unternehmen bleiben überwacht. Ein Dateiimport im Dashboard fügt Unternehmen bis zur Grenze hinzu und meldet, wie viele übersprungen wurden.
Eine Information ist erst bekannt, wenn sie veröffentlicht wurde: Eine sehr frische Änderung erscheint eventuell noch nicht. Die Überwachung hilft bei Entscheidungen; sie ersetzt weder Rechtsberatung noch eine Bonitätsanalyse.
Häufige Fragen
Muss ich Code schreiben, um Unternehmen zu überwachen?+
Nein. Sie können Unternehmen hinzufügen und Meldungen im Kundenbereich lesen, oder die API nutzen, wenn Sie automatisieren möchten.
Werde ich über eine Änderung vor dem Hinzufügen informiert?+
Nein. Der Stand beim Hinzufügen ist die Referenz; nur spätere Änderungen erzeugen Ereignisse.
Kosten Webhooks extra?+
Nein, sie sind in jedem Tarif enthalten, und ihre Zustellungen zählen nicht als Anfragen.
Was, wenn mein Server nicht antwortet?+
Lesen Sie die Ereignisse mit GET /v2/events ab Ihrem letzten Cursor erneut: Sie bleiben 90 Tage verfügbar.
Weiterlesen
- INSOLVENZVERFAHRENPrüfen, ob ein französisches Unternehmen in Liquidation istLiquidation, Redressement und Sauvegarde erklärt, die Signale, auf die Sie achten sollten, und Alerts zu Ihren Kunden und Lieferanten.
- STATUSGelöschtes, geschlossenes oder ruhendes französisches Unternehmen: so erkennen Sie esGelöscht, geschlossen, ruhend: die Definitionen, warum Sie vor der Rechnungsstellung prüfen und wie Sie über eine Änderung gewarnt werden.
- PRÜFUNGExistiert dieses Unternehmen wirklich? Prüfungen vor VertragsabschlussEine Checkliste mit sechs Punkten: Kennung, Status, Name und Adresse, USt-IdNr., Signale und Sanktionslisten.