NR_SEQUENCIA — Sequência do Parâmetro de Vendedor

Tela de configuração: MFA007 — Parâmetros de Vendedor Tabela: PARMVENDEDOR.NR_SEQUENCIA (DOM_INTEGER NOT NULL) Chave primária: PK_PARMVENDEDOR Controle na tela: edtNR_SEQUENCIA (somente leitura, cor cinza)

Resumo

NR_SEQUENCIA é o identificador único (chave primária) de cada registro na tabela PARMVENDEDOR. Não é um parâmetro de comportamento configurável pelo usuário — seu valor é gerado automaticamente pelo gerador de sequência SEQ_PARMVENDEDOR no momento da inclusão de um novo registro.

Campos envolvidos

Campo	Tipo	Obrigatório	Descrição
NR_SEQUENCIA	DOM_INTEGER	Sim	Chave primária auto-gerada
CD_VENDEDOR	DOM_INTEGER	Sim	Vendedor vinculado
CD_REGIAOCOMERCIAL	DOM_INTEGER	Não	Região comercial (filtro)
CD_PESSOA	DOM_INTEGER	Não	Pessoa/Cliente (filtro)
CD_GRUPO	DOM_INTEGER	Não	Grupo de produto (filtro)
CD_MARCA	DOM_INTEGER	Não	Marca (filtro)
CD_ITEM	DOM_INTEGER	Não	Produto (filtro)
DT_REGISTRO	DOM_TIMESTAMP_NOW	Sim	Data/hora de registro

Comportamento

O que faz	Detalhe
Geração automática	Ao incluir um novo registro, se NR_SEQUENCIA estiver vazio, o sistema chama GERA_SEQUENCIA(NULL, 'SEQ_PARMVENDEDOR') e atribui o retorno
Somente leitura na tela	O campo edtNR_SEQUENCIA possui ReadOnly = True e cor de fundo cinza (15658734)
Não editável	O usuário não pode alterar o valor manualmente

Simulação passo a passo

1. Acesse a tela MFA007 — Parâmetros de Vendedor.
2. Clique em Incluir para criar um novo registro.
3. Preencha os campos de filtro (Vendedor, Região Comercial, Grupo, Marca, Item e/ou Pessoa).
4. Salve o registro.
5. O campo Sequência será preenchido automaticamente com o próximo número disponível.

Resultado esperado: O campo NR_SEQUENCIA exibe o número sequencial gerado automaticamente e não pode ser modificado pelo usuário.

Exceção / Importante: Se o gerador SEQ_PARMVENDEDOR retornar uma mensagem de erro (campo V_DS_MENSAGEM preenchido), o sistema interrompe a gravação e exibe o erro ao usuário. O sistema também exige que ao menos um filtro esteja preenchido (Região Comercial, Grupo, Pessoa ou Produto).

Procedures impactadas

Referências SQL indiretas (uso da tabela PARMVENDEDOR)

Procedure/View	Arquivo	Evidência
ATUALIZA_PESSOA	Scripts/ATUALIZA_PESSOA.sql	Atualiza CD_PESSOA em PARMVENDEDOR quando há troca de código de pessoa

A procedure ATUALIZA_PESSOA referencia a tabela PARMVENDEDOR mas não utiliza o campo NR_SEQUENCIA diretamente — apenas atualiza o campo CD_PESSOA quando o código de uma pessoa é alterado.

Rotinas Delphi

Rotina	Arquivo	Evidência
TdmMFA007.tabPARMVENDEDORBeforePost	source/MFA007/UdmMFA007.pas	Gera o valor de NR_SEQUENCIA via GERA_SEQUENCIA(NULL, 'SEQ_PARMVENDEDOR') quando o campo está vazio

Não foram encontradas referências diretas ao campo NR_SEQUENCIA da tabela PARMVENDEDOR em outros scripts SQL além da definição do schema.