¶ Fechamento Automático de Caixa
Disponível a partir da versão 3.5.5.166
¶ Visão Geral
O Fechamento Automático de Caixa permite que o sistema feche (e opcionalmente reabra) caixas de forma programada, sem intervenção manual do operador. A funcionalidade utiliza um SQL Server Agent Job que executa periodicamente e verifica quais terminais devem ter seus caixas fechados com base em horários configurados.
¶ Benefícios
- Elimina esquecimento de fechamento de caixa no final do turno
- Permite operação 24h com troca automática de caixa (fechar e reabrir)
- Configuração individual por terminal (cada caixa pode ter seu horário)
- Auditoria completa com histórico de execuções
¶ Como Funciona
+-------------------------------------------------------------+
| Administrador configura horarios na tela do Softpark |
| (Menu > Administracao > Caixa > Fechamento Automatico) |
+-----------------------------+-------------------------------+
|
v
+-------------------------------------------------------------+
| Sistema cria/atualiza o Job no SQL Server Agent |
| (executa a cada 1 minuto) |
+-----------------------------+-------------------------------+
|
v
+-------------------------------------------------------------+
| Job verifica: "Algum terminal atingiu o horario?" |
| - Terminal habilitado? SIM |
| - Horario configurado <= hora atual? SIM |
| - Ja foi processado com sucesso hoje? NAO |
+-----------------------------+-------------------------------+
|
v
+-------------------------------------------------------------+
| Para cada terminal elegivel: |
| - Se tem caixa aberto > Fecha (e reabre se configurado) |
| - Se nao tem caixa aberto > Registra "sem acao" |
| - Se deu erro > Registra erro e continua nos demais |
+-------------------------------------------------------------+
¶ Tela de Configuração
¶ Acesso
Menu > Administração > Caixa > Fechamento Automático de Caixa
[!] Acesso restrito a administradores.
¶ Seções da Tela
¶ 1. Status do Ambiente
No topo da tela, uma caixa de texto exibe o status atual:
| Status | Significado |
|---|---|
| Pronto (verde) | SQL Server Agent rodando, permissões OK, Job íntegro |
| Com Pendências (laranja) | Algum problema detectado — detalhes na mensagem |
O sistema tenta corrigir problemas automaticamente (iniciar o Agent, adicionar permissões). Se não conseguir, exibe orientações.
¶ 2. Grid de Configuração de Terminais
| Coluna | Descrição |
|---|---|
| Terminal | Número do terminal (automático, não editável) |
| Tipo | SOFTPARK ou ATM (automático, não editável) |
| Horário | Horário de fechamento no formato HH:mm (ex: 23:00) |
| Ação | FECHAR = apenas fecha · FECHAR_REABRIR = fecha e abre novo caixa |
| Habilitado | Checkbox — ativa/desativa o fechamento para aquele terminal |
Regras:
- Terminais habilitados devem ter horário e ação preenchidos
- Terminais desabilitados são ignorados pelo Job
- O horário usa máscara automática (basta digitar 4 números:
2300>23:00)
¶ 3. Histórico de Execuções
Grid com o registro de todas as execuções do Job:
| Coluna | Descrição |
|---|---|
| Terminal | Número do terminal processado |
| Caixa | Número do caixa que foi fechado (ou "-" se sem ação) |
| Data/Hora | Quando a execução ocorreu |
| Ação | FECHAR, FECHAR_REABRIR ou SEM_ACAO |
| Resultado | SUCESSO ou ERRO |
| Erro | Mensagem de erro (se houver) |
Filtros disponíveis:
- Terminal (todos ou específico)
- Período (padrão: últimos 7 dias, máximo: 90 dias)
Botão "Excluir Antigos": Remove registros com mais de 90 dias (com confirmação).
¶ Ações Disponíveis
¶ Apenas Fechar (FECHAR)
O Job fecha o caixa no horário configurado. O terminal fica sem caixa aberto até que alguém abra manualmente.
Uso típico: Terminais que operam em horário comercial e não precisam de caixa durante a madrugada.
¶ Fechar e Reabrir (FECHAR_REABRIR)
O Job fecha o caixa e imediatamente abre um novo caixa para o mesmo terminal, preservando o tipo (ATM ou SOFTPARK).
Uso típico: Terminais ATM que operam 24h e precisam de um novo caixa diário para fins de fechamento contábil.
¶ Pré-requisitos
¶ SQL Server Agent
O SQL Server Agent deve estar em execução no servidor de banco de dados. O sistema tenta iniciá-lo automaticamente, mas pode falhar se:
- A edição do SQL Server é Express (não tem Agent)
- O usuário do Windows não tem permissão de administrador
- A conta de serviço do SQL Server não tem permissão para controlar serviços
Como verificar: No SQL Server Management Studio, o ícone "SQL Server Agent" deve estar com seta verde (rodando).
¶ Permissões no Banco
O usuário de conexão do Softpark precisa da role SQLAgentUserRole no banco msdb. O sistema tenta adicionar automaticamente, mas pode falhar se o usuário não for sysadmin.
Comando manual (se necessário):
USE msdb;
EXEC sp_addrolemember 'SQLAgentUserRole', 'nome_do_usuario';
¶ Comportamento do Job
¶ Frequência
O Job executa a cada 1 minuto. Em cada execução, verifica quais terminais atingiram o horário configurado.
¶ Idempotência
Se um terminal já foi processado com sucesso no dia corrente, ele não é processado novamente. Isso garante que o caixa é fechado apenas uma vez por dia.
¶ Resiliência a Falhas
Se o fechamento de um terminal falhar (ex: erro na procedure), o Job:
- Registra o erro no log
- Continua processando os demais terminais
- Na próxima execução (1 minuto depois), tenta novamente o terminal que falhou
¶ Terminal sem Caixa Aberto
Se o horário é atingido mas o terminal não tem caixa aberto, o Job registra "SEM_ACAO" com resultado "SUCESSO" e não tenta novamente no dia.
¶ Estrutura Técnica
¶ Tabelas
| Tabela | Função |
|---|---|
T_FECHAMENTO_CAIXA_JOB_CONFIG |
Configurações por terminal (horário, ação, habilitado) |
T_FECHAMENTO_CAIXA_JOB_LOG |
Histórico de execuções (auditoria) |
¶ Procedure
PROC_EXECUTA_FECHAMENTO_CAIXA_AUTOMATICO — Executada pelo Job, itera os terminais elegíveis e chama PROC_FECHA_CAIXA e opcionalmente PROC_INICIA_CAIXA.
¶ Job no SQL Server Agent
| Propriedade | Valor |
|---|---|
| Nome | SOFTPARK_FECHAMENTO_CAIXA_AUTOMATICO |
| Schedule | A cada 1 minuto, 24h |
| Step | Executa PROC_EXECUTA_FECHAMENTO_CAIXA_AUTOMATICO |
| Retry | Sem retry (o próprio schedule garante reexecução) |
¶ Módulo VB.NET
modFechamentoCaixaJob.vb — Gerencia o Job (criar, desativar, reativar), executa health check e operações de configuração/histórico.
¶ Troubleshooting
¶ "Com Pendências - SQL Server Agent não está em execução"
Causa: O serviço SQL Server Agent está parado.
Solução:
- Abra o SQL Server Configuration Manager
- Encontre "SQL Server Agent" > Clique direito > Iniciar
- Ou execute como administrador:
net start SQLSERVERAGENT
¶ "Permissões insuficientes no msdb"
Causa: O usuário de banco não tem a role necessária para gerenciar Jobs.
Solução: Execute no SSMS com um usuário sysadmin:
USE msdb;
EXEC sp_addrolemember 'SQLAgentUserRole', 'nome_do_usuario';
¶ "Integridade do Job divergente"
Causa: Alguém alterou o Job manualmente no SQL Server Agent.
Solução: Clique em "Salvar" na tela de configuração — o sistema recria o Job automaticamente.
¶ Caixa não foi fechado no horário
Verifique:
- O terminal está habilitado na configuração?
- O horário está correto?
- O terminal tinha caixa aberto no momento?
- Consulte o histórico para ver se houve erro
¶ FAQ
P: O que acontece se o servidor reiniciar?
R: O SQL Server Agent reinicia junto com o SQL Server (se configurado como automático). O Job continua executando normalmente.
P: Posso ter horários diferentes para cada terminal?
R: Sim, cada terminal tem sua própria configuração de horário e ação.
P: O que acontece se eu desabilitar todos os terminais?
R: O Job é desativado automaticamente no SQL Server Agent. Ao habilitar novamente, o Job é reativado.
P: O fechamento automático interfere com operações em andamento?
R: O fechamento usa a mesma PROC_FECHA_CAIXA do fechamento manual. Se houver pendências que impeçam o fechamento, a procedure retornará erro e o Job registrará no log.
P: Posso usar em SQL Server Express?
R: Não. O SQL Server Express não inclui o SQL Server Agent. É necessário SQL Server Standard, Developer ou Enterprise.
P: O histórico cresce indefinidamente?
R: Não. O botão "Excluir Antigos" permite limpar registros com mais de 90 dias. Recomenda-se fazer essa limpeza periodicamente.