TP_VALOR — Tipo de Valor do DLPA

Tela de configuração: TCB014 — Parâmetros do DLPA Tabela: PARMDLPA.TP_VALOR (CHAR(1) NOT NULL) Valor padrão: M (Informado Manualmente)

Telas impactadas

Tela	Rotina	Efeito
RCB009 (Demonstrativo de Lucros)	gridDLPAKeyDown	Linhas S recebem saldo acumulado automaticamente; linhas M/A somam ao total.
RCB009 (Demonstrativo de Lucros)	tabDLPAAfterScroll	Bloqueia VL_DLPA para edição quando <> M; calcula saldo automático quando = A.
RCB012 (DLPA — Relatório)	ConsultaDLPA	Recupera TP_VALOR do cadastro para exibição no relatório.
RCB013 (LALUR/Livros)	grd*DrawColumnCell	Linhas com TP_VALOR = 'T' recebem cor de fundo diferenciada (laranja, negrito).
RCB013 (LALUR/Livros)	tab*AfterScroll	Linhas T ou vazias bloqueiam edição do campo de valor.
RCB013 (LALUR/Livros)	grdPISCOFINSKeyDown	Linhas T não permitem edição manual.

Campos envolvidos

Campo	Tabela	Descrição
TP_VALOR	PARMDLPA	Tipo de preenchimento do valor na linha do DLPA.
VL_DLPA	DLPA	Valor informado ou calculado para a linha do DLPA.
ST_SALDO	PARMDLPA	Sinal do saldo (+ ou -), utilizado na soma acumulada.
CD_CONTA	PARMDLPA	Conta contábil usada quando o tipo é A (automático).

Opções disponíveis

M — Informado Manualmente

O que faz	Detalhe
Permite digitação livre do valor	Campo VL_DLPA fica editável.

Simulação passo a passo

1. Acesse TCB014 — Parâmetros do DLPA e abra o cadastro de um modelo de plano.
2. Selecione uma linha e defina TP_VALOR como M — Informado Manualmente.
3. Salve o parâmetro (<F9> ou botão Salvar).
4. Na tela RCB009 — Demonstrativo de Lucros, posicione na linha correspondente.
5. Digite o valor desejado no campo VL_DLPA (ex.: R$ 15.000,00).

Resultado esperado: O campo VL_DLPA aceita digitação livre e o valor digitado é incluído na soma/substração do total geral, respeitando ST_SALDO (+ ou -).

---

A — Calculado Automaticamente

O que faz	Detalhe
Valor obtido do saldo da conta contábil	Campo VL_DLPA fica somente leitura; o sistema consulta RETORNA_SALDODIA.
Exige CD_CONTA preenchido	A conta contábil vinculada à linha é usada na busca do saldo.

Simulação passo a passo

1. Acesse TCB014 — Parâmetros do DLPA e abra o cadastro de um modelo de plano.
2. Selecione uma linha e defina TP_VALOR como A — Calculado Automaticamente.
3. Informe o campo CD_CONTA com a conta contábil desejada (ex.: conta 1.1.01.00.01).
4. Salve o parâmetro.
5. Na tela RCB009, posicione na linha correspondente.
6. O sistema executa automaticamente a função RETORNA_SALDODIA passando a empresa e a data final do período.
7. O valor retornado é carregado em VL_DLPA.

Resultado esperado: O campo VL_DLPA é preenchido automaticamente com o saldo da conta contábil na data final do período e não pode ser editado manualmente.

Exceção / Importante: Se RETORNA_SALDODIA retornar vazio, o campo permanece sem preenchimento. O parâmetro exige que CD_CONTA esteja preenchido na linha de PARMDLPA.

---

S — Exibir o Saldo

O que faz	Detalhe
Exibe o saldo acumulado até aquela linha	Campo VL_DLPA recebe o total das linhas anteriores (somando/subtraindo conforme ST_SALDO).
Não entra na soma do total	Linhas do tipo S são ignoradas na acumulação do total geral.

Simulação passo a passo

1. Acesse TCB014 — Parâmetros do DLPA e abra o cadastro de um modelo de plano.
2. Selecione uma linha (geralmente intermediária ou final de um grupo) e defina TP_VALOR como S — Exibir o Saldo.
3. Salve o parâmetro.
4. Na tela RCB009, pressione <Enter> ou navegue com as setas para disparar o recálculo.
5. O sistema percorre todas as linhas, soma/subtrai as que não são tipo S e grava o total acumulado nas linhas do tipo S.

Resultado esperado: A linha com TP_VALOR = 'S' exibe o saldo parcial acumulado até aquele ponto. Por exemplo, se as linhas anteriores somam R$ 50.000,00 e subtraem R$ 10.000,00, a linha de saldo mostrará R$ 40.000,00.

Exceção / Importante: O saldo considera o ST_SALDO de cada linha (+ soma, - subtrai). A ordem das linhas é definida pelo campo NR_ORDEM de PARMDLPA.

Tabela Comparativa Resumida

Opção	Editável	Origem do Valor	Entra na Soma?
M — Informado Manualmente	✓ Sim	Digitação do usuário	Sim
A — Calculado Automaticamente	✗ Não	RETORNA_SALDODIA via CD_CONTA	Sim
S — Exibir o Saldo	✗ Não	Acumulado das linhas anteriores	Não (apenas exibe)

Regra Geral

• Na tela RCB009, ao navegar pelas linhas do DLPA (<Enter>, <Seta Cima>, <Seta Baixo>), o sistema recalcula automaticamente os saldos das linhas tipo S.
• Linhas tipo A consultam o saldo da conta contábil (CD_CONTA) na data final do período selecionado.
• Linhas tipo M permitem digitação livre e participam normalmente da acumulação.
• O total geral do DLPA é a soma/subtração de todas as linhas tipo M e A, ignorando as tipo S.

Procedures impactadas

Rotinas Delphi com referência direta ao campo

Rotina	Arquivo	Evidência
TdmRCB009.tabDLPAAfterScroll	source/RCB009/UdmRCB009.pas:213	Bloqueia edição e calcula automático quando TP_VALOR <> 'M' / = 'A'
TfrmRCB009.gridDLPAKeyDown	source/RCB009/URCB009.pas:332	Ignora linhas S na soma; grava saldo acumulado nas linhas S
TdmRCB012.ConsultaDLPA	source/RCB012/UdmRCB012.pas:4743	Recupera TP_VALOR no SELECT do relatório

Referências SQL diretas ao campo na tabela PARMDLPA

Não foi encontrada referência direta ao campo PARMDLPA.TP_VALOR em Scripts/. As stored procedures do repositório (RETORNA_LALUR, CALCULA_VALOR, etc.) referenciam TP_VALOR da tabela PARMLALUR, que é uma tabela distinta usada no LALUR (RCB013), com valores semânticos diferentes (T, +, -, R, =).

Candidatas por uso da tabela (sem referência direta confirmada ao campo)

Procedure/View	Arquivo	Observação
RETORNA_LALUR	Scripts/RETORNA_LALUR.sql	Usa TP_VALOR de PARMLALUR, não de PARMDLPA
VALOR_IMPOSTO	Scripts/VALOR_IMPOSTO.sql	Usa V_TP_VALOR como variável local, sem ligação com PARMDLPA