ST_NOMEFANTASIA - Obrigatoriedade do Nome Fantasia

Tela de configuração: ADM010 — Parâmetros do Sistema Localização: Aba Bloqueio/Cadastro Pessoa — checkbox Nome Fantasia Tabela: PARMSISTEMA.ST_NOMEFANTASIA Valor padrão: N (Desmarcado — campo não obrigatório)

Telas impactadas

Tela	Descrição
TFA001	Cadastro de Pessoas

Campos envolvidos

Campo	Tabela	Efeito quando parâmetro = S
NM_FANTASIA	PESSOA	Torna-se obrigatório; label em negrito; bloqueio de salvamento se vazio

Opções disponíveis

S — Marcado (Nome Fantasia obrigatório)

O que faz	Detalhe
Torna o campo Nome Fantasia obrigatório no cadastro de pessoa	Label fica em negrito; campo passa a ser Required; ao tentar salvar vazio, exibe erro
Validação ocorre no BeforePost do cadastro	Impede gravação do registro enquanto o campo estiver em branco

Simulação passo a passo

1. Acesse Administrativo → Parâmetros do Sistema (ADM010).
2. Abra a aba Bloqueio/Cadastro Pessoa.
3. Marque o checkbox Nome Fantasia.
4. Salve o parâmetro (<F9> ou botão Salvar).
5. Abra o Cadastro de Pessoas (TFA001).
6. Preencha os dados de uma nova pessoa, deixando o campo Nome Fantasia vazio.
7. Tente salvar o cadastro.

Resultado esperado: O sistema exibe a mensagem "É Obrigatório Informar o Nome Fantasia! Verifique![TFA001/ADM010]", posiciona o cursor no campo Nome Fantasia e impede a gravação.

N — Desmarcado (campo livre — padrão)

O que faz	Detalhe
Campo Nome Fantasia permanece opcional	Sem validação de preenchimento; label em estilo normal

Simulação passo a passo

1. Acesse Administrativo → Parâmetros do Sistema (ADM010).
2. Abra a aba Bloqueio/Cadastro Pessoa.
3. Desmarque o checkbox Nome Fantasia (ou confirme que já está desmarcado).
4. Salve o parâmetro.
5. Abra o Cadastro de Pessoas (TFA001).
6. Preencha os dados de uma nova pessoa, deixando o campo Nome Fantasia vazio.
7. Salve o cadastro.

Resultado esperado: O registro é salvo normalmente, sem nenhuma exigência de preenchimento do campo Nome Fantasia.

Regra geral

• O parâmetro age sobre a tela TFA001 (Cadastro de Pessoas) em dois momentos:
  1. Ao abrir/editar o cadastro — aplica Required := True ao campo e destaca o label em negrito.
  2. Ao salvar (BeforePost) — valida o preenchimento; se vazio, exibe erro e foca o campo.
• Não há distinção entre tipo de pessoa (Física/Jurídica) na validação — ambos são afetados igualmente.

Tabela comparativa resumida

Valor	Nome Fantasia obrigatório?	Label em negrito?	Bloqueia salvamento se vazio?
N (padrão)	Não	Não	Não
S	Sim	Sim	Sim

Procedures impactadas

Rotinas Delphi com referência direta ao campo

Rotina	Arquivo	Linha	Comportamento
TfrmTFA001.validaObrigatoriedadeADM010	source/TFA001/UTFA001.pas	4958	Marca NM_FANTASIA como Required e destaca o label
TdmTFA001.tabPESSOABeforePost	source/TFA001/UdmTFA001.pas	1278	Valida preenchimento; raise exception se vazio

Referências SQL diretas ao campo

Nenhuma procedure/view em Scripts/ referencia diretamente o campo ST_NOMEFANTASIA.

Candidatas por uso da tabela

As procedures abaixo utilizam a tabela PARMSISTEMA, mas não citam o campo ST_NOMEFANTASIA literalmente. Impacto funcional direto não confirmado:

• ARRUMA_MASCARACONTA, ATUALIZA_CONTACONTABIL, CALCULA_TEMPOPERMANENCIA, CONTABILIZA_CUPOMFISCAL, ENDERECOPESSOA_BI0, GERA_CONTACLIFOR, GERA_DARF, GERA_PLANOFILIAL, GERA_SPEDBLOCOL, GERA_SPEDCONTABIL, GERA_SPEDCONTABIL_0000, GERA_SPEDECF, GERA_SPEDECFBLOCOJ, GERA_SPEDECFBLOCOK155, GERA_SPEDECFBLOCOK355, GERA_SPEDECFBLOCOL210, GERA_SPEDECFBLOCOY, GRAVA_REGISTROSPED0500, IMPORTA_ARQUIVOMAGNETICO, INCLUI_IMPOSTONOTACTB.