CD_HISTORICOSAIDACONF - Histórico de Saída na Conferência

Tela de configuração: MFA001 — Parâmetros de Faturamento Localização: aba Conferência, campo Histórico Saída Tabela: PARMFATUR.CD_HISTORICOSAIDACONF (INTEGER, FK → HISTORICO.CD_HISTORICO) Valor padrão: nenhum

Resumo

Define o histórico padrão de estoque utilizado nos lançamentos automáticos de saída gerados ao finalizar uma conferência de nota de entrada, quando a quantidade conferida é menor que a quantidade da nota fiscal (sobras / faltas).

Telas impactadas

Tela	Formulário	Uso
MFA001 — Parâmetros de Faturamento	UMFA001	Configuração do parâmetro
MNF035 — Conferência de Nota de Entrada	UMNF035	Consumo: ao finalizar conferência com diferença negativa

Campos envolvidos

Campo	Tabela	Tipo	Observação
CD_HISTORICOSAIDACONF	PARMFATUR	INTEGER	Código do histórico de saída
CD_HISTORICO	HISTORICO	INTEGER	Tabela referenciada (FK)
TP_HISTORICO	HISTORICO	CHAR(1)	Deve ser 'E' (Estoque)
TP_MOVTOESTOQUE	PARMFATUR	CHAR(1)	Controle de visibilidade: 'C' exibe o campo
ST_CONFNOTAENTRADA	PARMFATUR	CHAR(1)	'S' ativa funcionalidade de conferência
CD_OPERACAOSAIDACONF	PARMFATUR	INTEGER	Operação de estoque de saída usada junto com este histórico

Regras de funcionamento

Visibilidade e edição

O campo só fica visível na aba Conferência quando:

1. ST_CONFNOTAENTRADA = 'S' (conferência de nota ativada); e
2. TP_MOVTOESTOQUE = 'C' (Quantidade Conferida).

Caso contrário, o campo e seu rótulo permanecem ocultos.

Validação ao preencher

Ao informar um código de histórico:

• O sistema valida que o histórico existe e é do tipo Estoque (TP_HISTORICO = 'E'). Se não for, exibe: "O histórico informado não é do tipo 'Estoque'! Verifique [TCB003]".
• O campo de descrição DS_HISTORICOSAIDACONF é preenchido automaticamente.
• Pressione <F9> para abrir a busca de históricos do tipo estoque (HISTORICOESTOQUE).

Uso na conferência (MNF035)

Ao finalizar uma conferência de nota de entrada (btnFinalizarConferenciaClick), o sistema percorre os itens conferidos. Para cada item com diferença:

Situação	Diferença	Operação usada	Histórico usado
Quantidade conferida maior que a da NF	Positiva	CD_OPERACAOENTRADACONF	CD_HISTORICOENTRADACONF
Quantidade conferida menor que a da NF	Negativa	CD_OPERACAOSAIDACONF	CD_HISTORICOSAIDACONF

O sistema chama GERA_ESTOQUE passando o código de operação, o código de histórico, a quantidade da diferença (módulo) e o valor total, gerando um lançamento de estoque com a observação: "Lancto. Ref. NF nº [número] Conferência nº [número]".

Opções disponíveis

O que faz	Detalhe
Define o histórico de estoque para saídas na conferência	Campo editável; aceita qualquer código de histórico do tipo Estoque válido; preenchimento obrigatório quando a conferência está ativa

Simulação passo a passo

1. Acesse a tela MFA001 — Parâmetros de Faturamento.
2. Marque o parâmetro de conferência (ST_CONFNOTAENTRADA = 'S').
3. Na aba Conferência, selecione "Quantidade Conferida" no campo "Tipo de Movto. Estoque" (TP_MOVTOESTOQUE = 'C').
4. Os campos Operação Saída e Histórico Saída serão exibidos.
5. No campo Histórico Saída, digite o código do histórico de estoque desejado ou pressione <F9> para buscar.
6. O sistema preenche automaticamente a descrição ao lado.
7. Salve os parâmetros.

Resultado esperado: Ao finalizar uma conferência de nota de entrada com quantidade conferida menor que a da nota, o sistema gera automaticamente um lançamento de estoque de saída usando a operação definida em CD_OPERACAOSAIDACONF e o histórico definido em CD_HISTORICOSAIDACONF.

Exceção / Importante: Se o campo estiver vazio ao finalizar a conferência (sem histórico informado), o lançamento de estoque será gerado com histórico nulo, o que pode causar erro ou inconsistência. Certifique-se de preencher tanto a operação quanto o histórico de saída.

Parâmetros relacionados

Parâmetro	Descrição	Configurado em
CD_HISTORICOENTRADACONF	Histórico de entrada na conferência (diferença positiva)	MFA001 — aba Conferência
CD_OPERACAOSAIDACONF	Operação de estoque de saída usada junto com este histórico	MFA001 — aba Conferência
CD_OPERACAOENTRADACONF	Operação de estoque de entrada na conferência	MFA001 — aba Conferência
ST_CONFNOTAENTRADA	Ativa/desativa a funcionalidade de conferência de nota	MFA001 — aba Conferência
TP_MOVTOESTOQUE	Define se usa quantidade da NF ou conferida; controla visibilidade	MFA001 — aba Conferência

Procedures impactadas

Rotinas Delphi com referência direta ao campo

Rotina	Arquivo	Descrição
TfrmMFA001.edtCD_HISTORICOSAIDACONFKeyDown	UMFA001.pas	Busca de histórico via <F9>
TfrmMFA001.cmbTP_MOVTOESTOQUEChange	UMFA001.pas	Controla visibilidade do campo conforme TP_MOVTOESTOQUE
TdmMFA001.tabPARMFATURCD_HISTORICOSAIDACONFValidate	UdmMFA001.pas	Validação: histórico deve ser tipo Estoque
TfrmMNF035.btnFinalizarConferenciaClick	UMNF035.pas	Consome o parâmetro ao gerar lançamento de saída na finalização da conferência

Referências SQL diretas ao campo

Não foi encontrada referência direta ao campo CD_HISTORICOSAIDACONF em scripts SQL (Scripts/). O uso está limitado às rotinas Delphi que leem o parâmetro em tempo de execução e o repassam para GERA_ESTOQUE.