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. El error se detecta en tu formulario, 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. 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();

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

validadoEn es la fecha de la consulta al censo que produjo el resultado.

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

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 resultado se refiere al número; la comparación del nombre corresponde a tu aplicación. Con un DNI o NIE el nombre sí cuenta, y uno incorrecto devuelve no_identificado. El mismo estado significa cosas distintas según el tipo de identificador: solo con personas físicas valida el nombre.

El campo nombreCenso

Cuando el censo devuelve un nombre distinto al consultado, nombreCenso trae la denominación oficial, útil 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 resultado en el campo validacionCensal del cliente. Es informativa: no bloquea la operación.