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ú.

Publicado el · IA Mood Lab

La respuesta corta

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 esperasLo que hay
API REST con JSONServicios web SOAP 1.1, con mensajes XML en UTF-8, sobre HTTPS
Una clave de APICertificado electrónico cualificado
Enviar cuando quierasUn tiempo de espera entre envíos, que empieza en 60 segundos
Lotes del tamaño que haga faltaUn máximo de 1.000 registros por envío
Un «OK» o un errorTres 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?

Secuencia de envío de registros a la Agencia TributariaTu sistema envía hasta 1.000 registros, la Agencia Tributaria responde con el estado y un tiempo de espera, tu sistema espera ese tiempo o acumula 1.000 registros, y envía de nuevo.Tu sistemaAgencia Tributaria1 · Envío: hasta 1.000 registros2 · Respuesta: estado y tiempo de espera3 · Espera 60 segundoso hasta acumular 1.000 registros4 · Siguiente envío
El tiempo de espera empieza en 60 segundos y cada respuesta puede traer un valor nuevo, que manda para el envío siguiente. Fuente: descripción de los servicios web, Agencia Tributaria, versión 1.0.3.

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?

Si envías tú, el sistema de facturación eres tú. La Agencia Tributaria lo responde en sus preguntas frecuentes: cada sistema en operación debe tener una certificación mediante declaración responsable de su productor, y si el software lo ha desarrollado la propia empresa, es ella la que debe certificarlo.

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?

CaminoQuién certificaLo que construyes tú
Que facture un programa que ya cumpleEl fabricante del programaMandarle el pedido por su API. La factura la emite él
Un servicio intermedio de tercerosDepende del contrato: pregúntalo por escritoLa llamada al servicio y la plantilla de la factura
Conectar directamenteTú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.

Seguir leyendo