Fuentio
Clave gratis

Comprobar concurso de acreedores e IVA por API (empresas españolas y francesas)

Dos llamadas a la API de 1 unidad: la situación concursal según el BORME y el BODACC, y el número de IVA con enlace a VIES. Qué significa cada respuesta.

· Por el equipo de Fuentio · 7 min de lectura

Imagen para compartir: «Comprobar concurso de acreedores e IVA por API» sobre el fondo de papel de Fuentio, con la etiqueta Tutorial.

Dos preguntas aparecen en toda revisión de clientes o proveedores: ¿está esta empresa en un procedimiento concursal? y ¿es correcto su número de IVA? La API de Fuentio responde a las dos con una llamada cada una, por 1 unidad, con la fuente y la fecha de comprobación. Este tutorial muestra las llamadas, qué significa cada campo, cómo leer los estados con honestidad (incluido «no cubierto») y una pequeña función que hace las dos comprobaciones.

Lo que vas a aprender

  • Cómo llamar al punto de acceso de concurso y qué significan sus estados en España y en Francia
  • Cómo llamar al punto de acceso de IVA y por qué nunca dice «registrado»
  • Una respuesta real de cada uno, grabada desde la API
  • Cómo combinar los dos en tu alta de clientes o tu revisión de riesgo
  • Lo que estas comprobaciones no dicen

Concurso: GET /v1/companies/{country}/{identifier}/insolvency

curl https://api.fuentio.com/v1/companies/ES/V-5581/insolvency -H "X-API-Key: YOUR_API_KEY"

Coste: 1 unidad. La respuesta tiene un state y, si existe, el procedure, las fechas opened_on y closed_on y la lista de notices, cada una con su referencia oficial. covered_since indica el primer día de datos cargado.

España: los actos «Situación concursal» del BORME

En España, la respuesta viene de los actos del BORME inscritos como «Situación concursal». El state es notice_found, none_found o not_covered. No existe closed: el BORME no dice cuándo termina un procedimiento. Para la declaración de concurso en sí, la referencia es el Registro Público Concursal: consulta cómo saber si una empresa está en concurso de acreedores.

Francia: los anuncios del BODACC, vinculados por SIREN

En Francia, la respuesta viene de los anuncios de procedimientos concursales publicados en el BODACC (boletín A, publicado por la DILA), vinculados a la empresa por su SIREN. El state es uno de estos:

EstadoSignificado
in_procedureHay un procedimiento abierto.
under_planLa empresa está bajo un plan de salvaguarda o de reorganización.
closedEl procedimiento está cerrado.
notice_foundHay un anuncio, pero el procedimiento se abrió antes de los años cargados.
none_foundNingún anuncio, y el BODACC está cargado para toda la vida de la empresa.
not_coveredLos años cargados no cubren la empresa: no se puede concluir nada.

El procedure es safeguard (salvaguarda), reorganisation (redressement judiciaire) o liquidation. Los anuncios sobre personas y las sanciones personales se descartan.

Una respuesta real, grabada el 12 de octubre de 2026 para PEUGEOT SA:

{
  "data": {
    "company": { "country": "FR", "id": "FR-SIREN-552100554", "name": "PEUGEOT SA" },
    "state": "not_covered",
    "procedure": null,
    "opened_on": null,
    "closed_on": null,
    "notices": [],
    "covered_since": "2008-02-13",
    "attribution": "Source: DILA, BODACC",
    "note": "From BODACC A insolvency notices (DILA), linked by SIREN. Notices about people and personal sanctions are left out. No notice outside the loaded years is not proof of no procedure."
  },
  "meta": { "cost": { "units": 1 } }
}

Aquí not_covered no es ni buena ni mala noticia: los años del BODACC cargados (desde el 13 de febrero de 2008) no cubren toda la vida de esta empresa, así que la API no afirma que nunca haya habido un procedimiento. Trata not_covered como «desconocido», y none_found como el único «nada publicado».

IVA: GET /v1/companies/{country}/{identifier}/vat

curl https://api.fuentio.com/v1/companies/FR/441639465/vat -H "X-API-Key: YOUR_API_KEY"

Coste: 1 unidad. Para Francia, la respuesta da el número de IVA intracomunitario de la empresa: el que publica el registro o, si no lo publica, el calculado a partir del SIREN con la clave estándar (algunas empresas tienen una clave con letras, que no se puede calcular). También indica cómo se obtuvo el número.

Dos campos merecen atención:

  • registration_checked siempre es false. Un número de IVA puede estar bien formado y no estar dado de alta para operaciones intracomunitarias. Fuentio no consulta VIES por ti; la respuesta te da la página oficial de VIES en check_url para comprobar el alta.
  • Para España no hay número de IVA: el BORME no los publica. El NIF-IVA de una empresa española se comprueba directamente en VIES.

La misma información de IVA acompaña también a una consulta francesa, en meta.vat. Grabada para RENAULT el 12 de octubre de 2026:

"vat": {
  "number": "FR63441639465",
  "origin": "published by the source",
  "registration_checked": false,
  "note": "VAT registration not checked. Check the registration on the official VIES page.",
  "check_url": "https://ec.europa.eu/taxation_customs/vies/"
}

Si solo quieres comprobar el formato de un número de IVA francés que ya tienes, no necesitas ninguna llamada: la clave se calcula a partir del SIREN.

def french_vat(siren: str) -> str:
    key = (12 + 3 * (int(siren) % 97)) % 97
    return f"FR{key:02d}{siren}"

assert french_vat("441639465") == "FR63441639465"

Para todas las reglas de validación (también los dígitos de control del SIREN y del SIRET), consulta SIREN, SIRET y número de IVA francés: formatos y validación.

Las dos comprobaciones en una función

Un esbozo de paso de «riesgo» para el alta de clientes o antes de conceder aplazamientos de pago, con la función de reintento de los primeros pasos con la API:

def risk_checks(country, identifier, key):
    insolvency = fuentio_get(f"/v1/companies/{country}/{identifier}/insolvency", key)
    vat = fuentio_get(f"/v1/companies/{country}/{identifier}/vat", key)
    state = (insolvency.get("data") or {}).get("state")
    return {
        "insolvency_state": state,
        "needs_review": state in ("in_procedure", "under_plan", "notice_found", "not_covered"),
        "vat": vat.get("data"),
    }

needs_review marca cada estado en el que una persona debe mirar, incluido not_covered, porque «no lo sabemos» no es «todo correcto». Guarda la meta.source y la fecha de cada respuesta con tu decisión.

Dos unidades por empresa es lo bastante poco como para hacerlo con cada cliente nuevo y antes de cada decisión de crédito importante. Para muchas empresas a la vez, la comprobación de listas gratuita revisa hasta 20 empresas con un archivo CSV; en un agente de IA, las mismas comprobaciones son las herramientas check_insolvency y check_vat por MCP.

Una clave API gratuita da 100 unidades al mes. Mira lo que cubrimos.

Cómo leer un anuncio concursal

Cuando la respuesta contiene anuncios, cada uno lleva su referencia oficial, y la respuesta da el procedure y las fechas opened_on y closed_on cuando la fuente las publica. Tres costumbres marcan la diferencia:

  • Lee primero el anuncio más reciente. Una empresa puede tener un procedimiento antiguo ya cerrado y uno nuevo. El state refleja la situación actual; los anuncios cuentan la historia.
  • Sigue la referencia. Cada anuncio remite a su publicación oficial (en España, el acto del BORME, con su enlace). Para cualquier decisión importante (comunicar un crédito, resolver un contrato), una persona debe leer la publicación oficial.
  • Anota a quién dirigirte. En España, el edicto de declaración del concurso indica la administración concursal y la dirección para comunicar los créditos, dentro del plazo (consulta cómo saber si una empresa está en concurso de acreedores).

Errores frecuentes

  • Tomar not_covered por un visto bueno. Significa «no se puede saber con los datos cargados». Pásalo a revisión cuando el importe lo justifique.
  • Creer que un número de IVA bien formado está dado de alta. El formato y el alta son preguntas distintas: VIES responde a la segunda.
  • Esperar un número de IVA para España. El BORME no los publica; pide al proveedor su NIF-IVA y compruébalo en VIES.
  • Comprobar una sola vez, en el alta. Un concurso es un hecho fechado. Repite la comprobación antes de pedidos grandes, anticipos y decisiones de crédito.
  • Perder la fuente. Guarda la meta.source y la fecha de cada resultado; sin ellas, nadie sabrá después en qué se basó la comprobación.

Límites. España: solo los actos «Situación concursal» publicados en el BORME, sin fecha de cierre; no se consulta el Registro Público Concursal. Francia: procedimientos concursales según los anuncios del BODACC A desde el 13 de febrero de 2008, vinculados por SIREN; que no haya anuncio fuera de los años cargados no prueba que no haya procedimiento. IVA: el alta nunca se comprueba, usa VIES; no hay números de IVA para España. Nada de esto es una evaluación de solvencia. Ejemplos grabados el 12 de octubre de 2026.

Preguntas frecuentes

¿La API dice si una empresa española está en concurso?

Dice si el BORME ha publicado una «Situación concursal» para la sociedad. Para la declaración de concurso, consulta también el Registro Público Concursal.

¿Qué significa not_covered?

Que los datos cargados no cubren toda la vida de la empresa, así que la API no puede afirmar que nunca haya habido un procedimiento. Trátalo como desconocido, no como tranquilizador.

¿Fuentio comprueba el alta en VIES?

No. registration_checked siempre es false, y la respuesta enlaza la página oficial de VIES para que lo compruebes tú.

¿Puedo obtener el número de IVA de una empresa española?

No con Fuentio: el BORME no publica números de IVA. Puedes comprobar en VIES un NIF-IVA que ya tengas.

Fuentes

← Todos los artículos · Canal RSS