Matéria-Prima¶

MKI > Cadastros > Matéria-Prima

Visão Geral¶

A tela de Matéria-Prima no MKI é uma view especializada do cadastro de produtos do Master Key, focada nos insumos. Ela não cria uma tabela própria — todos os dados são lidos e gravados na tabela PRODUTOS e FILIALPROD (estoque por filial), as mesmas usadas pelo MK.

Serve para que o operador do MKI consulte e atualize dados de insumos sem precisar abrir o Master Key completo. O campo de preço de custo só é exibido se o usuário tiver a permissão do módulo 125 no MK.

A tela possui duas abas: - Consulta — grid de pesquisa por texto com modo simples e avançado - Cadastro — dados do produto selecionado (com sub-aba de estoque por filial)

Campos e Banco de Dados¶

Dados do Produto (`PRODUTOS`)¶

Campo na Tela	Tabela.Campo Banco	Para que serve	Onde Afeta	Regras
Código	`PRODUTOS.PR_CODIGO`	Identificador único do produto/insumo	PK em toda a base; referenciado na composição e ordens	Inteiro, obrigatório.
Código de Barras	`PRODUTOS.PR_CODBARRA`	Código de barras/EAN do produto	Leitura por scanner	Opcional.
Nome	`PRODUTOS.PR_NOME`	Nome completo do produto	Usado em todos os relatórios e pesquisas	Obrigatório.
Nome Resumido	`PRODUTOS.PR_NOMERES`	Nome curto para exibição em telas pequenas	PDV e etiquetas	Opcional.
Grupo	`PRODUTOS.PR_GRUPO` → `GRUPOS.GR_CODIGO`	Classificação do produto por grupo	Filtro no MKI por `GRUPOMP`; relatórios agrupados	FK para `GRUPOS`.
Subgrupo	`PRODUTOS.PR_SUBGRUPO`	Subclassificação	Relatórios	—
Unidade	`PRODUTOS.PR_UNIDADE`	Unidade de medida (un, kg, L, etc.)	Quantidade nas ordens de produção	Obrigatório.
Preço de Custo	`PRODUTOS.PR_PRECOCUST`	Custo atual do insumo	Compõe o custo da composição e é atualizado no fechamento se `ATLZ_CUSTO_PRODUCAO = 'S'`	Visível apenas com permissão módulo 125 (MK).
Inativo	`PRODUTOS.PR_INATIVO`	Marca o produto como inativo	`'S'` = produto não aparece na composição nem nas ordens; linha exibida em vermelho na grid	`'S'`/`'N'`.

Estoque por Filial (`FILIALPROD`)¶

Campo na Tela	Tabela.Campo Banco	Para que serve	Onde Afeta	Regras
Saldo Atual	Calculado via `SaldoEstoque(PF_PRODUTO, PF_FILIAL)`	Estoque disponível do insumo na filial	Exibido no painel inferior da tela como lembrete para o operador	Calculado em tempo real; não editável nesta tela.
Saldo Inicial	`FILIALPROD.PF_SALDINI`	Saldo inicial do período	Relatórios de movimentação	—
Estoque Mínimo	`FILIALPROD.PF_ESTMINI`	Alerta de reposição	Relatórios de estoque	—
Preço de Custo (filial)	`FILIALPROD.PF_PRECOCUST`	Custo por filial (se diferente do padrão)	—	—
Data de Atualização	`FILIALPROD.PF_DTATLZ`	Última atualização do estoque	Auditoria	—

Regras de Negócio¶

Filtro por Grupo de Matéria-Prima¶

O sistema aplica automaticamente o filtro PR_GRUPO = GRUPOMP (parâmetro configurado em Parâmetros Especiais) em todas as consultas desta tela. Isso garante que só apareçam produtos cadastrados como matérias-primas do cliente.

Se GRUPOMP estiver vazio (não configurado), todos os produtos são listados sem restrição de grupo.

Consulta paginada¶

Se o parâmetro CONSPAG = 'S' estiver ativo (em PARAMESP do MK), a consulta carrega os registros em pacotes de QTDITENSPAG itens para evitar travamentos com bases grandes.

Consulta automática ao abrir¶

Se CONS_AUTO = 'S' (em PARAMESP), ao abrir a tela o sistema já executa a consulta automaticamente sem precisar pressionar o botão Pesquisar.

Pesquisa avançada¶

A aba Avançada da pesquisa permite montar filtros com múltiplos critérios (E/OU) sobre qualquer campo de PRODUTOS (código, nome, grupo, NCM, referência, etc.), gerando dinamicamente a cláusula WHERE da query.

Filtros rápidos na consulta¶

Todos — sem filtro (PR_INATIVO irrelevante)
Somente Ativos — PR_INATIVO = 'N' ou nulo
Somente Inativos — PR_INATIVO <> 'N'

Integrações e Lookups¶

Ação	Origem
F3 na consulta	`SELECT * FROM PRODUTOS WHERE PR_CODIGO > 0` filtrado por `PR_GRUPO = GRUPOMP`
Sub-aba de movimentação	`FILIALPROD` filtrado pela filial logada (`PF_FILIAL = aFilial`)
Saldo exibido no rodapé	`SaldoEstoque(PF_PRODUTO, PF_FILIAL, False)` — função padrão do sistema

Passo a Passo do Usuário¶

Como consultar o saldo de um insumo?¶

Acesse Cadastros → Matéria-Prima.
Digite parte do nome no campo de pesquisa e clique Pesquisar (ou F3).
Dê duplo clique no produto desejado.
O saldo disponível aparece no rodapé da tela na seção de estoque por filial.

Como verificar o custo de uma matéria-prima?¶

Localize o produto conforme acima.
O campo Preço de Custo fica visível se o usuário tiver permissão no módulo 125. Caso contrário, o campo não aparece.

Perguntas frequentes do suporte¶

"O produto que eu cadastrei no MK não aparece aqui no MKI" → Verifique se o produto pertence ao grupo configurado em GRUPOMP (Parâmetros Especiais do MKI). Se o cliente usa grupo de MP específico, apenas esses produtos aparecem.

"O campo de custo não aparece" → O campo PR_PRECOCUST só é exibido para usuários com permissão no módulo 125 do Master Key (TestaModulo(125, oUsuario, '', false, 'MK')). Verifique as permissões do usuário no MK.

"Produto inativo aparece em vermelho na lista" → Correto. PR_INATIVO = 'S' exibe a linha em fundo vermelho. O produto inativo não aparece nas pesquisas de composição/ordens de produção.