Colaborador social de la AEAT

API de gestión de NIFs

La API de gestión de NIFs de Verifacti es la capa común que compartes entre normativas: con ella das de alta, activas y desactivas los NIFs de tus clientes, gestionas su modelo de representación y configuras los webhooks, una sola vez. Después, cada normativa (Verifactu, TicketBAI o SII) se conecta con su propia integración de envío.

Lee la documentación
Entorno de test y NIF de prueba incluidos
POST /nifs
[{
  "nif": "B86561412",
  "entorno": "test",
  "hacienda": "verifactu",
  "nombre": "Mi empresa SL",
  …
}]
200 OK
[{
  "nif": "B86561412",
  "activo": true,
  "representacion": "Inexistente",
  …
}]

Qué hace la API de gestión de NIFs

Tres piezas que integras una sola vez y que comparten todas las APIs de cumplimiento. No es un proceso en orden: usas cada una cuando la necesitas.

API de gestión de NIFsLa capa común de tu cuenta, con su API key de cuenta (vfn_…)

Gestión de NIFs

Alta, activación y baja de los NIFs de tus clientes por API, de uno en uno o en lote, cada uno con su entorno, su hacienda y su propia API key.

  • Software de facturación y SaaS: das de alta a cada cliente desde tu producto, sin pasar por un panel.
  • ERPs y grupos: gestionas cientos o miles de NIFs y solo pagas por los activos en producción.
  • Integradores y consultoras: todos tus proyectos en una misma cuenta.
Alta, activación y baja →

Modelo de representación

El documento que autoriza a Verifacti a enviar en nombre de cada NIF. Lo generas prerrellenado, lo envías firmado y consultas su estado por API.

  • El mismo documento para la AEAT y las tres haciendas forales.
  • El titular también puede firmarlo online, sin certificado digital.
Modelo de representación →

Webhooks

El resultado de cada envío a la AEAT o a la hacienda foral llega a tu sistema, sin consultar el estado.

  • Por entorno: test o producción.
  • Para todos tus NIFs o solo para algunos.
Webhooks →

Alta, activación y baja de NIFs

Das de alta los NIFs de tus clientes de uno en uno o en lote, eligiendo para cada uno su entorno (test o producción) y su hacienda: verifactu, alava, vizcaya, guipuzcoa o sii. Un mismo NIF puede estar en varias haciendas.
  • Alta y consulta

    POST /nifs para dar de alta y GET /nifs para listar, con filtros por entorno y estado.
  • Activar y desactivar

    Desactiva un NIF que deja de facturar y reactívalo cuando vuelva. Solo pagas por los NIFs activos en producción.
  • API key por NIF

    Cada NIF tiene su API key de envío, que puedes consultar y rotar por API.
  • Datos y etiquetas

    Modifica los datos de cada NIF y organízalos con etiquetas.
Qué hace la capa común y a qué APIs sirve cada función
FunciónEndpointsSirve para
Alta, consulta, modificación, desactivación, reactivación y borrado de NIFsPOST /nifs, GET /nifs; GET, PUT y DELETE /nifs/{entorno}/{nif}; PUT /nifs/activate/{entorno}/{nif}; DELETE /nifs/{entorno}/{nif}/permanentAPI Verifactu, API TicketBAI y API SII
API keys de cada NIFGET /nifs/keys/{entorno}/{nif}; POST /nifs/keys/{entorno}/{nif}/rotarTodas las APIs disponibles
Modelo de representación/representacion/generar, /enviar, /estado, /descargar, /cancelar y /firma_remotaAEAT (Verifactu y SII) y haciendas forales de Álava, Bizkaia y Gipuzkoa (TicketBAI): el mismo documento
Webhooks/webhooks y /webhooks/{webhook_id}/nifs/{nif}Respuestas de la AEAT y de las haciendas forales
ValidaciónPOST /nifs/validar, /nifs/validar_lotes y /nifs/validar/viesDestinatarios de cualquier normativa
Ejemplo: dar de alta un NIF · cURL
curl -X POST https://api.verifacti.com/nifs \
  -H "Authorization: Bearer $VERIFACTI_USER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{
    "nif": "B86561412",
    "entorno": "test",
    "hacienda": "verifactu",
    "nombre": "Mi empresa SL",
    "direccion": "Calle Mayor 15",
    "cp": "28040",
    "poblacion": "Madrid",
    "provincia": "Madrid"
  }]'

# Respuesta
[{
  "nif": "B86561412",
  "entorno": "test",
  "hacienda": "verifactu",
  "nombre": "Mi empresa SL",
  "activo": true,
  "representacion": "Inexistente",
  "fecha_creacion": "2026-11-17T10:18:21.671Z",
  "webhooks": []
}]

Modelo de representación por API

Generas el modelo de representación prerrellenado, lo envías firmado, consultas su estado, lo descargas o lo cancelas. El titular también puede firmarlo online, sin certificado digital. Cómo funciona el modelo de representación.

Webhooks

Registras webhooks por entorno (test o producción) y los asocias a todos tus NIFs o solo a algunos. Recibes en tu sistema el resultado de cada envío a la AEAT o a la hacienda foral, sin tener que consultar el estado.

Validación de NIFs

Comprueba si un NIF está identificado en la AEAT (POST /nifs/validar), hasta 20.000 NIFs por llamada (POST /nifs/validar_lotes), y el NIF-IVA intracomunitario en VIES (POST /nifs/validar/vies).

Pensada para integrar a escala

Pensado para quien integra

Documentación pública con ejemplos por llamada, guía rápida, colecciones Postman, llms.txt y cuenta gratuita con entorno de test.

Integración habitual: de uno a tres días de un desarrollador

Especialistas en España

Territorio común y foral: Verifactu, TicketBAI y SII con el mismo proveedor.

Software garante TicketBAI en Álava, Bizkaia y Gipuzkoa

Solidez demostrable

Cientos de empresas y fabricantes de software en producción con Verifacti. Datos alojados en la UE y SLA en los términos de uso.

Colaborador social de la AEAT

Precio

La API de gestión de NIFs está incluida en la suscripción: pagas por los NIFs activos en producción de cada normativa. Con la cuenta gratuita puedes probar el envío en el entorno de test.

Ver precios

    Preguntas sobre la gestión de NIFs

    Más preguntas frecuentes

    ¿Puedo dar de alta NIFs de forma masiva y recibir webhooks?

    Sí. El alta admite varios NIFs por llamada, y los webhooks se registran por entorno y se asocian a todos los NIFs o solo a algunos.

    ¿Tengo que integrar la gestión de NIFs para cada normativa?

    No. Se integra una vez y sirve para Verifactu, TicketBAI y SII; cada normativa añade su envío.

    ¿Puedo desactivar un NIF que no factura?

    Sí, y reactivarlo después. Solo pagas por los NIFs activos en producción.

    ¿Puedo validar el NIF del destinatario antes de facturar?

    Sí, contra la AEAT y contra VIES, de uno en uno o en lotes de hasta 20.000.

    ¿La API de gestión de NIFs está en la cuenta gratuita?

    La API de gestión de NIFs (claves vfn_) y los webhooks de producción requieren suscripción. Con la cuenta gratuita pruebas el envío de facturas con las claves de test y los webhooks de test.

    Empieza a integrar hoy

    Pruébalo gratis con el entorno de test.

    Entorno de test y NIF de prueba incluidosVer precios