- 📁Crea la carpeta
gago_pos en tu carpeta de módulos (addons) con estos archivos.
- 🔑En Odoo: Ajustes → Técnico → Parámetros del sistema → nuevo: clave
gago.api_key, valor tu llave.
- ⬆️Aplicaciones → Actualizar lista → instala Gago para Punto de Venta. Cierra y abre la sesión del POS.
- ✅Al cobrar sale «¿Acumula puntos? Sí / No». Con Sí, el cajero escanea el QR de la tarjeta del cliente y en su celular se abre la encuesta (cliente nuevo: deja el campo vacío y el QR sale en el ticket). Con No, la venta sigue normal. En la venta también aparece el botón 🎁 Canjear Gago.
Hecho para Odoo 17 (Community y Enterprise). Odoo 18 cambió las ventanas del POS: si usas 18, pídenos la versión para 18. Pruébalo primero en una base de pruebas de Odoo.
gago_pos/__manifest__.py
# gago_pos/__manifest__.py
{
"name": "Gago para Punto de Venta",
"version": "17.0.1.0.0",
"summary": "Lealtad y encuestas de Gago en el POS: QR de la encuesta en el ticket y botón para canjear premios y cupones.",
"category": "Point of Sale",
"depends": ["point_of_sale"],
"data": [],
"assets": {
"point_of_sale._assets_pos": [
"gago_pos/static/src/**/*",
],
},
"license": "LGPL-3",
"installable": True,
}
gago_pos/__init__.py y gago_pos/models/__init__.py
# gago_pos/__init__.py
from . import models
# gago_pos/models/__init__.py
from . import pos_order
gago_pos/models/pos_order.py
# gago_pos/models/pos_order.py
# La llave de Gago va en Ajustes > Técnico > Parámetros del sistema, con la clave «gago.api_key».
# Las llamadas salen del servidor de Odoo: la llave nunca llega al navegador.
import requests
from odoo import _, api, models
from odoo.exceptions import UserError
GAGO_URL = "https://www.getgago.com/api/v1"
class PosOrder(models.Model):
_inherit = "pos.order"
@api.model
def _gago(self, metodo, ruta, datos=None, params=None):
llave = self.env["ir.config_parameter"].sudo().get_param("gago.api_key")
if not llave:
raise UserError(_("Falta la llave de Gago: Ajustes > Técnico > Parámetros del sistema > gago.api_key"))
try:
r = requests.request(
metodo,
GAGO_URL + ruta,
json=datos,
params=params,
headers={"Authorization": "Bearer " + llave},
timeout=10,
)
respuesta = r.json()
except Exception:
raise UserError(_("No se pudo conectar con Gago. Revisa el internet e intenta de nuevo."))
if not respuesta.get("ok"):
raise UserError(respuesta.get("error", {}).get("mensaje") or _("Gago no pudo completar la operación."))
return respuesta
@api.model
def gago_compra_cliente(self, qr, factura, monto, moneda="GTQ", confirmado=False):
"""«¿Acumula puntos? Sí»: registra la venta con el QR de la tarjeta del cliente. En su celular se abre
la encuesta. Si tiene una encuesta pendiente, devuelve registrada=False y el aviso."""
return self._gago("POST", "/compras/cliente", {
"qr": qr, "factura": factura, "monto": monto, "moneda": moneda, "confirmado": bool(confirmado),
})
@api.model
def gago_compra(self, factura, monto, moneda="GTQ"):
"""Cliente nuevo (aún sin tarjeta): devuelve el QR de la encuesta (qr_png) para imprimirlo en el ticket."""
return self._gago("POST", "/compras", {"factura": factura, "monto": monto, "moneda": moneda})
@api.model
def gago_canjear(self, codigo):
"""Canjea un premio o un cupón de Gago."""
return self._gago("POST", "/canjes", {"codigo": codigo})
@api.model
def gago_cliente(self, telefono):
"""Sellos o puntos, premio listo y cupones del cliente."""
return self._gago("GET", "/clientes", params={"telefono": telefono})
gago_pos/static/src/gago_pos.js
/** @odoo-module */
// gago_pos/static/src/gago_pos.js
// 1) Al cobrar: «¿Acumula puntos? Sí / No».
// Sí → escanea el QR de la tarjeta del cliente («Mi código») y Gago le abre la encuesta en su celular.
// Cliente nuevo (sin tarjeta): deja el campo vacío y el QR de la encuesta sale impreso en el ticket.
// No → la venta sigue normal.
// 2) Botón «Canjear Gago» en la pantalla de venta, para premios y cupones.
import { Component } from "@odoo/owl";
import { patch } from "@web/core/utils/patch";
import { useService } from "@web/core/utils/hooks";
import { usePos } from "@point_of_sale/app/store/pos_hook";
import { ProductScreen } from "@point_of_sale/app/screens/product_screen/product_screen";
import { PaymentScreen } from "@point_of_sale/app/screens/payment_screen/payment_screen";
import { Order } from "@point_of_sale/app/store/models";
import { TextInputPopup } from "@point_of_sale/app/utils/input_popups/text_input_popup";
import { ConfirmPopup } from "@point_of_sale/app/utils/confirm_popup/confirm_popup";
import { ErrorPopup } from "@point_of_sale/app/errors/popups/error_popup";
const mensajeError = (e) => e?.data?.message || e?.message || "Intenta de nuevo.";
// ── Al cobrar: ¿Acumula puntos? ─────────────────────────────────────────
patch(PaymentScreen.prototype, {
async validateOrder(isForceValidate) {
const orden = this.currentOrder;
// Se pregunta una sola vez por venta (aunque el pago se valide de nuevo).
if (!orden.gago_preguntado) {
orden.gago_preguntado = true;
await this.gagoAcumular(orden);
}
return await super.validateOrder(...arguments);
},
async gagoAcumular(orden) {
const popup = this.env.services.popup;
const orm = this.env.services.orm;
const { confirmed: acumula } = await popup.add(ConfirmPopup, {
title: "¿Acumula puntos?",
body: "¿El cliente quiere sumar esta compra a su tarjeta de Gago?",
confirmText: "Sí",
cancelText: "No",
});
if (!acumula) return;
const datos = [orden.name, orden.get_total_with_tax(), this.pos.currency.name === "USD" ? "USD" : "GTQ"];
const { confirmed, payload } = await popup.add(TextInputPopup, {
title: "Escanea el QR de la tarjeta del cliente",
placeholder: "«Mi código» en su tarjeta · vacío si es cliente nuevo",
});
if (!confirmed) return;
const qr = (payload || "").trim();
try {
// Cliente nuevo: el QR de la encuesta sale en el ticket.
if (!qr) {
const r = await orm.call("pos.order", "gago_compra", datos);
orden.gago_qr = r.qr_png;
return;
}
let r = await orm.call("pos.order", "gago_compra_cliente", [qr, ...datos, false]);
// Encuesta pendiente: si registra esta compra, pierde lo de la anterior.
if (!r.registrada && r.aviso) {
const pierde = r.aviso.puntos ? `${r.aviso.puntos} puntos` : "ese sello";
const { confirmed: igual } = await popup.add(ConfirmPopup, {
title: "Tiene una encuesta sin responder",
body: `${r.nombre || "El cliente"} no ha respondido la encuesta de su compra anterior. Si registras esta compra, pierde ${pierde}. Lo mejor es que la responda ahora en su celular.`,
confirmText: "Registrar de todos modos",
cancelText: "No registrar",
});
if (!igual) return;
r = await orm.call("pos.order", "gago_compra_cliente", [qr, ...datos, true]);
}
const gana = r.puntos ? `${r.puntos} puntos` : "su sello";
await popup.add(ConfirmPopup, {
title: "✅ Listo",
body: `En el celular de ${r.nombre || "el cliente"} se abrió la encuesta. Al responderla gana ${gana}.`,
confirmText: "Continuar",
cancelText: "Cerrar",
});
} catch (e) {
await popup.add(ErrorPopup, {
title: "No se pudo registrar en Gago",
body: `${mensajeError(e)} La venta sigue normal.`,
});
}
},
});
// El QR de la encuesta (cliente nuevo) viaja con la orden hasta el ticket.
patch(Order.prototype, {
export_for_printing() {
const datos = super.export_for_printing(...arguments);
datos.gago_qr = this.gago_qr || false;
return datos;
},
});
// ── Botón «Canjear Gago» (premios y cupones) ────────────────────────────
export class GagoCanjearButton extends Component {
static template = "gago_pos.CanjearButton";
setup() {
this.pos = usePos();
this.popup = useService("popup");
this.orm = useService("orm");
}
async click() {
const { confirmed, payload } = await this.popup.add(TextInputPopup, {
title: "Canjear premio o cupón de Gago",
placeholder: "Escanea o escribe el código",
});
if (!confirmed || !payload || !payload.trim()) return;
try {
const r = await this.orm.call("pos.order", "gago_canjear", [payload.trim()]);
const detalle = r.tipo === "cupon" ? `Cupón: ${r.descripcion || ""}` : `Premio entregado${r.nombre ? " a " + r.nombre : ""}`;
await this.popup.add(ConfirmPopup, { title: "✅ Canjeado en Gago", body: detalle });
} catch (e) {
await this.popup.add(ErrorPopup, { title: "No se pudo canjear", body: mensajeError(e) });
}
}
}
ProductScreen.addControlButton({ component: GagoCanjearButton, condition: () => true });
gago_pos/static/src/gago_pos.xml
<?xml version="1.0" encoding="UTF-8"?>
<!-- gago_pos/static/src/gago_pos.xml -->
<templates xml:space="preserve">
<!-- Botón en la pantalla de venta -->
<t t-name="gago_pos.CanjearButton">
<button class="control-button btn btn-light rounded-0 fw-bolder" t-on-click="() => this.click()">
<i class="fa fa-gift me-1"/> Canjear Gago
</button>
</t>
<!-- QR de la encuesta al final del ticket -->
<t t-name="gago_pos.OrderReceipt" t-inherit="point_of_sale.OrderReceipt" t-inherit-mode="extension">
<xpath expr="//div[hasclass('pos-receipt')]" position="inside">
<div t-if="props.data.gago_qr" style="text-align:center;margin-top:12px">
<div style="font-weight:bold">¡Califícanos y gana tus puntos!</div>
<img t-att-src="props.data.gago_qr" style="width:160px;height:160px"/>
<div style="font-size:12px">Escanea con la cámara de tu celular</div>
</div>
</xpath>
</t>
</templates>