Runbook Operativo — Sistema POS Toros de Tijuana
📋 Introducción

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.

👤
Etiquetas de rol Técnico Configuración de sistema, primera instalación.
Admin Ajustes desde el backend de Odoo.
Operador Uso diario en el kiosko o terminal.
MóduloFunciónEstado
pos_kiosk_storeKiosko, inventario, fondo de caja, recibos QR✅ Activo
pos_self_order_compagoIntegración kiosko + terminal Compago✅ Activo
pos_compagoProcesamiento de pagos con tarjeta✅ Activo
payment_compagoProveedor de pago Compago✅ Activo
account_internal_consumptionConsumo Interno de personal🔧 En configuración
💳 Sección 1

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)
📸 Pantalla: Formulario de Método de Pago — Terminal Compago
🖼 Captura de pantalla: Configuración → Métodos de Pago → formulario con terminal "Compago" seleccionado
💡
Verificación Si el campo "Terminal de Pago" no muestra "Compago", confirma que el módulo 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
📸 Pantalla: Método de pago "Pago en Caja" sin terminal asignado
🖼 Captura: formulario con Terminal de Pago vacío, casilla "Es recuento de efectivo" marcada
⚠️
Importante El método aparecerá en el kiosko solo si en la configuración del POS se activa la opción "Permitir Pago en Efectivo en Kiosko" (ver Sección 3).
⚙️ Sección 2

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 Compago y Pago 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
📸 Pantalla: Configuración del POS — sección Autopedido con "Kiosko" seleccionado
🖼Captura: pestaña Autopedido con modo "Kiosko" activo y métodos de pago asignados

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ámetroDónde configurarloRecomendación Toros
Color primarioCampo hexadecimal#C0392B (rojo Toros)
Color secundarioCampo hexadecimal#D4A017 (dorado)
Color de fondoCampo hexadecimal#1A1A1A (negro)
Imagen de fondoSubir imagen PNG/JPGLogo o foto del estadio (1920×1080 px)
TipografíaSelector desplegableOutfit o Poppins
Columnas de productosNúmero (2, 3 o 4)3 para pantalla de 7"
Tamaño de imagenPequeña / Mediana / GrandeMediana (180 px)
Mostrar precioToggleActivado
Mostrar descripciónToggleDesactivado (pantalla pequeña)
📸 Pantalla: Sección "Kiosko Store" en Configuración del POS
🖼Captura: campos de color, fuente, columnas y imagen de fondo en la config del POS
📸 Vista del kiosko con colores Toros aplicados (vista previa en terminal)
🖼Foto o captura de la terminal Newland mostrando el kiosko con branding Toros

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
ℹ️
Qué pasa al abrir sesión Odoo mueve automáticamente los productos configurados desde el almacén principal hacia la ubicación de la caseta, y registra el fondo de caja en el diario de efectivo. El vendedor no tiene que hacer nada extra.
ℹ️
Qué pasa al cerrar sesión Odoo revisa el inventario sobrante en la caseta y lo devuelve automáticamente al almacén principal. Los movimientos quedan registrados con origen "Cierre Kiosko".
📸 Pantalla: Sección Tienda/Caseta con inventario inicial configurado
🖼Captura: tabla de inventario inicial con productos y cantidades
💵 Sección 3

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 Caja esté en la lista de Métodos de Pago del POS (creado en Sección 1B)
  • 5Guarda
💡
Cómo se ve para el cliente En la pantalla de pago del kiosko aparecerá un botón adicional "Pagar en Caja". Al seleccionarlo, la orden queda en estado pendiente. El operador cobra y confirma el pago desde la terminal.
📸 Pantalla del kiosko: botón "Pago en Caja" visible junto a "Tarjeta"
🖼Captura de la pantalla de pago del kiosko mostrando ambas opciones
📱 Sección 4

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.

📋
Materiales necesarios Terminal Newland encendida y con WiFi activo · Archivo APK de Compago · Acceso al backend de Odoo como Administrador · Cable USB o acceso por red para transferir el APK

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
📸 Terminal Newland: pantalla de instalación del APK Compago
🖼Foto de la terminal mostrando la pantalla de instalación
⚠️
Versión del APK Asegúrate de instalar la versión del APK Compago compatible con Odoo 19. Versiones antiguas pueden fallar en la comunicación con el servidor.

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
📸 Odoo: QR de acceso al kiosko en la configuración del POS
🖼Captura: campo "QR de Acceso al Kiosko" en la config del POS mostrando el código QR
📸 Terminal Newland: pantalla del kiosko Toros cargada correctamente
🖼Foto de la terminal mostrando el catálogo de productos con branding Toros
💡
Si el QR no funciona Verifica que la terminal esté en la misma red WiFi que el servidor de Odoo, o que la URL del servidor sea accesible desde internet si operan en la nube.

Datos de la terminal para soporte

Anota estos datos al dar de alta cada terminal:

CampoValor
Nombre del POS en Odooej: Caseta Norte 1
Número de serie Newlanden la etiqueta trasera del dispositivo
Dirección MAC / IPAjustes → WiFi → [red conectada] → detalles
Versión APK Compagoen la app: Ajustes → Acerca de
🛒 Sección 5

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
📸 Pantalla del kiosko: selección de productos y carrito
🖼Captura: pantalla de catálogo con productos y botón "Pagar"
📸 Terminal Newland: pantalla de cobro Compago
🖼Foto de la terminal mostrando el monto y las instrucciones de pago con tarjeta

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
⚠️
Control de efectivo El efectivo cobrado por ventas en kiosko se registra en el diario de efectivo de la sesión. Al cierre, el operador debe cuadrar el efectivo físico con lo registrado en Odoo.
📄 Sección 6

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
📸 Pantalla de éxito con QR después del pago
🖼Captura: pantalla completa con ícono ✓, mensaje de éxito, código QR y cuenta regresiva
📸 Recibo digital en el celular del cliente (abierto por el QR)
🖼Captura del recibo HTML: logo, listado de productos, totales y método de pago

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
🏃 Sección 7

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.

📋
Prerequisitos El POS debe tener el modo "Vendedor Flotante" configurado (en Sección 2A, seleccionar "Vendedor Flotante" en lugar de "Kiosko"), o el modo Kiosko con la opción de efectivo habilitada. El inventario y el fondo de caja deben estar configurados para este POS en modo Tienda/Caseta.

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
💡
Recarga durante la sesión Si al vendedor se le agota stock o efectivo, el administrador puede enviar una Recarga en Caliente desde Punto de Venta → Recargas de Tienda sin interrumpir la sesión activa.
📸 Odoo Backend: formulario de Recarga de Tienda (efectivo o producto)
🖼Captura: formulario con tipo de recarga (Efectivo / Producto), monto/cantidad y botón "Aplicar Recarga"

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
🔒 Sección 8

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 → Sesiones y 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
📸 Pantalla de Control de Cierre de sesión POS
🖼Captura: pantalla de cierre con resumen de ventas por método y botón "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
ℹ️
Informe de ventas post-cierre Ve a 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.
💡
Movimientos de inventario Para ver el detalle de qué se entregó y qué regresó al almacén, ve a Inventario → Operaciones → Transferencias y filtra por origen "Apertura Kiosko" o "Cierre Kiosko".
📸 Odoo Inventario: transferencias de apertura y cierre de kiosko
🖼Captura: lista de transferencias con origen "Apertura Kiosko" y "Cierre Kiosko"

Resumen del ciclo completo por sesión

MomentoAcción Odoo (automática)Acción del operador
AperturaTransfiere inventario inicial al vendedor · Registra fondo de cajaVerifica que los productos estén en la terminal
Venta tarjetaProcesa con Compago · Registra el pago · Genera QR de reciboAsistir al cliente si tiene dudas
Venta efectivoRegistra la orden como pendienteCobra físicamente · Confirma el pago
RecargaTransfiere stock o efectivo adicional en calienteAdmin crea la recarga desde Odoo backend
CierreDevuelve sobrantes al almacén · Genera informe de cierreCuenta efectivo · Registra monto contado · Entrega efectivo
🛠 Referencia

Errores Frecuentes y Soluciones

Error / SíntomaCausa probableSolució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
👥 Referencia

Quién Hace Qué — Tabla de Responsabilidades

TareaTécnicoAdminOperador
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.