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