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

Una API Verifactu es la pieza que conecta tu sistema de facturación con la Agencia Tributaria: genera el registro de cada factura, lo encadena con el anterior y lo envía a la AEAT. La AEAT no publica una API REST al uso, sino un servicio web con sus esquemas XML. Tu sistema puede conectarse a él directamente o a través de un intermediario que ofrece su propia API. Si facturas con un software propio o un ERP a medida, esa integración, y la declaración de que cumple, es responsabilidad tuya.

Con un programa de facturación comercial, el fabricante hace el trabajo. Si la factura sale de un sistema hecho para tu empresa, de un ERP adaptado durante años o de una aplicación antigua que nadie quiere tocar, no hay actualización que descargar: alguien tiene que diseñar la integración.

Este artículo es para ese caso. Es una guía técnica para decidir, no asesoría fiscal.

Qué exige Verifactu a un sistema de facturación

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.

Plazos de Verifactu: cuándo tiene que estar adaptado

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.

Tres formas de integrar Verifactu en tu software

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.

• Cuándo lo elegiría: cuando la facturación no es lo que diferencia a la empresa. Lo defendí en el software debe adaptarse a la empresa: se construye a medida donde aporta, no por costumbre.

Arquitectura de 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.

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.

Software a medida o antiguo: quién lo certifica

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.

Lo que falla antes de llegar a la API

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.