Ir para o conteúdo principal

Manual de Suporte Interno — Novos Recursos (Tópicos 1 a 6)

Calunaty Manual de Suporte — Novidades Março 2026 Versão 1.0 · 23/03/2026 · Uso interno
Sumário

Manual de Suporte Interno — Novos Recursos (Tópicos 1 a 6)

Versão: 1.0  ·  Data: 23/03/2026  ·  Público-alvo: Equipe de suporte técnico (não-programadores)  ·  Classificação: Uso interno
  

Visão Geral das Novidades

Este manual documenta seis blocos de novos recursos implementados no SysLoja. Os recursos estão organizados por área funcional e incluem melhorias de segurança, controle de acesso, auditoria e integração.

#RecursoÁreaImpacto
1Bloqueio de vendas para inadimplentesVendas / GerentesControle financeiro
2ABloqueio de campos sensíveis no cadastroClientes / GerentesSegurança de dados
2BLog de auditoria de alteraçõesClientesRastreabilidade
2CTela de consulta do logClientesAuditoria
3A/3BAnexação de documentosClientesCompliance
3CValidação venda a prazo + RelatórioVendas / ClientesCompliance
4Saldo automático na abertura do caixaCaixaOperacional
5Controle de acesso ao ALT+RRelatórios / GerentesSegurança
6Consulta CPF na Receita FederalClientesProdutividade
Atenção — Instalações Fragoso

Vários recursos possuem comportamento diferenciado para instalações do grupo Fragoso. Onde aplicável, as diferenças estão destacadas em cada tópico.


  

Tópico 1 — Bloqueio de Vendas para Clientes Inadimplentes

O que mudou

Agora o sistema pode impedir a realização de vendas para clientes que possuem títulos vencidos além do prazo configurado. Quando o operador tenta vender para um cliente inadimplente, o sistema exibe uma mensagem de bloqueio. Para prosseguir, é necessário solicitar a senha de um gerente que tenha permissão específica para liberar essa situação.

A liberação fica registrada em log (tabela Autoriza) com a data, hora e o gerente que autorizou.

Configuração

Passo 1 — Verificar a permissão do gerente:

  1. Acessar Cadastro de Gerentes
  2. Selecionar o gerente desejado
  3. Pressionar F7 (tela de permissões)
  4. Pressionar F4 (permissões adicionais)
  5. Localizar o campo “Liberar venda p/ cliente inadimplente...?”
  6. Definir como S (sim, pode liberar) ou N (não pode liberar)

Passo 2 — Verificar os dias de tolerância:

O sistema utiliza o prazo de dias configurado no parâmetro de inadimplência já existente. Certifique-se de que o prazo está adequado à política do cliente.

Parâmetros e Permissões

ItemTabelaCampoTipoValoresPadrão FragosoPadrão demais
Permissão gerentegerente.dbfLibInadimC(1)S = pode liberar, N = não podeNS
Registro de autorizaçãoAutoriza.dbf(vários)Data, hora, gerente

Cenários de Suporte

Cenário 1: “O operador não consegue vender para um cliente”
  1. Verificar se o cliente possui títulos vencidos (consultar contas a receber)
  2. Se sim, o bloqueio está funcionando corretamente
  3. Orientar o operador a chamar o gerente para liberar com senha
  4. Se o gerente também não consegue liberar, verificar se o campo LibInadim está como S no cadastro desse gerente
Cenário 2: “O gerente digitou a senha mas o sistema não liberou”
  1. Acessar o cadastro do gerente em questão
  2. Ir em F7 > F4
  3. Confirmar que o campo “Liberar venda p/ cliente inadimplente” está como S
  4. Se estiver como N, alterar para S e tentar novamente
Cenário 3: “Quero saber quem liberou uma venda para inadimplente”
  1. Consultar a tabela Autoriza
  2. Procurar pelo código do cliente e pela data em questão
  3. O registro mostrará qual gerente autorizou, com data e hora
Cenário 4: “Em instalação não-Fragoso, o bloqueio não está funcionando”
  1. Verificar se o prazo de dias de inadimplência está configurado
  2. Em instalações não-Fragoso, o padrão é S (liberado) — ou seja, todos os gerentes podem liberar por padrão
  3. Se deseja bloquear, alterar LibInadim para N nos gerentes que não devem ter essa permissão

Perguntas Frequentes

O bloqueio vale para todos os tipos de venda?
Sim, para qualquer venda vinculada a um cliente identificado que esteja inadimplente.
Se o cliente pagar o débito, a venda é liberada automaticamente?
Sim. O bloqueio se baseia na existência de títulos vencidos. Ao quitar, o cliente deixa de ser inadimplente e a venda é permitida normalmente.
A autorização vale para todas as vendas do dia?
Não. Cada venda bloqueada requer uma nova autorização.

  

Tópico 2A — Bloqueio de Campos Sensíveis no Cadastro de Clientes

O que mudou

Em instalações Fragoso, ao abrir o cadastro de um cliente já existente, os seguintes campos ficam bloqueados (somente leitura):

  • Nome
  • CPF
  • Data de Nascimento
  • Filiação

Os campos Telefone e Endereço continuam editáveis normalmente.

Para desbloquear os campos sensíveis, o operador precisa pressionar F3 dentro do formulário do cliente e informar a senha de um gerente com permissão.

Importante

Ao cadastrar um cliente novo (inclusão), todos os campos ficam editáveis normalmente, sem necessidade de desbloqueio.

Configuração

Passo 1 — Verificar a permissão do gerente:

  1. Acessar Cadastro de Gerentes
  2. Selecionar o gerente desejado
  3. Pressionar F7 (tela de permissões)
  4. Pressionar F4 (permissões adicionais)
  5. Localizar o campo “Editar dados sensíveis do cliente...?”
  6. Definir como S (pode desbloquear) ou N (não pode desbloquear)

Parâmetros e Permissões

ItemTabelaCampoTipoValoresPadrão FragosoPadrão demais
Permissão gerentegerente.dbfEditSensiC(1)S = pode desbloquear, N = não podeNS

Cenários de Suporte

Cenário 1: “O operador não consegue alterar o nome do cliente”
  1. Confirmar que é uma instalação Fragoso
  2. Explicar que os campos sensíveis agora são bloqueados por padrão
  3. Orientar a pressionar F3 no formulário do cliente
  4. Informar a senha de um gerente com permissão EditSensi = S
Cenário 2: “Pressionei F3 mas não desbloqueou”
  1. Verificar se o gerente cuja senha foi informada tem EditSensi = S
  2. Se o campo estiver como N, ajustar no cadastro do gerente
Cenário 3: “Estou cadastrando um cliente novo e os campos estão bloqueados”
  1. Em modo de inclusão (novo cliente), os campos não devem estar bloqueados
  2. Verificar se o operador está realmente em modo de inclusão e não editando um registro existente
  3. Se persistir, pode ser necessário verificar a versão do sistema
Cenário 4: “Instalação não é Fragoso, mas os campos estão bloqueados”
  1. Em instalações fora do grupo Fragoso, o padrão é S (desbloqueado)
  2. Verificar se alguém alterou manualmente o parâmetro de controle
  3. Todos os gerentes devem ter EditSensi = S por padrão nessas instalações

Perguntas Frequentes

Quais campos exatamente ficam bloqueados?
Nome, CPF, Data de Nascimento e Filiação. Telefone e Endereço continuam livres.
Posso bloquear campos em instalações que não são Fragoso?
O comportamento de bloqueio automático é específico para instalações Fragoso. Em outras instalações, os campos ficam editáveis por padrão.
O desbloqueio via F3 é permanente?
Não. O desbloqueio vale apenas para a edição atual. Ao sair e reabrir o cadastro do cliente, os campos voltam a ficar bloqueados.

  

Tópico 2B — Log de Auditoria de Alterações no Cadastro de Clientes

O que mudou

Em instalações Fragoso, toda alteração feita em determinados campos do cadastro de clientes passa a ser registrada automaticamente em um log de auditoria. O sistema grava o valor anterior, o valor novo, quem alterou, quando e em qual terminal.

O log é gerado automaticamente — o operador não precisa fazer nada. Se o operador abrir o cadastro e não alterar nenhum campo, nenhum registro de log é gerado.

Configuração

Automático

Este recurso é ativado automaticamente em instalações Fragoso. Não há configuração adicional necessária.

Parâmetros e Permissões

ItemTabelaCampoTipoDescrição
Código do clienteLogAltCli.dbfCodCliCIdentifica o cliente alterado
Campo alteradoLogAltCli.dbfCampoCNome do campo que foi modificado
Valor anteriorLogAltCli.dbfValorAntCConteúdo do campo antes da alteração
Valor novoLogAltCli.dbfValorNovCConteúdo do campo após a alteração
DataLogAltCli.dbfDataDData da alteração
HoraLogAltCli.dbfHoraCHora da alteração
UsuárioLogAltCli.dbfUsuarioCLogin do operador que fez a alteração
TerminalLogAltCli.dbfTerminalCNome do computador

Campos monitorados pelo log:

  • Telefone
  • Bairro
  • Endereço
  • Cidade
  • CEP
  • UF
  • (e demais campos de endereço/contato)
Observação

O campo Observação (campo livre) não é monitorado pelo log.

Cenários de Suporte

Cenário 1: “Quero saber quem alterou o telefone de um cliente”
  1. Acessar a tela de consulta do log (ver Tópico 2C — ALT+L)
  2. Filtrar pelo código do cliente
  3. Procurar registros onde o campo = “Telefone”
  4. O registro mostrará o valor anterior, o valor novo, quem alterou e quando
Cenário 2: “O log não está registrando alterações”
  1. Confirmar que é uma instalação Fragoso
  2. Verificar se a tabela LogAltCli.dbf existe na pasta de dados
  3. Se não existir, a tabela será criada automaticamente na próxima atualização ou pode ser criada manualmente pela rotina de criação de arquivos
Cenário 3: “O log registrou uma alteração que o operador diz não ter feito”
  1. Verificar o campo “Terminal” no registro do log para confirmar de qual máquina partiu a alteração
  2. Verificar o campo “Usuario” para confirmar o login
  3. Cruzar com o horário de trabalho do operador

Perguntas Frequentes

O log funciona em instalações que não são Fragoso?
Não. O log de auditoria é exclusivo para instalações do grupo Fragoso.
O log registra alterações feitas pelo suporte remoto?
Sim. Qualquer alteração feita por qualquer meio é registrada, incluindo acesso remoto. O campo Terminal identifica a máquina de origem.
O log pode ser apagado pelo operador?
Não. O log é somente leitura para os operadores. A exclusão só pode ser feita com acesso direto ao banco de dados.
Se eu alterar um campo e depois voltar ao valor original, gera dois registros?
Sim. Cada alteração individual gera um registro separado, mesmo que o valor final seja igual ao original.

  

Tópico 2C — Tela de Consulta do Log de Auditoria

O que mudou

Em instalações Fragoso, foi adicionado o atalho ALT+L na tela de browse (listagem) de clientes. Ao pressionar ALT+L, o sistema solicita a senha do gerente e abre uma tela de consulta do log de alterações.

A barra inferior da tela de clientes agora exibe a indicação “[ALT+L] Log de Alterações”.

Configuração

Automático

Não há configuração adicional. O recurso está disponível automaticamente em instalações Fragoso.

Requisitos:

  • Instalação Fragoso
  • Senha de gerente válida para acessar

Parâmetros e Permissões

ItemDetalhe
AtalhoALT+L na tela de browse de clientes
AcessoRequer senha de gerente
ModoSomente leitura (não permite inserir nem excluir)

Colunas exibidas na consulta:

ColunaDescrição
DataData em que a alteração foi feita
HoraHorário da alteração
UsuarioLogin do operador responsável
CampoNome do campo que foi alterado
Valor AnteriorConteúdo do campo antes da alteração
Valor NovoConteúdo do campo após a alteração

Cenários de Suporte

Cenário 1: “Não aparece a opção ALT+L na tela de clientes”
  1. Confirmar que é uma instalação Fragoso
  2. Verificar se a versão do sistema está atualizada
  3. O texto “[ALT+L] Log de Alterações” deve aparecer na barra inferior da tela de clientes
Cenário 2: “Pressionei ALT+L mas não aconteceu nada”
  1. Confirmar que o operador está na tela de browse (listagem) de clientes, não dentro do formulário de edição
  2. Verificar se a tecla ALT está funcionando corretamente no teclado
  3. Se o sistema pediu senha e o operador cancelou, é comportamento normal
Cenário 3: “O log aparece vazio”
  1. Se a tabela LogAltCli foi criada recentemente, é normal que esteja vazia
  2. O log só contém registros a partir do momento em que o recurso foi ativado
  3. Alterações feitas antes da implantação não são retroativas

Perguntas Frequentes

Posso imprimir o log?
A tela atual é somente de consulta visual. Para obter os dados em relatório, consulte o suporte de desenvolvimento.
Posso filtrar por cliente específico?
A consulta mostra os registros do log. Utilize a navegação da tela para localizar o cliente desejado.
Posso excluir registros do log pela tela?
Não. A tela é somente leitura. Não é possível inserir, alterar ou excluir registros por meio dessa consulta.

  

Tópico 3A/3B — Anexação de Documentos no Cadastro de Clientes

O que mudou

Agora é possível anexar documentos digitalizados (fotos, PDFs, etc.) diretamente no cadastro de cada cliente. No formulário do cliente, aparece um indicador visual:

  • DOC:--- em vermelho = cliente SEM documento anexado
  • DOC:Sim em verde = cliente COM documento anexado

O atalho ALT+D dentro do formulário do cliente abre as opções de gerenciamento do documento.

Configuração

Passo 1 — Verificar a permissão do gerente (para substituição de documentos):

  1. Acessar Cadastro de Gerentes
  2. Selecionar o gerente desejado
  3. Pressionar F7 > F4
  4. Localizar o campo relacionado a “Alterar documento do cliente”
  5. Definir como S (pode substituir) ou N (não pode substituir)

Passo 2 — Verificar a pasta de armazenamento:

Os documentos são armazenados em: Dados\Docs\Clientes\

Verificar
  • A pasta existe
  • O sistema tem permissão de leitura e escrita na pasta
  • Há espaço em disco suficiente

Parâmetros e Permissões

ItemTabelaCampoTipoDescriçãoPadrão
Nome do arquivo anexadoClientes.dbfDOCANEXOC(50)Nome do arquivo do documentovazio
Data da anexaçãoClientes.dbfDTDOCANEXD(8)Data em que o documento foi anexadovazio
Usuário da anexaçãoClientes.dbfUSRDOCANXC(20)Login de quem anexouvazio
Permissão substituirgerente.dbfAltDocCliC(1)S = pode substituir, N = não podeS

Formatos de arquivo aceitos: JPG, PDF, PNG, BMP e outros formatos de imagem comuns.

Regra de nomenclatura do arquivo: O sistema salva o arquivo usando o código do cliente como nome. Exemplo: se o cliente tem código “001234” e o documento é um JPG, o arquivo será salvo como 001234.jpg na pasta Dados\Docs\Clientes\.

Como o operador utiliza

Para anexar um documento (cliente sem documento):

  1. Abrir o cadastro do cliente
  2. Pressionar ALT+D
  3. O menu exibe: [Anexar Documento] / [Cancelar]
  4. Selecionar “Anexar Documento”
  5. Escolher o arquivo na janela de seleção
  6. O indicador muda de DOC:--- para DOC:Sim

Para visualizar ou substituir (cliente com documento):

  1. Abrir o cadastro do cliente
  2. Pressionar ALT+D
  3. O menu exibe: [Visualizar] / [Substituir] / [Cancelar]
  4. “Visualizar” abre o documento no programa padrão do Windows
  5. “Substituir” requer senha de gerente com permissão AltDocCli = S

Cenários de Suporte

Cenário 1: “O indicador mostra DOC:--- mas o cliente tem documento”
  1. Verificar se o campo DOCANEXO está preenchido no registro do cliente
  2. Verificar se o arquivo existe fisicamente na pasta Dados\Docs\Clientes\
  3. Se o arquivo existe mas o campo está vazio, o vínculo foi perdido — anexar novamente
Cenário 2: “Não consigo anexar o documento — erro ao salvar”
  1. Verificar se a pasta Dados\Docs\Clientes\ existe
  2. Verificar permissões de escrita na pasta
  3. Verificar espaço em disco
  4. Testar com um arquivo menor (pode ser limite de tamanho)
Cenário 3: “Não consigo substituir o documento”
  1. A substituição requer senha de gerente
  2. Verificar se o gerente tem AltDocCli = S
  3. Se o campo estiver como N, alterar no cadastro do gerente
Cenário 4: “O documento abre no programa errado”
  1. O sistema usa o programa padrão do Windows para abrir o arquivo
  2. Configurar a associação de arquivos no Windows (ex: PDFs abrindo no Adobe Reader)
  3. Isso não é configuração do SysLoja, é configuração do sistema operacional
Cenário 5: “Preciso anexar mais de um documento por cliente”
  1. O sistema permite apenas um documento por cliente
  2. Se for necessário anexar múltiplos documentos, orientar o cliente a digitalizar tudo em um único PDF

Perguntas Frequentes

Qual o tamanho máximo do arquivo?
Não há limite fixo definido pelo sistema, mas recomenda-se manter os arquivos com tamanho razoável (até 5 MB) para evitar lentidão.
Se eu excluir o cliente, o documento é excluído?
O arquivo físico permanece na pasta. A exclusão do arquivo deve ser feita manualmente, se necessário.
Os documentos são sincronizados entre filiais?
Depende da configuração de sincronização da instalação. Consulte a equipe de desenvolvimento para verificar se a pasta de documentos está incluída no processo de sincronização.

  

Tópico 3C — Validação Venda a Prazo + Relatório Clientes sem Documento

O que mudou

Dois novos recursos complementares à anexação de documentos:

  1. Validação na venda a prazo: Quando ativado, o sistema bloqueia vendas a prazo (crediário/fiado) para clientes que não possuem documento anexado.
  2. Relatório de clientes sem documento: Novo relatório acessível pela tela de clientes que lista todos os clientes que ainda não possuem documento anexado.

Configuração

Passo 1 — Ativar a obrigatoriedade de documento para venda a prazo:

  1. Acessar a Tela de Parâmetros do sistema
  2. Localizar o campo “Obrigar documento anexado p/ venda a prazo?”
  3. Definir como S para ativar o bloqueio ou N para desativar

Passo 2 — O relatório está disponível automaticamente na tela de clientes.

Parâmetros e Permissões

ItemTabelaCampoTipoDescriçãoPadrão
Obrigar documentoParamDiv.dbfObrigDocVPC(1)S = obriga documento para venda a prazoN

Como funciona a validação

Quando ObrigDocVP = S:

  1. O operador inicia uma venda a prazo
  2. O sistema verifica se o cliente possui documento anexado (campo DOCANEXO preenchido)
  3. Se não possui, exibe a mensagem: “Cliente sem documento anexado!”
  4. A venda é bloqueada até que um documento seja anexado ao cadastro do cliente

Como acessar o relatório

  1. Abrir a tela de browse de clientes
  2. Pressionar TAB
  3. Selecionar “Clientes sem Documento”
  4. Informar os filtros:
    • Bairro (deixar em branco para todos)
    • Situação (99 = todos)

Colunas do relatório:

ColunaDescrição
CódigoCódigo do cliente
NomeNome do cliente
TelefoneTelefone de contato
BairroBairro do cliente
CadastroData de cadastro

Ao final do relatório são exibidos os totalizadores:

  • Total sem documento: X (quantidade de clientes sem documento)
  • Total analisados: Y (quantidade total de clientes analisados com base nos filtros)

Cenários de Suporte

Cenário 1: “A venda a prazo está sendo bloqueada e o cliente não sabe por quê”
  1. Verificar se o parâmetro ObrigDocVP está como S
  2. Explicar que o sistema agora exige documento anexado para vendas a prazo
  3. Orientar a anexar o documento do cliente (ALT+D no cadastro)
  4. Após anexar, a venda a prazo será permitida
Cenário 2: “Quero desativar o bloqueio temporariamente”
  1. Acessar a Tela de Parâmetros
  2. Alterar “Obrigar documento anexado p/ venda a prazo?” para N
  3. O bloqueio é desativado imediatamente para todas as estações
Cenário 3: “O relatório não aparece na lista”
  1. Verificar se a versão do sistema está atualizada
  2. O relatório está no menu de relatórios acessível via TAB na tela de clientes
Cenário 4: “A venda à vista funciona, mas a prazo não”
  1. Comportamento correto — o bloqueio afeta apenas vendas a prazo
  2. Vendas à vista, cartão, PIX, etc. não são afetadas pelo parâmetro ObrigDocVP

Perguntas Frequentes

Quais formas de pagamento são afetadas pelo bloqueio?
Apenas vendas a prazo (crediário/fiado). Vendas à vista, cartão, PIX e demais formas não são bloqueadas.
Posso usar o relatório para fazer uma campanha de regularização?
Sim. O relatório “Clientes sem Documento” é ideal para identificar clientes que precisam trazer documentação. Filtre por bairro para organizar a abordagem.
O bloqueio se aplica a todos os clientes ou posso isentar alguns?
O bloqueio é global. Se ObrigDocVP = S, todos os clientes sem documento são bloqueados para venda a prazo, sem exceção individual.

  

Tópico 4 — Abertura do Caixa: Saldo Automático

O que mudou

Ao abrir o caixa, o sistema pode agora trazer automaticamente o saldo de fechamento do dia anterior e bloquear a edição desse valor. Isso evita que o operador altere o saldo inicial manualmente.

Quando ativado, o campo de saldo inicial aparece em verde com o texto “(Saldo automático)”, indicando que o valor foi preenchido automaticamente e não pode ser alterado.

Se o saldo do dia anterior for R$ 0,00, o sistema permite a edição normalmente (campo desbloqueado), pois entende que pode ser um primeiro dia de operação ou situação atípica.

Configuração

Este recurso depende de dois parâmetros trabalhando juntos:

Passo 1 — Ativar o parâmetro de trazer saldo anterior (se não estiver ativo):

O parâmetro TrazSldCxA já existia no sistema. Ele faz com que o saldo de fechamento do dia anterior seja sugerido como saldo inicial. Deve estar como S.

Passo 2 — Ativar o bloqueio de alteração:

  1. Acessar a Tela de Parâmetros do sistema
  2. Localizar o campo “Bloquear alteração do saldo inicial caixa?”
  3. Definir como S para bloquear a edição

Parâmetros e Permissões

ItemTabelaCampoTipoDescriçãoPadrão
Trazer saldo anteriorParamDiv.dbfTrazSldCxAC(1)S = traz saldo do dia anterior(existente)
Bloquear alteraçãoParamDiv.dbfBlkSldIniCxC(1)S = bloqueia edição do saldoN

Regra de funcionamento combinada:

TrazSldCxABlkSldIniCxSaldo anteriorComportamento
N(qualquer)(qualquer)Campo livre para digitação (comportamento antigo)
SN(qualquer)Saldo sugerido mas editável (comportamento antigo)
SS> R$ 0,00Saldo preenchido e bloqueado (verde, “Saldo automático”)
SS= R$ 0,00Campo editável (fallback — não bloqueia valor zero)

Cenários de Suporte

Cenário 1: “O operador não consegue alterar o saldo inicial”
  1. Verificar se BlkSldIniCx = S
  2. Se sim, é comportamento correto — o campo está bloqueado intencionalmente
  3. Se o cliente deseja permitir alteração, mudar BlkSldIniCx para N
Cenário 2: “O saldo está vindo errado”
  1. Verificar o saldo de fechamento do caixa do dia anterior
  2. O valor exibido na abertura deve ser exatamente igual ao fechamento anterior
  3. Se divergir, verificar se houve fechamento correto do caixa no dia anterior
Cenário 3: “O campo está livre para edição mesmo com bloqueio ativado”
  1. Verificar se TrazSldCxA também está como S (ambos precisam estar ativos)
  2. Verificar se o saldo do dia anterior é R$ 0,00 — nesse caso, o campo fica editável intencionalmente
  3. Um saldo zero não é bloqueado para permitir correções em situações atípicas
Cenário 4: “Não aparece o texto ‘(Saldo automático)’ em verde”
  1. Confirmar que ambos os parâmetros estão como S
  2. Confirmar que o saldo do dia anterior é maior que zero
  3. Se tudo estiver correto, verificar a versão do sistema

Perguntas Frequentes

O bloqueio funciona por operador ou por caixa?
O bloqueio é global — se ativado, afeta todos os caixas e todos os operadores.
Se o caixa não foi fechado no dia anterior, o que acontece?
O sistema buscará o último saldo de fechamento disponível. Se nunca houve fechamento, o valor será zero e o campo ficará editável.
Posso ativar o bloqueio sem trazer o saldo anterior?
Não faz sentido prático. Se TrazSldCxA = N, o campo será livre para digitação independentemente do valor de BlkSldIniCx. Os dois parâmetros devem estar como S para o bloqueio funcionar.

  

Tópico 5 — ALT+R: Controle de Acesso

O que mudou

O atalho ALT+R (acesso rápido a relatórios/funções) agora pode ser protegido por senha de gerente, com controle individual de quem pode acessar.

Quando o parâmetro SenhaRel está ativo (S) na tabela Config, ao pressionar ALT+R o sistema solicita a senha de um gerente. Somente gerentes com a permissão AcessoALTR = S terão acesso autorizado.

Se SenhaRel estiver desativado (N), o ALT+R funciona livremente como antes, sem solicitar senha.

Configuração

Passo 1 — Verificar o parâmetro geral de senha para relatórios:

O parâmetro SenhaRel na tabela Config deve estar como S para que o controle de acesso ao ALT+R seja ativado.

Passo 2 — Configurar a permissão por gerente:

  1. Acessar Cadastro de Gerentes
  2. Selecionar o gerente desejado
  3. Pressionar F7 > F4 (permissões adicionais)
  4. Localizar o campo de acesso ao ALT+R
  5. Definir como S (pode acessar) ou N (não pode acessar)

Parâmetros e Permissões

ItemTabelaCampoTipoDescriçãoPadrão
Exigir senha p/ relatóriosConfig.dbfSenhaRelC(1)S = exige senha, N = livre(existente)
Permissão gerente ALT+Rgerente.dbfAcessoALTRC(1)S = pode acessar, N = não pode(verificar)

Regra de funcionamento:

SenhaRelAcessoALTRComportamento
N(qualquer)ALT+R funciona livremente, sem senha
SSALT+R pede senha, gerente é aceito
SNALT+R pede senha, gerente é recusado

Cenários de Suporte

Cenário 1: “O operador não consegue acessar o ALT+R”
  1. Verificar se SenhaRel = S na tabela Config
  2. Se sim, é necessário senha de gerente com AcessoALTR = S
  3. Verificar a permissão do gerente cuja senha está sendo informada
Cenário 2: “O gerente digita a senha mas é recusado no ALT+R”
  1. Acessar o cadastro do gerente em questão
  2. Ir em F7 > F4
  3. Verificar se AcessoALTR está como S
  4. Se estiver como N, alterar para S
Cenário 3: “Quero liberar o ALT+R para todos”
  1. Opção A: Alterar SenhaRel para N na Config — desativa a senha para todos
  2. Opção B: Manter SenhaRel = S e colocar AcessoALTR = S em todos os gerentes
Cenário 4: “ALT+R não pede senha (e deveria pedir)”
  1. Verificar se SenhaRel = S na tabela Config
  2. Se estiver como N, o sistema não pede senha (comportamento esperado)
  3. Alterar para S se desejar ativar o controle

Perguntas Frequentes

O controle de ALT+R afeta outros atalhos?
Não. O controle é exclusivo para o ALT+R. Outros atalhos de relatórios não são afetados por esta permissão específica.
Se eu desativar SenhaRel, o AcessoALTR perde o efeito?
Sim. O campo AcessoALTR só é verificado quando SenhaRel = S. Com SenhaRel = N, o ALT+R é livre para todos.

  

Tópico 6 — Integração CPF com API da Receita Federal

O que mudou

Ao cadastrar um novo cliente do tipo Pessoa Física, após digitar o CPF, o sistema oferece a opção de consultar os dados automaticamente na Receita Federal via API.

Se o operador aceitar, o sistema preenche automaticamente:

  • Nome do cliente
  • Data de Nascimento

Configuração

Automático

Não há configuração adicional necessária. O recurso funciona automaticamente ao cadastrar novos clientes.

Requisitos técnicos:

  • Conexão com a internet ativa na estação
  • API de consulta de CPF disponível e acessível

Como funciona

  1. O operador inicia o cadastro de um novo cliente (modo inclusão)
  2. Seleciona tipo Pessoa Física
  3. Digita o CPF do cliente
  4. Ao sair do campo CPF, o sistema pergunta: “Consultar dados do CPF na Receita Federal?”
  5. Se o operador responder Sim:
    • O sistema consulta a API
    • Preenche automaticamente o Nome e a Data de Nascimento
  6. Se o operador responder Não:
    • O cadastro continua normalmente, com preenchimento manual
Regras importantes
  • Funciona apenas para novos clientes (inclusão) — não se aplica a clientes já existentes
  • Se o campo Nome já estiver preenchido, o sistema não sobrescreve o valor existente
  • Erros na consulta (API indisponível, CPF inválido, etc.) exibem mensagens apropriadas e o cadastro continua normalmente

Cenários de Suporte

Cenário 1: “A consulta do CPF não aparece ao cadastrar”
  1. Verificar se é um cliente novo (modo inclusão). A consulta não funciona em clientes existentes
  2. Verificar se o tipo é Pessoa Física. Pessoa Jurídica não utiliza este recurso
  3. Verificar se o CPF foi digitado corretamente
Cenário 2: “A consulta retorna erro”
  1. Verificar a conexão com a internet da estação
  2. A API da Receita Federal pode estar temporariamente indisponível — tentar novamente em alguns minutos
  3. Verificar se o CPF informado é válido
  4. Se o erro persistir, o operador pode preencher os dados manualmente sem prejuízo
Cenário 3: “O nome veio errado ou incompleto”
  1. A informação vem diretamente da Receita Federal — o sistema apenas repassa
  2. O operador pode corrigir o nome manualmente após o preenchimento automático
  3. Se o nome vier com acentuação diferente, ajustar manualmente
Cenário 4: “Quero consultar o CPF de um cliente já existente”
  1. O recurso funciona apenas para novos cadastros (inclusão)
  2. Para clientes existentes, os dados devem ser verificados e atualizados manualmente
  3. Esta é uma limitação intencional para preservar dados já validados
Cenário 5: “O sistema preencheu o nome mas não a data de nascimento”
  1. A API pode não ter retornado a data de nascimento para aquele CPF
  2. O operador deve preencher manualmente a data de nascimento

Perguntas Frequentes

A consulta tem custo?
Consulte a equipe de desenvolvimento sobre os termos de uso da API utilizada.
O CPF consultado fica registrado em algum log?
O registro fica apenas no cadastro do cliente, com os dados preenchidos.
Funciona para CNPJ também?
Não. Este recurso é exclusivo para CPF (Pessoa Física).
Se a internet cair durante a consulta, perco os dados digitados?
Não. O cadastro permanece aberto com os dados já digitados. Apenas a consulta à API falha, e o operador pode continuar preenchendo manualmente.

  

Tabela Resumo de Parâmetros e Permissões

Permissões de Gerente (gerente.dbf)

CampoTipoDescriçãoPadrão FragosoPadrão demaisAcesso
LibInadimC(1)Liberar venda p/ cliente inadimplenteNSF7 > F4
EditSensiC(1)Editar dados sensíveis do clienteNSF7 > F4
AltDocCliC(1)Substituir documento do clienteSSF7 > F4
AcessoALTRC(1)Acessar ALT+R (quando SenhaRel=S)(verificar)(verificar)F7 > F4

Parâmetros do Sistema (ParamDiv.dbf)

CampoTipoDescriçãoPadrãoTela de Parâmetros
ObrigDocVPC(1)Obrigar documento p/ venda a prazoNSim
BlkSldIniCxC(1)Bloquear alteração saldo inicial caixaNSim

Parâmetro Existente Relacionado (ParamDiv.dbf)

CampoTipoDescriçãoObservação
TrazSldCxAC(1)Trazer saldo do caixa anteriorPré-requisito para BlkSldIniCx

Parâmetro Existente Relacionado (Config.dbf)

CampoTipoDescriçãoObservação
SenhaRelC(1)Exigir senha para relatóriosPré-requisito para AcessoALTR

Campos Novos em Tabelas Existentes (Clientes.dbf)

CampoTipoDescrição
DOCANEXOC(50)Nome do arquivo do documento anexado
DTDOCANEXD(8)Data da anexação do documento
USRDOCANXC(20)Usuário que anexou o documento

Tabela Nova (LogAltCli.dbf) — Somente Fragoso

CampoTipoDescrição
CodCliCCódigo do cliente
CampoCNome do campo alterado
ValorAntCValor anterior
ValorNovCValor novo
DataDData da alteração
HoraCHora da alteração
UsuarioCLogin do operador
TerminalCNome do computador

  

Checklist de Implantação

Use este checklist ao implantar os novos recursos em um cliente:

Pré-requisitos

  •  Versão do sistema atualizada com os novos recursos
  •  Backup realizado antes da atualização
  •  Verificar se é instalação Fragoso ou não (afeta comportamentos padrão)

Tópico 1 — Bloqueio Inadimplentes

  •  Verificar se o campo LibInadim foi criado na tabela gerente.dbf
  •  Definir o valor de LibInadim para cada gerente conforme política do cliente
  •  Verificar prazo de dias de inadimplência configurado
  •  Testar: fazer venda para cliente com título vencido e confirmar bloqueio
  •  Testar: liberar com senha de gerente autorizado

Tópico 2A — Campos Sensíveis (Fragoso)

  •  Verificar se o campo EditSensi foi criado na tabela gerente.dbf
  •  Definir o valor de EditSensi para cada gerente
  •  Testar: abrir cliente existente e verificar campos bloqueados
  •  Testar: desbloquear com F3 + senha de gerente autorizado
  •  Testar: novo cliente — todos os campos devem estar editáveis

Tópico 2B/2C — Log de Auditoria (Fragoso)

  •  Verificar se a tabela LogAltCli.dbf foi criada na pasta de dados
  •  Testar: alterar um campo monitorado e verificar se o log foi gerado
  •  Testar: acessar ALT+L na tela de clientes e verificar o registro

Tópico 3A/3B — Anexação de Documentos

  •  Verificar se os campos DOCANEXO, DTDOCANEX, USRDOCANX existem em Clientes.dbf
  •  Verificar se o campo AltDocCli foi criado na tabela gerente.dbf
  •  Criar a pasta Dados\Docs\Clientes\ se não existir
  •  Verificar permissões de leitura/escrita na pasta
  •  Testar: anexar um documento (ALT+D)
  •  Testar: visualizar o documento anexado
  •  Testar: substituir o documento com senha de gerente autorizado
  •  Verificar indicador visual (DOC:--- vermelho / DOC:Sim verde)

Tópico 3C — Validação Venda a Prazo

  •  Verificar se o campo ObrigDocVP foi criado em ParamDiv.dbf
  •  Definir o valor conforme política do cliente (S ou N)
  •  Se S: testar venda a prazo para cliente sem documento (deve bloquear)
  •  Se S: testar venda a prazo para cliente com documento (deve permitir)
  •  Testar relatório “Clientes sem Documento” via TAB na tela de clientes

Tópico 4 — Saldo Automático

  •  Verificar se o campo BlkSldIniCx foi criado em ParamDiv.dbf
  •  Verificar se TrazSldCxA = S (pré-requisito)
  •  Se desejado, ativar BlkSldIniCx = S
  •  Testar: abrir caixa e verificar se o saldo veio bloqueado em verde
  •  Testar: fechar e reabrir com saldo zero — campo deve ficar editável

Tópico 5 — ALT+R Controle de Acesso

  •  Verificar se o campo AcessoALTR foi criado na tabela gerente.dbf
  •  Definir o valor de AcessoALTR para cada gerente
  •  Verificar se SenhaRel está configurado conforme desejado
  •  Se SenhaRel = S: testar ALT+R com gerente autorizado e não autorizado
  •  Se SenhaRel = N: confirmar que ALT+R funciona livremente

Tópico 6 — Consulta CPF

  •  Verificar conexão com a internet na(s) estação(ões)
  •  Testar: cadastrar novo cliente PF e aceitar consulta do CPF
  •  Verificar se Nome e Data de Nascimento foram preenchidos
  •  Testar: cadastrar novo cliente e recusar consulta — deve continuar normalmente
  •  Testar: simular erro de internet — deve exibir mensagem e continuar

Pós-implantação

  •  Treinar operadores sobre os novos recursos
  •  Treinar gerentes sobre as novas permissões
  •  Documentar quais gerentes têm quais permissões
  •  Informar ao cliente sobre os atalhos novos (ALT+D, ALT+L, F3)

📞 Canais de Suporte

📱 WhatsApp: (67) 3481-3361   ·   📧 suporte@calunaty.com.br   ·   ☎️ Telefone: (67) 3481-3361