Fuentio
Clave gratis

Caso de uso · Alta de clientes (KYB)

Comprueba un cliente empresa francés o español antes del alta

Una sola llamada al registro oficial: un resultado con sus razones, cada dato con su fuente y su fecha, y un código de prueba para tu expediente.

En resumen

Antes de dar de alta a un cliente empresa francés o español, una sola llamada te dice si la sociedad existe en el registro oficial, si sigue activa, dónde está inscrita y qué identificadores usa. verify_company lo convierte en una decisión que puedes archivar: un resultado con sus razones, los controles superados o fallidos, las señales de alerta y un código de prueba que un auditor podrá consultar después. Cada dato lleva su fuente y la fecha en que se comprobó.

Cubre el paso del registro en el KYB (conocer a tus clientes empresa). No sustituye tus controles de titularidad, tus comprobaciones documentales ni tus propias reglas de riesgo, y nunca nombra a una persona.

Un ejemplo real

El 12 de octubre de 2026 pedimos a la API en producción, sin clave, que verificara una empresa francesa conocida antes del alta: Peugeot SA, SIREN 552100554. Esta es la respuesta en una línea, tal cual la devolvió (en inglés):

FR data: partial coverage (All French companies in the public Sirene directory, live from the official Annuaire des Entreprises API (refreshed after 7 days).). PEUGEOT SA (FR, SIREN 552100554): unverified, inactive per Annuaire des Entreprises (API Recherche d'entreprises), checked 2026-10-12. Proof FUE-FR-20261012-C8G7R6.

El resultado es unverified, con el motivo company_inactive: el registro oficial muestra la empresa como cesada. Que el nombre coincida o que el número sea válido no basta, y la respuesta lo dice en lugar de dar el visto bueno. El código de prueba FUE-FR-20261012-C8G7R6 te permite, a ti o a tu auditor, recuperar la verificación tal como se sirvió. Hay más respuestas reales en la página de ejemplos.

Cómo funciona

Tres llamadas cubren la mayoría de los expedientes:

  1. ¿Aún no tienes un número oficial? search_companies(country, query) encuentra la empresa por su nombre (2 unidades por página), la mejor coincidencia primero, cada resultado con una puntuación y sus razones. Elige la correcta y guarda su identificador.
  2. Decidir. verify_company(country, identifier, reference) comprueba la empresa en el registro (5 unidades): identificador válido, ficha encontrada, estado activo, domicilio presente, datos recientes. Pasa tu número de expediente como reference para enlazar el código de prueba con tu expediente.
  3. Archivar. Con una clave API, review_report(country, identifier) genera un informe listo para una revisión (8 unidades): identidad, datos con fuentes, cambios y lagunas del último año, y todos los controles a la vez (insolvencia, cribado de los nombres de la empresa en listas de sanciones, domicilio, IVA).

Las mismas llamadas existen por REST para tu back office y como herramientas MCP para un agente de IA que prepara el expediente. La configuración y cada parámetro están en la documentación.

Qué guardar en el expediente

  • El resultado y sus razones (verified, partial, unverified o insufficient_data).
  • El código de prueba, para recuperar la verificación tal como se sirvió.
  • La fuente de cada dato, su enlace y su fecha de comprobación.
  • Lo que no se pudo confirmar. Una laguna reconocida merece anotarse: indica al siguiente revisor dónde mirar.

España es distinta

Las fichas españolas vienen del BORME, el boletín oficial del Registro Mercantil. Fuentio contiene las sociedades con un acto publicado desde el 2 de enero de 2009: son actos, no un registro completo. El estado es «desconocido» salvo que un acto diga otra cosa, y no hay consulta por NIF ni CIF: busca por denominación y usa la hoja registral. Cuando probamos un NIF el 12 de octubre de 2026, la API respondió (en inglés):

invalid_identifier: 'B12345678' has the format of a NIF/CIF but its check digits are wrong. Next step: Spanish tax-ID (NIF/CIF) lookup isn't supported. Search by company name instead: search_companies(country='ES', query='<company name>').

Esa negativa educada es la clave: recibes el siguiente paso, nunca una empresa adivinada.

Límites

  • Solo Francia y España.
  • Ningún nombre de persona en las respuestas: administradores, socios y empresarios individuales no se sirven.
  • Francia no tiene datos de capital social, y «cesada» (cessée) es el estado del directorio, no una disolución jurídica.
  • El alta en el IVA nunca se comprueba: la respuesta enlaza la página oficial de VIES.
  • Una consulta al registro confirma lo que el registro inscribe. La decisión sigue siendo tuya.

Siguientes pasos

  • Mira más respuestas reales y lee la documentación para conectar tu back office o tu agente.
  • Los planes empiezan con una clave gratuita (100 unidades al mes): consulta los precios.
  • O envíanos hasta 20 de tus clientes: el piloto gratis te devuelve un archivo comprobado en 24 horas.