Cómo adaptar Magento 2 a VeriFactu, paso a paso

Los plazos, para situarte: VeriFactu será obligatorio desde el 01/01/2027 para los contribuyentes del Impuesto sobre Sociedades y desde el 01/07/2027 para el resto de obligados. La fuente oficial es la Agencia Tributaria.

Si aún no tienes claro el marco general —qué registro genera cada evento, qué límites tiene la factura simplificada o cómo conviven varios canales de venta—, empieza por la guía de VeriFactu para tiendas online y vuelve aquí. Y si tu tienda es Magento 1.9 u OpenMage, sigue leyendo igualmente: el módulo de Factulit también cubre esas versiones, con su propio paquete de instalación; tienes el detalle en la ficha de VeriFactu para Magento.

Qué necesitas antes de empezar

Tres cosas, y solo la primera es específica de Magento.

Una tienda Magento 2.4.4 o superior —o Mage-OS— con acceso de administrador y acceso a la línea de comandos. A diferencia de otras plataformas, en Magento 2 la instalación de un módulo termina con una actualización de esquema, así que necesitas poder ejecutar los comandos de mantenimiento de tu tienda o tener a mano a quien lo haga. Si tu tienda es Magento 1.9 u OpenMage 19 o 20, el proceso es más simple —subir archivos y vaciar la caché— y está descrito en la ficha de Magento.

Tus datos fiscales completos y correctos. Nombre o razón social, NIF y domicilio del emisor tal y como constan ante la Agencia Tributaria. Es la causa más frecuente de rechazos evitables en las primeras facturas.

El certificado electrónico o el apoderamiento correspondiente. Los registros se remiten a la Agencia Tributaria en nombre del obligado tributario, así que esa parte se resuelve antes de emitir. Se revisa contigo en el alta, junto con la serie y la fecha desde la que empiezas a facturar.

Qué tienes que decidir antes de instalar nada

Tres decisiones. Tomarlas antes evita rehacer trabajo, porque afectan a la numeración y la numeración no se reescribe.

La serie de facturación. Si ya facturas con otro programa —un TPV físico, tu gestoría, un ERP—, tu tienda Magento necesita una serie propia y distinta. Si dos sistemas emiten la misma combinación de serie y número bajo el mismo NIF, la Agencia Tributaria lo rechaza como duplicado. Reparte las series de una vez, por ejemplo TPV para la tienda física, WEB para otro canal online y MAG para tu Magento, y acuerda quién crea las series nuevas en el futuro.

Qué estado de pedido genera factura. En Magento puedes facturar al pasar a processing, al pasar a complete o en un estado propio de tu flujo. No hay respuesta universal: depende de cuándo consideras cerrada la operación. Lo importante es que lo decidas tú, y que decidas también qué estados cancelan y cuáles abonan. Esa clasificación se hace en el panel de Factulit, no en Magento.

Factura completa o simplificada. Si vendes a consumidores finales, es tentador emitirlo todo como simplificada, y por importe casi siempre cabe. El artículo 4.1 del Real Decreto 1619/2012 fija el límite general en 400 euros, pero el 4.2.a) lo sube a 3.000 para las ventas al por menor a consumidor final, que es donde encaja una tienda B2C. Lo que suele dejar fuera a la simplificada no es el importe: es que el comprador sea empresa, autónomo, persona jurídica no empresaria o Administración, o que la venta salga de España. Si vendes fuera de España, ese es el caso que hay que mirar con tu asesoría.

Cómo se instala el módulo, paso a paso

Cinco pasos. El tercero es el único que distingue a Magento 2 del resto de plataformas.

1. Descarga el módulo desde tu panel de Factulit. Cada variante tiene su propio paquete: al descargar desde la ficha de tu conexión recibes el que corresponde a tu plataforma. Es un archivo ZIP.
2. Sube los archivos del módulo a tu instalación. El módulo se distribuye exclusivamente desde el panel de Factulit y se instala desde ese ZIP, como el resto de conectores.
3. Ejecuta la actualización de esquema. En Magento 2, tras instalar los archivos hay que ejecutar la actualización de esquema (setup:upgrade) y vaciar la caché. Ese paso crea la tabla local donde el módulo guarda su cola de envíos. En Magento 1 y OpenMage no hace falta: basta con subir los archivos y vaciar la caché.
4. Pega tu clave de API y comprueba la conexión. En la configuración del módulo guardas la clave que te facilitamos al dar de alta la conexión. La prueba de conexión valida las credenciales con una comprobación que no modifica nada en tu tienda ni en tu cuenta: si la clave es incorrecta, lo ves ahí mismo.
5. Deja que el cron trabaje. El módulo sincroniza por dos vías: la tarea programada nativa de Magento, que se ejecuta cada cinco minutos, o un endpoint con token pensado para hostings que programan el cron con llamadas web. Cualquiera de las dos mantiene la sincronización al día.

Queda un paso que no ocurre en Magento, sino en el panel de Factulit: clasificar los estados. Hasta que no digas qué estado factura, cuál cancela y cuál abona, no se emite nada. Es deliberado: preferimos que una tienda recién conectada no facture a que facture con el criterio equivocado.

Qué se sincroniza exactamente

Tres cosas viajan de tu tienda a Factulit, y ninguna incluye decisiones fiscales.

Pedidos, con desglose por línea y en la moneda del pedido. Fecha, referencia, totales e impuestos, y cada línea con su base, su tipo y su cuota. Los importes viajan siempre en la moneda en la que compró el cliente, no en la moneda base de tu instalación: si vendes en varias divisas, la factura refleja la operación tal y como se hizo. Los descuentos van ya repartidos por línea —Magento lo hace de serie— y el recargo de equivalencia se identifica por separado del IVA cuando tu tienda lo tiene configurado como impuesto propio.

Clientes, incluidas las ventas de invitado. Los clientes registrados se sincronizan con su ficha; los pedidos de invitado viajan con los datos del comprador embebidos en el propio pedido, así que ninguna venta se queda fuera por no tener cuenta. El identificador fiscal que tu tienda ya recoge se valida con el mismo algoritmo que usa el servidor: validamos lo que tu checkout recoge, no añadimos campos nuevos a tu proceso de compra.

El catálogo de estados, con identificación por vista de tienda. Cada vista de tienda de Magento se identifica por separado, de forma que un catálogo multitienda se gestiona desde el mismo panel. Los estados llegan en crudo, sin interpretar, y aparecen sin clasificar hasta que los clasificas tú.

La regla que gobierna todo lo anterior: el módulo envía hechos, la decisión fiscal la toma el servidor. El módulo no marca estados como finales, no decide si una venta es factura, anulación o abono, y no calcula claves fiscales de línea. Esa clasificación se hace en el panel y la decisión final es del núcleo.

Cómo se factura una devolución

Cuando creas un abono (credit memo) en Magento, el módulo envía su detalle completo: las líneas devueltas con sus importes netos de descuento y los gastos de envío devueltos. Es información, no una orden: como todo lo demás, el abono viaja como un hecho de tu tienda.

La factura rectificativa se genera desde el panel de Factulit, mediante la clasificación de estados que definiste al conectar la tienda: cuando el pedido pasa al estado que has clasificado como abono, el servidor decide la rectificativa que corresponde. Si la factura original era completa se emite una R1; si era simplificada, una R5. Y un abono se rectifica por diferencias: la rectificativa lleva la diferencia en negativo, no los valores finales.

Lo decimos con claridad porque preferimos ser precisos a parecer más automáticos de lo que somos: en Magento, hoy, la rectificativa nace de la clasificación de estados en el panel. El detalle del credit memo está ahí para que la rectificativa cuadre línea a línea, no para disparar nada por sí solo.

Qué pasa si tu tienda pierde la conexión

Nada se pierde en silencio. El módulo guarda cada envío en una tabla local de tu propia base de datos, con su estado, sus intentos y su último error. Si un envío falla —tu servidor sin red, un pico de carga, la API que no responde—, queda pendiente y se reintenta más tarde.

Los reintentos se espacian de forma progresiva: cada fallo duplica la espera hasta un máximo de 24 horas entre intentos. Al octavo intento sin éxito, el registro deja de reintentarse automáticamente y queda marcado para revisión manual. Desde la administración del módulo ves cuántos registros están en ese estado y puedes devolverlos a la cola con un clic, una vez resuelto el problema de fondo. Cada envío lleva además una huella de su contenido, así que un reintento nunca duplica lo ya entregado.

Del lado de la Agencia Tributaria, cuando un registro se reenvía después de una incidencia, el reenvío se marca como tal, como exige la Orden HAC/1177/2024. La facturación no se detiene por una caída.

Conecta tu tienda Magento

Cuéntanos qué versión de Magento usas —2.4.x, Mage-OS, o Magento 1.9/OpenMage— y cuántas facturas emites al mes. Te respondemos con los pasos concretos de tu tienda, el plan que te encaja por volumen y desde cuándo puedes empezar. Sin tarjeta.

Los flujos de alta de factura completa y simplificada, anulación, anulación sin registro previo, subsanación tras rechazo y rectificativa están probados en el entorno de pruebas de la AEAT (Preportal), con última ejecución el 27/07/2026.

¿Buscabas la ficha del conector en lugar de la guía? Está en módulo VeriFactu para Magento. Si vendes también en otra plataforma, míralo en todas las plataformas. Y si tu duda es de precios, en planes y límites.

Última actualización: 14/08/2026. Esta guía es informativa y no constituye asesoramiento fiscal ni jurídico. La normativa aplicable es el Real Decreto 1007/2023, la Orden HAC/1177/2024 y, para los requisitos de las facturas, el Real Decreto 1619/2012. Para tu caso concreto, consulta con un profesional o con la Agencia Tributaria.