CD_HISTPERDA - Histórico para Perdas de Produção
Tela de configuração: MEQ001 - Parâmetros de Estoque Localização: Aba "Operações Padrão" → campo "Operações" Tabela:
PARMESTOQUE.CD_HISTPERDATipo: INTEGER (FK paraHISTORICO.CD_HISTORICO) Valor padrão: Nenhum (campo opcional)
Define o código de histórico contábil/gerencial utilizado para classificar movimentações de perda de produção. Quando uma ordem de produção registra perda de material (quebra técnica, refugo, etc.), este histórico é gravado na movimentação de estoque e contábil associada.
Telas impactadas
| Tela | Uso |
|---|---|
| MEQ001 | Cadastro do parâmetro (campo editável na aba Operações Padrão) |
| MEQ066 | Ao marcar "Quebra Técnica", utiliza CD_HISTPERDA como histórico de saída da manutenção/leira |
| CEQ015 | Consulta PARMESTOQUE para obter CD_HISTPERDA junto com parâmetros de produção |
| MEQ020 | Consulta PARMESTOQUE para obter CD_HISTPERDA em rotinas de ordem de produção |
| MEQ044 | Consulta PARMESTOQUE para obter CD_HISTPERDA ao gerar ordens de produção |
| MEQ049 | Busca CD_HISTPERDA em Busca_Parametros para uso interno |
Campos envolvidos
| Campo | Tabela | Função |
|---|---|---|
CD_HISTPERDA | PARMESTOQUE | Código do histórico de perda (INTEGER) |
DS_HISTPERDA | PARMESTOQUE | Descrição do histórico (preenchida automaticamente pelo sistema) |
CD_OPERPRODPERDA | PARMESTOQUE | Operação de perda de produção (complemento — configurado na mesma aba) |
ST_PERDAPRODUCAO | PARMESTOQUE | Flag que habilita registro de perdas na produção (S/N) |
Opções disponíveis
O campo aceita qualquer código de histórico cadastrado na tabela HISTORICO que atenda às seguintes condições:
Código de Histórico Válido (tipo Estoque, ativo)
| O que faz | Detalhe |
|---|---|
| Editável | Sim — campo numérico, digite o código ou pressione <F9> para pesquisar |
| Exige | Histórico cadastrado em HISTORICO com ST_ATIVO = 'S' e TP_HISTORICO = 'E' (Estoque) |
| Restrição | Rejeita históricos inativos ou de tipo diferente de Estoque |
| Preenchimento automático | Ao informar o código, o sistema preenche DS_HISTPERDA com a descrição do histórico |
Simulação passo a passo
- Acesse MEQ001 (Parâmetros de Estoque).
- Navegue até a aba "Operações Padrão".
- Localize o campo "Operações" (label do
edtCD_HISTPERDA). - Pressione
<F9>para abrir a pesquisa. - O sistema exibe a janela "Selecione Histórico" listando apenas históricos com
ST_ATIVO = 'S'eTP_HISTORICO = 'E'(tipo Estoque). - Selecione o histórico desejado (ex: código
50— "Perda de Material"). - O campo
DS_HISTPERDAé preenchido automaticamente com a descrição do histórico selecionado. - Salve o registro.
Resultado esperado: O código do histórico fica gravado em PARMESTOQUE.CD_HISTPERDA. Nas geração de ordens de produção e movimentações de perda, o sistema utiliza este histórico para classificar a movimentação contábil.
Excecao / Importante: Se o histórico informado estiver inativo (
ST_ATIVO = 'N'), o sistema exibe o erro: "O Histório não está Ativo [TCB003]!". Se o tipo do histórico não for Estoque (TP_HISTORICO <> 'E'), exibe: "O Histório deve ser do Tipo Estoque [TCB003]!". Se o código não existir na tabelaHISTORICO, exibe: "O Histório não está Cadastrado [TCB003]!".
Campo em branco (sem histórico configurado)
| O que faz | Detalhe |
|---|---|
| Comportamento | Quando CD_HISTPERDA está vazio, movimentações de perda não possuem classificação de histórico específica |
| Impacto | A procedure GERA_ORDEMPRODUCAO lê o valor de PARMESTOQUE; se nulo, o histórico da movimentação de perda fica sem valor |
| Em MEQ066 | Ao habilitar "Quebra Técnica", o sistema verifica se CD_HISTPERDA está preenchido antes de atribuir ao histórico de saída |
Simulação passo a passo
- Acesse MEQ001 (Parâmetros de Estoque).
- Navegue até a aba "Operações Padrão".
- Deixe o campo "Operações" (
CD_HISTPERDA) em branco. - Salve o registro.
- Gere uma ordem de produção com perda de material.
Resultado esperado: A movimentação de perda é gerada sem código de histórico associado, o que pode impedir a contabilização correta da perda.
Excecao / Importante: Na tela MEQ066 (Manutenção de Ordem de Leira), ao marcar "Quebra Técnica", o sistema atribui
CD_HISTPERDAao campoCD_HISTSAIda manutenção. Se o parâmetro estiver vazio, o histórico de saída da quebra técnica ficará em branco.
Regra Geral de Validação
Ao informar um código no campo CD_HISTPERDA, o sistema executa as seguintes validações na tabela HISTORICO:
- Existência: O código deve existir em
HISTORICO.CD_HISTORICO. - Ativo:
HISTORICO.ST_ATIVOdeve ser'S'. - Tipo Estoque:
HISTORICO.TP_HISTORICOdeve ser'E'.
Procedures impactadas
Rotinas Delphi com referência direta ao campo
| Rotina | Arquivo | Linha | Contexto |
|---|---|---|---|
TdmMEQ001.tabPARMESTOQUECD_HISTPERDAValidate | UMEQ001.pas | 1186 | Validação: verifica existência, ativo e tipo Estoque em HISTORICO |
TfrmMEQ001.edtCD_HISTPERDAKeyDown | UMEQ001.pas | 1585 | Pesquisa <F9>: lista históricos ativos do tipo Estoque |
TfrmMEQ066.chkST_QUEBRATECNICAClick | UMEQ066.pas | 1132 | Atribui CD_HISTPERDA ao CD_HISTSAI da manutenção de leira |
iniciar (MEQ066) | UMEQ066.pas | 238 | Verifica se CD_HISTPERDA está preenchido |
Ordemproducao (CEQ015) | UCEQ015.pas | 156 | Consulta CD_HISTPERDA de PARMESTOQUE |
Ordemproducao (MEQ020) | UMEQ020.pas | 178 | Consulta CD_HISTPERDA de PARMESTOQUE |
TfrmMEQ044.btnORDEMPRODClick | UMEQ044.pas | 919 | Consulta CD_HISTPERDA de PARMESTOQUE |
Busca_Parametros (MEQ049) | UdmMEQ049.pas | 190 | Busca CD_HISTPERDA para uso interno |
Scripts SQL com referência direta ao campo
| Procedure/View | Arquivo | Linha | Contexto |
|---|---|---|---|
GERA_ORDEMPRODUCAO | GERA_ORDEMPRODUCAO.sql | 92, 112, 118, 598, 610, 632, 644 | Declara variável V_CD_HISTPERDA, lê de PARMESTOQUE e utiliza nas movimentações de perda na produção |
Nota: O campo
CD_HISTPERDAtambém existe emPARMFINANC(configurado na tela FNC001 — Parâmetros Financeiros), sendo utilizado pela procedureGERA_MOVTOCONTABILpara determinar complementos de lançamento contábil. São campos distintos em tabelas distintas, apesar do mesmo nome.
Tabela Comparativa Resumida
| Aspecto | Detalhe |
|---|---|
| Tela | MEQ001 — Parâmetros de Estoque |
| Aba | Operações Padrão |
| Tabela | PARMESTOQUE |
| Tipo | INTEGER |
| FK para | HISTORICO.CD_HISTORICO |
| Editável | Sim |
| Valor padrão | Nenhum |
| Validação | Deve existir, estar ativo e ser tipo Estoque |
| Pesquisa | <F9> — filtra HISTORICO com ST_ATIVO = 'S' e TP_HISTORICO = 'E' |
| Preenche campo | DS_HISTPERDA (descrição automática) |
| Impacto principal | Classificação contábil de perdas em ordens de produção |
| Complemento | CD_OPERPRODPERDA (operação de perda na mesma aba) |