CD_HISTPAGTO - Histórico Padrão de Pagamento à Vista

Tela de configuração: MFA001 - Parâmetros de Faturamento Localização: Aba Operação 1 → seção "Movimentos e Operações Padrão" Tabela: PARMFATUR.CD_HISTPAGTO Tipo: INTEGER — código do histórico (FK para HISTORICO.CD_HISTORICO) Valor padrão: nenhum (campo vazio = pagamento à vista desabilitado)

Resumo

Define o histórico contábil padrão utilizado para gerar automaticamente o movimento de caixa de pagamento à vista quando uma nota fiscal de saída é confirmada. Quando preenchido, o sistema liquida o processo de caixa no ato da gravação da nota; quando vazio, abre a tela de caixa para confirmação manual.

Telas impactadas

Tela	Rotina	Efeito
MNF001	Nota Fiscal de Saída	Ao gravar a nota, gera movimento de caixa automático usando este histórico
MTR004	Movimentação (Entrada)	Mesmo comportamento: gera movimento de caixa automático ao confirmar

Campos envolvidos

Campo	Tabela	Descrição
CD_HISTPAGTO	PARMFATUR	Código do histórico de pagamento à vista
DS_HISTPAGTO	HISTORICO (via JOIN)	Descrição do histórico exibida na tela
CD_HISTORICO	HISTORICO	Chave primária da tabela de históricos

Validações na configuração (MFA001)

Ao informar um código no campo, o sistema executa as seguintes validações contra a tabela HISTORICO:

Validação	Condição	Mensagem de erro
Histórico cadastrado	Código não encontrado	"O Histórico não está Cadastrado [TCB003]!"
Natureza	TP_NATUREZA = 'R' (Recebimento)	"A Natureza do Histórico não pode ser de Recebimento!"
Tipo	TP_HISTORICO <> 'V'	"O Tipo do Histórico deve ser Avulso!"
Ativo	ST_ATIVO = 'N'	"O Histórico não está Ativo!"

Resumo das restrições: o histórico deve ser ativo, do tipo Avulso (V) e com natureza Pagamento (P). Natureza de Recebimento (R) é rejeitada.

Opções disponíveis

Campo vazio (não preenchido)

O que faz	Detalhe
Pagamento à vista manual	Sem histórico padrão, o sistema abre a tela de caixa para confirmação manual do processo

Simulação passo a passo

1. Acesse MFA001 → aba Operação 1.
2. Deixe o campo "Histórico Pagamento" vazio.
3. Salve os parâmetros.
4. Na tela MNF001, grave uma nota fiscal de saída cujo pagamento seja à vista.
5. O sistema abrirá a tela de caixa (AbreCaixa) para que o operador confirme o processo manualmente.

Resultado esperado: O processo de caixa é aberto para confirmação manual; o movimento não é gerado automaticamente.

---

Campo preenchido (código de histórico válido)

O que faz	Detalhe
Pagamento à vista automático	O sistema gera automaticamente o movimento de caixa usando o histórico informado, sem intervenção do operador

Simulação passo a passo

1. Acesse MFA001 → aba Operação 1.
2. No campo "Histórico Pagamento", pressione <F9> para abrir a tela de pesquisa.
3. Selecione um histórico ativo (ST_ATIVO = 'S'), do tipo Avulso (TP_HISTORICO = 'V') e com natureza Pagamento (TP_NATUREZA = 'P').
4. O campo será preenchido com o código e a descrição aparecerá ao lado.
5. Salve os parâmetros.
6. Na tela MNF001, grave uma nota fiscal de saída cujo pagamento seja à vista.
7. O sistema chamará GRAVA_MOVTOCAIXA automaticamente, usando o código informado como parâmetro de histórico, com tipo de movimento P (Pagamento) e origem AV (À Vista).

Resultado esperado: O movimento de caixa é gerado e liquidado automaticamente no momento da gravação da nota, sem abrir a tela de caixa.

Exceção / Importante: O histórico informado deve pertencer à tabela HISTORICO e atender às validações de natureza, tipo e situação. Se o código for alterado para um histórico inativo ou com natureza/_tipo inadequado, o sistema recusará a gravação. A pesquisa <F9> já filtra automaticamente ST_ATIVO = 'S', TP_NATUREZA = 'P' e TP_HISTORICO = 'V'.

Regra de funcionamento no MNF001 e MTR004

O comportamento segue a mesma lógica em ambas as telas:

Se CD_HISTPAGTO estiver VAZIO:
    → Abre tela de caixa para confirmação manual (AbreCaixa)
Se CD_HISTPAGTO estiver PREENCHIDO:
    → Executa GRAVA_MOVTOCAIXA automaticamente com o histórico informado

Em ambas as telas, o movimento de caixa gerado usa:

• Tipo de movimento: P (Pagamento)
• Origem: AV (À Vista)
• Pessoa: a pessoa da nota fiscal
• Valor: o valor do processo

Procedures impactadas

Rotinas Delphi com referência direta ao campo

Rotina	Arquivo	Descrição
edtCD_HISTPAGTO2KeyDown	source/MFA001/UMFA001.pas	Pesquisa <F9> de históricos com filtro Pagamento/Avulso/Ativo
tabPARMFATURCD_HISTPAGTOValidate	source/MFA001/UdmMFA001.pas	Validação do histórico informado (natureza, tipo, ativo)
TfrmMNF001.btnSalvarClick	source/MNF001/UMNF001.pas	Verifica iCD_HISTPAGTO para decidir entre caixa manual ou automático
Busca_Parametros (MNF001)	source/MNF001/UdmMNF001.pas	Carrega CD_HISTPAGTO da tabela PARMFATUR para a variável iCD_HISTPAGTO
TfrmMTR004.btnSalvarClick	source/MTR004/UMTR004.pas	Mesma lógica do MNF001: caixa automático quando iCD_HISTPAGTO preenchido
Busca_Parametros (MTR004)	source/MTR004/UdmMTR004.pas	Carrega CD_HISTPAGTO da tabela PARMFATUR

Referências SQL diretas ao campo

Contexto	Arquivo	Linha
SELECT com JOIN em HISTORICO H2	source/MFA001/UdmMFA001.dfm	84
INSERT em PARMFATUR	source/MFA001/UdmMFA001.dfm	2483
UPDATE em PARMFATUR	source/MFA001/UdmMFA001.dfm	2662
SELECT com JOIN em HISTORICO H2	source/MFA001/UdmMFA001.dfm	2964
Manutenção em PARMFATUR (CPD009)	source/CPD009/UdmCPD009.dfm	276, 339, 409, 538, 645

Candidatas por uso da tabela

As procedures SQL abaixo utilizam a tabela PARMFATUR, mas não referenciam CD_HISTPAGTO diretamente. Impacto funcional direto não confirmado:

• CANCELA_NOTAFISCAL, CANCELA_MESTRA, CONFIRMA_ORDEMSERVICO, CALCULA_COMISSAO, CALCULA_COMISSAO_V2, CALCULA_CENTRORESULT, CALCULA_CENTRORESULTITEM, CALCULA_JUROVENDA, CALCULA_MAQUINA, CALCULA_MAQUINAFICHA, CONSOME_LOTEMATERIAPRIMA, CREDITOPERIODICO_AI0, CREDITOPERIODICOGRUPO_AI0, EXPORTACAO_ALLABOR, EXPORTACAO_DOMINIOCADASTROS, EXPORTACAO_DOMINIOCUPOM, BUSCAPRECORECAP, ATUALIZA_PESSOA, ATUALIZA_PRECOVENDA