ST_REGIAOCOMERCIALENDERECO - Região Comercial por Endereço

Tela de configuracao: ADM010 — Parâmetros do Sistema Aba: Bloqueio/Cadastro Pessoa Componente: chkRegiaComercialEndereco (checkbox) Tabela: PARMSISTEMA.ST_REGIAOCOMERCIALENDERECO Tipo: CHAR(1) — DOM_CHAR1 Valor padrao: N (Desmarcado)

Quando habilitado, o sistema exige que o campo Regiao Comercial (CD_REGIAOCOMERCIAL) seja informado durante o cadastro ou edicao de endereco da pessoa na tela TFA001.

Telas impactadas

Tela	Nome	Efeito
ADM010	Parametros do Sistema	Tela de configuracao do parametro
TFA001	Cadastro de Pessoa	Torna o campo Regiao Comercial obrigatorio nos enderecos quando o parametro esta S

Campos envolvidos

Campo	Tabela	Tipo	Obrigatorio
ST_REGIAOCOMERCIALENDERECO	PARMSISTEMA	CHAR(1)	Sim (default N)
CD_REGIAOCOMERCIAL	ENDERECOPESSOA	INTEGER	Sim se S

Opcoes disponiveis

N - Desmarcado (Padrao) — Regiao Comercial Nao Obrigatorio no Endereco

O que faz	Detalhe
Comportamento	O campo Regiao Comercial no cadastro de endereco da pessoa fica opcional
Restricao	Nenhuma — o usuario pode salvar o endereco sem informar regiao comercial

Simulacao passo a passo

1. Acesse ADM010 — Parametros do Sistema.
2. Na aba Bloqueio/Cadastro Pessoa, desmarque a opcao Regiao Comercial por Endereco.
3. Clique em Salvar.
4. Acesse TFA001 — Cadastro de Pessoa e abra o cadastro de um cliente.
5. Na secao de Enderecos, adicione ou edite um endereco.
6. Deixe o campo Regiao Comercial em branco.
7. Clique em Salvar.

Resultado esperado: O endereco e salvo com sucesso mesmo sem Regiao Comercial informada.

---

S - Marcado — Regiao Comercial Obrigatorio no Endereco

O que faz	Detalhe
Comportamento	O campo Regiao Comercial no cadastro de endereco da pessoa fica obrigatorio, com label em negrito
Exige	Que o usuario selecione uma regiao comercial valida antes de salvar o endereco
Restricao	Bloqueia o salvamento com mensagem de erro se o campo estiver vazio

Simulacao passo a passo

1. Acesse ADM010 — Parametros do Sistema.
2. Na aba Bloqueio/Cadastro Pessoa, marque a opcao Regiao Comercial por Endereco.
3. Clique em Salvar.
4. Acesse TFA001 — Cadastro de Pessoa e abra o cadastro de um cliente.
5. Vá ate a aba Enderecos (pagENDERECOPESSOA) — o label Regiao Comercial aparece em negrito (lblCD_REGIAOCOMERCIAL.Font.Style := [fsBold]).
6. Clique em Adicionar um novo endereco (ou edite um endereco existente).
7. Preencha os demais dados (logradouro, numero, cidade), mas deixe Regiao Comercial em branco.
8. Clique em Salvar.

Resultado esperado: O sistema exibe a mensagem de erro: "E Obrigatorio Informar a Regiao Comercial! Verifique![TFA001/ADM010]", posiciona automaticamente no campo CD_REGIAOCOMERCIAL e bloqueia o salvamento ate que uma regiao comercial seja informada.

Simulacao com regiao comercial preenchida

1. Com o parametro habilitado (S), siga os passos 1 a 6 acima.
2. No campo Regiao Comercial, selecione uma regiao valida (ex: 1 - Regiao Metropolitana).
3. Clique em Salvar.

Resultado esperado: O endereco e salvo com sucesso, pois o campo obrigatorio foi preenchido.

Excecao / Importante:

• Este parametro afeta apenas a validacao de enderecos na tela TFA001 (Cadastro de Pessoa). Outros formularios que cadastrem enderecos podem ter validacoes independentes.
• O parametro ST_OBRIGAREGCOMCONDPAGTO (configurado na mesma tela ADM010) tem efeito similar, mas para o campo Condicao de Pagamento — ambos sao validacoes de campos de endereco e operam de forma independente.
• A tabela REGIAOCOMERCIAL contem os valores validos do campo (CD_REGIAOCOMERCIAL, DS_REGIAOCOMERCIAL, vinculo com CD_VENDEDOR e CD_AREACOMERCIAL). Se nenhuma regiao estiver cadastrada, o usuario nao conseguira preencher o campo obrigatorio.

Procedures impactadas

Rotinas Delphi com referencia direta ao parametro

Rotina	Arquivo	Linha	Efeito
iniciar (TFA001)	source/TFA001/UTFA001.pas	1025	Coloca label da regiao comercial em negrito quando S
validacoesADM010 (TFA001)	source/TFA001/UdmTFA001.pas	3792	Valida que CD_REGIAOCOMERCIAL em ENDERECOPESSOA esta preenchido; lanca excecao E-0000 se vazio

Referencias SQL diretas ao campo

Nao foi encontrada referencia direta ao campo ST_REGIAOCOMERCIALENDERECO nos scripts SQL do diretorio Scripts/.

Candidatas por uso da tabela

As seguintes procedures usam a tabela PARMSISTEMA, mas nao citam o campo ST_REGIAOCOMERCIALENDERECO literalmente — sem impacto direto identificado:

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.

Tabela Comparativa Resumida

Valor	Label Componente	Endereco: Regiao Comercial	Label Bold	Erro ao Vazio
N	Desmarcado	Opcional	Nao	Nao
S	Marcado	Obrigatorio	Sim	Sim — "E Obrigatorio Informar a Regiao Comercial! Verifique![TFA001/ADM010]"