Códigos de autorização

Os códigos de autorização são códigos de 6 dígitos, de uso único, gerados por um gerente no backoffice da Fire. O POS usa esses códigos para concluir operações sensíveis que exigem aprovação do gerente. Eles são diferentes dos códigos de vinculação do terminal. Um código de vinculação registra um dispositivo. Um código de autorização aprova uma ação operacional, como fechar um caixa com falta ou executar uma retirada de dinheiro.

​

Quando um código é necessário

O FIRE POS V2 pode pedir um código de autorização para operações como:

• Fechar caixa com falta de dinheiro.
• Corrigir um valor declarado durante o fechamento de caixa.
• Executar uma retirada de dinheiro.
• Cancelar um pedido concluído no POS.
• Desbloquear ou forçar ações administrativas, conforme a política da loja.

A exigência exata depende da ação e da configuração da loja. Por padrão, qualquer falta no fechamento de caixa exige autorização do gerente.

​

Quem gera o código

Somente um gerente com acesso ao backoffice e escopo sobre a loja pode gerar um código de autorização. O gerente gera o código no backoffice:

• POS → Códigos de autorização: o gerente escolhe o propósito, escreve a razão e define a duração, e gera um código de 6 dígitos.

​

1. O caixa inicia a operação

No POS, o caixa inicia uma operação que exige aprovação. Por exemplo, tenta fechar um caixa com falta. O POS pede novamente o PIN do caixa quando a operação é sensível. Isso confirma que o caixa ativo ainda é a pessoa que executa a ação.

​

2. O POS pede um código

Quando a aprovação do gerente é necessária, o POS mostra uma tela para inserir o código do gerente. O caixa avisa o gerente verbalmente ou pelo canal operacional normal da loja.

​

3. O gerente abre Códigos de autorização

No backoffice, o gerente abre POS → Códigos de autorização para gerar o código. Escolhe o propósito que corresponde à operação, escreve a razão e define a duração do código. O propósito vincula o código a uma operação específica, como fechar um caixa com falta, uma retirada de dinheiro ou o cancelamento de um pedido.

​

4. O gerente escreve a razão e gera o código

O gerente preenche os campos obrigatórios, como razão, valor ou categoria conforme a solicitação, e clica em Gerar código. O backoffice mostra um código de 6 dígitos. O código tem vida curta e fica vinculado ao propósito e às restrições da solicitação.

​

5. O caixa digita o código no POS

O gerente dita o código ao caixa. O caixa digita os 6 dígitos no campo de código de autorização do POS. Se o código for válido, o POS conclui a operação e o backend registra o código consumido na auditoria. Se o código expirou, já foi usado ou está fora do escopo da operação, o POS o rejeita. O gerente pode gerar outro código se a operação ainda precisar de aprovação.

​

Fechamento de caixa com falta

Durante o fechamento cego de caixa, o caixa declara o dinheiro contado sem ver o dinheiro esperado pelo sistema. Se a declaração for menor que o esperado, o POS pede um código do gerente. O gerente abre Códigos de autorização, escreve a razão e gera um código com propósito pos:close_with_shortage vinculado a essa sessão de caixa. O caixa digita o código e fecha o caixa. A falta exata fica visível para o gerente e para auditoria, não para o caixa durante o fluxo.

​

Retirada de dinheiro

Para uma retirada, o caixa solicita aprovação no POS. O gerente abre Códigos de autorização, informa valor, razão e categoria, e gera um código com propósito pos:withdrawal_approval. O caixa digita o código no POS. Quando o backend valida o código, a retirada é registrada, a gaveta abre e um voucher digital é criado.

​

Cancelar um pedido

Um caixa pode cancelar um pedido concluído no POS dentro de uma janela de 30 minutos. O cancelamento gera uma nota de crédito, por isso sempre exige autorização do gerente. O gerente gera um código com a finalidade pos:cancel_order_access. Diferente dos códigos acima, este desbloqueia uma sessão de cancelamento: depois que o caixa digita um código válido, ele pode cancelar mais de um pedido sem pedir um novo. Para o fluxo operacional completo — lista de pedidos, janela de 30 minutos e confirmação — consulte Cancelamentos.

​

Regras de segurança

Os códigos de autorização no FIRE POS V2 seguem estas regras:

• Têm 6 dígitos.
• São consumidos uma única vez. Para a maioria das ações, um código autoriza uma única operação; para o cancelamento de pedidos, esse único uso abre uma sessão de cancelamento na qual o caixa pode cancelar mais de um pedido.
• Expiram rapidamente.
• São gerados para um propósito específico, como pos:close_with_shortage, pos:withdrawal_approval ou pos:cancel_order_access.
• Podem incluir restrições como sessão de caixa destino, caixa destino ou valor máximo.
• Ficam registrados na auditoria quando são gerados, falham ou são consumidos.

​

Solução de problemas

Se o POS rejeitar o código, revise as causas mais comuns:

• O código expirou.
• O código já foi usado.
• O código foi digitado incorretamente.
• O gerente o gerou para outro propósito.
• O código foi gerado para outra sessão de caixa, outro caixa ou outro valor.

Gere um novo código em Códigos de autorização quando a operação ainda precisar de aprovação.