CD_HISTREVPROV — Histórico de Reversão de Provisão de Perdas

Tela de configuração: FNC001 — Parâmetros Financeiros Aba: Financeiro 3 Campo: Complemento (editCD_HISTREVPROV) Tabela: PARMFINANC.CD_HISTREVPROV Tipo: INTEGER Chave estrangeira: → HISTORICO(CD_HISTORICO)

Esse parâmetro armazena o código do Histórico de Reversão de Provisão de Perdas. Ele e usado durante a operação de reversão de provisão no módulo de Contas a Pagar/Receber (tela MFC034) para identificar qual histórico contabilizar quando títulos com provisão de perdas sao revertidos.

---

Telas impactadas

Tela	Descrição	Impacto
FNC001	Parâmetros Financeiros	Tela de configuração do parâmetro
MFC034	Operações de Contas	Usa o parâmetro para Reversão de Provisão (TP_OPERACAO = 'Z' / CD_OPERACAO = 'RP')

Campos envolvidos

Campo	Tabela	Tipo	FK para
CD_HISTREVPROV	PARMFINANC	INTEGER	HISTORICO(CD_HISTORICO)

Opções disponíveis

Este parâmetro nao possui um conjunto predefinido de opcoes (opcoes_detectadas: []). O campo aceita qualquer código valido da tabela HISTORICO.

O que faz	Detalhe
Editável livremente	Campo de edição direta na tela FNC001, aba Financeiro 3
Selecao via <F9>	Abre a busca rapida HISTORICODUPLICATAS (históricos do tipo duplicata)
Exige histórico valido	Na validacao, o sistema exige: cadastrado, ativo (ST_ATIVO = 'S') e tipo duplicata (TP_HISTORICO = 'U')

Simulacao passo a passo

1. Acesse FNC001 — Parâmetros Financeiros.
2. Navegue até a aba Financeiro 3.
3. Localize o campo Complemento (CD_HISTREVPROV).
4. Pressione F9 para abrir a busca de Histórico Duplicatas.
5. Selecione o histórico desejado na lista (ex: HISTORICO = 1520 → "Reversão de Provisão").
6. Salve o registro.

Resultado esperado: O código do histórico selecionado e gravado em PARMFINANC.CD_HISTREVPROV para a empresa. Quando um usuário realizar uma operação de Reversão de Provisão na tela MFC034 (TP_OPERACAO = 'Z'), o sistema usará esse histórico nos lancamentos do tipo CD_OPERACAO = 'RP'.

Importante: O histórico selecionado deve obrigatoriamente ter TP_HISTORICO = 'U' (duplicata) e ST_ATIVO = 'S'. Caso contrário, o salva bloqueia a operacao com a mensagem de erro correspondente.

---

Regras de validacao

O campo CD_HISTREVPROV possui um evento OnValidate (tabPARMFINANCCD_HISTREVPROVValidate) que executa as seguintes verificacoes quando um valor e informado:

Regra	Mensagem de erro	Condiçao
Histórico deve existir	Histórico não cadastrado! [TCB003]	O código nao foi encontrado na tabela HISTORICO
Histórico deve estar ativo	O Histórico não está Ativo! [TCB003]	ST_ATIVO = 'N'
Histórico deve ser do tipo duplicata	O Tipo do Histórico deve ser do Tipo Duplicata! [TCB003]	TP_HISTORICO <> 'U'

Regras no GERA_MOVTOCONTABIL Quando o script SQL GERA_MOVTOCONTABIL processa um movimento contabil e o histórico utilizado corresponde ao CD_HISTREVPROV, ele aplica o complemento DS_COMPLEMENTOREVPROV (também configurado em FNC001).

Regras na tela MFC034 (Operacoes de Contas)

• Ao confirmar uma operacao de Reversao de Provisao (TP_OPERACAO = 'Z' / CD_OPERACAO = 'RP') sem que CD_HISTREVPROV esteja configurado, o sistema exibe:

  Histórico de Reversão de Provisão de Perdas não Cadastrado nos Parâmetros Financeiros! [FNC001]

• Quando configurado corretamente, o sistema recupera:
  • icd_histaux = CD_HISTREVPROV
  • dsComplemento = DS_COMPLEMENTOREVPROV (campo irmão em PARMFINANC)

---

Procedures impactadas

Rotinas Delphi com referencia direta ao parametro

Rotina	Arquivo	Linha	Evidencia
editCD_HISTREVPROVKeyDown	source/FNC001/UFNC001.pas	411	Atalho <F9> → busca HISTORICODUPLICATAS
TfrmFNC001.editCD_HISTREVPROVKeyDown	source/FNC001/UFNC001.pas	1401	Atribui retorno.getParam(0) ao campo
tabPARMFINANCCD_HISTREVPROVValidate	source/FNC001/UdmFNC001.pas	243	Validacao: exige historico ativo e tipo duplicata
TdmFNC001.tabPARMFINANCCD_HISTREVPROVValidate	source/FNC001/UdmFNC001.pas	1157	Implementacao da validacao
TfrmMFC034.btnProcurarClick	source/MFC034/UMFC034.pas	883	Exige CD_HISTREVPROV preenchido para operacao RP
TfrmMFC034.btnConfirmarClick	source/MFC034/UMFC034.pas	1164	Usa CD_HISTREVPROV como icd_histaux na reversao de provisao

Referencias SQL diretas ao campo

Procedure/View	Arquivo	Linha	Uso
GERA_MOVTOCONTABIL	Scripts/GERA_MOVTOCONTABIL.sql	69, 811–828	Declara variavel e seleciona CD_HISTREVPROV de PARMFINANC. Usa para definir I_DS_COMPLEMENTO = v_ds_complementorevprov quando o historico do movimento coincide com o parametro

Candidatas por uso da tabela PARMFINANC

As rotinas abaixo acessam a tabela PARMFINANC mas nao mencionam CD_HISTREVPROV explicitamente no codigo-fonte disponivel. Nao ha confirmação de impacto funcional direto ao campo:

CALCULA_CAPITAL, CALCULA_JURO, CALCULA_JUROMORA, CALCULA_JUROMORA_RFC019, CANCELA_CONTAS, CONTABILIZA_REPARCELAMENTO, CONTROLE_CAIXA, ESTORNA_MOVTOCAIXA, EXECUTA_PROCESSO, GERA_DUPLICATAS, GERA_INTEGRACAO, GERA_INTEGRACAOFISCAL, GRAVA_CHEQUECARTAO, GRAVA_CONTAS, GRAVA_MOVTOCAIXA, GRAVA_MOVTOCAIXAINDIVIDUAL, GRAVA_MOVTOPROCESSO, GRAVA_PROCESSOSMART, PROCESSA_FATURA, PROCESSA_REPARCELAMENTO.

---

Campos relacionados em PARMFINANC

Campo	Funcao	Onde usar
DS_COMPLEMENTOREVPROV	Complemento texto para Reversao de Provisao	Mesma aba Financeiro 3, logo apos CD_HISTREVPROV
CD_HISTREVPERDA	Historico de Reversao de Perda (operacao RL)	Mesma aba Financeiro 3
CD_HISTPROVPERDA	Historico de Provisao de Perda	Mesma aba Financeiro 3
CD_HISTPERDA	Historico de Perda	Mesma aba Financeiro 3

O campo DS_COMPLEMENTOREVPROV funciona como template de texto para o complemento do lancamento contabil na reversao de provisao. Variaveis suportadas no template (quando mapeadas pelo GERA_MOVTOCONTABIL): %H (historico), %D (documento), %V (valor total), %P (nome da pessoa).