Pular para o conteúdo principal

CD_VENDEDOR - Parâmetro de Vendedor

Tela de configuração: MFA007 — Parâmetros de Vendedor Tabela: PARMVENDEDOR.CD_VENDEDOR (DOM_INTEGER NOT NULL) Valor padrão: preenchido via pesquisa <F9> Controle: edtCD_VENDEDOR (TDBEdit, editável)

Descrição​

Define qual vendedor receberá a comissão ou terá regras especiais de preço/tabela para a combinação de filtros cadastrada na linha de PARMVENDEDOR. É o único campo obrigatório do cadastro — sem ele, o registro não pode ser salvo.

Telas impactadas​

TelaImpacto
MFA007 — Parâmetros de VendedorTela de cadastro deste campo
MFA001 — Parâmetros de FaturamentoUtiliza PARMVENDEDOR indiretamente para aplicar regras de preço/tabela por vendedor

Campos envolvidos​

CampoTabelaTipoDescrição
CD_VENDEDORPARMVENDEDORINTEGER NOT NULLCódigo do vendedor (FK para VENDEDOR.CD_VENDEDOR)
NM_VENDEDORPARMVENDEDOR (lookup)VARCHARNome do vendedor, preenchido automaticamente via validação
NR_SEQUENCIAPARMVENDEDORINTEGER NOT NULLChave primária da tabela
CD_REGIAOCOMERCIALPARMVENDEDORINTEGERFiltro opcional — Região Comercial
CD_GRUPOPARMVENDEDORINTEGERFiltro opcional — Grupo de produto
CD_MARCAPARMVENDEDORINTEGERFiltro opcional — Marca
CD_PESSOAPARMVENDEDORINTEGERFiltro opcional — Pessoa/Cliente
CD_ITEMPARMVENDEDORINTEGERFiltro opcional — Produto

Regras de preenchimento​

O que fazDetalhe
ObrigatórioO campo não pode ficar vazio ao salvar (BeforePost exige valor)
ValidaçãoO código informado deve existir na tabela VENDEDOR (join com PESSOA); caso contrário, exibe erro "O Vendedor não está Cadastrado [TFA007]!"
Pesquisa <F9>Abre janela de pesquisa listando pessoas ativas (ST_ATIVA = 'S') que são vendedoras
Nome automáticoAo informar um código válido, o campo NM_VENDEDOR é preenchido automaticamente com o nome da pessoa

Opções disponíveis​

Este parâmetro é um campo de código inteiro (não possui opções fixas como A/B/N). O comportamento varia conforme o valor informado (código do vendedor).

Preenchimento manual (digitação direta)​

Simulação passo a passo​

  1. Acesse MFA007 — Parâmetros de Vendedor.
  2. Pressione <F5> ou clique em Novo.
  3. Digite o código do vendedor diretamente no campo Vendedor (ex.: 42).
  4. Pressione <Tab> para sair do campo.
  5. O nome do vendedor será exibido automaticamente ao lado.

Resultado esperado: O campo é validado; se o código existir em VENDEDOR, o nome é carregado. Se não existir, uma mensagem de erro é exibida impedindo a gravação.

Exceção / Importante: Se o campo ficar vazio ao tentar salvar, o sistema exibe "É Obrigatório informar o Vendedor!" e bloqueia a gravação.

Preenchimento via pesquisa (<F9>)​

Simulação passo a passo​

  1. Acesse MFA007 — Parâmetros de Vendedor.
  2. Pressione <F5> ou clique em Novo.
  3. Posicione o cursor no campo Vendedor e pressione <F9>.
  4. Na janela "Selecione o Vendedor", localize o vendedor desejado (ex.: "João Silva — Código 42").
  5. Dê um duplo clique ou selecione e confirme.
  6. O código 42 é preenchido no campo e o nome "João Silva" aparece ao lado.

Resultado esperado: O campo Vendedor é preenchido com o código selecionado e o nome é exibido automaticamente no campo adjacente (somente leitura).

Exceção / Importante: A pesquisa lista apenas pessoas com ST_ATIVA = 'S' que possuam registro na tabela VENDEDOR. Vendedores inativos não aparecem na lista, mas ainda podem ser digitados manualmente.

Regras complementares do registro​

Ao salvar, o sistema exige que pelo menos um dos filtros complementares esteja preenchido:

  • CD_REGIAOCOMERCIAL (Região Comercial)
  • CD_GRUPO (Grupo)
  • CD_PESSOA (Pessoa/Cliente)
  • CD_ITEM (Produto)

Se nenhum desses filtros for informado, o sistema exibe: "É Obrigatório informar a Região Comercial, Grupo, Pessoa ou Produto!".

Procedures impactadas​

Rotinas Delphi​

RotinaArquivoDescrição
edtCD_VENDEDORKeyDownsource/MFA007/UMFA007.pasAbre pesquisa <F9> de vendedores
tabPARMVENDEDORCD_VENDEDORValidatesource/MFA007/UdmMFA007.pasValida código do vendedor e preenche nome
tabPARMVENDEDORBeforePostsource/MFA007/UdmMFA007.pasExige CD_VENDEDOR preenchido antes de salvar

Scripts SQL com referência direta ao campo CD_VENDEDOR​

Procedure/ViewArquivoContexto
CALCULA_COMISSAOScripts/CALCULA_COMISSAO.sqlRecebe V_CD_VENDEDOR para cálculo de comissão
CALCULA_COMISSAO_V2Scripts/CALCULA_COMISSAO_V2.sqlRecebe V_CD_VENDEDOR para cálculo de comissão
GERA_COMISSAOTABPRECOScripts/GERA_COMISSAOTABPRECO.sqlUtiliza vendedor da nota fiscal para comissão
GERA_CREDITOVENDEDORScripts/GERA_CREDITOVENDEDOR.sqlRecebe I_CD_VENDEDOR como parâmetro de entrada
GRAVA_COMISSAOCONTASScripts/GRAVA_COMISSAOCONTAS.sqlUtiliza V_CD_VENDEDOR para gravar comissão em contas
GRAVA_CONTASScripts/GRAVA_CONTAS.sqlRecebe V_CD_VENDEDOR como parâmetro
GERA_DUPLICATASScripts/GERA_DUPLICATAS.sqlRecebe I_CD_VENDEDOR para gerar duplicatas
GERA_NOTAFISCALScripts/GERA_NOTAFISCAL.sqlRecebe I_CD_VENDEDOR para gerar nota fiscal
GERA_ESTOQUE_NOTAFISCALScripts/GERA_ESTOQUE_NOTAFISCAL.sqlRecebe I_CD_VENDEDOR para movimentar estoque
CONFIRMA_ORDEMSERVICOScripts/CONFIRMA_ORDEMSERVICO.sqlDeclara V_CD_VENDEDOR na confirmação de OS
ENDERECOPESSOA_BI0Scripts/ENDERECOPESSOA_BI0.sqlTrigger que verifica NEW.CD_VENDEDOR