API Verifactu: cómo integrarla en tu ERP en cuestión de horas
Integrar una API Verifactu en tu ERP es la vía más rápida para cumplir con el Real Decreto 1007/2023 sin reemplazar tu sistema de gestión actual. En lugar de migrar todo tu software de facturación, añades una capa de conformidad que firma, encadena y remite cada registro a la AEAT en tiempo real, de forma transparente para el resto de tu flujo de trabajo. Si tu empresa tributa por el Impuesto sobre Sociedades, el plazo límite es el 1 de enero de 2027; si eres autónomo o contribuyente del IRPF con actividad económica, el 1 de julio de 2027.
¿Qué es Verifactu y por qué afecta a tu ERP?
Verifactu es el sistema de registro de facturación exigido por el Real Decreto 1007/2023 y desarrollado técnicamente en la Orden HAC/1177/2024. Obliga a que cada factura emitida quede registrada en un fichero firmado electrónicamente, encadenado con el anterior y remitido —o remisible en cualquier momento— a la Agencia Tributaria. El objetivo es eliminar el software de doble uso que permite alterar o borrar facturas a posteriori.
Tu ERP es el punto de origen de cada factura: ahí se calcula el importe, se asigna la serie y se guarda el registro contable. Si ese ERP no genera registros Verifactu conformes, toda la cadena de facturación quedará fuera del cumplimiento normativo. La solución no pasa necesariamente por cambiar de ERP, sino por conectarlo a un motor de conformidad mediante una API REST.
¿Quién está excluido de Verifactu?
Las empresas obligadas al Suministro Inmediato de Información (SII) —aquellas con facturación superior al umbral legal o que se hayan acogido voluntariamente— quedan excluidas de Verifactu, ya que su sistema de reporte en tiempo real cumple una función equivalente. Si no sabes con certeza si tu empresa está en el SII, consúltalo con tu asesor fiscal antes de planificar la integración.
Riesgos de no tener el ERP adaptado: sanciones de hasta 50.000 €
El artículo 201 bis de la Ley General Tributaria, introducido por la Ley 11/2021, tipifica como infracción grave el uso o la tenencia de software de facturación no conforme con la normativa. La sanción puede alcanzar los 50.000 € por ejercicio fiscal, con independencia de que se haya producido fraude real. Esto significa que, aunque tus facturas sean correctas en fondo, el incumplimiento formal del formato y el encadenamiento puede derivar en una sanción de cinco cifras.
Además, es importante aclarar que no existe ningún proceso de homologación oficial del software. El fabricante o proveedor de la solución presenta una declaración responsable de conformidad con el RD 1007/2023 y la Orden HAC/1177/2024. Por eso es fundamental elegir un proveedor que haya realizado dicha declaración y que pueda acreditarla documentalmente.
Cómo funciona la integración de una API Verifactu en tu ERP
El modelo de integración más habitual sigue un flujo de tres pasos entre tu ERP y el motor de conformidad externo:
- Generación de la factura en el ERP: Tu sistema de gestión crea la factura con los datos habituales (NIF emisor, NIF receptor, base imponible, tipo de IVA, serie y número).
- Envío a la API Verifactu: Tu ERP realiza una llamada HTTP POST al endpoint del motor de conformidad con el payload JSON o XML de la factura. Esta llamada puede producirse en tiempo real en el momento de emisión o en modo programado/por lotes según la configuración.
- Recepción del registro firmado, QR y CSV: La API devuelve el registro firmado y encadenado, el código QR oficial y el CSV de la AEAT que debes adjuntar o imprimir en la factura. Tu ERP almacena estos datos en el expediente del documento.
Este flujo es compatible con prácticamente cualquier ERP moderno —SAP Business One, Odoo, Holded, Sage, A3, Dynamics 365, desarrollos a medida— siempre que permita realizar llamadas HTTP salientes y almacenar campos adicionales en el registro de facturas.
Autenticación y seguridad de la API
Las APIs REST de conformidad Verifactu utilizan habitualmente autenticación mediante API Key o tokens OAuth 2.0. El tráfico debe ir cifrado en TLS 1.2 o superior. Antes de comenzar el desarrollo, solicita a tu proveedor la especificación OpenAPI (Swagger) completa y verifica que incluye los endpoints de alta, anulación y consulta de registros, así como la gestión de errores y reintentos.
Modos de envío disponibles
No todas las integraciones requieren envío en tiempo real. Dependiendo del volumen de facturas y la arquitectura de tu ERP, puedes optar por distintos modos:
- Automático en tiempo real: Cada factura se envía en el instante de emisión. Recomendado para ERPs con conexión estable y facturación unitaria.
- Por lotes (batch): Se acumulan facturas de un período y se envían en un único proceso. Útil en ERPs con picos de facturación al cierre del mes.
- Uno a uno con confirmación manual: El usuario revisa la factura antes de que se envíe a la AEAT. Adecuado para empresas con flujos de validación interna.
- Programado: El envío se lanza a una hora fija del día mediante un job automático.
Comparativa de enfoques de integración
| Enfoque | Tiempo de implementación | Coste estimado | Mantenimiento normativo | Idóneo para |
|---|---|---|---|---|
| Módulo nativo del ERP | Semanas o meses | Alto (licencia + consultoría) | Depende del fabricante del ERP | Grandes empresas con ERP estándar actualizado |
| Desarrollo a medida | Meses | Muy alto | Interno (costoso) | ERPs propietarios con equipo IT sólido |
| API REST de tercero (SaaS) | Horas o días | Bajo (suscripción mensual) | El proveedor SaaS mantiene la conformidad | PYMEs, autónomos, ERPs de cualquier tamaño |
| Importación manual de ficheros | Ninguno (sin integración) | Muy bajo | El proveedor SaaS mantiene la conformidad | Volúmenes bajos sin ERP o con ERP heredado |
FactuGuard: API Verifactu lista para conectar con tu ERP hoy
FactuGuard es una plataforma SaaS diseñada específicamente para el cumplimiento Verifactu que puedes conectar a tu ERP en cuestión de horas gracias a su API REST documentada. Una vez que tu ERP llama al endpoint de alta de factura, FactuGuard se encarga de firmar y encadenar el registro, enviarlo a la AEAT en tiempo real y devolverte el QR oficial y el CSV para adjuntar a la factura. No tienes que preocuparte por los cambios normativos futuros: FactuGuard mantiene actualizada la declaración responsable de conformidad con el RD 1007/2023 y la Orden HAC/1177/2024.
Más allá de la integración por API, FactuGuard también acepta facturas por entrada manual, importación de ficheros (XLSX, CSV, PDF, DOCX) e importación automática desde Stripe, lo que lo convierte en una solución válida tanto si tienes un ERP consolidado como si facturas desde herramientas más simples. Soporta multi-NIF, por lo que un mismo panel gestiona varias razones sociales o clientes de asesoría. Los planes arrancan desde 19 €/mes y dispone de un sandbox gratuito sin necesidad de tarjeta para que tu equipo técnico pruebe la integración antes de activarla en producción.
Pasos para integrar la API de FactuGuard en tu ERP
- Crea tu cuenta en el sandbox: Accede a factuguard.es, registra tu cuenta de pruebas sin tarjeta y obtén tu API Key de entorno de test.
- Descarga la especificación OpenAPI: Revisa los endpoints de alta, anulación y consulta de registros, así como los códigos de respuesta y los campos obligatorios del payload.
- Configura el conector en tu ERP: Añade la llamada HTTP POST en el flujo de emisión de facturas de tu ERP. Mapea los campos de tu modelo de datos (NIF, serie, número, fechas, importes, tipo de IVA) con los campos del payload de la API.
- Testa en sandbox con facturas reales: Emite facturas de prueba y verifica que recibes correctamente el registro firmado, el QR y el CSV. Comprueba también el flujo de anulación.
- Activa el entorno de producción: Sustituye la API Key de sandbox por la de producción, configura el modo de envío que mejor se adapte a tu operativa (automático, por lotes, programado) y activa el monitor de errores.
- Documenta la integración y forma al equipo: Registra los parámetros de configuración y asegúrate de que el equipo de administración sabe interpretar los estados de envío y gestionar posibles incidencias.
Buenas prácticas para el mantenimiento de la integración
Una integración API no es un proyecto de un solo disparo. Para garantizar la conformidad continua con Verifactu es recomendable establecer alertas automáticas ante fallos de envío, revisar los logs de la API de forma periódica y asegurarse de que cualquier actualización del ERP no rompa el conector. Suscríbete a las notificaciones de cambios de versión de la API de tu proveedor y mantén actualizadas las credenciales de autenticación según su política de rotación.
Preguntas frecuentes
¿Puedo usar la API de FactuGuard con cualquier ERP?
Sí. La API REST de FactuGuard es agnóstica respecto al ERP de origen: cualquier sistema que pueda realizar llamadas HTTP salientes y almacenar los campos de respuesta puede integrarse. Si tu ERP no permite llamadas HTTP directas, puedes usar la importación de ficheros XLSX, CSV, PDF o DOCX como alternativa.
¿Cuándo es obligatorio tener el ERP adaptado a Verifactu?
Las sociedades sujetas al Impuesto sobre Sociedades deben tener su software de facturación conforme a Verifactu desde el 1 de enero de 2027. Los autónomos y demás contribuyentes del IRPF con actividad económica disponen hasta el 1 de julio de 2027. Las empresas acogidas al SII están excluidas de esta obligación.
¿Necesito obtener alguna homologación oficial para usar la API?
No existe un proceso de homologación oficial del software. El cumplimiento se acredita mediante una declaración responsable del fabricante o proveedor que afirma la conformidad con el RD 1007/2023 y la Orden HAC/1177/2024. FactuGuard mantiene y actualiza esa declaración, por lo que no tienes que gestionarla tú.
¿Qué pasa si hay un fallo en el envío y la factura no llega a la AEAT?
Verifactu permite el envío diferido: si la conexión falla en el momento de la emisión, el registro queda almacenado y puede enviarse posteriormente. FactuGuard gestiona los reintentos automáticamente y notifica al usuario cuando un registro queda en estado de error, para que pueda resolverse antes de que el retraso suponga un incumplimiento.
Contar con una API Verifactu bien integrada en tu ERP es la forma más eficiente de garantizar el cumplimiento normativo sin interrumpir tus procesos de negocio. Cuanto antes empieces a probar la integración en sandbox, más margen tendrás para ajustar el conector y llegar a los plazos de 2027 con total tranquilidad.