Códigos de autorización

Los códigos de autorización son códigos de 6 dígitos, de un solo uso, generados por un manager en el backoffice de Fire. El POS los usa para completar operaciones sensibles que requieren aprobación del manager. Son distintos a los códigos de vinculación del terminal. Un código de vinculación registra un dispositivo. Un código de autorización aprueba una acción operativa, como cerrar una caja con faltante o ejecutar un retiro de efectivo.

​

Cuándo se necesita un código

FIRE POS V2 puede pedir un código de autorización para operaciones como:

• Cerrar caja con faltante de efectivo.
• Corregir un monto declarado durante el cierre de caja.
• Ejecutar un retiro de efectivo.
• Cancelar un pedido completado desde el POS.
• Desbloquear o forzar acciones administrativas, según la política de la tienda.

El requisito exacto depende de la acción y de la configuración de la tienda. Por defecto, cualquier faltante en el cierre de caja requiere autorización del manager.

​

Quién genera el código

Solo un manager con acceso al backoffice y scope sobre la tienda puede generar un código de autorización. El manager genera el código desde el backoffice:

• POS → Códigos de autorización: el manager elige el propósito, escribe la razón y define la duración, y genera un código de 6 dígitos.

​

1. El cajero inicia la operación

En el POS, el cajero inicia una operación que requiere aprobación. Por ejemplo, intenta cerrar una caja con faltante. El POS vuelve a pedir el PIN del cajero cuando la operación es sensible. Esto confirma que el cajero activo sigue siendo la persona que ejecuta la acción.

​

2. El POS pide un código

Cuando se necesita aprobación del manager, el POS muestra una pantalla para ingresar el código del manager. El cajero avisa al manager verbalmente o por el canal operativo normal de la tienda.

​

3. El manager abre Códigos de autorización

En el backoffice, el manager abre POS → Códigos de autorización para generar el código. Elige el propósito que corresponde a la operación, escribe la razón y define la duración del código. El propósito ata el código a una operación específica, como cerrar una caja con faltante, un retiro de efectivo o la cancelación de un pedido.

​

4. El manager escribe la razón y genera el código

El manager completa los campos requeridos, como razón, monto o categoría según la solicitud, y hace clic en Generar código. El backoffice muestra un código de 6 dígitos. El código tiene vida corta y queda atado al propósito y las restricciones de la solicitud.

​

5. El cajero ingresa el código en el POS

El manager dicta el código al cajero. El cajero ingresa los 6 dígitos en el campo de código de autorización del POS. Si el código es válido, el POS completa la operación y el backend registra el código consumido en la auditoría. Si el código expiró, ya fue usado o no corresponde al alcance de la operación, el POS lo rechaza. El manager puede generar otro código si todavía se necesita aprobar la operación.

​

Cierre de caja con faltante

Durante el cierre ciego de caja, el cajero declara el efectivo contado sin ver el efectivo esperado por el sistema. Si la declaración es menor que el esperado, el POS pide un código de manager. El manager abre Códigos de autorización, escribe la razón y genera un código con propósito pos:close_with_shortage atado a esa sesión de caja. El cajero ingresa el código y cierra la caja. El faltante exacto es visible para el manager y para auditoría, no para el cajero durante el flujo.

​

Retiro de efectivo

Para un retiro, el cajero solicita aprobación desde el POS. El manager abre Códigos de autorización, ingresa monto, razón y categoría, y genera un código con propósito pos:withdrawal_approval. El cajero ingresa el código en el POS. Cuando el backend lo valida, el retiro queda registrado, la gaveta se abre y se crea un voucher digital.

​

Cancelar un pedido

Un cajero puede cancelar un pedido completado desde el POS dentro de una ventana de 30 minutos. La cancelación genera una nota de crédito, por lo que siempre requiere autorización del manager. El manager genera un código con propósito pos:cancel_order_access. A diferencia de los códigos anteriores, este desbloquea una sesión de cancelación: una vez que el cajero ingresa un código válido, puede cancelar más de un pedido sin pedir uno nuevo. Para el flujo operativo completo — lista de pedidos, ventana de 30 minutos y confirmación — consulta Cancelaciones.

​

Reglas de seguridad

Los códigos de autorización en FIRE POS V2 siguen estas reglas:

• Tienen 6 dígitos.
• Se consumen una sola vez. Para la mayoría de las acciones, un código autoriza una sola operación; para la cancelación de pedidos, ese único uso abre una sesión de cancelación en la que el cajero puede cancelar más de un pedido.
• Expiran rápidamente.
• Se generan para un propósito específico, como pos:close_with_shortage, pos:withdrawal_approval o pos:cancel_order_access.
• Pueden incluir restricciones como sesión de caja destino, cajero destino o monto máximo.
• Quedan registrados en auditoría cuando se generan, fallan o se consumen.

​

Solución de problemas

Si el POS rechaza el código, revisa las causas más comunes:

• El código expiró.
• El código ya fue usado.
• El código se digitó mal.
• El manager lo generó para otro propósito.
• El código fue generado para otra sesión de caja, otro cajero u otro monto.

Genera un nuevo código desde Códigos de autorización cuando la operación todavía necesita aprobación.