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 / Verificar un cliente o proveedor antes de trabajar con él

🛡️ 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.

Obtener una clave APILeer la documentación

Documentación de referencia

  • Empresa
  • Datos de referencia

Otros casos de uso

  • Enriquecer automáticamente un CRM a partir del número de empresa
  • 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 🇧🇪