Entra en el administrador de módulos

Abre el panel de administración de tu tienda, el mismo que usas para ver los pedidos. En la columna de la izquierda busca Módulos y pincha en Administrador de módulos.

Arriba a la derecha verás un botón azul que pone Subir un módulo. Es ese.

Pantalla del administrador de módulos de PrestaShop con el botón «Subir un módulo» arriba a la derecha — El botón «Subir un módulo» está arriba a la derecha, en azul.

Sube el archivo que has descargado

Al pulsar el botón se abre una ventana con un recuadro de líneas discontinuas. Tienes dos formas de hacerlo, la que te resulte más cómoda:

Arrastrar el archivo tiendafactu-prestashop-0.4.0.zip desde tu carpeta de descargas hasta ese recuadro.
O pinchar en selecciona el archivo y buscarlo en tu ordenador.

Ventana de PrestaShop para subir un módulo, con el recuadro donde arrastrar el archivo zip — Arrastra aquí el zip, o pincha en «selecciona el archivo».

La instalación tarda unos segundos y va sola. Cuando termine te lo dirá con un mensaje en verde.

Si te da un error al subirlo, casi siempre es porque tu hosting limita el tamaño de los archivos que se pueden subir. Escríbenos a hola@tiendafactu.es y te decimos qué pedirle a tu proveedor de hosting; es un cambio de dos minutos para ellos.

Abre la configuración del módulo

Ya está instalado. Ahora busca su ficha en la lista de módulos — puedes escribir «TiendaFactu» en el buscador para encontrarla antes — y pulsa el botón Configurar.

Ficha del módulo TiendaFactu en la lista de módulos, con el botón Configurar a la derecha — La ficha del módulo, con el botón «Configurar» a la derecha.

Lo primero que verás arriba es un asistente que se llama «¿Estás listo para Verifactu?». Es una lista de comprobación que se va poniendo en verde sola según vas completando los pasos que vienen ahora. Úsala como guía: cuando esté todo verde, has terminado.

Escribe tus datos fiscales

Baja hasta el apartado Ajustes de TiendaFactu y rellena dos campos:

Nombre fiscal del emisor: el nombre oficial de tu empresa o tu nombre completo si eres autónomo. Ojo, el fiscal, no el comercial: si tu tienda se llama «Zapatos Pepe» pero la empresa es «Calzados Pérez SL», aquí va Calzados Pérez SL.
NIF del emisor: tu NIF o CIF, el mismo con el que declaras.

Campos de nombre fiscal del emisor y NIF del emisor en la configuración del módulo — Estos dos datos son los que aparecerán en la cabecera de tus facturas.

Justo debajo hay dos campos más, Serie de facturas y Serie de rectificativas, que vienen rellenos con una F y una R. Son las letras que llevarán delante tus números de factura. Déjalos como están salvo que tu gestoría te diga otra cosa.

Una advertencia importante: estas dos letras no se pueden cambiar una vez hayas empezado a emitir facturas de verdad. La numeración tiene que ser continua por ley, así que decide ahora y no las toques más.

Programa el aviso automático

Este es el único paso que se sale del panel de PrestaShop, así que vamos despacio.

Cuando tu tienda emite una factura, se la manda a Hacienda al momento. Pero si justo en ese instante internet falla o Hacienda no contesta, el envío se queda pendiente. Para que se reintente solo y para confirmar que Hacienda la ha aceptado, hace falta que algo llame a tu tienda cada cierto tiempo y le diga «revisa si tienes algo pendiente». A eso se le llama una tarea programada, o cron.

El módulo te da la dirección de internet que hay que llamar. Está debajo del campo «Serie de rectificativas», en letra pequeña:

Dirección de internet del cron que muestra el módulo debajo del campo de serie de rectificativas — Copia esa dirección entera, incluida la parte final que empieza por «token=».

Esa dirección es tuya y es secreta. No la publiques ni la mandes por ahí: el código del final hace de contraseña.

Opción A: tu hosting lo hace por ti

Casi todos los paneles de hosting (cPanel, Plesk y parecidos) tienen un apartado llamado Tareas programadas o Cron jobs. Si tienes acceso, entra ahí, crea una tarea nueva, pega esa dirección y dile que se ejecute cada 15 minutos. Ya está.

Si no encuentras esa opción o no lo tienes claro, escribe a tu proveedor de hosting y mándales esto tal cual: «Necesito programar una tarea cron que llame a esta URL cada 15 minutos», con la dirección. Lo hacen en un momento.

Opción B: un servicio gratuito, sin tocar el hosting

Si tu plan de hosting no permite tareas programadas, o simplemente prefieres no meterte ahí, puedes usar un servicio externo gratuito como cron-job.org:

Entra en cron-job.org y crea una cuenta gratis.
Pulsa en crear un cronjob nuevo.
En el campo de la dirección, pega la que te dio el módulo.
En la frecuencia, elige cada 15 minutos.
Guarda. Listo.

¿Y si me salto este paso? Tus facturas se seguirán emitiendo y enviando con normalidad. Lo que perderías es la red de seguridad: si un envío falla, nadie lo reintentaría, y no se actualizaría el estado de las facturas cuando Hacienda las acepta. Es muy recomendable hacerlo, pero no te bloquea para seguir con el resto de la guía.

Pon tu clave y prueba sin riesgo

Falta conectar tu tienda con la plataforma que lleva los registros hasta Hacienda. Para eso hace falta una clave.

Fíjate en que hay dos campos de clave separados, uno de pruebas y otro de producción, y un selector de Modo arriba. Están separados a propósito, para que no puedas mandar sin querer facturas de mentira a Hacienda, ni al revés.

Selector de modo y campo de clave API de pruebas en la configuración del módulo — Empieza siempre en modo Pruebas. Es gratis e ilimitado.

Deja el modo en Pruebas, pega tu clave de pruebas en el campo correspondiente y pulsa Guardar. En modo pruebas nada de lo que hagas llega a Hacienda ni tiene efecto fiscal: puedes equivocarte tranquilamente.

¿No tienes ninguna clave? Puedes crear tu cuenta y sacarla tú, o dejarnos a nosotros el papeleo con TiendaFactu Conecta: damos de alta tu NIF, configuramos la clave y te dejamos una factura de prueba verificada en menos de un día laborable, por 14,99 € al mes sin cuotas por factura.

Haz tu primera factura y compruébala

Ya está todo montado. Vamos a verlo funcionar:

Ve a Pedidos y abre cualquier pedido, o hazte uno de prueba en tu propia tienda.
Cámbiale el estado a Pago aceptado.
Vuelve a la configuración del módulo. Abajo del todo, en Últimas facturas, verás aparecer tu factura con su número.
Pulsa Ver para abrirla.

Esto es lo que verá tu cliente, y lo que recibirá por email con un enlace privado:

Factura generada por el módulo, con el desglose de IVA y el código QR oficial de la AEAT — La factura, con su desglose de IVA y el código QR oficial de la Agencia Tributaria.

Si has llegado hasta aquí y ves esa pantalla, ya lo tienes funcionando. Sube al asistente del principio y comprueba que la lista está en verde.

Cuando llegue tu fecha, activa el envío real

Todo lo anterior lo puedes dejar hecho hoy y no volver a tocarlo. El envío de verdad a Hacienda se activa cuando te toque: el 1 de enero de 2027 si facturas como sociedad, el 1 de julio de 2027 si eres autónomo.

Llegado el momento son tres cosas: pegar tu clave de producción, cambiar el Modo a Producción y activar el interruptor Confirmo el envío real. Ese interruptor existe porque los registros que llegan a Hacienda no se pueden anular, así que preferimos que sea imposible activarlo sin querer.

Mientras estés en pruebas, las facturas salen marcadas como «PRUEBA — SIN VALIDEZ FISCAL». Si ves ese aviso en una factura que creías real, es que todavía estás en modo pruebas.

Si algo no sale como esperabas

No aparece ninguna factura después de marcar el pedido como pagado

Comprueba en el asistente que tienes puestos el nombre fiscal, el NIF y una clave. Si falta alguno de los tres, el módulo no emite a propósito, para no gastar números de tu serie de facturación. Si está todo puesto, revisa que el estado al que cambiaste el pedido sea uno de los que tu tienda considera «pagado».

La factura aparece pero pone «Pendiente»

Significa que se creó bien pero el envío aún no ha salido o falló. Si tienes el aviso automático del paso 5 programado, se reintenta solo en los próximos minutos. Si no lo programaste, ese es el motivo.

Me sale un error diciendo que el tipo de IVA no es válido

Hacienda solo admite los tipos de IVA españoles. Si tienes productos con un IVA de otro país configurado en la tienda, ese pedido no se puede facturar así. Revisa las reglas de impuestos de esos productos.

Quiero desinstalarlo

Puedes hacerlo desde el administrador de módulos con toda tranquilidad. Se borra la configuración, pero tus facturas se conservan: la ley obliga a guardar los registros de facturación, así que no las tocamos.

Estoy en el País Vasco o presento el IVA por SII

Entonces puede que Verifactu no te aplique: en el País Vasco rige TicketBAI y quien presenta por SII ya informa a Hacienda en tiempo real. El asistente del módulo lo detecta según la provincia de tu tienda y te lo avisa. Más sobre las exenciones.

Cómo instalar TiendaFactu en tu PrestaShop

Tu descarga está empezando