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 / KYC/KYB al abrir una cuenta de empresa

🪪 KYC/KYB al abrir una cuenta de empresa

Cuando una sociedad abre una cuenta contigo, necesitas saber quién es, dónde está establecida y quién la dirige. La API reúne esos elementos a partir de fuentes oficiales.

El problema#

Abrir una cuenta a una sociedad (fintech, marketplace, plataforma B2B, despacho sujeto a la normativa contra el blanqueo) supone verificar su identidad, no copiar lo que escribió el solicitante. En la práctica, el expediente mezcla capturas de pantalla, un extracto del registro en PDF y nombres de administradores escritos a mano.

La API permite construir ese expediente solo con el número de empresa, comparar lo que declara el solicitante con lo que dicen las fuentes oficiales e implicar a un analista únicamente en las discrepancias.

Los datos de la API que responden#

  • GET /enterprise/{num}: denominación oficial, forma jurídica, estado, situación jurídica, fecha de inicio y domicilio social.
  • GET /enterprise/{num}/denominations: todas las denominaciones, para vincular un nombre comercial con la sociedad que lo usa.
  • GET /enterprise/{num}/roles: administradores, representantes y titulares reales extraídos de la publicación más reciente del Moniteur belge (constitución, nombramiento, cesión), con la referencia de esa publicación.
  • GET /vat/{vatNumber}: la validación del número de IVA en VIES.
  • GET /enterprise/{num}/financial: el resumen financiero a partir de las cuentas depositadas en el Banco Nacional, cuando existen.

Ejemplo de petición#

"tok-comment"># Identity: legal name, form, status, juridical situation, registered office
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">
# Officers and beneficial owners extracted from the Moniteur belge
curl https://companybelgium.be/api/v2/enterprise/1033.022.383/roles \
  -H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"
"tok-comment">
# VAT number through VIES
curl https://companybelgium.be/api/v2/vat/BE1033022383 \
  -H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"

Extracto de la respuesta de /enterprise/{num}/roles:

{
  "success": true,
  "data": {
    "enterpriseNumber": "1033022383",
    "status": "...",
    "source": {
      "refNumber": "...",
      "publicationDate": "...",
      "publicationTitle": "...",
      "publicationType": "..."
    },
    "roles": [
      {
        "fullName": "...",
        "entityType": "...",
        "roles": [
          "..."
        ],
        "ownershipPercentage": "...",
        "enterpriseNumber": "..."
      }
    ],
    "updatedAt": "..."
  },
  "timestamp": "...",
  "meta": {
    "responseTime": "..."
  }
}

El campo status de esta respuesta vale ok cuando se ha leído una publicación, no_publication cuando no existe ninguna publicación aprovechable y extraction_failed cuando la lectura ha fallado. El bloque source permite localizar la publicación original en el Moniteur belge.

Implementación recomendada#

  • Pide primero el número de empresa y rellena el formulario a partir de la ficha: el solicitante corrige en lugar de escribir.
  • Compara a la persona que abre la cuenta con los administradores devueltos por /enterprise/{num}/roles; una ausencia no es un rechazo, es un punto que verificar (un apoderado puede actuar sin ser administrador).
  • Rechaza automáticamente una empresa no activa y deriva a un analista una situación jurídica anormal.
  • Archiva la respuesta en bruto, la referencia de la publicación y la fecha de la llamada en el expediente del cliente.

Límites que conviene conocer#

  • Los administradores y titulares se extraen automáticamente de las publicaciones del Moniteur belge. No es el registro UBO del SPF Finanzas, que sigue siendo la fuente que debes consultar para tus obligaciones reglamentarias.
  • La extracción se basa en la última publicación pertinente: un cambio aún no publicado no aparece, y una extracción puede fallar o ser incompleta.
  • Una empresa sin publicación aprovechable devuelve no_publication; cuando la fuente no está accesible temporalmente, el endpoint puede responder 502.
  • La API no verifica la identidad de una persona física (documento de identidad, selfi): documenta la empresa, no al solicitante.
  • El resultado ayuda a decidir; no decide por ti y no constituye asesoramiento jurídico.

Preguntas frecuentes#

¿La API devuelve los titulares reales (UBO)?

A través de GET /enterprise/{num}/roles devuelve los administradores y titulares extraídos automáticamente del Moniteur belge. No es una copia del registro UBO oficial del SPF Finanzas.

¿De dónde proceden los datos de identidad de la empresa?

De los datos abiertos oficiales del Banco-Cruce de Empresas (BCE/KBO), publicados por el SPF Economía.

¿Se puede usar la API para un expediente contra el blanqueo?

Sí, como fuente de datos para constituir y documentar el expediente. Las obligaciones de diligencia siguen siendo tuyas, y el registro UBO oficial debe consultarse cuando la ley lo exige.

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
  • Validación de IVA

Otros casos de uso

  • Verificar un cliente o proveedor antes de trabajar con él
  • Enriquecer automáticamente un CRM a partir del número de empresa
  • Validar un número de IVA (VIES) al introducir una factura
  • 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 🇧🇪