Cuando evalúas una API para cumplir con obligaciones fiscales como VeriFactu, una de las preguntas más importantes es: ¿Cuánto tiempo voy a necesitar para que esto funcione en producción?
La respuesta corta: con VerifactuAPI, el tiempo medio de integración técnica es de 5 horas. Eso cubre desde la primera llamada de prueba en sandbox hasta tener el sistema enviando facturas reales a la AEAT.
Este es el promedio observado en las integraciones reales de clientes que ya están operativos en el entorno real.
En este artículo
Qué significa "estar operativo"
Cuando hablamos de 5 horas, nos referimos al tiempo que un desarrollador dedica a:
- Configurar el acceso a la API (credenciales, autenticación)
- Realizar las primeras pruebas en sandbox sin certificado digital
- Adaptar el modelo de datos de su sistema al formato de la API
- Implementar las llamadas de envío de facturas y consulta de estado
- Validar el flujo completo de generación, firma y envío
- Probar casos de error y reintentos
No incluye tiempos administrativos (firma de contrato, subida de certificados a la plataforma) ni periodos de espera externos. Solo desarrollo activo.
Por qué este tiempo es posible
La integración de una API fiscal no suele ser rápida. Hay varios factores que complican el proceso: formatos complejos, validaciones estrictas, gestión de certificados, ambientes de prueba limitados.
VerifactuAPI reduce esos tiempos por diseño:
- Sandbox sin barreras: No necesitas certificado digital para probar. Recibes credenciales y puedes empezar a enviar peticiones inmediatamente. Esto elimina la fricción inicial que retrasa la mayoría de integraciones fiscales.
- Documentación orientada a casos reales: La API está diseñada pensando en los flujos de facturación estándar. Los endpoints están estructurados para que envíes facturas con la información que ya tienes en tu sistema, sin transformaciones complejas.
- Validación en tiempo real: Cada petición devuelve errores específicos si algo falla. No hay que esperar a producción para descubrir que falta un campo o un formato está mal.
- Gestión automática de firma y encadenamiento: No tienes que implementar la lógica de encadenamiento de registros ni la firma electrónica. La API se encarga de generar el hash de cada factura, enlazarlo con el anterior y firmarlo con el certificado correspondiente.
Ejemplo de flujo de integración
Aquí tienes un ejemplo de cómo sería el proceso en una integración típica:
Hora 0-1: Setup inicial
curl -X POST https://api.verifactuapi.es/auth/token \
-H "Content-Type: application/json" \
-d '{
"client_id": "tu_client_id",
"client_secret": "tu_secret"
}'
Recibes un token de acceso. Lo usas en todas las peticiones posteriores. Ya puedes probar.
Hora 1-3: Primera factura de prueba
Adaptas tu modelo de factura al formato de la API. Un ejemplo de payload básico:
{
"factura": {
"numero": "F-2025-001",
"fecha": "2025-01-15",
"tipo": "F1",
"emisor": {
"nif": "B12345678",
"nombre": "Tu Empresa SL"
},
"receptor": {
"nif": "12345678A",
"nombre": "Cliente Ejemplo"
},
"lineas": [
{
"descripcion": "Servicio de consultoría",
"cantidad": 10,
"precio_unitario": 100.00,
"iva": 21
}
],
"total": 1210.00
}
}
Envías la factura:
curl -X POST https://api.verifactuapi.es/v1/facturas \
-H "Authorization: Bearer tu_token" \
-H "Content-Type: application/json" \
-d @factura.jsonRecibes la respuesta con el estado de envío, el hash generado y el enlace con la factura anterior si existe.
Hora 3-4: Gestión de errores y reintentos
Pruebas facturas con datos incorrectos para ver cómo responde la API. Implementas la lógica de reintentos para fallos temporales de red o de los sistemas de la AEAT.
Hora 4-5: Consulta de estado y validación final
Implementas la consulta de estado de envío:
curl -X GET https://api.verifactuapi.es/v1/facturas/F-2025-001/estado \
-H "Authorization: Bearer tu_token"Validas que toda la información se ha enviado correctamente y que la cadena de registros se mantiene íntegra.
Factores que pueden alargar la integración
No todas las integraciones se completan en 5 horas. Estos son los escenarios que suelen requerir más tiempo:
- Sistemas legacy con estructuras de datos muy alejadas del estándar: Si tu sistema guarda la información de facturación en tablas muy fragmentadas o con nomenclaturas propias, necesitarás más tiempo para mapear correctamente los datos al formato de la API VeriFactu.
- Requisitos de sincronización complejos: Si necesitas enviar lotes grandes de facturas históricas o implementar lógica de sincronización bidireccional con múltiples estados, el desarrollo puede extenderse.
- Integración con múltiples NIF: Si tu sistema gestiona facturación para varias empresas (SaaS multitenant, asesorías), necesitarás tiempo adicional para manejar la autenticación y el contexto de cada emisor.
Aun así, estos casos suelen resolverse en 1-2 días de desarrollo, no semanas.
Después de la integración
Una vez operativo, el mantenimiento es mínimo. La API se actualiza automáticamente con cambios normativos sin que tengas que modificar tu código, los otorgamientos de representación se gestionan desde la plataforma, y los backups están garantizados durante 5 años.
El esfuerzo real se concentra en esas primeras horas. Después, el sistema funciona sin intervención.
Si desarrollas software de facturación o estás evaluando cómo cumplir con VeriFactu, puedes probar VerifactuAPI en sandbox de forma gratuita y sin límites ni compromisos.
