---
title: 'Odoo POS Cashback'
description: 'Módulo Odoo 19 que genera y canjea cashback Guper dentro del Punto de Venta, con validación por PIN vía WhatsApp.'
---

# 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](/docs/{lang}/guides/authentication) 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](/docs/assets/integrations/odoo/step1.png)

### 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](/docs/assets/integrations/odoo/step2.png)

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](/docs/assets/integrations/odoo/step3.png)

### 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](/docs/assets/integrations/odoo/step4.png)

---

## 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](/docs/assets/integrations/odoo/step5.png)

### 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](/docs/assets/integrations/odoo/step6.png)

### Paso 7. Configurar los parámetros de Guper

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

<img src="/docs/assets/integrations/odoo/step7.png" alt="Paso 7: lista de parámetros guper.*" style="max-width:440px;width:100%;height:auto;" />

| 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:

```bash
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:

<div style="position:relative;width:100%;max-width:720px;aspect-ratio:16/9;margin:16px 0;">
  <iframe src="https://www.youtube.com/embed/kr87Gc99w-s" title="Guper POS Cashback en Odoo" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen style="position:absolute;top:0;left:0;width:100%;height:100%;border-radius:8px;"></iframe>
</div>

▶️ [Ver el video en YouTube](https://www.youtube.com/watch?v=kr87Gc99w-s)

## Soporte

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