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.
Documentación de referencia