Manual del módulo Quipu para PrestaShop: cómo funciona, qué automatiza y checklist

Manual encuadernado de Quipu para PrestaShop con su índice: cómo funciona, qué envía a Quipu y checklist

Si tiene una tienda PrestaShop en España y ya gestiona su facturación con Quipu, este manual explica cómo conectar ambas plataformas con el módulo de Veltrio, qué automatiza y qué debe revisar antes de activarlo en producción. Es el manual del módulo Quipu para PrestaShop de Veltrio, una integración preparada para el flujo VeriFactu a través de Quipu, de la instalación al primer pedido facturado.

¿Todavía no tiene el módulo? Precios y compatibilidad en la ficha del módulo Quipu para PrestaShop.

PrestaShop gestiona pedidos, stock y pagos, pero no emite facturas electrónicas conforme a la normativa española por sí solo. No genera huella digital ni registro encadenado y no comunica con la AEAT. Si su negocio ya usa Quipu como software de facturación, el módulo Quipu PrestaShop de Veltrio conecta directamente su tienda con su cuenta de Quipu sin herramientas intermedias ni exportaciones manuales.

Factura electrónica en PrestaShop: qué cambia con VeriFactu

Hablar de factura electrónica en PrestaShop y hablar de VeriFactu no es exactamente lo mismo, aunque van de la mano. La factura electrónica es el documento en sí: emitido, enviado y conservado en formato digital con la misma validez legal que el papel. VeriFactu es el sistema de la Agencia Tributaria que exige que ese documento se genere con un registro encadenado, huella digital y numeración consecutiva, de forma que no se pueda alterar después de emitirlo.

PrestaShop, por sí solo, no hace ninguna de las dos cosas: genera un PDF del pedido, que no es una factura electrónica conforme a la normativa española. Por eso hace falta conectar la tienda con un software de facturación —en este manual, Quipu— que sí emite el documento cumpliendo los requisitos y lo conserva. El módulo de Veltrio es el puente entre los dos: recoge el pedido de PrestaShop y lo envía a Quipu, que emite la factura, sin copiar nada a mano.

Qué hace el módulo Quipu para PrestaShop y qué hace Quipu

Quipu es un software de facturación y contabilidad en la nube para autónomos y pymes españolas. Dispone de una API que permite que sistemas externos —como este módulo— envíen pedidos para que Quipu emita las facturas directamente en la cuenta del usuario. Quipu numera y registra cada factura; su estado VeriFactu depende de la configuración de su cuenta de Quipu.

El módulo Quipu PrestaShop de Veltrio es la integración técnica entre el BackOffice de PrestaShop y esa API. Recoge los datos fiscales del pedido (NIF, importes, IVA, tipo de cliente), los envía a Quipu y recupera el PDF de la factura, que queda asociado al pedido. Sin trabajo manual tras la configuración inicial.

Flujo real: del pedido a la factura en PrestaShop

  1. El cliente completa el checkout. Si es empresa, introduce su NIF/CIF. El módulo valida el formato antes de continuar (letra de control incluida).
  2. El pedido queda pagado: al validarse, si el pago es inmediato, o cuando pasa a un estado que PrestaShop marca como pagado (Pedidos > Estados). Con transferencia o contra reembolso, espera a ese estado.
  3. El módulo envía los datos del pedido a Quipu vía API: cliente, líneas de producto, IVA, descuentos y número de pedido.
  4. Quipu emite la factura con numeración consecutiva y la registra en su cuenta de Quipu.
  5. El módulo descarga el PDF y lo asocia al pedido.
  6. Si hay un reembolso total o parcial, queda registrado en la pestaña Quipu del pedido. La rectificativa se emite en Quipu: el envío automático todavía no está disponible en PrestaShop.

Qué automatiza el módulo

  • Envío automático: cada pedido pagado se envía a Quipu, que emite la factura.
  • Facturas completas y simplificadas — distingue entre pedidos con y sin NIF según el límite legal (400 € o 3.000 € configurable).
  • Devoluciones registradas — cada reembolso o abono queda anotado en el pedido, con aviso de que la rectificativa está pendiente de emitir en Quipu.
  • Validación NIF/CIF/NIE/VAT en checkout — letras de control verificadas antes de enviar a Quipu. No llegan a Quipu facturas con NIF inválido.
  • VIES en tiempo real — valida NIFs intracomunitarios contra la base oficial de la Comisión Europea y aplica IVA 0% cuando corresponde.
  • Marcado de cobrado automático — al pasar el pedido a entregado o pagado (configurable), la factura se marca como cobrada en Quipu.
  • Sincronización retroactiva — envía a Quipu, en lote, pedidos antiguos no facturados.
  • Envío en lote desde el BackOffice — seleccione varios pedidos y envíelos todos a Quipu de golpe.
  • Series de su cuenta — elige, entre las numeraciones que ya tiene en Quipu, la de facturas, la de simplificadas y la de rectificativas; Quipu numera.
  • Panel completo en BackOffice — Escritorio con indicadores, Ajustes, Herramientas, Diagnóstico y Soporte, con modo oscuro.
  • Sistema de tickets integrado — abra y gestione incidencias desde el propio módulo sin salir del BackOffice.
  • Reintentos automáticos — si la API de Quipu no responde, el pedido queda marcado y un cron lo recupera. Las facturas quedan en cola para reintento y revisión.
  • Registro de operaciones: lo que hace el módulo queda anotado, para revisar y resolver incidencias.
  • Pestaña Quipu en la ficha del pedido — desde cada pedido en el BackOffice puede ver el estado de su factura, descargar el PDF y ver las devoluciones pendientes de rectificar.

Diferencias frente a facturar manualmente en PrestaShop

PrestaShop genera un documento PDF interno con el resumen del pedido, pero ese PDF no lo genera un sistema de facturación: no lleva huella ni registro encadenado, que es lo que pide VeriFactu a partir de 2027.

Facturar manualmente —exportando pedidos a CSV e importándolos en Quipu— implica trabajo repetitivo, riesgo de errores en numeración y retraso en la entrega del PDF al cliente. El módulo elimina ese proceso: cada pedido pagado llega a Quipu sin intervención.

Qué revisar antes de activar en producción

  • Tener una cuenta activa en Quipu con acceso a la API (la API Key se genera desde el panel de Quipu).
  • PrestaShop 1.7.7 a 9.x (probado en la 8.2) con PHP 8.0 o superior y MySQL 5.7+ / MariaDB 10.3+.
  • Revisar en Pedidos > Estados qué estados tienen la marca «pagado»: son los que hacen que el pedido se envíe a Quipu.
  • Configurar el umbral para facturas simplificadas.
  • Revisar que el campo NIF/CIF esté activo en el checkout para clientes empresa.
  • Si ya tiene facturas en Quipu, verificar la numeración para no crear huecos al activar.
  • Hacer una prueba con un pedido real antes de activar para todos.
  • Decidir desde qué pedido empieza la facturación automática; los pedidos anteriores se pueden enviar a Quipu después con la sincronización retroactiva.
  • Si vende desde Canarias, Ceuta o Melilla, revisar la configuración fiscal del módulo (IGIC/IPSI) antes de activar, para que no se aplique IVA donde no corresponde.

Casos habituales

Comercio PrestaShop estándar (50–500 pedidos/mes)

El módulo elimina la facturación manual o la exportación de CSV. Cada pedido pagado llega a Quipu sin intervención y el PDF queda asociado al pedido.

B2B con clientes intracomunitarios

El cliente introduce su NIF europeo en el checkout. El módulo valida VIES en tiempo real, aplica la exención de IVA si procede y envía el pedido a Quipu con la exención correcta. Sin trabajo manual.

Tiendas con devoluciones

Al reembolsar un pedido en PrestaShop, el módulo lo deja registrado y le avisa en la pestaña Quipu del pedido; la rectificativa se emite en Quipu. Así ve cuáles tiene pendientes.

Multi-tienda PrestaShop

El módulo es configurable por tienda: cada instalación puede facturar desde su propia cuenta Quipu con series independientes.

Errores comunes y cómo evitarlos

  • NIF inválido — el módulo valida la letra de control antes de enviar el pedido. Si el NIF no es válido, el pedido queda como «pendiente de facturar» y recibe un aviso.
  • API Key incorrecta o caducada — el panel de Diagnóstico comprueba la conexión con Quipu. Actualice la clave en Ajustes si ha cambiado.
  • Pedidos sin facturar de periodos anteriores — use la herramienta de sincronización retroactiva para enviar a Quipu los pedidos pendientes sin afectar a los nuevos pedidos.
  • Conflicto con otro módulo de facturas PDF — desactive cualquier módulo que genere facturas PDF propio de PrestaShop antes de activar el conector Quipu para evitar duplicados.
  • NIF del cliente en blanco — si el campo NIF no es obligatorio y el cliente no lo rellena, el pedido se envía igualmente y Quipu emite una factura simplificada cuando el importe está por debajo del umbral configurado.
  • Zona fiscal incorrecta — si vende desde territorio IGIC o IPSI y el módulo está configurado como IVA peninsular, las facturas saldrán con el impuesto equivocado. Revise el régimen fiscal en la configuración del módulo antes de activar.

Checklist antes de poner en producción

  • ☐ API Key de Quipu introducida y verificada en Diagnóstico.
  • ☐ Estados con la marca «pagado» revisados en Pedidos > Estados.
  • ☐ Umbral de factura simplificada revisado.
  • ☐ Campo NIF en checkout activo para clientes empresa.
  • ☐ Prueba con un pedido real: factura emitida en Quipu y PDF asociado al pedido.
  • ☐ Prueba de devolución: reembolse un pedido de prueba, compruebe el aviso en la pestaña Quipu y emita la rectificativa en Quipu.
  • ☐ Prueba VIES con NIF intracomunitario de prueba.
  • ☐ Numeración existente en Quipu revisada para evitar huecos.
  • ☐ Módulos PDF de PrestaShop duplicados desactivados si los había.

Sobre VeriFactu 2027

El reglamento VeriFactu (Real Decreto 1007/2023) y la Ley Crea y Crece fijan la adaptación de los sistemas informáticos de facturación en 2027: antes del 1 de enero de 2027 para entidades sujetas al Impuesto sobre Sociedades y antes del 1 de julio de 2027 para el resto de obligados tributarios. PrestaShop de base no incluye esos requisitos. El módulo Quipu PrestaShop de Veltrio está diseñado para facilitar la adaptación conectando su tienda con Quipu, que trabaja para cumplir los requisitos técnicos del reglamento. El cumplimiento definitivo depende de la configuración de su cuenta Quipu, del uso del software y de la normativa aplicable. Para más contexto, consulte la guía VeriFactu 2027 para tiendas online y el tutorial de instalación del módulo paso a paso.

¿Su tienda es WooCommerce en lugar de PrestaShop?

Si vende con WooCommerce, el plugin Quipu WooCommerce de Veltrio ofrece las mismas funcionalidades adaptadas a WordPress. El flujo de facturación es equivalente; en WooCommerce, además, el reembolso genera la rectificativa en Quipu de forma automática.

Empiece con el módulo Quipu PrestaShop

Tiene 14 días para probarlo: si no le convence, le devolvemos el dinero entero, sin preguntas. Más detalle en la política de garantía y devoluciones. Puede ver todos los detalles, planes y precios en la página del módulo Quipu PrestaShop.


La información de este artículo es de carácter técnico e informativo. No constituye asesoramiento fiscal, contable ni legal. El cumplimiento de las obligaciones tributarias depende de su situación concreta, su configuración del software y la normativa vigente aplicable. Consulte con su asesor fiscal o jurídico si tiene dudas sobre sus obligaciones.

Aviso de marca: Quipu es marca registrada de Quipu Partners S.L. PrestaShop es marca registrada de PrestaShop SA. Veltrio es un desarrollador independiente. Este módulo no está afiliado, patrocinado ni respaldado por Quipu Partners S.L. ni por PrestaShop SA.