Verificar un cliente o proveedor antes de trabajar con él
Antes de un primer pedido, un contrato o un crédito de proveedor, una pregunta sencilla: ¿sigue existiendo esta empresa y en qué situación jurídica se encuentra?
El problema#
Un equipo de compras da de alta un nuevo proveedor, un comercial concede un plazo de pago a un nuevo cliente. En ambos casos se confía a menudo en lo que la propia empresa declara: un nombre, un número, una dirección en un presupuesto. Nadie comprueba que el número corresponda de verdad a esa empresa, que siga activa ni que no esté en quiebra o en liquidación.
La comprobación manual existe (la búsqueda pública de la BCE), pero no escala: hay que repetirla para cada tercero, anotarla en algún sitio, y nadie la vuelve a hacer seis meses después. Este control tiene su lugar en tu herramienta, en el momento en que se crea la ficha del tercero.
Los datos de la API que responden#
GET /enterprise/{num}: la ficha de la empresa, con su estado en el registro, su código de situación jurídica, su forma jurídica, su fecha de inicio y su domicilio social.GET /juridical-situations: la lista de referencia de los códigos de situación jurídica (situación normal, quiebra, disolución…), para guardar en caché y traducir un código en etiqueta.GET /juridical-forms: la lista de referencia de formas jurídicas (SA, SRL, ASBL…) con sus códigos oficiales.GET /enterprise/{num}/establishments: las unidades de establecimiento vinculadas, útil cuando el tercero factura desde un centro de explotación.
La ficha contiene un código de estado (AC para una empresa activa) y el código de situación jurídica. Cuando esa situación no es normal, la respuesta añade su etiqueta y un indicador inDistress: es la señal que hay que trasladar a una persona.
Ejemplo de petición#
"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"Extracto de la respuesta, dentro del envelope JSON estándar:
{
"success": true,
"data": {
"enterpriseNumber": "1033.022.383",
"name": "ESPERO-SOFT INFORMATIQUES",
"statusCode": "AC",
"juridicalSituationCode": "...",
"inDistress": "...",
"juridicalFormCode": "610"
},
"timestamp": "...",
"meta": {
"responseTime": "..."
}
}Implementación recomendada#
- Haz la llamada en el servidor, al crear la ficha del tercero, nunca desde el navegador: la clave y el secret no deben salir de tu backend.
- Trata una respuesta 404 como una señal y no como un error técnico: un número desconocido en el registro merece una revisión humana.
- Usa tres resultados en lugar de dos: aceptado, bloqueado (empresa no activa), a revisar (situación jurídica anormal o número no encontrado).
- Guarda la fecha del control y el código recibido en tu propia base de datos: prueba que el control se hizo.
- Para los terceros con los que trabajas de forma duradera, suscríbelos a un webhook en lugar de repetir el control a mano (ver el caso «vigilar empresas»).
Límites que conviene conocer#
- La API refleja lo que la BCE ha publicado. Una quiebra declarada por un tribunal solo aparece una vez inscrita en el registro, no el día de la sentencia.
- Un estado activo no dice nada de la solvencia ni de la calidad de un proveedor. Es un control de existencia y de situación jurídica, no una calificación crediticia.
- Los datos oficiales de la BCE no siempre indican la causa de un cese. No deduzcas una quiebra de una empresa que simplemente está inactiva.
- El resumen financiero (
/enterprise/{num}/financial) depende de las cuentas depositadas en el Banco Nacional: una pequeña empresa o una persona física a menudo no tiene.
Preguntas frecuentes#
¿Cómo saber por la API si una empresa belga está en quiebra?
Llama a GET /enterprise/{num}. La respuesta contiene el código de situación jurídica; cuando no es normal, añade su etiqueta y el indicador inDistress. La lista de referencia GET /juridical-situations traduce cada código.
¿El control cuenta en mi cuota?
Sí, cada llamada a la ficha de empresa cuenta en la cuota mensual de tu clave. Solo el endpoint /me, que muestra tu consumo, no se descuenta.
¿Puedo verificar una empresa extranjera?
La ficha no: la API cubre el registro belga. Para un número de IVA de otro país de la Unión Europea, usa la validación VIES (GET /vat/{vatNumber}).
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