Ir al contenido
API BCEAPI BCEAPI de datos de empresas belgas
Casos de usoPreciosDocumentaciónSandboxObtener clave
🇬🇧 English🇫🇷 Français🇳🇱 Nederlands🇩🇪 Deutsch🇪🇸 Español
Obtener clave
API BCE / Casos de uso / Enriquecer automáticamente un CRM a partir del número de empresa

📇 Enriquecer automáticamente un CRM a partir del número de empresa

Un número de empresa basta para completar correctamente una ficha de cliente o de prospecto: denominación oficial, dirección del domicilio social, actividades y datos de contacto publicados.

El problema#

En un CRM la misma sociedad existe a menudo tres veces: «Dupont SRL», «DUPONT» y «Dupont e hijos», cada una con una dirección algo distinta. Las fichas se escriben a mano, llamada tras llamada, y nadie sabe cuál es la buena. Los informes por sector o región dejan de ser fiables y la facturación toma la dirección más reciente, no necesariamente la correcta.

El número de empresa es el identificador estable de una sociedad belga. Si tu herramienta parte de ese número, puede buscar el resto en la fuente oficial en lugar de hacerlo teclear.

Los datos de la API que responden#

  • GET /denominations?q=…: autocompletado sobre los nombres de empresas, para proponer la sociedad correcta desde las primeras letras y obtener su número.
  • GET /enterprise/{num}: la ficha principal (denominación, forma jurídica, estado, fecha de inicio, domicilio social).
  • GET /enterprise/{num}/address: solo la dirección del domicilio social, si únicamente quieres actualizar ese campo.
  • GET /enterprise/{num}/activities: todas las actividades NACE declaradas, para clasificar tus cuentas por sector.
  • GET /enterprise/{num}/denominations: todas las denominaciones (oficial, abreviada, comercial) en los idiomas publicados.
  • GET /enterprise/{num}/contact: teléfono, correo y sitio web, cuando la empresa los ha publicado.
  • GET /naces: búsqueda en la nomenclatura NACE, para mostrar la etiqueta de un código o construir tus propios segmentos.

Ejemplo de petición#

"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"

La primera llamada sirve a la pantalla de alta: el usuario escribe unas letras, elige la sociedad correcta y tu herramienta guarda su número. Las siguientes completan la ficha a partir de ese número.

Implementación recomendada#

  • Haz del número de empresa la clave de conciliación de tus cuentas: dos fichas con el mismo número son la misma sociedad.
  • No sustituyas sin avisar una dirección introducida por un comercial: propón el valor oficial y deja que el usuario lo confirme.
  • Guarda la fecha del último enriquecimiento y actualiza periódicamente las cuentas activas en lugar de todo el fichero cada vez.
  • Llama a los subrecursos en paralelo: son independientes entre sí y cada uno devuelve el envelope JSON estándar.
  • Sitúa la llamada en tu backend o en una tarea programada, nunca en el navegador.

Límites que conviene conocer#

  • Los datos de contacto (teléfono, correo, sitio web) solo se devuelven si la empresa los ha publicado; muchas no publican ninguno.
  • Con un token OAuth de aplicación, el endpoint de contacto exige el scope enterprise:contact. Una clave API normal tiene acceso sin scope.
  • Las actividades NACE son las declaradas en el registro: describen el objeto de la empresa, no necesariamente lo que vende realmente hoy.
  • La API no devuelve un interlocutor comercial ni contactos nominativos: no es una base de datos de prospección.
  • Cada llamada cuenta en tu cuota mensual: un enriquecimiento masivo se planifica según tu plan y el límite por hora.

Preguntas frecuentes#

¿Se puede encontrar una empresa por su nombre en lugar de su número?

Sí. GET /denominations?q=… devuelve sugerencias con el número de empresa de cada una; después basta con llamar a la ficha con ese número.

¿En qué idioma están las denominaciones?

En los idiomas publicados en el registro: francés, neerlandés, alemán o inglés según la empresa. GET /enterprise/{num}/denominations las devuelve todas.

¿Cómo mantener las fichas al día después del enriquecimiento?

Actualiza periódicamente las cuentas activas, o suscríbelas a un webhook para recibir aviso cuando su ficha cambie en el registro.

Llevarlo a la práctica

Crea una clave en el portal de desarrolladores y sigue después la documentación de referencia de cada endpoint citado.

Obtener una clave APILeer la documentación

Documentación de referencia

  • Empresa
  • Filtros y búsqueda

Otros casos de uso

  • Verificar un cliente o proveedor antes de trabajar con él
  • Validar un número de IVA (VIES) al introducir una factura
  • KYC/KYB al abrir una cuenta de empresa
  • Vigilar empresas mediante webhooks

En esta página

El problemaLos datos de la API que respondenEjemplo de peticiónImplementación recomendadaLímites que conviene conocerPreguntas frecuentesLlevarlo a la práctica
API BCEAPI BCE

Un producto para desarrolladores de Espero-Soft Informatiques, basado en datos abiertos oficiales BCE/KBO.

Producto

Casos de usoPor qué API BCEPreciosFAQ

Desarrolladores

DocumentaciónReferencia APIPlayground de la APIRegistro de cambiosObtener clave

Empresa

Datos, cumplimiento y Peppol ↗Company Belgium ↗Espero-Soft ↗

Legal

Aviso legalCondiciones generales de uso y de ventaPolítica de privacidadPolítica de cookies
© 2026 Espero-Soft Informatiques SRL · Todos los derechos reservados.Hecho en Bélgica 🇧🇪