Kunden oder Lieferanten vor der Zusammenarbeit prüfen
Vor einer ersten Bestellung, einem Vertrag oder einem Lieferantenkredit steht eine einfache Frage: Gibt es dieses Unternehmen noch, und in welcher rechtlichen Lage befindet es sich?
Das Problem#
Ein Einkaufsteam nimmt einen neuen Lieferanten auf, ein Vertriebsmitarbeiter gewährt einem neuen Kunden ein Zahlungsziel. In beiden Fällen verlässt man sich oft auf die Angaben des Unternehmens selbst: einen Namen, eine Nummer, eine Adresse auf einem Angebot. Niemand prüft, ob die Nummer wirklich zu diesem Unternehmen gehört, ob es noch aktiv ist oder ob es sich in einem Konkurs oder einer Liquidation befindet.
Die manuelle Prüfung gibt es (die öffentliche Suche der BCE), aber sie skaliert nicht: Sie muss für jeden Dritten wiederholt, irgendwo festgehalten werden, und niemand wiederholt sie sechs Monate später. Diese Prüfung gehört in Ihr eigenes Werkzeug, in dem Moment, in dem der Datensatz des Dritten angelegt wird.
Die API-Daten, die antworten#
GET /enterprise/{num}: der Unternehmensdatensatz mit Status im Register, Code der Rechtslage, Rechtsform, Gründungsdatum und Sitz.GET /juridical-situations: die Referenzliste der Codes der Rechtslage (normale Lage, Konkurs, Auflösung…), zum Zwischenspeichern und um einen Code in eine Bezeichnung zu übersetzen.GET /juridical-forms: die Referenzliste der Rechtsformen (SA, SRL, ASBL…) mit ihren offiziellen Codes.GET /enterprise/{num}/establishments: die verknüpften Niederlassungseinheiten, nützlich, wenn der Dritte von einem Betriebsstandort aus abrechnet.
Der Datensatz enthält einen Statuscode (AC für ein aktives Unternehmen) und den Code der Rechtslage. Ist diese Lage nicht normal, ergänzt die Antwort die Bezeichnung und ein Kennzeichen inDistress: das ist das Signal, das an einen Menschen weitergegeben wird.
Beispielanfrage#
"tok-comment"># Enterprise record: status, juridical situation, legal form
curl https://companybelgium.be/api/v2/enterprise/1033.022.383 \
-H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"
"tok-comment">
# Reference list of juridical situation codes (cache it on your side)
curl "https://companybelgium.be/api/v2/juridical-situations" \
-H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"Auszug der Antwort in der Standard-JSON-Envelope:
{
"success": true,
"data": {
"enterpriseNumber": "1033.022.383",
"name": "ESPERO-SOFT INFORMATIQUES",
"statusCode": "AC",
"juridicalSituationCode": "...",
"inDistress": "...",
"juridicalFormCode": "610"
},
"timestamp": "...",
"meta": {
"responseTime": "..."
}
}Empfohlene Umsetzung#
- Führen Sie den Aufruf serverseitig aus, beim Anlegen des Datensatzes des Dritten, nie aus dem Browser: Schlüssel und Secret dürfen Ihr Backend nicht verlassen.
- Behandeln Sie eine 404-Antwort als Signal, nicht als technischen Fehler: Eine dem Register unbekannte Nummer verdient eine menschliche Prüfung.
- Nutzen Sie drei statt zwei Ergebnisse: angenommen, gesperrt (Unternehmen nicht aktiv), zu prüfen (ungewöhnliche Rechtslage oder unbekannte Nummer).
- Speichern Sie das Datum der Prüfung und den erhaltenen Code in Ihrer eigenen Datenbank: das belegt, dass die Prüfung stattgefunden hat.
- Abonnieren Sie Dritte, mit denen Sie dauerhaft arbeiten, über einen Webhook, statt die Prüfung von Hand zu wiederholen (siehe Fall „Unternehmen überwachen“).
Grenzen, die Sie kennen sollten#
- Die API spiegelt wider, was die BCE veröffentlicht hat. Ein von einem Gericht eröffneter Konkurs erscheint erst, wenn er im Register eingetragen ist, nicht am Tag des Urteils.
- Ein aktiver Status sagt nichts über die Zahlungsfähigkeit oder Qualität eines Lieferanten aus. Es ist eine Prüfung von Existenz und Rechtslage, keine Bonitätsnote.
- Die offiziellen BCE-Daten nennen nicht immer den Grund einer Einstellung. Schließen Sie nicht aus einem bloß inaktiven Unternehmen auf einen Konkurs.
- Die Finanzübersicht (
/enterprise/{num}/financial) hängt von den bei der Nationalbank hinterlegten Abschlüssen ab: Ein kleines Unternehmen oder eine natürliche Person hat oft keine.
Häufige Fragen#
Wie erkenne ich per API, ob ein belgisches Unternehmen in Konkurs ist?
Rufen Sie GET /enterprise/{num} auf. Die Antwort enthält den Code der Rechtslage; ist sie nicht normal, ergänzt sie die Bezeichnung und das Kennzeichen inDistress. Die Referenzliste GET /juridical-situations übersetzt jeden Code.
Zählt die Prüfung zu meinem Kontingent?
Ja, jeder Aufruf des Unternehmensdatensatzes zählt zum Monatskontingent Ihres Schlüssels. Nur der Endpunkt /me, der Ihren Verbrauch anzeigt, wird nicht gezählt.
Kann ich ein ausländisches Unternehmen prüfen?
Den Datensatz nicht: Die API deckt das belgische Register ab. Für eine USt-Nummer aus einem anderen Land der Europäischen Union nutzen Sie die VIES-Validierung (GET /vat/{vatNumber}).
In die Praxis umsetzen
Erstellen Sie einen Schlüssel im Entwicklerportal und folgen Sie dann der Referenzdokumentation für jeden genannten Endpunkt.
Referenzdokumentation