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.
[{
"nif": "B86561412",
"entorno": "test",
"hacienda": "verifactu",
"nombre": "Mi empresa SL",
…
}][{
"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.
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.
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.
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.
Alta, activación y baja de NIFs
verifactu, alava, vizcaya, guipuzcoa o sii. Un mismo NIF puede estar en varias haciendas.Alta y consulta
POST /nifspara dar de alta yGET /nifspara 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.
| Función | Endpoints | Sirve para |
|---|---|---|
| Alta, consulta, modificación, desactivación, reactivación y borrado de NIFs | POST /nifs, GET /nifs; GET, PUT y DELETE /nifs/{entorno}/{nif}; PUT /nifs/activate/{entorno}/{nif}; DELETE /nifs/{entorno}/{nif}/permanent | API Verifactu, API TicketBAI y API SII |
| API keys de cada NIF | GET /nifs/keys/{entorno}/{nif}; POST /nifs/keys/{entorno}/{nif}/rotar | Todas las APIs disponibles |
| Modelo de representación | /representacion/generar, /enviar, /estado, /descargar, /cancelar y /firma_remota | AEAT (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ón | POST /nifs/validar, /nifs/validar_lotes y /nifs/validar/vies | Destinatarios de cualquier normativa |
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
Webhooks
Validación de NIFs
POST /nifs/validar), hasta 20.000 NIFs por llamada (POST /nifs/validar_lotes), y el NIF-IVA intracomunitario en VIES (POST /nifs/validar/vies).Una capa común para cada normativa
Integras la gestión de NIFs una sola vez. Cada normativa añade su propia integración de envío.
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 desarrolladorEspecialistas en España
Territorio común y foral: Verifactu, TicketBAI y SII con el mismo proveedor.
Software garante TicketBAI en Álava, Bizkaia y GipuzkoaSolidez 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 AEATPrecio
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 preciosDocumentación de la API de gestión de NIFs
Preguntas sobre la gestión de NIFs
Más preguntas frecuentes¿Puedo dar de alta NIFs de forma masiva y recibir webhooks?
¿Tengo que integrar la gestión de NIFs para cada normativa?
¿Puedo desactivar un NIF que no factura?
¿Puedo validar el NIF del destinatario antes de facturar?
¿La API de gestión de NIFs está en la cuenta gratuita?
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.