Modelo de Lista de Produtos

Tela de configuração: MFA001 - Parâmetros de Faturamento Localização: Parâmetros → Faturamento → Opção 1 Tabela: PARMFATUR.TP_LISTAITEM Valor padrão: A (Desc. Produto, Preço e Estoque)

Telas impactadas

Este parâmetro é utilizado por mais de 130 módulos do sistema. Principais módulos impactados:

Módulo	Código	Descrição
Cadastro de Produto	TPO001	Cadastro de produtos (F9 pesquisa)
Cadastro de Produto (Outro)	TPO021	Cadastro auxiliar
Pedido de Venda	MPD002	Pedidos de venda
Pedido de Venda (Mobile)	MPD020	Pedido mobile
Pedido de Compra	MPD001	Pedidos de compra
Orçamento	MPD018	Orçamentos
Ordem de Produção	MPD053, MPD092	Produção
NF Saída	MNF002	Emissão de NF saída
NF Entrada	MNF001	NF entrada
NF Devolução/Outra	MNF007	NF devolução
NF Entrada (Mobile)	MNF008-MNF019	NF mobile
NF Troca/Diferença	MNF026	Frente de caixa
Ordem de Serviço	MOF001-MOF006	Ordens de serviço
Transporte	MTR008, MTR009	Transporte
Relatórios Pedido	RPD012, RPD027	Relatórios
Relatórios NF	RNF006	Relatório NF
Relatórios OS	ROF007	Relatório OS
Relatórios Transporte	RTR007-RTR014	Relatórios transporte
Consultas/Requisições	REQ001-REQ036	Consultas diversas
Equipamentos	CEQ001, CEQ005, CEQ018	Equipamentos
Manutenção Equip.	MEQ002-MEQ074	Manutenção
Config NF	CNF005, CNF006	Configuração NF
Compras/Pedido	CPD002, CPD003	Compras
Comissão	MCO008	Comissão
Histórico Pedido	HistoricoPedido	Histórico

Procedures impactadas

Nenhuma procedure SQL referencia TP_LISTAITEM. O parâmetro é utilizado exclusivamente na camada de aplicação (Delphi) para definir qual formulário de pesquisa de produto será exibido.

Campos envolvidos

Campo	Descrição
DS_ITEM	Descrição do produto (exibido em todas as listas)
VL_PRECO	Preço do produto (exibido nos grupos ADG e BEH)
QT_ESTOQUE / O_QT_SALDO	Estoque do produto (exibido no grupo ADG)
CD_CODIGOBARRA	Código de barras (exibido nos grupos D, E, F)
CD_FORNECEDOR1	Código do fornecedor (exibido nos grupos G, H, I)
CD_TABPRECO	Tabela de preço vinculada

---

Opções disponíveis

Grupo ADG - Lista com Descrição, Preço e Estoque

As opções A, D e G compartilham o mesmo formulário de busca (ITEM_PRECO_ESTOQUE) que exibe descrição, preço e estoque do produto. A diferença está nas colunas adicionais exibidas.

A - Desc. Produto, Preço e Estoque

O que faz	Detalhe
Formulário de busca	ITEM_PRECO_ESTOQUE
Colunas exibidas	Descrição do produto, Preço, Estoque
Informações extras	Nenhuma

D - Desc. Produto + Cód. Barras, Preço e Estoque

O que faz	Detalhe
Formulário de busca	ITEM_PRECO_ESTOQUE
Colunas exibidas	Descrição do produto, Código de Barras, Preço, Estoque
Diferença de 'A'	Inclui coluna de código de barras

G - Desc. Produto + Cód. Fornec., Preço e Estoque

O que faz	Detalhe
Formulário de busca	ITEM_PRECO_ESTOQUE
Colunas exibidas	Descrição do produto, Código Fornecedor, Preço, Estoque
Diferença de 'A'	Inclui coluna de código do fornecedor

Simulação passo a passo (A)

1. Vá em MFA001 → Parâmetros → Faturamento → Opção 1 → TP_LISTAITEM = "Desc. Produto, Preço e Estoque"
2. Salve os parâmetros (F6)
3. Abra um Pedido de Venda (MPD002)
4. Pressione F9 no campo de produto → Abre lista com 3 colunas: Descrição, Preço, Estoque
5. Selecione um produto → Retorna o código do item

Resultado esperado: Lista padrão com descrição, preço e saldo em estoque.

Este é o valor padrão ao criar um novo registro no MFA001.

---

Grupo BEH - Lista com Descrição e Preço (sem Estoque)

As opções B, E e H compartilham o formulário de busca (ITEM_PRECO) que exibe descrição e preço (sem estoque).

B - Desc. Produto e Preço

O que faz	Detalhe
Formulário de busca	ITEM_PRECO
Colunas exibidas	Descrição do produto, Preço
Diferença de 'A'	Sem coluna de estoque

E - Desc. Produto + Cód. Barras e Preço

O que faz	Detalhe
Formulário de busca	ITEM_PRECO
Colunas exibidas	Descrição do produto, Código de Barras, Preço
Diferença de 'B'	Inclui coluna de código de barras

H - Desc. Produto + Cód. Fornec. e Preço

O que faz	Detalhe
Formulário de busca	ITEM_PRECO
Colunas exibidas	Descrição do produto, Código Fornecedor, Preço
Diferença de 'B'	Inclui coluna de código do fornecedor

Simulação passo a passo (B)

1. MFA001 → TP_LISTAITEM = "Desc. Produto e Preço"
2. Salve os parâmetros (F6)
3. Abra um Pedido de Venda
4. Pressione F9 no campo de produto → Abre lista com 2 colunas: Descrição e Preço (sem estoque)

Resultado esperado: Lista simplificada sem informação de estoque. Útil quando o usuário não precisa ver o saldo ao pesquisar.

---

Grupo CFI - Lista apenas com Descrição (sem Preço e sem Estoque)

As opções C, F e I compartilham o formulário de busca (ITEM) que exibe apenas a descrição do produto.

C - Descrição Produto

O que faz	Detalhe
Formulário de busca	ITEM
Colunas exibidas	Apenas Descrição do produto
Diferença de 'A'	Sem preço e sem estoque

F - Descrição Produto + Cód. Barras

O que faz	Detalhe
Formulário de busca	ITEM
Colunas exibidas	Descrição do produto, Código de Barras
Diferença de 'C'	Inclui coluna de código de barras

I - Descrição Produto + Cód. Fornec.

O que faz	Detalhe
Formulário de busca	ITEM
Colunas exibidas	Descrição do produto, Código Fornecedor
Diferença de 'C'	Inclui coluna de código do fornecedor

Simulação passo a passo (C)

1. MFA001 → TP_LISTAITEM = "Descrição Produto"
2. Salve os parâmetros (F6)
3. Abra um Pedido de Venda
4. Pressione F9 no campo de produto → Abre lista com apenas 1 coluna: Descrição

Resultado esperado: Lista mínima com apenas a descrição. Usuário seleciona pelo nome sem ver preço ou estoque.

---

S - Agrupado por Seção

O que faz	Detalhe
Formulário de pesquisa	CarregarListaProduto (UListaProduto)
Estrutura	Árvore organizada por Seção → Grupo → Subgrupo
Filtros disponíveis	Grupo, Subgrupo, Seção, Marca, Código de Barras
Informações exibidas	Descrição, Preço, Estoque, Preço por tabela
Tipo de seleção	Seleção única

Simulação passo a passo

1. MFA001 → TP_LISTAITEM = "Agrupado por Seção"
2. Salve os parâmetros (F6)
3. Abra um Pedido de Venda
4. Pressione F9 no campo de produto → Abre formulário com árvore de seções
5. Expanda uma seção → Lista os produtos com preço e estoque
6. Selecione um produto → Retorna o código

Resultado esperado: Interface em árvore com navegação por seções (Grupo/Subgrupo/Seção), facilitando a busca por categoria.

---

J - Agrupado por Seção/Marca

O que faz	Detalhe
Formulário de pesquisa	CarregarListaSecaoMarca (UListaSecaoMarca)
Estrutura	Árvore organizada por Seção com filtro por Marca
Filtros disponíveis	Grupo, Subgrupo, Seção, Marca, Código de Barras, Fornecedor
Informações extras	NCM, Códigos Alternativos, Cód. Fornecedor, Aplicação
Imagens	Suporta visualização de imagem do produto
Tipo de seleção	Seleção única

Simulação passo a passo

1. MFA001 → TP_LISTAITEM = "Agrupado por Seção/Marca"
2. Salve os parâmetros (F6)
3. Abra um Pedido de Venda
4. Pressione F9 → Abre formulário com árvore de seções + filtro de marca
5. Filtre por marca → Lista produtos da marca selecionada
6. Visualize detalhes → NCM, códigos alternativos, aplicação

Resultado esperado: Interface avançada em árvore com filtros por marca, informações adicionais como NCM e códigos alternativos, e suporte a imagens.

---

M - Peças por Modelo

O que faz	Detalhe
Formulário de pesquisa	CarregarListaPeca (UListaPeca) via PesquisaPeca
Estrutura	Lista de peças com seleção por checkbox
Filtros disponíveis	Marca, Grupo, Subgrupo, Seção
Informações exibidas	Descrição, Preço, Estoque
Tipo de seleção	Múltipla (permite selecionar várias peças)
Imagens	Suporta visualização de imagem do produto
Atenção	Na função PesquisarProduto, o valor 'M' é substituído por 'C' (lista simples) automaticamente

Simulação passo a passo

1. MFA001 → TP_LISTAITEM = "Peças por Modelo"
2. Salve os parâmetros (F6)
3. Abra uma Ordem de Serviço (MOF001)
4. Adicione peças → O módulo MOF001/MOF005 chama PesquisaPeca diretamente, ignorando a substituição

Resultado esperado: Nas Ordens de Serviço (MOF001, MOF005), a busca de peças usa o formulário especial com seleção múltipla e filtros por modelo. Nos demais módulos, cai no comportamento da opção 'C' (lista simples).

Nota: Este modo é destinado ao contexto de OS/peças. Módulos como MOF001 e MOF005 chamam PesquisaPeca diretamente em vez de PesquisarProduto, garantindo o funcionamento correto.

---

P - Seleção Múltipla de Produtos

O que faz	Detalhe
Formulário de pesquisa	CarregarListaProdutoAvancada (UListaProdutoAvancada)
Estrutura	Dois grids: resultado da pesquisa (cima) + produtos selecionados (baixo)
Tipo de seleção	Múltipla (permite adicionar vários produtos de uma vez)
Grid superior	Resultados da pesquisa com colunas configuráveis (via FER007)
Grid inferior	Produtos selecionados com colunas de Qt e Ps Entrega
Atenção	Na função PesquisarProduto, se iOperacao = topEntrada (entradas/compras), 'P' é substituído por 'C'

Simulação passo a passo

1. MFA001 → TP_LISTAITEM = "Seleção Múltipla de Produtos"
2. Salve os parâmetros (F6)
3. Abra um Pedido de Venda
4. Pressione F9 → Abre formulário com dois grids
5. Pesquise produtos no grid superior
6. Adicione vários produtos ao grid inferior (seleção múltipla)
7. Informe Qt e Ps Entrega para cada produto selecionado
8. Confirme → Retorna lista de produtos com quantidades

Resultado esperado: Permite adicionar múltiplos produtos de uma só vez, agilizando a criação de pedidos grandes.

Exceção: Em módulos de entrada (NF entrada, pedido de compra), a seleção múltipla é substituída pela lista simples (opção 'C').

---

K - Agrupado por Seção c/ Imagem Seção

O que faz	Detalhe
Formulário de pesquisa	CarregarSecaoImagem (UListaSecaoImagem)
Estrutura	Lista de seções com imagem da seção e visualizador de imagem do produto
Informações exibidas	Descrição, Preço, Estoque, Saldo por empresa
Imagens	Imagem da seção + imagem do produto (BMP/JPG/PNG/GIF)
Tipo de seleção	Seleção única
Parâmetro adicional	Respeita ST_VALIDAITEMEMPRESA para filtrar por empresa

Simulação passo a passo

1. MFA001 → TP_LISTAITEM = "Agrupado por Seção c/ Imagem Seção"
2. Salve os parâmetros (F6)
3. Abra um Pedido de Venda
4. Pressione F9 → Abre formulário com lista de seções e imagens
5. Selecione uma seção → Exibe produtos com imagens e preços
6. Visualize a imagem do produto → Aba de imagem dedicada

Resultado esperado: Interface visual com imagens das seções e dos produtos, ideal para catálogos visuais e vendedores externos.

---

Regra Geral de Substituição

A função PesquisarProduto (em ) aplica as seguintes substituições automáticas:

Condição	Valor Original	Substituído Para	Motivo
iOperacao = topEntrada e iTpLista = 'P'	P	C	Seleção múltipla não permitida em entradas
iTpLista = 'M' (qualquer operação)	M	C	Peças por modelo usa formulário próprio via PesquisaPeca

---

Tabela Comparativa Resumida

Opção	Descrição	Grupo	Busca	Preço?	Estoque?	Cód. Barras?	Cód. Fornec?	Seleção múltipla?	Imagem?
A	Desc. Produto, Preço e Estoque	ADG	ITEM_PRECO_ESTOQUE	Sim	Sim	Não	Não	Não	Não
B	Desc. Produto e Preço	BEH	ITEM_PRECO	Sim	Não	Não	Não	Não	Não
C	Descrição Produto	CFI	ITEM	Não	Não	Não	Não	Não	Não
D	Desc. + Cód. Barras, Preço e Estoque	ADG	ITEM_PRECO_ESTOQUE	Sim	Sim	Sim	Não	Não	Não
E	Desc. + Cód. Barras e Preço	BEH	ITEM_PRECO	Sim	Não	Sim	Não	Não	Não
F	Descrição + Cód. Barras	CFI	ITEM	Não	Não	Sim	Não	Não	Não
G	Desc. + Cód. Fornec., Preço e Estoque	ADG	ITEM_PRECO_ESTOQUE	Sim	Sim	Não	Sim	Não	Não
H	Desc. + Cód. Fornec. e Preço	BEH	ITEM_PRECO	Sim	Não	Não	Sim	Não	Não
I	Descrição + Cód. Fornec.	CFI	ITEM	Não	Não	Não	Sim	Não	Não
S	Agrupado por Seção	-	CarregarListaProduto	Sim	Sim	Não	Não	Não	Não
J	Agrupado por Seção/Marca	-	CarregarListaSecaoMarca	Sim	Sim	Não	Não	Não	Sim
M	Peças por Modelo	-	CarregarListaPeca*	Sim	Sim	Não	Não	Sim	Sim
P	Seleção Múltipla	-	CarregarListaProdutoAvancada	Sim	Sim	Não	Não	Sim	Não
K	Agrup. por Seção c/ Imagem	-	CarregarSecaoImagem	Sim	Sim	Não	Não	Não	Sim

*M via PesquisarProduto cai em 'C'. M via PesquisaPeca (MOF001/MOF005) usa o formulário especial.

---