Nota

Alcance de esta sección: Esta sección detalla los flujos de cobro en la caja de Depot OS, incluyendo pagos mixtos, redención de puntos de lealtad, aplicación de promociones automáticas y autorizaciones especiales por PIN.

Checkout, Promociones y Medios de Pago

El Checkout es el paso final de la venta. Se encarga de procesar los cobros, validar promociones y cupones, calcular el cambio exacto y registrar de forma segura la transacción tanto en el inventario como en la caja registradora activa.

1. Aplicación de Promociones y Cupones en Checkout

Antes de recibir el pago, Depot OS calcula los descuentos correspondientes en el subtotal del carrito:

A. Motor de Auto-Aplicación de Promociones (`promotionAutoApply`)

Si está activo, el cajero no necesita buscar ni seleccionar ofertas. El sistema evalúa el carrito en tiempo real y aplica automáticamente la combinación óptima de promociones que maximice el ahorro del cliente, respetando siempre los límites de acumulación establecidos.

Límite de Acumulación (promotionMaxStack): Si hay múltiples ofertas válidas en el carrito, el motor matemático calcula y aplica de forma acumulada las mejores promociones hasta alcanzar el límite máximo configurado (ej. máximo 2 o 3 promociones simultáneas). Si el límite es 1 (no acumulable), se aplicará únicamente la promoción individual que otorgue el mayor descuento absoluto.
Exclusión de Cupones (excludeCoupons): Si alguna de las promociones aplicadas en el ticket tiene activa la casilla de exclusión, el sistema bloqueará el campo de ingreso de cupones, protegiendo los márgenes de ganancia mínimos del negocio.

B. Canje de Cupones de Descuento

Si el cliente cuenta con un código promocional físico o digital (ej. BIENVENIDA10), el cajero lo introduce en la pantalla de cobro. El sistema valida en tiempo real:

La vigencia de fechas y horas.
La sucursal permitida.
Que el cliente asignado al ticket no haya superado el límite de uso del cupón.

2. Redención de Puntos de Lealtad (Monedero Electrónico)

Si el cliente seleccionado en el ticket cuenta con puntos en su monedero electrónico (enableLoyalty = true):

Consulta de Saldo: La pantalla de checkout muestra de forma directa su saldo de puntos acumulados y su equivalencia en dinero según la tasa redeemRate.
Redención Parcial o Total: El cajero puede ingresar los puntos que el cliente desea descontar. El sistema restará el valor monetario correspondiente del total a pagar.
Restricción de Seguridad: La redención genera una transacción de tipo spend en la base de datos inmutable. Si el cajero desea realizar un ajuste o compensación de puntos manual sin una venta de por medio, requerirá el PIN de un gerente con permiso loyalty:adjust.

3. Cuentas Divididas y Pagos Mixtos (Split Payments)

Depot OS permite cobrar una sola cuenta utilizando diferentes métodos de pago en una sola transacción:

Captura de Pago Parcial: El cajero introduce el monto recibido para el primer método (ej. $100.00 pesos en Efectivo). La interfaz descuenta el monto del saldo pendiente y mantiene bloqueada la confirmación de la venta.
Selección del Segundo Método: El cajero selecciona el siguiente método (ej. Tarjeta) para cobrar los $150.00 pesos restantes de la cuenta.
Validación de Cierre: El sistema solo permite presionar el botón "Finalizar Venta" cuando la sumatoria de todos los pagos ingresados cubre con exactitud el total del pedido.

4. Autorizaciones de Cortesías y Operaciones Críticas (PIN Bypass)

Para evitar fraudes o errores involuntarios en la caja, ciertas acciones de riesgo financiero están bloqueadas por defecto:

Aplicar un descuento manual del 100% (Cortesía).
Eliminar un artículo del carrito después de haber impreso la comanda.
Cancelar o anular un ticket ya cobrado.

Al intentar realizar una de estas acciones, Depot OS desplegará un teclado numérico flotante. La pantalla permanecerá congelada hasta que un gerente o administrador digite su PIN personal, autorizando la operación. Una vez aprobada con el PIN, la acción se completa y se registra automáticamente en la bitácora de auditoría. Cada entrada inmutable en este registro almacena el identificador único de la transacción, el nombre del gerente que la autorizó, el tipo de acción realizada (como la aplicación de descuentos por cortesía, la eliminación de artículos del carrito después de imprimir la comanda, o la cancelación definitiva del ticket) y la justificación o motivo ingresado por el supervisor.

5. Ejemplo Operativo de un Checkout Mixto (Paso a Paso)

Visualicemos una venta en el mostrador por un total de $300.00 pesos:

Auto-aplicación: Al presionar "Pagar", el sistema detecta que el cliente lleva una promoción de bebidas y descuenta -$50.00 pesos. El total a cobrar baja a $250.00 pesos.
Pago Mixto - Parte 1 (Efectivo): El cliente desea pagar su refresco en efectivo entregando un billete de $200.00 pesos, pero quiere que se apliquen solo $100.00 pesos de ahí al pedido, y el resto cobrarlo a su tarjeta.
- El cajero registra $200.00 como efectivo físico recibido y especifica $100.00 como el importe a aplicar al cobro actual.
- El sistema registra el pago parcial de $100.00, calcula el saldo restante de la venta ($150.00 pesos) e indica al cajero que devuelva exactamente $100.00 pesos de cambio al cliente.
Pago Mixto - Parte 2 (Tarjeta): El cajero selecciona el método de pago Tarjeta por el saldo restante de $150.00 pesos y procesa el cobro en la terminal bancaria.
Finalizar Venta: La sumatoria de pagos ($100 en efectivo + $150 en tarjeta) es igual a $250. El sistema habilita el botón "Finalizar", imprime el ticket de compra y descuenta los productos del inventario de la sucursal.