ST_VALIDASALDOBOLETO — Validar Saldo da Conta/Retorno Boletos

Tela de configuração: FNC001 — Parâmetros do Financeiro
Localização: Aba Financeiro 2, opção Validar Saldo da Conta/Retorno Boletos [MFC011]
Tabela: PARMFINANC.ST_VALIDASALDOBOLETO
Valor padrão: N (Desmarcado)

Telas impactadas

• FNC001 — Tela de Parâmetros do Financeiro (origem da configuração).
• MFC011 — Retorno / Liquidação de Boletos. Comportamento validado no código: ao confirmar a liquidação, o sistema checa saldo vs. valor pago conforme este parâmetro.
• MFC033 — Baixa de Boletos. O parâmetro é carregado em memória (UdmMFC033.pas), mas não foi identificado consumo direto desta variável no código fonte analisado.

Campos envolvidos

Campo	Origem	Descrição
ST_VALIDASALDOBOLETO	PARMFINANC	Indica se o sistema deve validar o saldo do boleto contra o valor pago no processamento de retorno de boletos. Tipo CHAR(1), aceita S ou N.
VL_PAGO	Retorno do banco (tabRetorno)	Valor efetivamente pago informado pelo arquivo de retorno.
VL_SALDO	Retorno do banco (tabRetorno)	Saldo do boleto no momento do processamento.

Opções disponíveis

S — Marcado (Validação ativa)

O que faz	Detalhe
Valida saldo vs. valor pago	No processamento de retorno de boletos, antes de gravar a liquidação, o sistema compara VL_PAGO com VL_SALDO de cada documento/parcela.
Pergunta antes de prosseguir	Se houver divergência, exibe mensagem listando os documentos afetados e solicita confirmação do usuário.
Bloqueia se usuário não confirmar	Ao responder Não à mensagem, a liquidação é abortada (resposta := False).
Campos editáveis?	N/A — validação em tempo de processamento.

Simulação passo a passo

1. Acesse FNC001 — Parâmetros do Financeiro.
2. Abra a aba Financeiro 2.
3. Marque a opção Validar Saldo da Conta/Retorno Boletos [MFC011].
4. Salve o parâmetro.
5. Abra a tela MFC011 — Retorno / Liquidação de Boletos.
6. Processe o arquivo de retorno de boletos normalmente (selecione o arquivo, importe e liquide).
7. Ao clicar em Salvar / Confirmar, o sistema verifica se VL_PAGO <> VL_SALDO para alguma parcela.
8. Se houver divergência, aparece a mensagem:

   O Valor Pago é diferente do Saldo do Boleto nas seguintes Contas/Parcelas: [lista de documentos/parcelas] Deseja realmente gravar a Liquidação?

9. Escolha Sim para confirmar a liquidação mesmo com diferença, ou Não para cancelar.

Resultado esperado:
Quando o parâmetro está ativo, o sistema só liquida boletos com saldo divergente se o usuário confirmar explicitamente. Caso contrário, interrompe o processo.

Exceção / Importante:
A mensagem de diferença de saldo não é exibida nas seguintes situações (o sistema ignora a validação para estes casos):

• Geração de duplicata de desconto Bradesco (CD_BANCO = '33', CD_CARTEIRARETORNO = '7', CD_TIPOOCORRENCIA = '5').
• Geração de duplicata de desconto Banco do Brasil (CD_BANCO = '1', CD_TIPOOCORRENCIA = '2', TP_BOLETO = 'V').
• Ocorrência 72 com TP_BOLETO = 'V'.

Essas exceções estão codificadas em UMFC011.pas (linha ~2390–2404).

N — Desmarcado (Validação inativa)

O que faz	Detalhe
Não valida saldo	O sistema ignora a diferença entre VL_PAGO e VL_SALDO durante a liquidação de retorno de boletos.
Campos editáveis?	N/A

Simulação passo a passo

1. Acesse FNC001 — Parâmetros do Financeiro.
2. Abra a aba Financeiro 2.
3. Desmarque a opção Validar Saldo da Conta/Retorno Boletos [MFC011].
4. Salve o parâmetro.
5. Abra a tela MFC011 — Retorno / Liquidação de Boletos.
6. Processe o arquivo de retorno e clique em Salvar / Confirmar.
7. O sistema grava a liquidação normalmente, mesmo que VL_PAGO seja diferente de VL_SALDO.

Resultado esperado:
A liquidação é efetuada sem qualquer alerta de divergência de saldo.

Regras gerais

• O parâmetro é aplicado exclusivamente no momento da confirmação/liquidação do retorno de boletos na tela MFC011.
• Não existe autorizador ou permissão de usuário que desvie esta validação — ela depende apenas do valor do parâmetro e da confirmação do operador na mensagem.
• O valor padrão é N, ou seja, a validação inicia desativada em novas instalações/registros.

Tabela comparativa resumida

Valor	Descrição	Efeito na Liquidação (MFC011)
S	Marcado	Valida saldo vs. valor pago; exibe alerta de confirmação se divergente.
N	Desmarcado	Não valida; liquida direto sem alerta.

Procedures impactadas

Rotinas Delphi com referência direta ao campo

Rotina	Arquivo	Linha	Comportamento
tabPARMFINANCAfterInsert	source/FNC001/UdmFNC001.pas	421	Atribui 'N' como valor padrão ao inserir novo registro em PARMFINANC.
TfrmMFC011.btnSalvarClick	source/MFC011/UMFC011.pas	2375	Se iST_VALIDASALDOBOLETO = 'S', executa loop de validação comparando VL_PAGO e VL_SALDO antes de permitir a liquidação.
Declaração de variáveis	source/MFC011/UdmMFC011.pas	289	Declara a variável global iST_VALIDASALDOBOLETO.
BuscaParametros	source/MFC011/UdmMFC011.pas	322	Consulta PARMFINANC e carrega ST_VALIDASALDOBOLETO na variável global.
Declaração de variáveis	source/MFC033/UdmMFC033.pas	188	Declara a variável global iST_VALIDASALDOBOLETO.
BuscaParametros	source/MFC033/UdmMFC033.pas	206	Consulta PARMFINANC e carrega ST_VALIDASALDOBOLETO na variável global.

Referências diretas em SQL / Scripts

Não foram encontradas referências diretas ao campo ST_VALIDASALDOBOLETO nos scripts da pasta Scripts/.

Candidatas por uso da tabela PARMFINANC

As procedures/scripts abaixo consultam PARMFINANC, mas não citam o campo ST_VALIDASALDOBOLETO literalmente. Seu impacto funcional direto sobre este parâmetro não foi verificado:

• 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, GERA_MOVTOCONTABIL, GRAVA_CHEQUECARTAO, GRAVA_CONTAS, GRAVA_MOVTOCAIXA, GRAVA_MOVTOCAIXAINDIVIDUAL, GRAVA_MOVTOPROCESSO, GRAVA_PROCESSOSMART, PROCESSA_FATURA.