Fecha o caixa do PDV
POST/store-front/cashier/:idbankaccount/close
Fecha a sessão atual do caixa, registrando a data e a hora do fechamento.
Validações
- Caixa precisa estar aberto — se não, retorna
Caixa não está aberto e precisa abrir antes de fechar. - Senha do operador autenticado, conferida contra a senha cadastrada do usuário —
Senha incorretaquando não confere. - O operador precisa estar ativo e vinculado à empresa (
Usuário não localizadoquando não confere).
Efeitos
- Se
FinalBalancedifere em mais de R$ 0,01 do saldo apurado da conta, gera um lançamento no extrato bancário com a descrição "Ajuste fechamento de caixa" — entrada quando o operador contou a mais, saída quando contou a menos. É assim que fica registrada a divergência apurada na conferência física ("contei R$ 850 mas o sistema dizia R$ 870"). - Grava
Commentsno histórico da sessão de caixa quando preenchido.
Na tela do PDV o encerramento fica bloqueado enquanto houver pedido em montagem ou transação de cartão em aberto, e o campo de observações passa a ser exigido quando há divergência de saldo — a API em si não impõe nenhuma das duas regras.
Request
Responses
- 200
- 400
- 500
Caixa fechado. Resposta: string Sucesso.
Erros (prefixo [BadRequest]):
Caixa não existeCaixa não está aberto e precisa abrir antes de fecharUsuário não localizadoUsuário não tem senha cadastradaSenha incorreta
Erro interno (prefixo Error:).