ST_ENDERECOVENDEDOR — Replicar Vendedor do Endereço para aba Vendedores

Tela de configuração: ADM010 — Parâmetros do Sistema Localização: aba Bloqueio/Cadastro Pessoa Tabela: PARMSISTEMA.ST_ENDERECOVENDEDOR Tipo: Checkbox (S / N) — Valor padrão: N

Resumo

Quando ativado, o sistema replica automaticamente o vendedor vinculado a cada endereço da pessoa para a aba Vendedores (tabela PESSOAVENDEDOR). Isso garante que todos os vendedores informados nos endereços também constem na lista de vendedores habilitados para aquela pessoa.

Dependência obrigatória

O checkbox só fica visível quando o parâmetro ST_VARIOSVENDEDORES estiver marcado com S.

Parâmetro dependente	Configurado em	Descrição
ST_VARIOSVENDEDORES	MFA001 — Parâmetros de Faturamento	Habilita o uso de múltiplos vendedores por pessoa. Se N, o campo ST_ENDERECOVENDEDOR fica oculto na tela ADM010.

Nota: Para que o campo Vendedor apareça na tela de cadastro de endereços, ative também ST_VENDEDORENDERECO (configurado em ADM010, mesma aba Bloqueio/Cadastro Pessoa).

Telas impactadas

Tela	Impacto
ADM010	Exibe/oculta o checkbox conforme ST_VARIOSVENDEDORES
TFA001	No AfterPost de ENDERECOPESSOA, replica vendedores dos endereços para PESSOAVENDEDOR

Campos envolvidos

Campo	Tabela	Descrição
CD_VENDEDOR	ENDERECOPESSOA	Vendedor vinculado a cada endereço da pessoa
CD_PESSOA / CD_VENDEDOR	PESSOAVENDEDOR	Relação de vendedores habilitados para a pessoa

Opções disponíveis

S — Marcado (Replicar vendedores dos endereços)

O que faz	Detalhe
Replica automaticamente o vendedor de cada endereço para a aba Vendedores	Exige ST_VARIOSVENDEDORES = S; funciona no AfterPost do endereço
Não duplica registros já existentes	Verifica se o par pessoa+vendedor já existe em PESSOAVENDEDOR antes de inserir

Simulação passo a passo

1. Acesse ADM010 → Parâmetros do Sistema.
2. Marque o checkbox Vendedor de cada Endereço p/ aba de Vendedores.
3. Salve os parâmetros.
4. Abra TFA001 — Cadastro de Pessoas e localize a pessoa desejada.
5. Na aba de Endereços, cadastre ou edite um endereço informando um Vendedor no campo correspondente.
6. Salve o endereço.
7. Navegue até a aba Vendedores da mesma pessoa.

Resultado esperado: O vendedor informado no endereço aparece automaticamente na aba Vendedores, sem necessidade de inclusão manual.

Exceção / Importante: Se o vendedor já estiver cadastrado na aba Vendedores (registro já existe em PESSOAVENDEDOR), o sistema não cria duplicata. Além disso, se o campo vendedor do endereço estiver em branco, nenhum registro é inserido. O parâmetro ST_VARIOSVENDEDORES precisa obrigatoriamente estar S em PARMFATUR, caso contrário o checkbox nem será exibido na tela ADM010 e a replicação não ocorrerá em TFA001.

N — Desmarcado (padrão)

O que faz	Detalhe
Não replica vendedores dos endereços	Cada vendedor deve ser incluído manualmente na aba Vendedores

Simulação passo a passo

1. Acesse ADM010 → Parâmetros do Sistema.
2. Deixe desmarcado o checkbox Vendedor de cada Endereço p/ aba de Vendedores.
3. Salve os parâmetros.
4. Abra TFA001 — Cadastro de Pessoas e localize a pessoa.
5. Na aba de Endereços, informe um vendedor no endereço e salve.
6. Navegue até a aba Vendedores.

Resultado esperado: O vendedor do endereço não aparece na aba Vendedores; é necessário incluí-lo manualmente.

Procedures impactadas

Rotinas Delphi com referência direta ao campo

Rotina	Arquivo	Descrição
TfrmADM010.pgcCONFChange	source/ADM010/UADM010.pas	Controla visibilidade do checkbox conforme ST_VARIOSVENDEDORES
TdmTFA001.tabENDERECOPESSOAAfterPost	source/TFA001/UdmTFA001.pas	Quando ST_ENDERECOVENDEDOR = S e ST_VARIOSVENDEDORES = S, percorre todos os endereços da pessoa e insere em PESSOAVENDEDOR os vendedores que ainda não existem

Scripts SQL

Nenhuma procedure/view SQL em Scripts/ referencia diretamente o campo ST_ENDERECOVENDEDOR.