Manual de Suporte Interno — Novos Recursos (Tópicos 1 a 6)
Manual_Usuario_Novidades_2026.html
Manual de Suporte — Novidades Março 2026 Versão 1.0 · 23/03/2026 · Uso internoSumário
Manual de Suporte Interno — Novos Recursos (Tópicos 1 a 6)
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 | Área | Impacto |
|---|---|---|---|
| 1 | Bloqueio de vendas para inadimplentes | Vendas / Gerentes | Controle financeiro |
| 2A | Bloqueio de campos sensíveis no cadastro | Clientes / Gerentes | Segurança de dados |
| 2B | Log de auditoria de alterações | Clientes | Rastreabilidade |
| 2C | Tela de consulta do log | Clientes | Auditoria |
| 3A/3B | Anexação de documentos | Clientes | Compliance |
| 3C | Validação venda a prazo + Relatório | Vendas / Clientes | Compliance |
| 4 | Saldo automático na abertura do caixa | Caixa | Operacional |
| 5 | Controle de acesso ao ALT+R | Relatórios / Gerentes | Segurança |
| 6 | Consulta CPF na Receita Federal | Clientes | Produtividade |
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:
- Acessar Cadastro de Gerentes
- Selecionar o gerente desejado
- Pressionar F7 (tela de permissões)
- Pressionar F4 (permissões adicionais)
- Localizar o campo “Liberar venda p/ cliente inadimplente...?”
- 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
| Item | Tabela | Campo | Tipo | Valores | Padrão Fragoso | Padrão demais |
|---|---|---|---|---|---|---|
| Permissão gerente | gerente.dbf | LibInadim |
C(1) | S = pode liberar, N = não pode | N | S |
| Registro de autorização | Autoriza.dbf | (vários) | — | Data, hora, gerente | — | — |
Cenários de Suporte
Cenário 1: “O operador não consegue vender para um cliente”
- Verificar se o cliente possui títulos vencidos (consultar contas a receber)
- Se sim, o bloqueio está funcionando corretamente
- Orientar o operador a chamar o gerente para liberar com senha
- Se o gerente também não consegue liberar, verificar se o campo
LibInadimestá como S no cadastro desse gerente
Cenário 2: “O gerente digitou a senha mas o sistema não liberou”
- Acessar o cadastro do gerente em questão
- Ir em F7 > F4
- Confirmar que o campo “Liberar venda p/ cliente inadimplente” está como S
- Se estiver como N, alterar para S e tentar novamente
Cenário 3: “Quero saber quem liberou uma venda para inadimplente”
- Consultar a tabela Autoriza
- Procurar pelo código do cliente e pela data em questão
- 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”
- Verificar se o prazo de dias de inadimplência está configurado
- Em instalações não-Fragoso, o padrão é S (liberado) — ou seja, todos os gerentes podem liberar por padrão
- Se deseja bloquear, alterar
LibInadimpara N nos gerentes que não devem ter essa permissão
Perguntas Frequentes
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.
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:
- Acessar Cadastro de Gerentes
- Selecionar o gerente desejado
- Pressionar F7 (tela de permissões)
- Pressionar F4 (permissões adicionais)
- Localizar o campo “Editar dados sensíveis do cliente...?”
- Definir como S (pode desbloquear) ou N (não pode desbloquear)
Parâmetros e Permissões
| Item | Tabela | Campo | Tipo | Valores | Padrão Fragoso | Padrão demais |
|---|---|---|---|---|---|---|
| Permissão gerente | gerente.dbf | EditSensi |
C(1) | S = pode desbloquear, N = não pode | N | S |
Cenários de Suporte
Cenário 1: “O operador não consegue alterar o nome do cliente”
- Confirmar que é uma instalação Fragoso
- Explicar que os campos sensíveis agora são bloqueados por padrão
- Orientar a pressionar F3 no formulário do cliente
- Informar a senha de um gerente com permissão
EditSensi = S
Cenário 2: “Pressionei F3 mas não desbloqueou”
- Verificar se o gerente cuja senha foi informada tem
EditSensi = S - 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”
- Em modo de inclusão (novo cliente), os campos não devem estar bloqueados
- Verificar se o operador está realmente em modo de inclusão e não editando um registro existente
- 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”
- Em instalações fora do grupo Fragoso, o padrão é S (desbloqueado)
- Verificar se alguém alterou manualmente o parâmetro de controle
- Todos os gerentes devem ter
EditSensi = Spor padrão nessas instalações
Perguntas Frequentes
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
Este recurso é ativado automaticamente em instalações Fragoso. Não há configuração adicional necessária.
Parâmetros e Permissões
| Item | Tabela | Campo | Tipo | Descrição |
|---|---|---|---|---|
| Código do cliente | LogAltCli.dbf | CodCli |
C | Identifica o cliente alterado |
| Campo alterado | LogAltCli.dbf | Campo |
C | Nome do campo que foi modificado |
| Valor anterior | LogAltCli.dbf | ValorAnt |
C | Conteúdo do campo antes da alteração |
| Valor novo | LogAltCli.dbf | ValorNov |
C | Conteúdo do campo após a alteração |
| Data | LogAltCli.dbf | Data |
D | Data da alteração |
| Hora | LogAltCli.dbf | Hora |
C | Hora da alteração |
| Usuário | LogAltCli.dbf | Usuario |
C | Login do operador que fez a alteração |
| Terminal | LogAltCli.dbf | Terminal |
C | Nome do computador |
Campos monitorados pelo log:
- Telefone
- Bairro
- Endereço
- Cidade
- CEP
- UF
- (e demais campos de endereço/contato)
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”
- Acessar a tela de consulta do log (ver Tópico 2C — ALT+L)
- Filtrar pelo código do cliente
- Procurar registros onde o campo = “Telefone”
- O registro mostrará o valor anterior, o valor novo, quem alterou e quando
Cenário 2: “O log não está registrando alterações”
- Confirmar que é uma instalação Fragoso
- Verificar se a tabela
LogAltCli.dbfexiste na pasta de dados - 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”
- Verificar o campo “Terminal” no registro do log para confirmar de qual máquina partiu a alteração
- Verificar o campo “Usuario” para confirmar o login
- Cruzar com o horário de trabalho do operador
Perguntas Frequentes
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
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
| Item | Detalhe |
|---|---|
| Atalho | ALT+L na tela de browse de clientes |
| Acesso | Requer senha de gerente |
| Modo | Somente leitura (não permite inserir nem excluir) |
Colunas exibidas na consulta:
| Coluna | Descrição |
|---|---|
| Data | Data em que a alteração foi feita |
| Hora | Horário da alteração |
| Usuario | Login do operador responsável |
| Campo | Nome do campo que foi alterado |
| Valor Anterior | Conteúdo do campo antes da alteração |
| Valor Novo | Conteú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”
- Confirmar que é uma instalação Fragoso
- Verificar se a versão do sistema está atualizada
- 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”
- Confirmar que o operador está na tela de browse (listagem) de clientes, não dentro do formulário de edição
- Verificar se a tecla ALT está funcionando corretamente no teclado
- Se o sistema pediu senha e o operador cancelou, é comportamento normal
Cenário 3: “O log aparece vazio”
- Se a tabela LogAltCli foi criada recentemente, é normal que esteja vazia
- O log só contém registros a partir do momento em que o recurso foi ativado
- Alterações feitas antes da implantação não são retroativas
Perguntas Frequentes
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):
- Acessar Cadastro de Gerentes
- Selecionar o gerente desejado
- Pressionar F7 > F4
- Localizar o campo relacionado a “Alterar documento do cliente”
- 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\
- 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
| Item | Tabela | Campo | Tipo | Descrição | Padrão |
|---|---|---|---|---|---|
| Nome do arquivo anexado | Clientes.dbf | DOCANEXO |
C(50) | Nome do arquivo do documento | vazio |
| Data da anexação | Clientes.dbf | DTDOCANEX |
D(8) | Data em que o documento foi anexado | vazio |
| Usuário da anexação | Clientes.dbf | USRDOCANX |
C(20) | Login de quem anexou | vazio |
| Permissão substituir | gerente.dbf | AltDocCli |
C(1) | S = pode substituir, N = não pode | S |
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):
- Abrir o cadastro do cliente
- Pressionar ALT+D
- O menu exibe: [Anexar Documento] / [Cancelar]
- Selecionar “Anexar Documento”
- Escolher o arquivo na janela de seleção
- O indicador muda de DOC:--- para DOC:Sim
Para visualizar ou substituir (cliente com documento):
- Abrir o cadastro do cliente
- Pressionar ALT+D
- O menu exibe: [Visualizar] / [Substituir] / [Cancelar]
- “Visualizar” abre o documento no programa padrão do Windows
- “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”
- Verificar se o campo
DOCANEXOestá preenchido no registro do cliente - Verificar se o arquivo existe fisicamente na pasta
Dados\Docs\Clientes\ - 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”
- Verificar se a pasta
Dados\Docs\Clientes\existe - Verificar permissões de escrita na pasta
- Verificar espaço em disco
- Testar com um arquivo menor (pode ser limite de tamanho)
Cenário 3: “Não consigo substituir o documento”
- A substituição requer senha de gerente
- Verificar se o gerente tem
AltDocCli = S - Se o campo estiver como N, alterar no cadastro do gerente
Cenário 4: “O documento abre no programa errado”
- O sistema usa o programa padrão do Windows para abrir o arquivo
- Configurar a associação de arquivos no Windows (ex: PDFs abrindo no Adobe Reader)
- Isso não é configuração do SysLoja, é configuração do sistema operacional
Cenário 5: “Preciso anexar mais de um documento por cliente”
- O sistema permite apenas um documento por cliente
- Se for necessário anexar múltiplos documentos, orientar o cliente a digitalizar tudo em um único PDF
Perguntas Frequentes
Tópico 3C — Validação Venda a Prazo + Relatório Clientes sem Documento
O que mudou
Dois novos recursos complementares à anexação de documentos:
- 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.
- 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:
- Acessar a Tela de Parâmetros do sistema
- Localizar o campo “Obrigar documento anexado p/ venda a prazo?”
- 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
| Item | Tabela | Campo | Tipo | Descrição | Padrão |
|---|---|---|---|---|---|
| Obrigar documento | ParamDiv.dbf | ObrigDocVP |
C(1) | S = obriga documento para venda a prazo | N |
Como funciona a validação
Quando ObrigDocVP = S:
- O operador inicia uma venda a prazo
- O sistema verifica se o cliente possui documento anexado (campo
DOCANEXOpreenchido) - Se não possui, exibe a mensagem: “Cliente sem documento anexado!”
- A venda é bloqueada até que um documento seja anexado ao cadastro do cliente
Como acessar o relatório
- Abrir a tela de browse de clientes
- Pressionar TAB
- Selecionar “Clientes sem Documento”
- Informar os filtros:
- Bairro (deixar em branco para todos)
- Situação (99 = todos)
Colunas do relatório:
| Coluna | Descrição |
|---|---|
| Código | Código do cliente |
| Nome | Nome do cliente |
| Telefone | Telefone de contato |
| Bairro | Bairro do cliente |
| Cadastro | Data 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ê”
- Verificar se o parâmetro
ObrigDocVPestá como S - Explicar que o sistema agora exige documento anexado para vendas a prazo
- Orientar a anexar o documento do cliente (ALT+D no cadastro)
- Após anexar, a venda a prazo será permitida
Cenário 2: “Quero desativar o bloqueio temporariamente”
- Acessar a Tela de Parâmetros
- Alterar “Obrigar documento anexado p/ venda a prazo?” para N
- O bloqueio é desativado imediatamente para todas as estações
Cenário 3: “O relatório não aparece na lista”
- Verificar se a versão do sistema está atualizada
- 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”
- Comportamento correto — o bloqueio afeta apenas vendas a prazo
- Vendas à vista, cartão, PIX, etc. não são afetadas pelo parâmetro
ObrigDocVP
Perguntas Frequentes
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:
- Acessar a Tela de Parâmetros do sistema
- Localizar o campo “Bloquear alteração do saldo inicial caixa?”
- Definir como S para bloquear a edição
Parâmetros e Permissões
| Item | Tabela | Campo | Tipo | Descrição | Padrão |
|---|---|---|---|---|---|
| Trazer saldo anterior | ParamDiv.dbf | TrazSldCxA |
C(1) | S = traz saldo do dia anterior | (existente) |
| Bloquear alteração | ParamDiv.dbf | BlkSldIniCx |
C(1) | S = bloqueia edição do saldo | N |
Regra de funcionamento combinada:
| TrazSldCxA | BlkSldIniCx | Saldo anterior | Comportamento |
|---|---|---|---|
| N | (qualquer) | (qualquer) | Campo livre para digitação (comportamento antigo) |
| S | N | (qualquer) | Saldo sugerido mas editável (comportamento antigo) |
| S | S | > R$ 0,00 | Saldo preenchido e bloqueado (verde, “Saldo automático”) |
| S | S | = R$ 0,00 | Campo editável (fallback — não bloqueia valor zero) |
Cenários de Suporte
Cenário 1: “O operador não consegue alterar o saldo inicial”
- Verificar se
BlkSldIniCx = S - Se sim, é comportamento correto — o campo está bloqueado intencionalmente
- Se o cliente deseja permitir alteração, mudar
BlkSldIniCxpara N
Cenário 2: “O saldo está vindo errado”
- Verificar o saldo de fechamento do caixa do dia anterior
- O valor exibido na abertura deve ser exatamente igual ao fechamento anterior
- 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”
- Verificar se
TrazSldCxAtambém está como S (ambos precisam estar ativos) - Verificar se o saldo do dia anterior é R$ 0,00 — nesse caso, o campo fica editável intencionalmente
- 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”
- Confirmar que ambos os parâmetros estão como S
- Confirmar que o saldo do dia anterior é maior que zero
- Se tudo estiver correto, verificar a versão do sistema
Perguntas Frequentes
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:
- Acessar Cadastro de Gerentes
- Selecionar o gerente desejado
- Pressionar F7 > F4 (permissões adicionais)
- Localizar o campo de acesso ao ALT+R
- Definir como S (pode acessar) ou N (não pode acessar)
Parâmetros e Permissões
| Item | Tabela | Campo | Tipo | Descrição | Padrão |
|---|---|---|---|---|---|
| Exigir senha p/ relatórios | Config.dbf | SenhaRel |
C(1) | S = exige senha, N = livre | (existente) |
| Permissão gerente ALT+R | gerente.dbf | AcessoALTR |
C(1) | S = pode acessar, N = não pode | (verificar) |
Regra de funcionamento:
| SenhaRel | AcessoALTR | Comportamento |
|---|---|---|
| N | (qualquer) | ALT+R funciona livremente, sem senha |
| S | S | ALT+R pede senha, gerente é aceito |
| S | N | ALT+R pede senha, gerente é recusado |
Cenários de Suporte
Cenário 1: “O operador não consegue acessar o ALT+R”
- Verificar se
SenhaRel = Sna tabela Config - Se sim, é necessário senha de gerente com
AcessoALTR = S - Verificar a permissão do gerente cuja senha está sendo informada
Cenário 2: “O gerente digita a senha mas é recusado no ALT+R”
- Acessar o cadastro do gerente em questão
- Ir em F7 > F4
- Verificar se
AcessoALTRestá como S - Se estiver como N, alterar para S
Cenário 3: “Quero liberar o ALT+R para todos”
- Opção A: Alterar
SenhaRelpara N na Config — desativa a senha para todos - Opção B: Manter
SenhaRel = Se colocarAcessoALTR = Sem todos os gerentes
Cenário 4: “ALT+R não pede senha (e deveria pedir)”
- Verificar se
SenhaRel = Sna tabela Config - Se estiver como N, o sistema não pede senha (comportamento esperado)
- Alterar para S se desejar ativar o controle
Perguntas Frequentes
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
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
- O operador inicia o cadastro de um novo cliente (modo inclusão)
- Seleciona tipo Pessoa Física
- Digita o CPF do cliente
- Ao sair do campo CPF, o sistema pergunta: “Consultar dados do CPF na Receita Federal?”
- Se o operador responder Sim:
- O sistema consulta a API
- Preenche automaticamente o Nome e a Data de Nascimento
- Se o operador responder Não:
- O cadastro continua normalmente, com preenchimento manual
- 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”
- Verificar se é um cliente novo (modo inclusão). A consulta não funciona em clientes existentes
- Verificar se o tipo é Pessoa Física. Pessoa Jurídica não utiliza este recurso
- Verificar se o CPF foi digitado corretamente
Cenário 2: “A consulta retorna erro”
- Verificar a conexão com a internet da estação
- A API da Receita Federal pode estar temporariamente indisponível — tentar novamente em alguns minutos
- Verificar se o CPF informado é válido
- Se o erro persistir, o operador pode preencher os dados manualmente sem prejuízo
Cenário 3: “O nome veio errado ou incompleto”
- A informação vem diretamente da Receita Federal — o sistema apenas repassa
- O operador pode corrigir o nome manualmente após o preenchimento automático
- Se o nome vier com acentuação diferente, ajustar manualmente
Cenário 4: “Quero consultar o CPF de um cliente já existente”
- O recurso funciona apenas para novos cadastros (inclusão)
- Para clientes existentes, os dados devem ser verificados e atualizados manualmente
- 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”
- A API pode não ter retornado a data de nascimento para aquele CPF
- O operador deve preencher manualmente a data de nascimento
Perguntas Frequentes
Tabela Resumo de Parâmetros e Permissões
Permissões de Gerente (gerente.dbf)
| Campo | Tipo | Descrição | Padrão Fragoso | Padrão demais | Acesso |
|---|---|---|---|---|---|
LibInadim |
C(1) | Liberar venda p/ cliente inadimplente | N | S | F7 > F4 |
EditSensi |
C(1) | Editar dados sensíveis do cliente | N | S | F7 > F4 |
AltDocCli |
C(1) | Substituir documento do cliente | S | S | F7 > F4 |
AcessoALTR |
C(1) | Acessar ALT+R (quando SenhaRel=S) | (verificar) | (verificar) | F7 > F4 |
Parâmetros do Sistema (ParamDiv.dbf)
| Campo | Tipo | Descrição | Padrão | Tela de Parâmetros |
|---|---|---|---|---|
ObrigDocVP |
C(1) | Obrigar documento p/ venda a prazo | N | Sim |
BlkSldIniCx |
C(1) | Bloquear alteração saldo inicial caixa | N | Sim |
Parâmetro Existente Relacionado (ParamDiv.dbf)
| Campo | Tipo | Descrição | Observação |
|---|---|---|---|
TrazSldCxA |
C(1) | Trazer saldo do caixa anterior | Pré-requisito para BlkSldIniCx |
Parâmetro Existente Relacionado (Config.dbf)
| Campo | Tipo | Descrição | Observação |
|---|---|---|---|
SenhaRel |
C(1) | Exigir senha para relatórios | Pré-requisito para AcessoALTR |
Campos Novos em Tabelas Existentes (Clientes.dbf)
| Campo | Tipo | Descrição |
|---|---|---|
DOCANEXO |
C(50) | Nome do arquivo do documento anexado |
DTDOCANEX |
D(8) | Data da anexação do documento |
USRDOCANX |
C(20) | Usuário que anexou o documento |
Tabela Nova (LogAltCli.dbf) — Somente Fragoso
| Campo | Tipo | Descrição |
|---|---|---|
CodCli |
C | Código do cliente |
Campo |
C | Nome do campo alterado |
ValorAnt |
C | Valor anterior |
ValorNov |
C | Valor novo |
Data |
D | Data da alteração |
Hora |
C | Hora da alteração |
Usuario |
C | Login do operador |
Terminal |
C | Nome 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
LibInadimfoi criado na tabela gerente.dbf - Definir o valor de
LibInadimpara 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
EditSensifoi criado na tabela gerente.dbf - Definir o valor de
EditSensipara 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.dbffoi 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,USRDOCANXexistem em Clientes.dbf - Verificar se o campo
AltDocClifoi 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
ObrigDocVPfoi 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
BlkSldIniCxfoi 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
AcessoALTRfoi criado na tabela gerente.dbf - Definir o valor de
AcessoALTRpara cada gerente - Verificar se
SenhaRelestá 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