API Verifactu: cómo integrar Verifactu en tu software o ERP

Qué es una API Verifactu, qué exige la AEAT a tu sistema de facturación, plazos de 2027 y cómo integrarla en un software propio, un ERP a medida o uno antiguo.

Ilustración del artículo «API Verifactu: cómo integrar Verifactu en tu software o ERP»

¿Buscas una API de Verifactu para tu sistema de facturación? La AEAT no ofrece una API REST: publica un servicio web con esquemas XML. Puedes conectarte directamente o usar un intermediario que ofrece su propia API.

Si facturas con un programa comercial, el fabricante se ocupa de adaptarlo. Si usas un sistema propio, un ERP a medida o una aplicación antigua, tendrás que resolver la integración y asumir la declaración de que cumple.

Esta guía compara las tres vías y explica los requisitos, los plazos y la arquitectura para ayudarte a decidir. No es asesoría fiscal.

Qué API de Verifactu ofrece la AEAT y qué exige tu sistema

El Real Decreto 1007/2023 fija los requisitos de los sistemas informáticos de facturación. Para quien tiene que integrarlos, se resumen en cinco obligaciones:

  • Un registro de facturación por cada factura. Un resumen estructurado de sus datos, que la AEAT llama registro de facturación de alta, y un registro de anulación cuando hay que anularlo.
  • Una huella encadenada. Cada registro lleva un hash calculado con sus datos y con la huella del registro anterior. Si alguien altera un registro antiguo, la cadena se rompe. El algoritmo está publicado en la información técnica de la AEAT.
  • Un código QR en la factura, con el que el cliente puede comprobar el registro en la sede de la AEAT.
  • Remitir o custodiar. En la modalidad VERI*FACTU, los registros se envían a la AEAT de forma inmediata. Fuera de ella, se guardan en el propio sistema con firma electrónica y un registro de eventos.
  • Una declaración responsable del productor del sistema, que certifica que cumple.

Cuándo debe estar adaptado tu sistema a Verifactu

Tras la ampliación del Real Decreto-ley 15/2025, según la Agencia Tributaria:

  • Las entidades que presentan el Impuesto sobre Sociedades, antes del 1 de enero de 2027.
  • El resto de obligados tributarios, antes del 1 de julio de 2027.

Una integración propia no se hace en dos semanas. Necesita diseño, desarrollo, pruebas en el entorno de preproducción de la AEAT y un periodo de convivencia con facturas reales. Si tu fecha es enero, el margen ya es corto.

Cómo integrar Verifactu: tres opciones

1. Conectar directamente con el servicio web de la AEAT

Tu sistema genera los registros en XML según los esquemas oficiales, calcula la huella, se autentica con un certificado electrónico y llama al servicio web de la AEAT.

  • A favor: no dependes de terceros ni pagas por factura enviada.
  • En contra: tienes que mantener el certificado, seguir los cambios de los esquemas y gestionar tú los errores de validación.
  • Cuándo lo elegiría: cuando hay equipo técnico que va a seguir manteniendo el sistema y el volumen de facturas lo justifica.

2. Usar la API Verifactu de un intermediario

Varios proveedores ofrecen una API propia, normalmente REST y JSON, que se encarga de la conversión a XML, la huella y el envío. Tu sistema solo les manda los datos de la factura.

  • A favor: la integración es más rápida y el proveedor sigue los cambios normativos.
  • En contra: añades una dependencia externa por la que pasan todos tus datos de facturación, con su coste y sus condiciones.
  • Cuándo lo elegiría: cuando el sistema es pequeño, el equipo no puede asumir el mantenimiento fiscal o el plazo aprieta.

3. Dejar de facturar desde tu sistema

A veces lo sensato es que tu sistema siga gestionando pedidos y clientes, pero que la factura la emita un programa ya adaptado, integrado con él. La AEAT también ofrece una aplicación de facturación gratuita para quien encaja en sus condiciones.

Cómo funciona una integración con la API Verifactu

Elijas la vía que elijas, la integración que funciona tiene la misma forma:

  1. Emitir la factura con numeración y datos definitivos. Después de este punto, la factura no se edita: se rectifica o se anula.
  2. Generar el registro de alta con los datos que exige el diseño de registro de la AEAT.
  3. Calcular la huella con la del registro anterior y guardarla junto al registro, en la misma transacción que la factura.
  4. Generar el QR e incluirlo en el PDF o en la factura impresa, con la leyenda que corresponda.
  5. Encolar el envío, sin hacerlo dentro de la petición del usuario. Si la AEAT tarda o no responde, la factura ya existe y el envío se reintenta.
  6. Guardar la respuesta de cada envío (aceptado, aceptado con errores o rechazado) y el estado de cada registro.
  7. Revisar los rechazos, con una pantalla donde alguien de administración vea qué falló y pueda subsanarlo.

Los pasos 5 a 7 son los que más se olvidan. Una llamada directa al servicio web funciona en la demo y falla el primer día con mala conexión. En Gustela CRM los envíos a terceros pasan por una cola con estado, fecha y reglas que se aplican antes de encolar, y es el mismo patrón que necesita una integración fiscal.

Cola de envío de Gustela CRM con campaña, estado y fecha de cada envío; leads y destinatarios difuminados.
Gustela CRM · una cola de envío con estado por registro, el mismo patrón que pide Verifactu

Antes de pasar a producción, la AEAT ofrece un portal de preproducción para probar los envíos. Úsalo con facturas reales anonimizadas, incluidas las rectificativas y las anuladas, no solo con el caso feliz.

Quién certifica un sistema de facturación propio o antiguo

Aquí está la parte que más sorprende. La AEAT lo deja claro en sus preguntas sobre la declaración responsable:

  • Si el software lo ha desarrollado la propia empresa, es ella quien debe certificarlo.
  • Si un tercero modifica o amplía un sistema, esas modificaciones no quedan cubiertas por la certificación del productor original y necesitan su propia certificación.

En la práctica: si tu ERP lo adaptó un proveedor que ya no está, o tu equipo añadió la facturación a una aplicación interna, alguien tiene que asumir la integración y firmar la declaración. Con sistemas antiguos, suele ser el momento de decidir si se adapta lo que hay o si se separa la facturación del resto, como cuento en modernización de software.

Qué revisar antes de conectar con la API Verifactu

La mayoría de los problemas que veo no están en el envío, sino en los datos que llegan a la factura: clientes duplicados con NIF distintos, precios que se recalculan al facturar o facturas que se editan después de emitidas. Una huella encadenada no perdona nada de eso.

Lo desarrollé en software Verifactu: no es un problema de facturas, es un problema de datos. La idea de fondo es guardar lo que se acordó, no lo que hay hoy. Es lo que hace Lantilla.com, donde cada pedido guarda una instantánea del título, la variante y el precio en el momento de la compra.

La API es la parte fácil. Lo difícil es que lo que le envías sea verdad desde el principio.

Preguntas frecuentes sobre la API Verifactu

¿Existe una API oficial de Verifactu?

La AEAT publica un servicio web con su WSDL, los esquemas XML, los diseños de registro y un documento de validaciones y errores. No es una API REST con JSON. Las «API Verifactu» que se anuncian como REST son de proveedores que hacen de intermediarios con ese servicio.

¿Es obligatorio enviar las facturas a la AEAT en tiempo real?

No. Es obligatorio que el sistema cumpla los requisitos. La modalidad VERI*FACTU envía cada registro de forma inmediata y, a cambio, no exige firmar los registros ni conservarlos en el propio sistema. La otra modalidad no envía, pero obliga a firmar electrónicamente los registros y a llevar un registro de eventos.

¿Necesito un certificado electrónico para conectar con la AEAT?

Sí. El envío se autentica con un certificado electrónico, del propio obligado o de quien actúa en su nombre como representante o colaborador social.

Mi software de facturación lo hicimos nosotros. ¿Qué tengo que hacer?

Adaptarlo a los requisitos, probarlo y emitir la declaración responsable como productor. Si lo desarrolló un tercero, conviene aclarar por escrito quién certifica qué.

¿Cuánto se tarda en integrar Verifactu en un ERP a medida?

Depende de lo ordenados que estén los datos de facturación, más que de la API. Con un sistema limpio, la integración es acotada. Con facturas que se editan después de emitidas o numeraciones a mano, primero hay que corregir eso.

Si tu facturación sale de un sistema propio, a medida o heredado y no tienes claro cómo adaptarlo, en software a medida explico cómo trabajo: reviso lo que hay, propongo la vía más sencilla de las tres y, si hace falta, construyo la integración.

Google5,019 opiniones · Verlas en Google

Han confiado en mi trabajo

  • Turismo de Andalucía
  • Turespaña
  • Red.es
  • ADIF
  • Aena
  • Decathlon

Mis sistemas han funcionado en

  • FITUR
  • MWC Barcelona
  • ITB Berlin
  • WTM London

REVIEWS / GOOGLE

Lo que dicen quienes han trabajado conmigo.

5,019 opiniones en Google
  • «Encantada con el servicio y con el resultado, ha superado mis expectativas. Desde el primer momento entendió la idea que tenía. Totalmente recomendable.»

    Elisa G.Reseña en Google
  • «Llevamos años trabajando con Andrés. Destacaría su profesionalidad, siempre dispuesto a hacer que nuestra empresa crezca. Una persona excepcional.»

    Remedios P.Reseña en Google
  • «Si tienes una idea y quieres hacerla llegar a los demás para que te conozcan, no busques más […] Mi experiencia con Andrés solo la puedo catalogar de excelente […] Un 10 sobre 10»

    Jose Manuel J.Reseña en Google

¿Qué necesita resolver tu empresa?

Cuéntame el problema, los datos que tienes, las restricciones y el objetivo. No hace falta que sepas todavía qué hay que construir.