Cómo usar este runbook
Guía operativa completa del sistema POS de Toros de Tijuana sobre Odoo 19. Cubre desde la configuración inicial hasta el cierre diario de caja, con pasos para técnicos y operadores en la misma sección.
Admin Ajustes desde el backend de Odoo.
Operador Uso diario en el kiosko o terminal.
| Módulo | Función | Estado |
|---|---|---|
pos_kiosk_store | Kiosko, inventario, fondo de caja, recibos QR | ✅ Activo |
pos_self_order_compago | Integración kiosko + terminal Compago | ✅ Activo |
pos_compago | Procesamiento de pagos con tarjeta | ✅ Activo |
payment_compago | Proveedor de pago Compago | ✅ Activo |
account_internal_consumption | Consumo Interno de personal | 🔧 En configuración |
Configuración de Método de Pago en Odoo
Antes de configurar cualquier punto de venta, los métodos de pago deben existir en Odoo. Esta sección crea los dos métodos necesarios: terminal de tarjeta (Compago) y efectivo emulado para el kiosko.
Admin 1A — Método de pago con terminal (Compago)
- 1Navega a
Punto de Venta → Configuración → Métodos de Pago - 2Haz clic en Nuevo
- 3Nombre:
Tarjeta Compago(o el nombre que se mostrará al cliente) - 4En el campo Terminal de Pago, selecciona
Compago - 5Asigna el Diario contable correspondiente (ej: "Tarjeta de Crédito/Débito")
- 6Guarda el registro (Guardar manualmente)
pos_compago está instalado en Ajustes → Aplicaciones.Admin 1B — Método de pago de efectivo emulado (Kiosko)
El kiosko en modo autopedido no puede mostrar métodos sin terminal a menos que se habilite explícitamente. Este método permite que el cliente seleccione "Pagar en Caja" y el cobro físico lo realiza el operador.
- 1En
Métodos de Pago, crea un nuevo registro - 2Nombre:
Pago en Caja(visible para el cliente en el kiosko) - 3Deja el campo Terminal de Pago en vacío / sin terminal
- 4Asigna el Diario de Efectivo correspondiente
- 5Activa la casilla Es recuento de efectivo (is_cash_count) — esto permite que el sistema registre el fondo de caja y las recargas en este diario
- 6Guarda
Configurar Punto de Venta en Modo Quiosco
Cada terminal física en el estadio es un "Punto de Venta" en Odoo. Esta sección configura uno de esos puntos para operar como kiosko de autopedido con la terminal Newland.
Admin 2A — Ajustes generales del POS
- 1Ve a
Punto de Venta → Configuración → Puntos de Venta - 2Selecciona el punto de venta que corresponde a la terminal, o crea uno nuevo con Nuevo
- 3En la sección Autopedido, activa la opción Kiosko en el campo Modo
- 4En Métodos de Pago, agrega los métodos creados en la Sección 1 (
Tarjeta CompagoyPago en Caja) - 5Configura el Tipo de Operación de almacén — esto define desde dónde salen y hacia dónde van los productos del inventario de la caseta
- 6Guarda
Admin 2B — Personalización visual del kiosko
Todos los ajustes visuales están en la misma pantalla de configuración del POS, en la sección "Kiosko Store".
| Parámetro | Dónde configurarlo | Recomendación Toros |
|---|---|---|
| Color primario | Campo hexadecimal | #C0392B (rojo Toros) |
| Color secundario | Campo hexadecimal | #D4A017 (dorado) |
| Color de fondo | Campo hexadecimal | #1A1A1A (negro) |
| Imagen de fondo | Subir imagen PNG/JPG | Logo o foto del estadio (1920×1080 px) |
| Tipografía | Selector desplegable | Outfit o Poppins |
| Columnas de productos | Número (2, 3 o 4) | 3 para pantalla de 7" |
| Tamaño de imagen | Pequeña / Mediana / Grande | Mediana (180 px) |
| Mostrar precio | Toggle | Activado |
| Mostrar descripción | Toggle | Desactivado (pantalla pequeña) |
Admin 2C — Modo Tienda / Caseta
Activa este modo si el vendedor opera desde una caseta fija con inventario propio asignado por sesión.
- 1En la configuración del POS, localiza la sección Tienda/Caseta
- 2Activa el toggle Activar Modo Tienda/Caseta
- 3En Fondo de Caja Inicial, escribe el monto en pesos que el vendedor recibirá al iniciar cada sesión (ej:
$500.00) - 4En la tabla Inventario Inicial, agrega cada producto con su cantidad por sesión:
- Haz clic en Agregar una línea
- Selecciona el producto y escribe la cantidad
- Repite para cada artículo que carga el vendedor
- 5Guarda la configuración
Activar Recepción de Efectivo en el Kiosko
Por defecto el kiosko solo muestra terminales de pago. Esta sección habilita la opción "Pago en Caja" para que el cliente pueda seleccionarla y el operador cobre físicamente.
- 1Ve a
Punto de Venta → Configuración → [nombre del POS] - 2Localiza la sección Kiosko Store o Métodos de Pago
- 3Activa el toggle "Permitir Pago en Efectivo en Kiosko"
- 4Confirma que el método
Pago en Cajaesté en la lista de Métodos de Pago del POS (creado en Sección 1B) - 5Guarda
Alta y Vinculación de Terminal Newland
Cada terminal Newland debe tener la APK de Compago instalada y vinculada al punto de venta de Odoo correspondiente mediante un código QR. Esta operación se realiza una sola vez por terminal.
Técnico 4A — Instalación del APK Compago en la terminal
- 1En la terminal Newland, entra a Ajustes → Seguridad → Fuentes desconocidas y actívalo para permitir instalación de APKs externos
- 2Transfiere el archivo APK de Compago a la terminal (vía USB, descarga por WiFi o correo)
- 3Desde el administrador de archivos de la terminal, localiza el APK y toca para instalarlo
- 4Acepta los permisos solicitados (cámara, almacenamiento, red)
- 5La aplicación Compago aparecerá en el menú de la terminal
- 6Abre Compago y completa el proceso de activación inicial si se solicita
Técnico Admin 4B — Vinculación de la terminal al POS mediante QR
- 1En Odoo, ve a
Punto de Venta → Configuración → [nombre del POS] - 2En la sección Kiosko Store o en la vista principal de la config, localiza el campo QR de Acceso al Kiosko — verás un código QR generado automáticamente
- 3En la terminal Newland, abre el navegador (Chrome) o la app Compago
- 4Escanea el código QR con la cámara de la terminal
- 5La terminal cargará automáticamente la URL del kiosko con el token de acceso correcto
- 6Confirma que la pantalla del kiosko de Toros aparece con los productos configurados
- 7Opcional: Fija la URL como página de inicio del navegador para que arranque automáticamente al encender la terminal
Datos de la terminal para soporte
Anota estos datos al dar de alta cada terminal:
| Campo | Valor |
|---|---|
| Nombre del POS en Odoo | ej: Caseta Norte 1 |
| Número de serie Newland | en la etiqueta trasera del dispositivo |
| Dirección MAC / IP | Ajustes → WiFi → [red conectada] → detalles |
| Versión APK Compago | en la app: Ajustes → Acerca de |
Operación de Venta Presencial
Flujo completo de una venta desde el kiosko: el cliente arma su pedido de forma autónoma y paga con tarjeta o efectivo. No requiere intervención del operador salvo en el caso de pago en efectivo.
Operador Cliente 5A — Venta y pago con tarjeta
- 1Cliente: En la pantalla del kiosko, selecciona los productos deseados y toca Agregar al carrito
- 2Cliente: Revisa el carrito y toca Pagar
- 3Cliente: En la pantalla de pago, selecciona Tarjeta Compago
- 4La terminal Newland muestra la pantalla de cobro de Compago con el monto a pagar
- 5Cliente: Acerca la tarjeta o celular al lector NFC, o inserta/desliza la tarjeta
- 6Compago procesa la transacción y retorna el resultado a Odoo
- 7Si es aprobado: el kiosko muestra la pantalla de recibo con QR (ver Sección 6)
- 8Si es declinado: se muestra un mensaje de error; el cliente puede intentar con otro método
Operador 5B — Venta con pago en efectivo
- 1Cliente: Selecciona productos y toca Pagar
- 2Cliente: Selecciona Pago en Caja
- 3El kiosko registra la orden como pendiente de cobro y muestra el número de orden al cliente
- 4Operador: En la interfaz del operador (o backend de Odoo), la orden aparece en lista de pendientes
- 5Operador: Cobra al cliente el monto indicado y entrega cambio si aplica
- 6Operador: Confirma el cobro desde la pantalla de órdenes — la orden pasa a estado "Pagado"
- 7El cliente puede escanear el QR de recibo si aparece en pantalla
QR de Recibo de Compra
Después de cada pago exitoso, el kiosko muestra automáticamente una pantalla con un código QR. El cliente lo escanea con su celular para ver el recibo digital completo de su compra.
Flujo automático — sin acción del operador
- 1El pago se confirma (tarjeta aprobada o efectivo confirmado)
- 2El kiosko muestra la pantalla de éxito con:
- Ícono de confirmación ✓
- Mensaje "¡Pago Exitoso! Tu pedido ha sido confirmado"
- Método de pago utilizado
- Código QR escaneable
- Cuenta regresiva de 60 segundos para volver al inicio
- 3Cliente: Abre la cámara del celular y escanea el QR
- 4El celular abre el recibo HTML con el detalle completo de la compra: productos, cantidades, subtotal, impuestos, método de pago y número de autorización de tarjeta
- 5Transcurridos 60 segundos (o al tocar Nuevo Pedido), la pantalla regresa al inicio
Técnico Impresión automática (opcional)
Si la terminal cuenta con el puente de impresión OdooPrintBridge activo en el puerto 9100, el recibo se imprime automáticamente en la impresora térmica sin intervención del operador.
- 1Instalar y ejecutar OdooPrintBridge en el mismo dispositivo o en la red local de la terminal
- 2La impresora debe ser compatible con protocolo ESC/POS
- 3Al completar el pago, el kiosko envía el recibo automáticamente al bridge que lo redirige a la impresora
Operación de Vendedor Externo desde Terminal
Para vendedores que operan en campo (pasillo, gradas) con una terminal Newland portátil. La terminal actúa como kiosko móvil: el vendedor toma el pedido, el cliente paga con tarjeta o efectivo.
Operador 7A — Apertura de sesión del vendedor
- 1El vendedor enciende la terminal Newland y abre el navegador con la URL del kiosko (guardada como favorito o página de inicio)
- 2Si no hay sesión abierta en ese POS, Odoo solicitará iniciar sesión con usuario de Odoo
- 3Al iniciar sesión, Odoo ejecuta automáticamente:
- ✅ Transfiere el inventario inicial al punto de venta
- ✅ Registra el fondo de caja inicial en el diario de efectivo
- 4El vendedor confirma en la terminal que el kiosko muestra los productos disponibles
Punto de Venta → Recargas de Tienda sin interrumpir la sesión activa.Operador 7B — Ciclo de venta en campo
- 1El vendedor muestra la terminal al cliente para que seleccione productos, o el vendedor agrega los productos él mismo
- 2Se confirma el pedido y se procede al pago
- 3Pago con tarjeta: el cliente acerca su tarjeta o celular al lector NFC de la terminal — Compago procesa y regresa el resultado
- 4Pago en efectivo: el vendedor selecciona "Pago en Caja", cobra al cliente y confirma el cobro
- 5La pantalla de QR aparece; el cliente puede escanearlo con su celular
- 6La terminal regresa automáticamente al inicio para el siguiente cliente
Reconciliación y Cierre de Caja
Al terminar el evento o turno, el operador cierra la sesión. Odoo reconcilia automáticamente el inventario y genera el informe de cierre. El cuadre físico del efectivo es responsabilidad del operador.
Operador Admin 8A — Cierre de sesión
- 1En el backend de Odoo, ve a
Punto de Venta → Sesionesy selecciona la sesión activa, o desde la terminal, accede al menú de cierre - 2Haz clic en Cerrar (Control de Cierre)
- 3Odoo ejecuta automáticamente la devolución de inventario: todos los productos sobrantes en la caseta regresan al almacén principal
- 4Se muestra el resumen de ventas por método de pago
- 5Confirma el cierre con Cerrar Sesión
Operador Admin 8B — Cuadre de caja
- 1Cuenta físicamente el efectivo en la caja del vendedor
- 2En Odoo, en la pantalla de cierre, compara:
- Efectivo esperado = Fondo inicial + Ventas en efectivo durante la sesión
- Efectivo contado físicamente = Lo que tiene el vendedor
- 3Registra el monto contado en el campo "Efectivo contado"
- 4Si hay diferencia (sobrante o faltante), Odoo la registra automáticamente
- 5El vendedor entrega el efectivo al encargado de caja
Punto de Venta → Informes → Sesiones para ver el resumen completo de la sesión cerrada: ventas por producto, por método de pago, y movimientos de inventario.
Inventario → Operaciones → Transferencias y filtra por origen "Apertura Kiosko" o "Cierre Kiosko".
Resumen del ciclo completo por sesión
| Momento | Acción Odoo (automática) | Acción del operador |
|---|---|---|
| Apertura | Transfiere inventario inicial al vendedor · Registra fondo de caja | Verifica que los productos estén en la terminal |
| Venta tarjeta | Procesa con Compago · Registra el pago · Genera QR de recibo | Asistir al cliente si tiene dudas |
| Venta efectivo | Registra la orden como pendiente | Cobra físicamente · Confirma el pago |
| Recarga | Transfiere stock o efectivo adicional en caliente | Admin crea la recarga desde Odoo backend |
| Cierre | Devuelve sobrantes al almacén · Genera informe de cierre | Cuenta efectivo · Registra monto contado · Entrega efectivo |
Errores Frecuentes y Soluciones
| Error / Síntoma | Causa probable | Solución |
|---|---|---|
| "Disculpe, parece que olvidó crear productos o agregarlos a pos_config" | El POS no tiene productos disponibles para el modo autopedido | En Odoo: Catálogo → Productos → activa "Disponible en Punto de Venta" y asigna el POS correcto en los productos |
| El botón "Pago en Caja" no aparece en el kiosko | Toggle "Permitir Pago en Efectivo en Kiosko" desactivado, o el método no está en la config del POS | Sección 3 — verificar toggle y lista de métodos de pago |
| La terminal no se comunica con Compago | APK desactualizado o terminal sin conexión a la misma red del servidor | Verificar WiFi · Reinstalar APK versión compatible · Revisar URL del servidor |
| El inventario no se transfiere al abrir sesión | Modo Tienda/Caseta no activado, o no hay Tipo de Operación con ubicaciones configuradas | Sección 2C — verificar Tipo de Operación en la config del POS |
| El sobrante no regresa al almacén al cerrar sesión | La ubicación de la caseta no tiene stock registrado (ventas vaciaron todo) | Comportamiento normal si se vendió todo · Revisar log de inventario en Transferencias |
| El QR de recibo no carga en el celular del cliente | El servidor de Odoo no es accesible desde internet o desde la red del cliente | Verificar que la URL del servidor sea pública, o que el celular esté en la misma red WiFi del estadio |
| Error al instalar/actualizar módulo pos_kiosk_store | Conflicto de parámetros de sistema (n8n_invoice_webhook_url) en actualización |
El módulo incluye un script de migración automático — revisar logs del servidor si persiste |
Quién Hace Qué — Tabla de Responsabilidades
| Tarea | Técnico | Admin | Operador |
|---|---|---|---|
| Instalar módulos en Odoo | ✅ | ||
| Instalar APK Compago en Newland | ✅ | ||
| Crear métodos de pago | ✅ | ||
| Configurar POS (modo, visual, inventario) | ✅ | ||
| Vincular terminal con QR | ✅ | ✅ | |
| Abrir sesión del vendedor | ✅ | ||
| Operar ventas diarias | ✅ | ||
| Enviar recargas en caliente | ✅ | ||
| Cerrar sesión y registrar efectivo | ✅ | ✅ | |
| Revisar informes de ventas | ✅ |
Documento generado por Lokal Money · webmaster@lokal.mx · v2025.05
Para soporte técnico o actualizaciones de este runbook, contactar al equipo de desarrollo.
Implementamos ecosistemas de cobros seguros, eficientes y sin complejidades ofreciendo más valor en cada transacción.
Servicios
Servicio y soporte
Contacto
Dirección
Nápoles 85 Juárez • Ciudad de México
Teléfono
+52 55 6491 5928
Correo electrónico
info@yellowgreen-louse-993046.hostingersite.com
LOKAL Group © 2025 Reservados todos los derechos.