Entrar
.md

Odoo POS Cashback

El módulo Guper POS Cashback (guper_pos_cashback) integra la generación y el canje de cashback Guper dentro del Punto de Venta (POS) de Odoo 19 Enterprise, con validación del cliente por PIN vía WhatsApp. El canje se representa fiscalmente como un descuento por línea (Descuento por concepto del CFDI).

Esta guía explica, paso a paso, cómo instalarlo y configurarlo en un proyecto de Odoo.sh.

Requisitos previos

  • Un proyecto de Odoo.sh ya creado sobre Odoo 19 Enterprise.
  • Acceso al repositorio del proyecto en GitHub (el que Odoo.sh construye).
  • Las credenciales Guper de la organización del cliente: API Key, API Secret y URL base (https://{org}.myguper.com). Consulta Autenticación si necesitas obtenerlas.

Parte A. Instalación del módulo

El módulo se distribuye como un git submódulo que apunta al repositorio MyGuper/guper-odoo. Así cada cliente reutiliza el mismo código y recibe actualizaciones sin copiar archivos.

Paso 1. Abrir el proyecto en Odoo.sh y agregar el submódulo

En el panel de Odoo.sh, entra a la pestaña Branches y selecciona tu rama (por ejemplo main). Arriba a la derecha, haz clic en el botón Submodule.

Paso 1: botón Submodule en Odoo.sh

Paso 2. Completar los datos del submódulo

En el diálogo Add a submodule, completa exactamente estos valores y haz clic en Add a submodule:

Campo Valor
Repository URL git@github.com:MyGuper/guper-odoo.git
Branch 19.0
Path MyGuper/guper-odoo

Paso 2: diálogo Add a submodule

Al confirmar, Odoo.sh genera un nuevo build de la rama. Espera a que el build quede en Success (verde).

Paso 3. Conectar al entorno de Odoo

Cuando el build esté listo, haz clic en CONNECT para abrir la base de datos. Verás el menú de aplicaciones de Odoo.

Nota: en ramas de desarrollo/staging, Odoo muestra un aviso de que la base es temporal. Úsalas solo para pruebas.

Paso 3: entorno de Odoo conectado

Paso 4. Instalar el módulo desde Apps

Entra a Apps, escribe guper en el buscador y localiza Guper POS Cashback (guper_pos_cashback). Haz clic en Activar / Instalar.

Si el módulo no aparece, usa Update Apps List (menú superior) y vuelve a buscar.

Paso 4: módulo Guper POS Cashback en Apps


Parte B. Configuración

La integración se configura mediante Parámetros del sistema. Para acceder a ellos hay que activar el modo desarrollador.

Paso 5. Activar el modo desarrollador

Ve a Ajustes (Settings), baja hasta la sección Developer Tools y haz clic en Activate the developer mode.

Paso 5: activar modo desarrollador

Paso 6. Abrir Parámetros del sistema

Con el modo desarrollador activo, en Ajustes aparece el menú Technical. Ábrelo y, bajo Parameters, entra a System Parameters.

Paso 6: menú Técnico, System Parameters

Paso 7. Configurar los parámetros de Guper

El módulo crea automáticamente las claves guper.*. Ajusta los valores según el cliente:

Paso 7: lista de parámetros guper.*
Parámetro Valor Descripción
guper.base_url https://{org}.myguper.com URL base de la organización Guper del cliente.
guper.apikey (provisto por Guper) API Key de la organización.
guper.apisecret (provisto por Guper) API Secret de la organización.
guper.client_id_field phone Campo que identifica al cliente. Valores posibles: phone, email, document.
guper.enabled True Activa la comunicación con Guper. Ver la nota de seguridad más abajo.
guper.access_token (automático) Token de sesión. Lo gestiona el módulo, no editar.
guper.token_expires_in (automático) Vencimiento del token. Lo gestiona el módulo, no editar.

Para editar un valor, haz clic en la fila del parámetro y cambia el campo Value.


Nota de seguridad: guper.enabled

guper.enabled viene en False por defecto a propósito.

En Odoo.sh, las bases de staging son una copia de producción, incluidas las credenciales Guper. Si una copia de staging quedara activa, podría comunicarse con la organización Guper de producción y enviar PINs reales por WhatsApp.

Por eso:

  • Deja guper.enabled = False en staging y en desarrollo.
  • Pon guper.enabled = True solo en producción.

Actualizar el módulo a una nueva versión

Como el módulo se instaló como submódulo, un push al repositorio guper-odoo no actualiza automáticamente los proyectos que ya lo tienen: un submódulo apunta a un commit fijo. Para traer la última versión, en el repositorio del proyecto Odoo.sh ejecuta:

git submodule update --remote MyGuper/guper-odoo
git add MyGuper/guper-odoo
git commit -m "update: Guper POS Cashback a la última versión"
git push

El --remote toma el último commit de la rama 19.0 (definida en .gitmodules). Al hacer push, Odoo.sh reconstruye el build con la versión nueva.


Verificación rápida

  1. Abre el Punto de Venta y crea un pedido con un cliente que tenga el campo identificador (por defecto, teléfono) registrado.
  2. Al hacer clic en Pagar, el flujo Guper cotiza el pedido: si hay saldo, ofrece canjear (con PIN); si no, informa cuánto acumulará.
  3. Confirma en Guper que el pedido queda registrado con el número de ticket del POS y el monto con impuesto incluido.

La experiencia en el POS

Este video muestra cómo se ve el flujo de cashback en el Punto de Venta una vez configurado:

▶️ Ver el video en YouTube

Soporte

El equipo de integración está en WhatsApp 24/7 — +52 55 2328 5981.