DS_COMPLEMENTOREVLIQ - Complemento Reversão de Perdas Definitivas - Liquidação

Tela de configuração: FNC001 - Parâmetros Financeiros Localização: Aba "Financeiro 3" Tabela: PARMFINANC.DS_COMPLEMENTOREVLIQ Tipo: VARCHAR(240) Componente na tela: editDS_COMPLEMENTOREVLIQ (campo editável com fundo creme — clCream)

O que faz

Define o texto complementar usado nos lançamentos contábeis de reversão de perdas definitivas (operação 'RL'). Quando um título marcado como "perda definitiva" é revertido (liquidado/estornado), o campo DS_COMPLEMENTOREVLIQ é inserido como complemento na tabela MOVTOCONTABIL.

O campo aceita variáveis de substituição, que são trocadas automaticamente no momento do lançamento:

Variável	Substituída por	Exemplo
%H	Descrição do histórico contábil	"Receita de Serviço"
%D	Número do documento	"NF 12345"
%V	Valor total do lançamento	"1.000,00"
%P	Nome da pessoa (cliente/fornecedor)	"João Silva"

Importante: O texto final é truncado para 140 caracteres pela procedure GERA_MOVTOCONTABIL (SUBSTRING(REPLACE(...) FROM 1 FOR 140)). Mesmo que o campo aceite 240 posições, apenas 140 são efetivamente gravados no movimento contábil.

Telas impactadas

Tela	Arquivo	Impacto
FNC001 (Parâmetros Financeiros)	source/FNC001/UFNC001.dfm:2904	Campo de configuração exibido na aba "Financeiro 3"
MFC034 (Reversão de Perdas)	source/MFC034/UMFC034.pas:1160	Preenche dsComplemento para operação 'RL' (Reversão Liquidação)

Campos envolvidos

Campo	Tabela	Função
DS_COMPLEMENTOREVLIQ	PARMFINANC	Complemento da reversão definitiva (liquidação)
CD_HISTREVPERDA	PARMFINANC	Histórico contábil da reversão — determina quando usar DS_COMPLEMENTOREVLIQ
CD_HISTPERDA	PARMFINANC	Histórico de provisão de perda — usa DS_COMPLEMENTOPROV
DS_COMPLEMENTOPER	PARMFINANC	Complemento de perda definitiva — usa DS_COMPLEMENTOPER
DS_COMPLEMENTOREVPROV	PARMFINANC	Complemento de reversão de provisão — usa DS_COMPLEMENTOREVPROV
DS_COMPLEMENTOPROV	PARMFINANC	Complemento de provisão — usa DS_COMPLEMENTOPROV

Procedures impactadas

Rotinas Delphi com referência direta ao campo

Rotina	Arquivo	Linha	Evidência
TfrmMFC034.btnConfirmarClick	source/MFC034/UMFC034.pas	1160	dsComplemento := ParmFinanc.Values['DS_COMPLEMENTOREVLIQ'];

Scripts SQL com referência direta ao campo

Procedure/View	Arquivo	Linha	Evidência
GERA_MOVTOCONTABIL	Scripts/GERA_MOVTOCONTABIL.sql	72	declare variable V_DS_COMPLEMENTOREVLIQ varchar(240);
GERA_MOVTOCONTABIL	Scripts/GERA_MOVTOCONTABIL.sql	812, 826	SELECT ... PF.DS_COMPLEMENTOREVLIQ ... + IF (:V_CD_HISTREVPERDA = :V_CD_HISTORICO) THEN I_DS_COMPLEMENTO = V_DS_COMPLEMENTOREVLIQ;
GERA_MOVTOCONTABIL	Scripts/GERA_MOVTOCONTABIL.sql	964, 978	Mesma lógica (segundo bloco — operação com parâmetros NR_LANCAMENTO e CD_FORMAPAGTO)

Candidatas por uso da tabela PARMFINANC

As procedures abaixo consultam PARMFINANC mas não foram encontradas com referência direta ao campo DS_COMPLEMENTOREVLIQ. Podem vir a ser impactadas se algum parâmetro correlacionado for alterado:

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.

Nota: Nenhuma destas candidatas usa diretamente DS_COMPLEMENTOREVLIQ nos trechos de código conhecidos. A referência direta foi encontrada apenas na GERA_MOVTOCONTABIL.

Opções disponíveis

O campo é um VARCHAR(240) livre — o usuário digita qualquer texto. Não há valores fixos ou enumerados.

O que faz	Detalhe
Texto livre com variáveis	O usuário preenche um texto de até 240 caracteres, podendo usar os marcadores %H, %D, %V e %P que são substituídos automaticamente no lançamento contábil.
Campo vazio	Se deixado vazio, o complemento será gravado como NULL ou vazio no movimento contábil. Nenhuma validação obriga o preenchimento.

Texto livre com variáveis de substituição

Simulação passo a passo

1. Acesse FNC001 — Parâmetros Financeiros (FNC001).
2. Clique na aba "Financeiro 3".
3. Localize o campo "Reversão de Perdas Definitivas - Liquidação".
4. Digite: Reversão de perda — DOC: %D | %P | R$ %V
5. Salve os parâmetros clicando no botão Salvar (ou pressione <Ctrl+S>).
6. Vá até a tela MFC034 — Reversão de Perdas, selecione um título de perda definitiva que está sendo revertido e confirme a operação.
7. Consulte o movimento contábil gerado (tabela MOVTOCONTABIL), campo DS_COMPLEMENTO.

Exceção / Importante: Observe que o texto final gravado será truncado em 140 caracteres. Exemplo: se a substituição resultasse em 200 caracteres, os 60 finais seriam cortados.

Resultado esperado: O campo DS_COMPLEMENTO do lançamento contábil conterá o texto processado, ex.: "Reversão de perda — DOC: NF 12345 | João Silva | R$ 1.000,00" (limitado a 140 caracteres).

Relação com outros parâmetros (mesmo grupo)

Complemento	Usado quando	Configuração
DS_COMPLEMENTOPROV	Provisão de perda	CD_HISTPROVPERDA = histórico (MFC034 usa 'PP')
DS_COMPLEMENTOPER	Perda definitiva	CD_HISTPERDA = histórico (MFC034 usa 'PD')
DS_COMPLEMENTOREVLIQ	Reversão de perda definitiva (liquidação)	CD_HISTREVPERDA = histórico (MFC034 usa 'RL')
DS_COMPLEMENTOREVPROV	Reversão de provisão	CD_HISTREVPROV = histórico (MFC034 usa 'RP')

Regra de funcionamento na GERA_MOVTOCONTABIL

A procedure GERA_MOVTOCONTABIL decide qual complemento usar com base no histórico contábil (V_CD_HISTORICO) informado no lance contábil:

IF (V_CD_HISTPERDA = V_CD_HISTORICO) THEN
   I_DS_COMPLEMENTO = V_DS_COMPLEMENTOPROV
ELSE IF (V_CD_HISTPROVPERDA = V_CD_HISTORICO) THEN
   I_DS_COMPLEMENTO = V_DS_COMPLEMENTOPER
ELSE IF (V_CD_HISTREVPERDA = V_CD_HISTORICO) THEN
   I_DS_COMPLEMENTO = V_DS_COMPLEMENTOREVLIQ    ← aqui
ELSE IF (V_CD_HISTREVPROV = V_CD_HISTORICO) THEN
   I_DS_COMPLEMENTO = V_DS_COMPLEMENTOREVPROV

Após a seleção, as variáveis (%H, %D, %V, %P) são substituídas e o resultado é truncado a 140 caracteres antes de inserir em MOVTOCONTABIL.

Exemplo prático completo

Configuração (FNC001 → Financeiro 3):

Parâmetro	Valor configurado
CD_HISTREVPERDA	3010 (histórico "Reversão de Perdas")
DS_COMPLEMENTOREVLIQ	Reversão perda def. — %H / DOC %D / Client: %P / R$ %V

Cenário: Título de R$ 10.000,00 da "Empresa ABC Ltda." com documento "NF-9876" é revertido. O histórico contábil 3010 é informado na geração do movimento contábil.

Resultado gravado em MOVTOCONTABIL.DS_COMPLEMENTO:

Reversão perda def. — Reversão de Perdas / DOC NF-9876 / Client: Empresa ABC Ltda. / R$ 10.000,00

Exceção / Importante: Se outro autorizador parametrizar DS_COMPLEMENTOREVLIQ com texto maior que 140 caracteres após substituição, o texto será cortado silenciosamente. Planeje textos curtos ou teste antes de definir em produção.