CD_HISTORICOENTRADACONF - Histórico de Entrada na Conferência

Tela de configuração: MFA001 — Parâmetros de Faturamento Localização: aba Conferência, visível quando TP_MOVTOESTOQUE = "Quantidade Conferida" Tabela: PARMFATUR.CD_HISTORICOENTRADACONF (INTEGER) Campo de busca: edtCD_HISTORICOENTRADACONF (TDBEdit) FK: HISTORICO (CD_HISTORICO)

Telas impactadas

Tela	Descrição
MFA001	Parâmetros de Faturamento — configuração do parâmetro
MNF035	Conferência de Nota de Entrada — uso na finalização da conferência

Campos envolvidos

Campo	Tabela	Tipo	Observação
CD_HISTORICOENTRADACONF	PARMFATUR	INTEGER	Código do histórico de entrada
DS_HISTORICOENTRADACONF	PARMFATUR	—	Descrição preenchida automaticamente via validação
CD_HISTORICO	HISTORICO	INTEGER	Tabela referenciada (FK)
TP_MOVTOESTOQUE	PARMFATUR	CHAR(1)	Controla visibilidade do campo (C = Quantidade Conferida)
ST_CONFNOTAENTRADA	PARMFATUR	CHAR(1)	Controla visibilidade do combo TP_MOVTOESTOQUE (S = visível)

Opções disponíveis

Trata-se de um campo numérico livre que aceita qualquer código de histórico válido do tipo Estoque. Não há opções fixas (como S/N), mas sim regras de preenchimento e validação.

O que faz	Detalhe
Visibilidade	Campo e label só ficam visíveis quando o combo TP_MOVTOESTOQUE (configurado na mesma aba) estiver com o valor "Quantidade Conferida" (C)
Preenchimento	Editável — digite o código ou pressione <F9> para abrir a busca de históricos
Validação obrigatória	O histórico informado deve ser do tipo "Estoque" (TP_HISTORICO = 'E'). Caso contrário, o sistema exibe erro e bloqueia a gravação
FK	Referencia HISTORICO (CD_HISTORICO)

Preenchimento do campo

Simulação passo a passo

1. Acesse a tela MFA001 — Parâmetros de Faturamento.
2. Vá para a aba Conferência.
3. No campo "Movimento de Estoque na Conferência" (TP_MOVTOESTOQUE), selecione a opção "Quantidade Conferida". Os campos de operação e histórico (entrada e saída) tornam-se visíveis.
4. Posicione o cursor no campo "Conferência de Nota de Entrada".
5. Digite o código do histórico desejado (ex.: 15) ou pressione <F9> para abrir a janela de busca de Histórico de Estoque.
6. Se usou <F9>, selecione o histórico na lista e confirme.
7. A descrição do histórico é preenchida automaticamente ao lado do campo.
8. Salve os parâmetros.

Resultado esperado: O código do histórico de entrada fica gravado em PARMFATUR.CD_HISTORICOENTRADACONF e será utilizado na tela MNF035 ao finalizar conferências de nota de entrada com diferença positiva (sobras).

Exceção / Importante:

• Se o histórico informado não for do tipo "Estoque" (TP_HISTORICO <> 'E'), o sistema exibe a mensagem: "O histórico informado não é do tipo 'Estoque'! Verifique [TCB003]" e bloqueia a gravação.
• Se TP_MOVTOESTOQUE estiver como "Quantidade NF" (N), este campo fica oculto e não é utilizado.
• O campo TP_MOVTOESTOQUE só fica visível quando ST_CONFNOTAENTRADA = 'S'.

Regra de uso na Conferência (MNF035)

Na finalização da conferência de nota de entrada (tela MNF035), quando existe diferença positiva (quantidade conferida > quantidade da NF):

• O sistema utiliza CD_HISTORICOENTRADACONF como histórico para gerar o lançamento de estoque de entrada via procedure GERA_ESTOQUE.
• Quando a diferença é negativa (faltas), o sistema utiliza CD_HISTORICOSAIDACONF em vez deste campo.

Condição na conferência	Histórico utilizado	Operação utilizada
Diferença > 0 (sobras)	CD_HISTORICOENTRADACONF	CD_OPERACAOENTRADACONF
Diferença < 0 (faltas)	CD_HISTORICOSAIDACONF	CD_OPERACAOSAIDACONF

Procedures impactadas

Rotinas Delphi com referência direta

Rotina	Arquivo	Descrição
edtCD_HISTORICOENTRADACONFKeyDown	source/MFA001/UMFA001.pas	Abre busca de histórico (<F9>)
cmbTP_MOVTOESTOQUEChange	source/MFA001/UMFA001.pas	Controla visibilidade do campo conforme tipo de movimento
tabPARMFATURCD_HISTORICOENTRADACONFValidate	source/MFA001/UdmMFA001.pas	Valida que o histórico é do tipo Estoque
btnFinalizarConferenciaClick	source/MNF035/UMNF035.pas	Usa o parâmetro ao gerar movimentação de estoque na conferência

Referências SQL diretas ao campo

Nenhuma procedure/view SQL em Scripts/ referencia diretamente o campo CD_HISTORICOENTRADACONF. As procedures listadas como candidatas (por uso da tabela PARMFATUR) não possuem impacto funcional direto comprovado neste parâmetro.

Parâmetros relacionados

Parâmetro	Tela	Relação
TP_MOVTOESTOQUE	MFA001 — aba Conferência	Controla a visibilidade deste campo
CD_OPERACAOENTRADACONF	MFA001 — aba Conferência	Operação de estoque usada em conjunto com este histórico na conferência
CD_HISTORICOSAIDACONF	MFA001 — aba Conferência	Histórico complementar, usado para diferenças negativas
CD_OPERACAOSAIDACONF	MFA001 — aba Conferência	Operação usada para diferenças negativas
ST_CONFNOTAENTRADA	MFA001 — aba Conferência	Habilita o combo TP_MOVTOESTOQUE (pré-requisito)