Validación de NIF

Comprueba NIF y razón social contra el censo de la AEAT antes de emitir.

Un destinatario mal identificado provoca el rechazo del registro. Este endpoint valida pares NIF + nombre contra el censo de la AEAT antes de construir la factura, para que el error se detecte en tu formulario y no en la remisión.

Este endpoint pertenece a la API de gestión: la base URL es https://manage-api.veribai.com, con la misma clave x-api-key de siempre. No requiere indicar entorno: el censo es único.

Validar NIFs

POST /v1/nif/validar

Admite lotes de 1 a 100 entradas en una sola llamada.

curl -X POST https://manage-api.veribai.com/v1/nif/validar \
  -H "x-api-key: TU_CLAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "nifs": [
      {
        "nif": "B26682641",
        "nombre": "SKY CLOUD INFRASTRUCTURE SL"
      }
    ]
  }'

import veribai

client = veribai.Client(api_key="TU_CLAVE", environment="test")

respuesta = client.nif.validar([
    {
        "nif": "B26682641",
        "nombre": "SKY CLOUD INFRASTRUCTURE SL",
    },
])

const respuesta = await fetch("https://manage-api.veribai.com/v1/nif/validar", {
  method: "POST",
  headers: {
    "x-api-key": "TU_CLAVE",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "nifs": [
      {
        "nif": "B26682641",
        "nombre": "SKY CLOUD INFRASTRUCTURE SL"
      }
    ]
  }),
});

if (!respuesta.ok) throw new Error(`VeriBai ${respuesta.status}`);
const datos = await respuesta.json();

El nombre es obligatorio también para un CIF, aunque la AEAT lo ignore en ese caso.

Respuesta

{
  "resultados": [
    {
      "nif": "B26682641",
      "nombre": "SKY CLOUD INFRASTRUCTURE SL",
      "estado": "identificado",
      "resultadoAeat": "IDENTIFICADO",
      "nombreCenso": null,
      "validadoEn": "2026-07-23T10:00:00Z"
    }
  ]
}

La frescura del veredicto la indica validadoEn, la fecha de la consulta al censo que lo produjo.

Valores de estado

identificado no valida el nombre de un CIF

Con un CIF, la AEAT ignora el nombre consultado: B26682641 con nombre: "Pepita SL" responde identificado, y la razón social real llega en nombreCenso. El veredicto habla del número; comparar el nombre es tu comprobación. Con un DNI o NIE el nombre sí cuenta, y uno incorrecto devuelve no_identificado. El mismo estado pesa distinto según el tipo de identificador, y solo con personas físicas valida un nombre.

El campo nombreCenso

Cuando el censo devuelve un nombre distinto al consultado, nombreCenso trae la denominación oficial, el «quizás quisiste decir» listo para autocorregir en tu interfaz. El comportamiento del censo difiere por tipo de identificador:

• CIF (personas jurídicas): la AEAT ignora el nombre consultado; si el NIF existe, responde identificado con la razón social oficial en nombreCenso.
• DNI / NIE: el nombre sí cuenta. Un nombre incorrecto devuelve no_identificado; un nombre parcial, identificado con el nombre completo en nombreCenso.

Errores

Validación implícita

Al crear un cliente emisor o modificar su nombre, la API ejecuta esta misma comprobación de oficio y guarda el veredicto en el campo validacionCensal del cliente. Es informativa: nunca bloquea la operación.