Blog API y datos
API de Verifactu: qué necesita una tienda con desarrollo propio
Servicios SOAP con XML y certificado, 1.000 registros por envío y 60 segundos de espera. Y si envías tú, la declaración responsable la firmas tú.
Verifactu no tiene una API como las que conoces: son servicios web SOAP con XML, autenticados con certificado electrónico, con un máximo de 1.000 registros por envío y un tiempo de espera entre envíos que empieza en 60 segundos. Pero la pregunta útil no es técnica. Si conectas directamente, tu sistema pasa a ser un sistema de facturación y la declaración responsable la firmas tú. Casi siempre compensa que facture un programa que ya cumple y hablarle a su API.
Quien busca «API de Verifactu» suele tener una tienda hecha a medida y una idea razonable: si ya genero mis facturas, les añado el envío a Hacienda y listo. La idea falla en dos sitios. Uno es técnico y se arregla. El otro es legal y cambia la decisión.
Lo que sigue sale de la descripción de los servicios web que publica la Agencia Tributaria —versión 1.0.3, de 28 de julio de 2025, la que estaba disponible el 11 de octubre de 2026— y de sus preguntas frecuentes sobre certificación.
¿Qué es exactamente lo que publica la Agencia Tributaria?
| Lo que esperas | Lo que hay |
|---|---|
| API REST con JSON | Servicios web SOAP 1.1, con mensajes XML en UTF-8, sobre HTTPS |
| Una clave de API | Certificado electrónico cualificado |
| Enviar cuando quieras | Un tiempo de espera entre envíos, que empieza en 60 segundos |
| Lotes del tamaño que haga falta | Un máximo de 1.000 registros por envío |
| Un «OK» o un error | Tres estados para el envío y tres para cada registro |
Hay operaciones de alta y de anulación de registros, y una de consulta. Y hay dos definiciones de servicios: una para producción y otra para el entorno de pruebas, con su propio portal.
¿Cómo funciona el control de envíos?
En cristiano: no envías cada factura en el momento. Tu sistema las encola y las manda por tandas. Si tu código da por hecho que una llamada equivale a una factura registrada, está mal diseñado desde la primera línea.
¿Qué tiene que saber leer tu código en la respuesta?
- El estado del envío: Correcto, ParcialmenteCorrecto o Incorrecto.
- El estado de cada registro: Correcto, AceptadoConErrores o Incorrecto.
- El tiempo de espera para el siguiente envío.
El caso que más se olvida es el de en medio. Un registro aceptado con errores queda registrado y aun así tiene algo que corregir. Y uno incorrecto no queda registrado: hay que arreglarlo y reenviarlo. Si solo miras el estado global, pierdes facturas sin enterarte.
¿Y el problema que no es técnico?
Eso significa que el envío es la parte pequeña. Lo grande es lo de antes: generar el registro de cada factura, encadenarlo con la huella del anterior, pintar el código QR y poder demostrar que nada se ha alterado. Y firmar un documento que dice que tu software lo hace bien.
No hace falta registrar el sistema en ningún sitio antes de usarlo. Pero la declaración tiene que existir, dentro del propio sistema y accesible desde fuera.
¿Qué tres caminos tiene una tienda a medida?
| Camino | Quién certifica | Lo que construyes tú |
|---|---|---|
| Que facture un programa que ya cumple | El fabricante del programa | Mandarle el pedido por su API. La factura la emite él |
| Un servicio intermedio de terceros | Depende del contrato: pregúntalo por escrito | La llamada al servicio y la plantilla de la factura |
| Conectar directamente | Tú | Registros, huella, QR, cola de envíos, lectura de respuestas y la declaración responsable |
El primero es el que conviene a casi todo el mundo. Tu tienda deja de emitir facturas y se limita a decirle a un programa «factura esto». Holded lo permite con su API en todos los planes, con cuota mensual. Odoo también, pero solo en su plan Personalizado. Lo que hay que preguntarle a esa API antes de elegir está en qué preguntarle a una documentación de API antes de firmar.
El tercero tiene sentido en un caso: cuando la facturación es parte de tu producto y no puedes delegarla. Si no es tu caso, estás construyendo un programa de facturación para ahorrarte una cuota.
Un aviso honesto: no hemos implementado estos servicios. Lo que contamos es lo que dice la documentación oficial, y la versión que rige es la que publique la Agencia Tributaria el día que programes. La norma completa está en Verifactu para tiendas online y las fechas en Verifactu se retrasa a 2027.
Preguntas frecuentes
¿Verifactu tiene API?
Tiene servicios web, que no es lo mismo que una API moderna. La Agencia Tributaria publica servicios SOAP 1.1 sobre HTTPS, con mensajes XML en UTF-8. No hay API REST, ni JSON, ni clave de API: la autenticación es con certificado electrónico cualificado.
¿Cuántas facturas se pueden enviar de una vez?
Hasta 1.000 registros de facturación por envío, según la descripción de los servicios web de la Agencia Tributaria. Entre un envío y el siguiente hay que respetar un tiempo de espera que empieza en 60 segundos y que la propia respuesta puede actualizar.
¿Hay entorno de pruebas?
Sí. La Agencia Tributaria publica un portal de pruebas externas y una definición de servicios específica para ese entorno, separada de la de producción.
Si desarrollo mi propio sistema de facturación, ¿necesito declaración responsable?
Sí. La Agencia Tributaria lo responde en sus preguntas frecuentes: si el software lo ha desarrollado la propia empresa, es ella la que debe certificarlo mediante declaración responsable. No hay que registrarlo antes en ningún sitio, pero la declaración tiene que existir.
¿Qué pasa si un registro tiene errores?
Depende del error. La respuesta califica el envío completo como Correcto, ParcialmenteCorrecto o Incorrecto, y cada registro como Correcto, AceptadoConErrores o Incorrecto. Los rechazados no quedan registrados y hay que corregirlos y volver a enviarlos.
Los jueves, en tu correo
Una herramienta nueva por semana, con lo que cumple y lo que no.