CD_PERFILSEMIACABADO - Perfil de Matéria Prima + Semiacabados

Tela de configuração: TPO041 — Parâmetros de Importação de Matéria Prima
Localização: Grupo Perfis → campo Matéria prima + semiacabados
Tabela: PARMIMPMATPRIMA.CD_PERFILSEMIACABADO
Tipo: INTEGER (chave estrangeira para PERFIL.CD_PERFIL)
Valor padrão: Nenhum (NULL) — preenchido via busca de Perfil

Telas impactadas

Tela / Rotina	Impacto
TPO041	Configuração do parâmetro.
Formação de Preço de Venda	Define o perfil esperado para itens classificados como Matéria Prima + Semiacabados durante o cálculo de custo e a validação de itens da ficha técnica.

Campos envolvidos

Campo	Tabela	Descrição
CD_PERFILSEMIACABADO	PARMIMPMATPRIMA	Código do perfil vinculado.
DS_PERFILPERFILSEMIACABADO	PARMIMPMATPRIMA	Descrição do perfil (campo calculado/lookup).
CD_PERFIL	PERFIL	Tabela de origem do lookup.
DS_PERFIL	PERFIL	Descrição do perfil (exibida na tela).

Funcionamento

O parâmetro CD_PERFILSEMIACABADO armazena o código de um Perfil (tabela PERFIL) utilizado para agrupar e validar itens de Matéria Prima e Semiacabados dentro das rotinas de Formação de Preço de Venda. Quando preenchido, o sistema utiliza este vínculo para filtrar e validar os itens da ficha técnica que devem compor o custo desta categoria específica.

O campo é configurado com um TDBEdit que aceita digitação direta do código ou utiliza a tecla <F9> para abrir a busca padrão de Perfis. Ao validar o campo, o sistema consulta a tabela PERFIL; caso não encontre o código informado, exibe a mensagem de erro E-0250.

Opções disponíveis

Este campo não possui opções fixas predefinidas (como S/N). Seu comportamento é definido pelo preenchimento (ou não) de um código de Perfil válido.

Com Perfil Informado

O que faz	Detalhe
Exige código de Perfil	Não, campo opcional.
Edição/Bloqueio	Editável. Aceita digitação manual ou busca via <F9>.
Restrição	O código informado deve existir na tabela PERFIL.

Simulação passo a passo

1. Acesse TPO041 — Parâmetros de Importação de Matéria Prima.
2. Clique no campo Matéria prima + semiacabados.
3. Digite o código de um perfil existente (ex: 10) e pressione Tab para validar.
4. Alternativamente, posicione o cursor no campo e pressione <F9>.
5. Na tela de busca de Perfil, selecione o perfil desejado e confirme.
6. O sistema preencherá automaticamente a descrição do perfil ao lado.
7. Salve o registro.

Resultado esperado: O campo CD_PERFILSEMIACABADO fica preenchido com o código do perfil selecionado. A descrição correspondente (DS_PERFILPERFILSEMIACABADO) é exibida. Rotinas de Formação de Preço de Venda passarão a validar se os itens da ficha técnica possuem este perfil atribuído (via ITEMPERFIL), filtrando os custos de matéria prima e semiacabados por este agrupamento.

Exceção / Importante:

• Se o código digitado não existir na tabela PERFIL, o sistema lança a exceção E-0250 e não permite continuar.
• O funcionamento em conjunto com outros perfis (CD_PERFILEMBALAGEM, CD_PERFILMAODEOBRA1, CD_PERFILMAODEOBRA2, CD_PERFILGASTOSGERAIS, configurados na mesma tela TPO041) define regras distintas para cada categoria de custo.

Sem Perfil (Em Branco)

O que faz	Detalhe
Exige código de Perfil	Não.
Edição/Bloqueio	Editável.
Restrição	Nenhuma.

Simulação passo a passo

1. Acesse TPO041 — Parâmetros de Importação de Matéria Prima.
2. Localize o campo Matéria prima + semiacabados.
3. Limpe o conteúdo do campo (delete o valor existente) e pressione Tab.
4. A descrição do perfil será apagada automaticamente.
5. Salve o registro.

Resultado esperado: O campo fica vazio (NULL). Na procedure RETORNA_STPERFILFORMPRECOVENDA, se todos os perfis (Matéria prima, Embalagem, Mão de obra I/II, Gastos Gerais) estiverem em branco, a procedure retorna O_ST_PERFIL = 'S' (liberado), ou seja, não há filtro de perfil aplicado. Se outros perfis estiverem preenchidos, apenas este grupo não será validado por perfil.

Exceção / Importante:

• Se ao menos um dos cinco perfis estiver preenchido, a validação por perfil será ativada para os demais grupos que tiverem valor configurado. Manter este campo em branco significa que a matéria prima e semiacabados não serão submetidos à validação de perfil.

Regra Geral de Autorização

Sem impacto direto identificado no código para autorização. A tela TPO041 geralmente está disponível para usuários com permissão de acesso ao módulo de produtos/custos.

Tabela Comparativa Resumida

Situação	Comportamento na Formação de Preço de Venda
Perfil preenchido	Valida se o item da ficha técnica possui o perfil via ITEMPERFIL. Custo filtrado por este perfil.
Perfil em branco	Sem validação específica para matéria prima + semiacabados (a menos que todos estejam em branco, liberando geral).

Procedures impactadas

Rotinas Delphi

Rotina	Arquivo	Descrição
edtCD_PERFILSEMIACABADOKeyDown	source/TPO041/UTPO041.pas	Dispara a busca (<F9>) de Perfis e atribui o resultado (result.getParam(0)) ao campo.
tabPARMIMPMATPRIMACD_PERFILSEMIACABADOValidate	source/TPO041/UdmTPO041.pas	Valida o código informado contra a tabela PERFIL, preenche a descrição ou lança exceção E-0250.

Scripts SQL (referência direta ao campo)

Procedure / Script	Arquivo	Função
RETORNA_CUSTOITEMFORMPRECOVENDA	Scripts/RETORNA_CUSTOITEMFORMPRECOVENDA.sql	Lê o parâmetro e define V_CD_PERFIL = CD_PERFILSEMIACABADO quando o tipo de validação for 'S', aplicando o filtro nos custos.
RETORNA_STPERFILFORMPRECOVENDA	Scripts/RETORNA_STPERFILFORMPRECOVENDA.sql	Verifica se o item informado possui associação com o CD_PERFILSEMIACABADO na tabela ITEMPERFIL, retornando O_ST_PERFIL = 'S' quando encontrado.