Tutorial del módulo Quipu para PrestaShop: instalación y uso paso a paso

Tutorial del módulo Quipu para PrestaShop: instalación y uso paso a paso

Conecta tu tienda PrestaShop con tu cuenta de Quipu. Cada pedido se envía a Quipu, y es Quipu quien emite y numera la factura. Preparado para el flujo VeriFactu a través de Quipu.

PrestaShop 8.xPHP 7.4+Soporte en castellano
Antes de empezar

PrestaShop 8 con HTTPS · cuenta activa en Quipu con acceso a su API · tu licencia del módulo. El servicio Quipu se contrata aparte; el módulo es el puente, no sustituye a Quipu. Puedes ver la ficha completa en módulo Quipu para PrestaShop.

¿Quiere usar este conector en su tienda?

Ver módulo Quipu para PrestaShop →

1Instalar el módulo

Módulos → Gestor de módulos → Subir un módulo → selecciona el .zip → Instalar. Aparece Veltrio Quipu en el menú, con 8 pestañas.

El Resumen te da la foto del mes: facturas, importe y estado de la numeración.

Módulo Quipu PrestaShop — Pestaña Resumen.
Imagen 8 Panel de resumen del módulo.→ Qué mirar: Facturas del mes, importe facturado, incidencias y estado de la numeración con Quipu.

2Conectar con Quipu

En Conexión: genera el App ID y App Secret en tu cuenta de Quipu (Configuración → API), pégalos y guarda. Pulsa Probar conexión.

Módulo Quipu PrestaShop — Pestaña Conexión con Quipu (OAuth2).
Imagen 1 Pestaña Conexión con Quipu (OAuth2).→ Qué mirar: App ID y App Secret (ocultos) · botón «Probar conexión» · estado «API: última llamada OK».

3Configurar la facturación

En Facturación: emisión automática al validar el pedido, crear como borrador, momento de cobro, IRPF y recargo (solo si tu actividad lo exige) y las series de numeración.

Módulo Quipu PrestaShop — Pestaña Facturación.
Imagen 2 Pestaña Facturación.→ Qué mirar: Interruptor «facturación automática» · borrador · momento de cobro · IRPF · y las series.

Si tu tienda ya facturaba pedidos por otro medio antes de instalar el módulo, en la misma pestaña puedes definir la fecha de inicio de gestión: ningún pedido anterior a esa fecha genera una factura nueva por ningún camino automático (ni la emisión al validar el pedido, ni los reintentos, ni la sincronización retroactiva, ni la acción masiva de la lista de pedidos), así que el histórico ya facturado por otro medio no se toca. Un pedido que ya tiene documento creado por el módulo no se ve afectado nunca, sea cual sea la fecha. Vacío = sin restricción.

Módulo Quipu PrestaShop — Fecha de inicio de gestión, en la pestaña Facturación.
Fecha de inicio de gestión.→ Qué mirar: campo «Fecha de inicio de gestión» y su explicación de límite de seguridad.
⚠ Importante: carga las series de numeración

Elige una serie concreta para facturas, simplificadas y rectificativas. Sin una serie de numeración cargada, Quipu no puede numerar la factura y la rechaza.

4Avisos por email y Telegram

En Notificaciones: alertas por email cuando algo falla, Telegram (token y chat) y umbral de alerta.

Módulo Quipu PrestaShop — Pestaña Notificaciones.
Imagen 3 Pestaña Notificaciones.→ Qué mirar: Email de alertas (valor de ejemplo, no el real del cliente) · Telegram: chat ID (valor de ejemplo) · umbral de alerta.

5Uso diario: un pedido y su factura

En PrestaShop la emisión es automática al validar el pedido: cuando pasa a un estado válido, el módulo lo envía a Quipu y Quipu emite la factura. Cada pedido tiene una pestaña Quipu con el resultado.

Módulo Quipu PrestaShop — Pedido con factura emitida en la pestaña Quipu.
Imagen 4 Pestaña Quipu del pedido, con la factura ya emitida por Quipu.→ Qué mirar: «Estado: Factura emitida» · «Número Quipu: PST-6» · importe · «Ver en Quipu». (Factura simplificada de un pedido de prueba, sin NIF de cliente.)
✓ Rectificativas

Para corregir una factura, haz una devolución/abono del pedido y el módulo envía la rectificativa a Quipu con su serie.

6Herramientas

En Herramientas: sincronización retroactiva (enviar pedidos antiguos), exportaciones e informes, cobros pendientes y la cola de reintentos.

Módulo Quipu PrestaShop — Pestaña Herramientas.
Imagen 5 Pestaña Herramientas.→ Qué mirar: Sincronización retroactiva · exportar CSV / informe · cobros pendientes · cola de reintentos.

7Panel y Diagnóstico

En Diagnóstico: errores recientes y la comprobación de estado del módulo.

Módulo Quipu PrestaShop — Pestaña Diagnóstico.
Imagen 6 Pestaña Diagnóstico.→ Qué mirar: «Histórico de eventos técnicos (aquí, de prueba)» · comprobación de estado: licencia configurada y validada, credenciales guardadas, tokens.

8Soporte

En Soporte: abre un ticket desde el módulo con diagnóstico y concede un acceso remoto temporal. También puedes escribirnos desde soporte.

Módulo Quipu PrestaShop — Pestaña Soporte.
Imagen 7 Pestaña Soporte.→ Qué mirar: «Nuevo ticket» con diagnóstico · «Acceso remoto temporal».

Problemas frecuentes

«Quipu rechazó la factura» / falta el número

Carga una serie de numeración en Facturación. Sin serie asignada, Quipu no puede numerar la factura.

«Falta DNI/NIF/NIE del cliente»

Pide el NIF en el checkout o activa las facturas simplificadas.

«Faltan datos de facturación»

Completa la dirección de facturación del pedido y vuelve a intentarlo.

Qué hace el módulo y qué no

✓ Lo que hace

  • Conecta PrestaShop con Quipu.
  • Envía cada pedido para que Quipu lo facture al validarlo.
  • Envía rectificativas al devolver.
  • Avisa por email/Telegram y da exportaciones.
  • Diagnóstico y cola de reintentos.

✕ Lo que no hace

  • No emite ni numera: eso lo hace Quipu.
  • No sustituye a tu cuenta de Quipu.
  • No es un sistema VeriFactu por sí mismo.
  • No es asesoría fiscal.

¿Usas WooCommerce? Mira el plugin Quipu para WooCommerce y su tutorial paso a paso. Aquí tienes todos los conectores de Veltrio.

¿Quiere usar este conector en su tienda?

Ver módulo Quipu para PrestaShop →

Publicaciones Similares

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *