DS_COMPLEMENTOPROV — Complemento da Provisão de Perdas

Tela de configuração: FNC001 — Parâmetros Financeiros
Localização: Aba "Financeiro 3", seção "Provisão de Perdas"
Tabela: PARMFINANC.DS_COMPLEMENTOPROV
Tipo: VARCHAR(240)
Componente: editDS_COMPLEMENTOPROV (campo editável, cor clCream apenas indicativa de estilo)
Valor padrão: nenhum (campo livre em branco)

Descrição

Armazena um texto livre de complemento que será gravado nos lançamentos contábeis de Provisão de Perdas (conta a pagar). Funciona como descritivo auxiliar do histórico contábil configurado em CD_HISTPROVPERDA.

O texto aceita placeholders que são substituídos em tempo de contabilização:

Placeholder	Substituído por
%H	Descrição do histórico contábil
%D	Número do documento
%V	Valor total do documento
%P	Nome da pessoa (cliente/fornecedor)

Nota sobre placeholders: a substituição (REPLACE encadeado) e o truncate para 140 caracteres são executados pela procedure GERA_MOVTOCONTABIL e pela rotina Delphi MFC034. O campo suporta até 240 caracteres na gravação, mas o complemento final aplicado no lançamento contábil é limitado a 140 caracteres.

Telas impactadas

Tela	Uso
FNC001 — Parâmetros Financeiros	Edição e gravação do parâmetro em PARMFINANC
MFC034 — Provisão/Reversa de Contas	Leitura do valor para compor o complemento dos lançamentos de provisão de perdas (TP_OPERACAO = 'P')
TFI005 — Parâmetros de Impostos	Campo homônimo IMPOSTO.DS_COMPLEMENTOPROV (VARCHAR 60) — configuração independente; ver Regra de validação W-1165 abaixo

Campos envolvidos

Campo	Tabela	Tipo	Relação
DS_COMPLEMENTOPROV	PARMFINANC	VARCHAR(240)	Parâmetro principal — complemento da provisão de perdas
CD_HISTPROVPERDA	PARMFINANC	INTEGER	Histórico contábil usado na provisão de perdas
CD_FORMAPAGPROVPERDA	PARMFINANC	VARCHAR	Forma de pagamento da provisão de perdas
DS_COMPLEMENTOPER	PARMFINANC	VARCHAR(240)	Complemento da Perda efetiva (operação PD)
DS_COMPLEMENTOREVLIQ	PARMFINANC	VARCHAR(240)	Complemento da Reversão de Liquidação (operação RL)
DS_COMPLEMENTOREVPROV	PARMFINANC	VARCHAR(240)	Complemento da Reversão de Provisão (operação RP)

Os quatro complementos (DS_COMPLEMENTOPROV, DS_COMPLEMENTOPER, DS_COMPLEMENTOREVLIQ, DS_COMPLEMENTOREVPROV) são lidos juntos de PARMFINANC e selecionados conforme a operação em andamento.

Opções disponíveis

O que faz	Detalhe
Texto livre	Campo editável sem lista de valores. O usuário preenche qualquer texto descritivo (até 240 caracteres).
Composição do lançamento contábil	O texto é gravado no campo DS_COMPLEMENTO da tabela MOVTOCONTABIL quando o histórico utilizado é o de provisão de perdas (CD_HISTPERDA).
Placeholders automáticos	Se o texto contiver %H, %D, %V ou %P, eles serão substituídos dinamicamente na geração do lançamento.

Texto livre (com ou sem placeholders)

Simulação passo a passo

1. Acesse FNC001 — Parâmetros Financeiros.
2. Selecione a aba "Financeiro 3".
3. Localize a seção "Provisão de Perdas", linha "Complemento".
4. Digite um texto descritivo, por exemplo: Provisão NF %NF — Cliente %P — Valor R$ %V
5. Clique em Salvar (ou pressione <Ctrl+S>).

Resultado esperado: o texto é gravado em PARMFINANC.DS_COMPLEMENTOPROV para a empresa. Quando o sistema gera um lançamento contábil de provisão de perdas, o texto aparece no campo DS_COMPLEMENTO de MOVTOCONTABIL, com os placeholders substituídos pelos dados reais. Ex.: "Provisão NF 12345 — Cliente ACME LTDA — Valor R$ 1.500,00" (truncado a 140 caracteres).

Exceção / Importante: Na contabilização de notas fiscais (CONTABILIZA_IMPOSTONOTACTB), o complemento usado vem do cadastro do imposto (IMPOSTO.DS_COMPLEMENTOPROV), não deste parâmetro. As duas tabelas possuem campos homônimos independentes:

• PARMFINANC.DS_COMPLEMENTOPROV — VARCHAR(240) — usado nas rotinas de provisão de perdas de contas a pagar (MFC034, GERA_MOVTOCONTABIL)
• IMPOSTO.DS_COMPLEMENTOPROV — VARCHAR(60) — usado na contabilização de impostos por nota fiscal

Importante — Validação na tela TFI005: Se o campo CD_HISTPROVISAO estiver preenchido no cadastro de um imposto e o campo DS_COMPLEMENTOPROV (da tabela IMPOSTO) estiver vazio, o sistema dispara a mensagem W-1165 e exige o preenchimento do complemento. Essa validação ocorre na tela TFI005 (configuração de impostos), independente deste parâmetro de FNC001.

Outros parâmetros relacionados (configurados na mesma aba da FNC001):

• CD_HISTPROVPERDA — Histórico contábil da provisão de perdas
• CD_FORMAPAGPROVPERDA — Forma de pagamento da provisão
• CD_HISTPERDA — Histórico da perda efetiva
• CD_HISTREVPERDA — Histórico da reversão de perda
• CD_HISTREVPROV — Histórico da reversão de provisão

Procedures impactadas

Rotinas Delphi com referência direta ao campo

Rotina	Arquivo	Uso
TfrmMFC034.btnConfirmarClick	source/MFC034/UMFC034.pas:1147	Lê ParmFinanc.Values['DS_COMPLEMENTOPROV'] quando TP_OPERACAO = 'P' (provisão de perdas) e grava em PROVISAOCONTAS.DS_COMPLEMENTO
TfrmMFC034.gera_movimentoInverso	source/MFC034/UMFC034.pas:1768	Lê ParmFinanc.Values['DS_COMPLEMENTOPROV'] quando ST_GERAMOVINVERSOPROVPERDA = 'S' e grava movimento inverso em PROVISAOCONTAS.DS_COMPLEMENTO

Scripts SQL com referência direta ao campo PARMFINANC.DS_COMPLEMENTOPROV

Procedimento	Arquivo	Uso
GERA_MOVTOCONTABIL	Scripts/GERA_MOVTOCONTABIL.sql:70, 819-822	Declara V_DS_COMPLEMENTOPROV, lê de PARMFINANC e aplica como I_DS_COMPLEMENTO quando CD_HISTPERDA = CD_HISTORICO. Substitui placeholders e trunca para 140 caracteres.
GERA_MOVTOCONTABIL (2º bloco)	Scripts/GERA_MOVTOCONTABIL.sql:963-974	Mesma lógica em ponto diferente da procedure.

Scripts SQL com referência ao campo IMPOSTO.DS_COMPLEMENTOPROV (homônimo, tabela diferente)

Procedimento	Arquivo	Uso
CONTABILIZA_IMPOSTONOTACTB	Scripts/CONTABILIZA_IMPOSTONOTACTB.sql:277, 302	Lê I.DS_COMPLEMENTOPROV (alias I = IMPOSTO) para contabilização de provisões de impostos em regime caixa. Substitui placeholders %NF, %S, %H, %D.

Candidatas por uso da tabela PARMFINANC

As rotinas abaixo utilizam a tabela PARMFINANC mas não referenciam o campo DS_COMPLEMENTOPROV diretamente — podem ler outros parâmetros financeiros:

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.