ST_FORMAPAGTOENDERECO - Forma de Pagamento por Endereço

Tela de configuração: ADM010 — Parâmetros do Sistema
Localização na tela: Aba "Bloqueio/Cadastro Pessoa"
Componente: chkPagamentoEndereco (checkbox)
Tabela: PARMSISTEMA.ST_FORMAPAGTOENDERECO
Valor padrão: N (Desmarcado)
Tipo: DOM_CHAR1 — CHAR(1)

Quando ativado, obriga o preenchimento do campo Forma de Pagamento (CD_FORMAPAGTO) no cadastro de endereços da pessoa (tela TFA001).

Telas impactadas

Tela	Nome	Efeito
TFA001	Cadastro de Pessoa	Torna obrigatória a Forma de Pagamento no endereço

Campos envolvidos

Campo	Tabela	Controle	Efeito
ST_FORMAPAGTOENDERECO	PARMSISTEMA	chkPagamentoEndereco	Liga/desliga a obrigatoriedade
CD_FORMAPAGTO	ENDERECOPESSOA	edtCD_FORMAPAGTO	Campo obrigatório quando S
lblCD_FORMAPAGTO	—	Label	Fonte em negrito quando S

Opções disponíveis

O que faz	Detalhe
Desmarcado (N)	Forma de pagamento no endereço é opcional
Marcado (S)	Forma de pagamento no endereço é obrigatória — o campo fica com Required = True, o label fica em negrito, e a tela bloqueia o salvamento sem valor

N — Não Obrigatório (Desmarcado)

Simulação passo a passo

1. Acesse ADM010 — Parâmetros do Sistema.
2. Abra a aba "Bloqueio/Cadastro Pessoa".
3. Localize o campo "Forma de Pagamento por Endereço" e desmarque o checkbox.
4. Salve a configuração.
5. Acesse a tela TFA001 — Cadastro de Pessoa.
6. Abra ou crie um registro de pessoa e vá à aba de Endereços.
7. Preencha os dados do endereço sem informar a Forma de Pagamento.
8. Salve o registro.

Resultado esperado: O registro é salvo normalmente, mesmo sem informar a Forma de Pagamento no endereço.

S — Obrigatório (Marcado)

Simulação passo a passo

1. Acesse ADM010 — Parâmetros do Sistema.
2. Abra a aba "Bloqueio/Cadastro Pessoa".
3. Localize o campo "Forma de Pagamento por Endereço" e marque o checkbox.
4. Salve a configuração.
5. Acesse a tela TFA001 — Cadastro de Pessoa.
6. Abra ou crie um registro de pessoa e vá à aba de Endereços.
7. Observe que o campo Forma de Pagamento (CD_FORMAPAGTO) exibe o label em negrito, indicando obrigatoriedade.
8. Preencha os dados do endereço sem informar a Forma de Pagamento.
9. Tente salvar o registro.

Resultado esperado: O sistema exibe a mensagem de erro: "É Obrigatório Informar a Forma de Pagamento! Verifique![TFA001/ADM010]", posiciona o cursor no campo CD_FORMAPAGTO e bloqueia o salvamento até que o campo seja preenchido.

Exceção / Importante: Assim como os demais parâmetros da família *ENDERECO (ex: ST_VENDEDORENDERECO, ST_TELEFONEENDERECO), este parâmetro só impacta a tela TFA001 no momento do cadastro/edição de endereços da pessoa. Não há validação retroativa em endereços já existentes.

Regra Geral de Funcionamento

• Quando ST_FORMAPAGTOENDERECO = 'S':

  • tabENDERECOPESSOA.CD_FORMAPAGTO.Required é setado para True.
  • O label lblCD_FORMAPAGTO recebe fonte em negrito (fsBold).
  • Se o campo estiver vazio no salvamento, o sistema:
    1. Ativa a página pagENDERECOPESSOA.
    2. Ativa a sub-página pagopcao1.
    3. Posiciona o foco em edtCD_FORMAPAGTO.
    4. Exibe a mensagem: "É Obrigatório Informar a Forma de Pagamento! Verifique![TFA001/ADM010]".

• Quando ST_FORMAPAGTOENDERECO = 'N':

  • Nenhuma obrigatoriedade é aplicada ao campo CD_FORMAPAGTO nos endereços.

Tabela Comparativa Resumida

Valor	Obrigatório?	Label em negrito?	Bloqueia salvamento?
N (Desmarcado)	Não	Não	Não
S (Marcado)	Sim	Sim	Sim — exige CD_FORMAPAGTO

Procedures impactadas

Rotinas Delphi com referência direta ao campo

Rotina	Arquivo	Linha	Efeito
TfrmTFA001.validaObrigatoriedadeADM010	source/TFA001/UTFA001.pas	4978	Seta Required = True no campo e label em negrito
TdmTFA001.validacoesADM010	source/TFA001/UdmTFA001.pas	3847	Valida campo vazio e lança exceção com mensagem de erro

Impacto em Scripts SQL

Não foi encontrada referência direta ao campo ST_FORMAPAGTOENDERECO em arquivos de Scripts/. O parâmetro é consumido exclusivamente via Delphi nas rotinas da tela TFA001.

Parâmetros relacionados

Dentro da mesma aba "Bloqueio/Cadastro Pessoa" da tela ADM010, existem parâmetros com comportamento similar para outros campos do endereço:

Parâmetro	Campo obrigatório
ST_VENDEDORENDERECO	Vendedor (CD_VENDEDOR)
ST_FORMAPAGTOENDERECO	Forma de Pagto (CD_FORMAPAGTO)
ST_TELEFONEENDERECO	Telefone/Celular (NR_FONE, NR_CELULAR)
ST_REGIAOCOMERCIALENDERECO	Região Comercial
ST_MAISENDERECOPESSOA	Dados complementares do endereço