Zum Inhalt
API BCEAPI BCEAPI für belgische Unternehmensdaten
AnwendungsfällePreiseDokumentationSandboxAPI-Schlüssel
🇬🇧 English🇫🇷 Français🇳🇱 Nederlands🇩🇪 Deutsch🇪🇸 Español
API-Schlüssel
API BCE / Anwendungsfälle / Ein CRM automatisch aus der Unternehmensnummer anreichern

📇 Ein CRM automatisch aus der Unternehmensnummer anreichern

Eine Unternehmensnummer genügt, um einen Kunden- oder Interessentendatensatz sauber zu füllen: offizielle Bezeichnung, Adresse des Sitzes, Tätigkeiten und veröffentlichte Kontaktdaten.

Das Problem#

In einem CRM existiert dieselbe Gesellschaft oft dreimal: „Dupont SRL“, „DUPONT“ und „Dupont & Söhne“, jeweils mit einer leicht anderen Adresse. Datensätze werden von Hand erfasst, Anruf für Anruf, und niemand weiß, welcher stimmt. Berichte nach Branche oder Region werden falsch, und die Rechnungsstellung nimmt die jüngste Adresse, nicht unbedingt die richtige.

Die Unternehmensnummer ist die stabile Kennung einer belgischen Gesellschaft. Geht Ihr Werkzeug von dieser Nummer aus, kann es den Rest aus der offiziellen Quelle holen, statt ihn eintippen zu lassen.

Die API-Daten, die antworten#

  • GET /denominations?q=…: Autovervollständigung auf Unternehmensnamen, um ab den ersten getippten Buchstaben die richtige Gesellschaft vorzuschlagen und ihre Nummer zu erhalten.
  • GET /enterprise/{num}: der Hauptdatensatz (Bezeichnung, Rechtsform, Status, Gründungsdatum, Sitz).
  • GET /enterprise/{num}/address: nur die Adresse des Sitzes, wenn Sie nur dieses Feld aktualisieren möchten.
  • GET /enterprise/{num}/activities: alle angegebenen NACE-Tätigkeiten, um Ihre Konten nach Branche einzuordnen.
  • GET /enterprise/{num}/denominations: alle Bezeichnungen (offiziell, abgekürzt, kommerziell) in den veröffentlichten Sprachen.
  • GET /enterprise/{num}/contact: Telefon, E-Mail und Website, wenn das Unternehmen sie veröffentlicht hat.
  • GET /naces: Suche in der NACE-Nomenklatur, um die Bezeichnung eines Codes anzuzeigen oder eigene Segmente zu bilden.

Beispielanfrage#

"tok-comment"># 1. Type-ahead on the company name, returns enterprise numbers
curl "https://companybelgium.be/api/v2/denominations?q=espero&limit=5" \
  -H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"
"tok-comment">
# 2. Once a number is chosen, read the record and its sub-resources
curl https://companybelgium.be/api/v2/enterprise/1033.022.383 \
  -H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"
curl https://companybelgium.be/api/v2/enterprise/1033.022.383/activities \
  -H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"
curl https://companybelgium.be/api/v2/enterprise/1033.022.383/contact \
  -H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"

Der erste Aufruf dient der Eingabemaske: Der Nutzer tippt ein paar Buchstaben, wählt die richtige Gesellschaft, und Ihr Werkzeug merkt sich ihre Nummer. Die folgenden Aufrufe füllen den Datensatz anhand dieser Nummer.

Empfohlene Umsetzung#

  • Machen Sie die Unternehmensnummer zum Abgleichschlüssel Ihrer Konten: Zwei Datensätze mit derselben Nummer sind dieselbe Gesellschaft.
  • Ersetzen Sie eine von einem Vertriebsmitarbeiter erfasste Adresse nicht stillschweigend: Schlagen Sie den offiziellen Wert vor und lassen Sie den Nutzer bestätigen.
  • Speichern Sie das Datum der letzten Anreicherung und aktualisieren Sie aktive Konten regelmäßig, statt jedes Mal den ganzen Bestand.
  • Rufen Sie die Unterressourcen parallel auf: Sie sind voneinander unabhängig und liefern jeweils die Standard-JSON-Envelope.
  • Platzieren Sie den Aufruf in Ihrem Backend oder in einem geplanten Job, nie im Browser.

Grenzen, die Sie kennen sollten#

  • Kontaktdaten (Telefon, E-Mail, Website) werden nur geliefert, wenn das Unternehmen sie veröffentlicht hat; viele veröffentlichen keine.
  • Mit einem OAuth-Token einer Anwendung erfordert der Kontakt-Endpunkt den Scope enterprise:contact. Ein normaler API-Schlüssel hat ohne Scope Zugriff.
  • Die NACE-Tätigkeiten sind die beim Register angegebenen: Sie beschreiben den Zweck des Unternehmens, nicht unbedingt, was es heute tatsächlich verkauft.
  • Die API liefert keine Ansprechpartner im Vertrieb und keine namentlichen Kontakte: Sie ist keine Datenbank für die Akquise.
  • Jeder Aufruf zählt zu Ihrem Monatskontingent: Eine Massenanreicherung planen Sie nach Ihrem Tarif und dem Stundenlimit.

Häufige Fragen#

Kann ich ein Unternehmen über den Namen statt über die Nummer finden?

Ja. GET /denominations?q=… liefert Vorschläge mit der Unternehmensnummer jedes Treffers; rufen Sie danach den Datensatz mit dieser Nummer auf.

In welcher Sprache sind die Bezeichnungen?

In den im Register veröffentlichten Sprachen: Französisch, Niederländisch, Deutsch oder Englisch, je nach Unternehmen. GET /enterprise/{num}/denominations liefert sie alle.

Wie halte ich Datensätze nach der Anreicherung aktuell?

Aktualisieren Sie aktive Konten regelmäßig, oder abonnieren Sie sie über einen Webhook, um benachrichtigt zu werden, wenn sich ihr Datensatz im Register ändert.

In die Praxis umsetzen

Erstellen Sie einen Schlüssel im Entwicklerportal und folgen Sie dann der Referenzdokumentation für jeden genannten Endpunkt.

API-Schlüssel erhaltenDokumentation lesen

Referenzdokumentation

  • Unternehmen
  • Filtern und Suche

Weitere Anwendungsfälle

  • Kunden oder Lieferanten vor der Zusammenarbeit prüfen
  • Eine USt-Nummer (VIES) bei der Erfassung einer Rechnung prüfen
  • KYC/KYB bei der Eröffnung eines Geschäftskontos
  • Unternehmen per Webhook überwachen

Auf dieser Seite

Das ProblemDie API-Daten, die antwortenBeispielanfrageEmpfohlene UmsetzungGrenzen, die Sie kennen solltenHäufige FragenIn die Praxis umsetzen
API BCEAPI BCE

Ein Entwicklerprodukt von Espero-Soft Informatiques auf Basis offizieller BCE/KBO-Opendata.

Produkt

AnwendungsfälleWarum API BCEPreiseFAQ

Entwickler

DokumentationAPI-ReferenzAPI-PlaygroundÄnderungsprotokollAPI-Schlüssel

Unternehmen

Daten, Compliance und Peppol ↗Company Belgium ↗Espero-Soft ↗

Rechtliches

ImpressumAllgemeine Nutzungs- und VerkaufsbedingungenDatenschutzerklärungCookie-Richtlinie
© 2026 Espero-Soft Informatiques SRL · Alle Rechte vorbehalten.Hergestellt in Belgien 🇧🇪