CD_HISTREVPERDA — Histórico de Reversão de Perda

Tela de configuração: FNC001 — Parâmetros Financeiros
Aba: Financeiro 3
Campo: Complemento (editCD_HISTREVPERDA)
Tabela: PARMFINANC.CD_HISTREVPERDA
Tipo: INTEGER (FK → HISTORICO.CD_HISTORICO)
Valor padrão: Nenhum (campo em branco)

O que faz

Armazena o código do histórico contábil padrão utilizado ao realizar a Reversão de Perda de títulos (operação tipo R — Reversão de Perda Liquidada). Esse histórico é aplicado nas integrações contábeis geradas pela rotina de provisao de contas.

Quando uma reversão de perda é executada, o sistema utiliza o histórico configurado aqui para criar o lançamento contábil, aplicando o complemento DS_COMPLEMENTOREVLIQ configurado na PARMFINANC.

Telas impactadas

Tela	Descrição	Impacto
FNC001	Parâmetros Financeiros	Tela de configuração direta
MFC034	Provisao de Contas	Usa o histórico para gerar lançamentos contábeis de reversão de perda

Campos envolvidos

Campo	Tabela	Tipo	FK
CD_HISTREVPERDA	PARMFINANC	INTEGER	HISTORICO(CD_HISTORICO)
DS_HISTREVPERDA (apresentação)	PARMFINANC	VARCHAR	Campo derivado (lookup)

Validação de entrada

O campo possui validação no OnValidate do dataset (tabPARMFINANCCD_HISTREVPERDAValidate):

Regra	Mensagem
O código deve existir na tabela HISTORICO	Histórico não cadastrado! [TCB003]
O histórico deve estar ativo (ST_ATIVO = 'S')	O Histórico não está Ativo! [TCB003]
O tipo do histórico deve ser 'U' (Duplicata)	O Tipo do Histórico deve ser do Tipo Duplicata! [TCB003]

Opções disponíveis

Este campo não possui opções fixas — ele referencia livremente registros da tabela HISTORICO.

Comportamento padrão

O que faz	Detalhe
Editável	Campo editável com lookup via <F9>
Exige	Código válido em HISTORICO, ativo e do tipo 'U' (Duplicata)
Restrição	FK RPARMFINANC_HISTREVPERDA garante integridade referencial
Lookup	<F9> abre HISTORICODUPLICATAS

Simulação passo a passo

1. Acesse FNC001 — Parâmetros Financeiros.
2. Abra a aba Financeiro 3.
3. No campo Complemento (editCD_HISTREVPERDA), digite o código do histórico ou pressione <F9> para buscar.
4. Na janela HISTORICODUPLICATAS, selecione o histórico desejado (ex: 301 — "Reversão de Perda Liquidada").
5. Salve o registro (Ctrl+S).

Resultado esperado: O campo exibe o código do histórico e a descrição é preenchida automaticamente ao lado (campo derivado DS_HISTREVPERDA). Na próxima reversão de perda executada pela MFC034, esse histórico será aplicado ao lançamento contábil gerado.

Onde o parâmetro é utilizado

1. Provisão de Contas — MFC034 (Reversão de Perda Liquidada)

Quando o usuário executa a MFC034 com TP_OPERACAO = 'R' (Reversão de Perda Liquidada), o sistema:

• Usa CD_HISTREVPERDA como icd_histaux (código do histórico contábil).
• Usa DS_COMPLEMENTOREVLIQ como texto de complemento do lançamento.
• Gera registros na tabela PROVISAOCONTAS com CD_OPERACAO = 'RL'.

2. Geração de Movimento Contábil — GERA_MOVTOCONTABIL

A procedure GERA_MOVTOCONTABIL consulta CD_HISTREVPERDA da PARMFINANC e, quando o histórico do lançamento corresponde ao parâmetro, aplica o complemento DS_COMPLEMENTOREVLIQ (com substituição de variáveis %H, %D, %V, %P):

ELSE IF (:V_CD_HISTREVPERDA = :V_CD_HISTORICO) THEN
   I_DS_COMPLEMENTO = V_DS_COMPLEMENTOREVLIQ;

Exceção / Importante: Se múltiplos parâmetros de histórico apontarem para o mesmo código (CD_HISTORICO), a procedure prioriza conforme a ordem de comparação: CD_HISTPERDA > CD_HISTPROVPERDA > CD_HISTREVPERDA > CD_HISTREVPROV. Ou seja, se CD_HISTREVPERDA for igual a CD_HISTPERDA, o complemento usado será DS_COMPLEMENTOPROV e não DS_COMPLEMENTOREVLIQ.

Relacionamentos com outros parâmetros

Parâmetro	Uso	Configurado em
CD_HISTPERDA	Histórico de Perda (tipo P)	FNC001 — Parâmetros Financeiros, aba Financeiro 3
CD_HISTPROVPERDA	Histórico de Provisão de Perda (tipo D)	FNC001 — Parâmetros Financeiros, aba Financeiro 3
CD_HISTREVPROV	Histórico de Reversão de Provisão (tipo Z)	FNC001 — Parâmetros Financeiros, aba Financeiro 3
DS_COMPLEMENTOREVLIQ	Complemento do lançamento de reversão de perda	FNC001 — Parâmetros Financeiros, aba Financeiro 3

Tabela comparativa resumida

Operação	TP_OPERACAO	Parâmetro de Histórico	Complemento aplicado
Provisão de Perda	D	CD_HISTPROVPERDA	DS_COMPLEMENTOPROV
Perda	P	CD_HISTPERDA	DS_COMPLEMENTOPER
Reversão de Perda Liquidada	R	CD_HISTREVPERDA	DS_COMPLEMENTOREVLIQ
Reversão de Provisão	Z	CD_HISTREVPROV	DS_COMPLEMENTOREVPROV

Procedures impactadas

Rotinas Delphi com referência direta

Rotina	Arquivo	Finalidade
editCD_HISTREVPERDAXKeyDown	source/FNC001/UFNC001.pas	Lookup <F9> → HISTORICODUPLICATAS
tabPARMFINANCCD_HISTREVPERDAValidate	source/FNC001/UdmFNC001.pas	Validação do código, ativo e tipo
btnConfirmarClick (MFC034)	source/MFC034/UMFC034.pas	Usa iCD_HISTREVPERDA quando TP_OPERACAO = 'R'
Busca_Parametros (dmMFC034)	source/MFC034/UdmMFC034.pas	Lê P.CD_HISTREVPERDA da PARMFINANC

Referências SQL diretas ao campo

Procedure	Arquivo	Finalidade
GERA_MOVTOCONTABIL	Scripts/GERA_MOVTOCONTABIL.sql	Consulta e aplica complemento de reversão de perda

Candidatas por uso da tabela PARMFINANC

As rotinas abaixo usam a tabela PARMFINANC mas não referenciam CD_HISTREVPERDA literalmente. Não foi encontrado impacto direto comprovado: 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.