Pular para o conteúdo principal

CD_ITEMPADRAO - Item Padrão (Abertura Automática de Tela de Produto)

Tela de configuração: MFA001 - Parâmetros de Faturamento Localização: Operação 1 → campo "Item Padrão" Tabela: PARMFATUR.CD_ITEMPADRAO (INTEGER) Valor padrão: Nenhum (campo vazio)

Telas impactadas​

TelaArquivoEfeito
MFA001source/MFA001/UMFA001.pasConfiguração do item padrão
MNF017source/MNF017/UMNF017.pasAo lançar item na NF, se o item corresponder ao CD_ITEMPADRAO ou pertencer à mesma seção (CD_SECAO), abre automaticamente a tela complementar frmMNF017Produto

Campos envolvidos​

CampoTabelaDescrição
CD_ITEMPADRAOPARMFATURCódigo do item padrão cadastrado
DS_ITEMPARMFATURDescrição do item (preenchida automaticamente via JOIN com ITEM)
CD_ITEMITEMCódigo do produto no cadastro
ST_ATIVOITEMSituação do produto (S = Ativo)
TP_ITEMITEMTipo do item (S = Serviço)
CD_SECAOPARMFATUR / ITEMSeção do item; usada como critério adicional na MNF017

Opções disponíveis​

Trata-se de um campo numérico de código de produto (sem opções fixas). O comportamento depende de o campo estar preenchido ou vazio.

O que fazDetalhe
Preenchido com código de produto ativo (não-serviço)Ao lançar esse item (ou item da mesma seção) em uma nota fiscal na tela MNF017, o sistema abre automaticamente a tela complementar frmMNF017Produto.
VazioNenhuma tela complementar é aberta automaticamente no lançamento de itens.
Produto inativoRejeitado na validação com a mensagem "O Produto Não Está Ativo!".
ServiçoRejeitado na validação com a mensagem "Não é Permito Selecionar um Serviço!".
Código inexistenteRejeitado na validação com a mensagem "Produto Não Cadastrado!".

Configuração do Item Padrão​

Simulação passo a passo​

  1. Acesse MFA001 - Parâmetros de Faturamento.
  2. Na aba Operação 1, localize o campo Item Padrão (ao lado da descrição do item).
  3. Digite o código do produto desejado ou pressione <F9> para abrir a busca de produtos.
  4. Selecione o produto na lista de pesquisa.
  5. Salve os parâmetros.

Exceção / Importante: O campo só aceita produtos ativos (ST_ATIVO = 'S') que não sejam serviços (TP_ITEM <> 'S'). Produtos inativos, serviços ou códigos inexistentes são bloqueados na validação.

Resultado esperado: O item padrão fica cadastrado e será utilizado como gatilho na tela de Nota Fiscal (MNF017) para abrir a tela complementar de dados do produto sempre que o item informado corresponder ao CD_ITEMPADRAO ou pertencer à mesma seção configurada em CD_SECAO da PARMFATUR.

Uso automático na Nota Fiscal (MNF017)​

Simulação passo a passo​

  1. Abra MNF017 - Nota Fiscal e inicie um novo documento.
  2. Inclua um item na nota fiscal.
  3. Se o código do item digitado for igual ao CD_ITEMPADRAO ou pertencer à mesma seção definida em CD_SECAO (configurado em MFA001), a tela complementar frmMNF017Produto será exibida automaticamente.
  4. Preencha os dados adicionais do produto na tela complementar e confirme.
  5. Continue o lançamento normal da nota fiscal.

Resultado esperado: Quando o item lançado na nota fiscal corresponde ao item padrão (ou à mesma seção), o sistema abre automaticamente uma tela de complemento de dados do produto, permitindo informações adicionais antes de prosseguir.

Exceção / Importante: O gatilho considera dois critérios em conjunto: (1) o item corresponder ao CD_ITEMPADRAO da PARMFATUR; ou (2) o item pertencer à mesma seção (CD_SECAO) configurada na PARMFATUR. Basta que um dos dois seja verdadeiro para que a tela complementar seja aberta.

Regra de validação​

Na tela MFA001, ao informar o valor no campo CD_ITEMPADRAO, o sistema executa automaticamente a validação (OnValidate):

  1. Consulta a tabela ITEM pelo código informado.
  2. Verifica se o produto existe.
  3. Verifica se ST_ATIVO = 'S'.
  4. Verifica se TP_ITEM <> 'S' (não pode ser serviço).
  5. Preenche automaticamente DS_ITEM com a descrição do produto.

Se o campo for limpo, a descrição também é limpa.

Procedures impactadas​

Rotinas Delphi com referência direta ao campo​

RotinaArquivoDescrição
edtCD_ITEMPADRAO3KeyDownsource/MFA001/UMFA001.pas:1723Abre busca de produto (<F9>) e preenche o campo
tabPARMFATURCD_ITEMPADRAOValidatesource/MFA001/UdmMFA001.pas:1408Valida se o item existe, está ativo e não é serviço
TfrmMNF017.edtSubMensagemKeyDownsource/MNF017/UMNF017.pas:1123Consulta CD_ITEMPADRAO para abrir tela complementar
TfrmMNF017.edtCD_ITEMKeyDownsource/MNF017/UMNF017.pas:1360Consulta CD_ITEMPADRAO para abrir tela complementar
TfrmMNF017.edtCD_ITEMKeyDownsource/MNF017/UMNF017.pas:1953Consulta CD_ITEMPADRAO para abrir tela complementar

Referências SQL diretas ao campo​

ContextoArquivoEvidência
Consulta na tela CPD009source/CPD009/UdmCPD009.dfm:509SELECT PARMFATUR.CD_ITEMPADRAO, ITEM.DS_ITEM com JOIN ITEM ON CD_ITEM = CD_ITEMPADRAO
Insert na PARMFATURsource/MFA001/UdmMFA001.dfm:2522:CD_ITEMPADRAO
Update na PARMFATURsource/MFA001/UdmMFA001.dfm:2663CD_ITEMPADRAO = :CD_ITEMPADRAO

Candidatas por uso da tabela​

As procedures SQL abaixo utilizam a tabela PARMFATUR, mas não referenciam diretamente o campo CD_ITEMPADRAO. Impacto funcional direto não foi identificado.

Procedures: ATUALIZA_PESSOA, ATUALIZA_PRECOVENDA, BUSCAPRECORECAP, CALCULA_CENTRORESULT, CALCULA_CENTRORESULTITEM, CALCULA_COMISSAO, CALCULA_COMISSAO_V2, CALCULA_JUROVENDA, CALCULA_MAQUINA, CALCULA_MAQUINAFICHA, CANCELA_MESTRA, CANCELA_NOTAFISCAL, CONFIRMA_ORDEMSERVICO, CONFIRMA_ORDEMSERVICOMETAL, CONSOME_LOTEMATERIAPRIMA, CREDITOPERIODICO_AI0, CREDITOPERIODICOGRUPO_AI0, EXPORTACAO_ALLABOR, EXPORTACAO_DOMINIOCADASTROS, EXPORTACAO_DOMINIOCUPOM.