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

Conecte su tienda PrestaShop con su 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 · su licencia del módulo. El servicio Quipu se contrata aparte; el módulo es el puente, no sustituye a Quipu. Puede 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

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

El Resumen le 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: genere el App ID y el App Secret en su cuenta de Quipu (Configuración → API), péguelos y guarde. Pulse 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 su 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 su tienda ya facturaba pedidos por otro medio antes de instalar el módulo, en la misma pestaña puede 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: cargue las series de numeración

Elija 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, haga una devolución o 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: abra un ticket desde el módulo con diagnóstico y conceda un acceso remoto temporal. También puede 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

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

«Falta DNI/NIF/NIE del cliente»

Pida el NIF en el checkout o active las facturas simplificadas.

«Faltan datos de facturación»

Complete la dirección de facturación del pedido y vuelva 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 su cuenta de Quipu.
  • No es un sistema VeriFactu por sí mismo.
  • No es asesoría fiscal.

¿Usa WooCommerce? Vea el plugin Quipu para WooCommerce y su tutorial paso a paso. Aquí tiene todos los conectores de Veltrio.

¿Quiere usar este conector en su tienda?

Ver módulo Quipu para PrestaShop →

Publicaciones Similares

Deja una respuesta

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