CD_CONTA - Conta Contábil do DLPA

Tela de configuração: TCB014 - Parâmetros do DLPA Tabela: PARMDLPA.CD_CONTA (DOM_INTEGER) Componente: edtCD_CONTA (edit) Valor padrão: vazio (não preenchido)

Resumo

Define a conta contábil analítica cujo saldo será utilizado para calcular automaticamente o valor de uma linha do DLPA (Demonstração de Lucros ou Perdas Acumulados). O campo só é habilitado quando o tipo de valor (TP_VALOR) da linha for igual a A (Conta Analítica).

Telas impactadas

Tela	Rotina	Impacto
TCB014	Parâmetros do DLPA	Onde o campo é editado
RCB009	DLPA (Relatório)	Usa PARMDLPA.CD_CONTA para buscar saldo via RETORNA_SALDODIA e para nota explicativa
RCB012	DLPA Mensal/Trimestral	Usa PARMDLPA.CD_CONTA na consulta de dados do DLPA

Campos envolvidos

Campo	Tabela	Descrição
CD_CONTA	PARMDLPA	Conta contábil analítica vinculada à linha do DLPA
TP_VALOR	PARMDLPA	Tipo de valor da linha — controla se CD_CONTA é editável
DS_CONTA	PARMDLPA (calculado)	Descrição retornada da validação da conta
CD_MODELOPLANO	PARMDLPA	Modelo do plano de contas (chave primária junto com CD_PARMDLPA)

Regras de comportamento

Habilitação / Desabilitação do campo

Condição	Estado do campo CD_CONTA
TP_VALOR = A (Conta Analítica)	Editável
TP_VALOR ≠ A (ex: M = Manual, S = Subtotal)	Somente leitura (ReadOnly) e valor é limpo

Quando o usuário altera TP_VALOR para algo diferente de A, o sistema automaticamente limpa CD_CONTA e trava o campo.

Validação ao preencher

Ao informar um código de conta contábil:

1. O sistema consulta VIEW_PLANOCONTAS para verificar se a conta existe no plano da empresa.
2. Verifica se o tipo da conta (TP_CONTA) é A (Analítica). Se não for, exibe erro W-1265.
3. Se a conta não existir, exibe erro E-0312.
4. Preenche automaticamente DS_CONTA com a descrição da conta.

Obrigatoriedade

Ao salvar um parâmetro com TP_VALOR = A, o campo CD_CONTA é obrigatório. Se estiver vazio, o sistema exibe o erro W-1257 e foca no campo.

Pesquisa de conta (F9 / F10)

Tecla	Ação	Filtro aplicado
<F9>	Abre pesquisa simples de conta contábil	Somente contas com TP_CONTA = 'A' (Analíticas)
<F10>	Abre pesquisa em árvore (plano de contas)	Somente contas com TP_CONTA = 'A' (Analíticas)

Ambas as pesquisas utilizam VIEW_PLANOCONTAS filtrando contas da empresa logada.

Uso em relatórios

RCB009 — DLPA

Quando TP_VALOR = 'A', o relatório RCB009 utiliza PARMDLPA.CD_CONTA para:

• Chamar a função RETORNA_SALDODIA(empresa, CD_CONTA, data) e obter o saldo da conta na data final do período.
• O valor retornado é atribuído automaticamente ao campo VL_DLPA da linha.

Também é usado para montar a nota explicativa via VIEW_NOTAEXPLICATIVACTB.

RCB012 — DLPA Mensal/Trimestral

O campo PARMDLPA.CD_CONTA é incluído na consulta de dados do DLPA, seguindo a mesma lógica de uso em relatórios.

Procedures impactadas

Rotinas Delphi com referência direta ao campo

Rotina	Arquivo	Descrição
tabPARMDLPACD_CONTAValidate	source/TCB014/UdmTCB014.pas	Valida existência e tipo analítico da conta
tabPARMDLPATP_VALORValidate	source/TCB014/UdmTCB014.pas	Habilita/desabilita CD_CONTA conforme TP_VALOR
tabPARMDLPABeforePost	source/TCB014/UdmTCB014.pas	Exige CD_CONTA preenchido quando TP_VALOR = 'A'
tabPARMDLPAAfterScroll	source/TCB014/UdmTCB014.pas	Alterna ReadOnly conforme TP_VALOR
edtCD_CONTAKeyDown	source/TCB014/UTCB014.pas	Abre pesquisa <F9> / <F10> de contas analíticas

Rotinas Delphi em relatórios (leitura)

Rotina	Arquivo	Descrição
Montagem do SQL do relatório	source/RCB009/URCB009.pas	Seleciona PARMDLPA.CD_CONTA para uso no relatório
Cálculo de saldo	source/RCB009/UdmRCB009.pas	Usa CD_CONTA para chamar RETORNA_SALDODIA
Montagem do SQL do relatório	source/RCB012/UdmRCB012.pas	Seleciona PARMDLPA.CD_CONTA na consulta DLPA

Scripts SQL

Não foram encontradas referências diretas ao campo PARMDLPA.CD_CONTA em scripts SQL (Scripts/). As procedures listadas no inventário utilizam CD_CONTA em contexto geral de outras tabelas, não na tabela PARMDLPA.

Simulação passo a passo

Preenchimento com conta analítica

1. Acesse a tela TCB014 — Parâmetros do DLPA.
2. Selecione ou inclua um parâmetro e defina TP_VALOR como A (Conta Analítica).
3. O campo CD_CONTA será habilitado para edição.
4. Digite o código de uma conta contábil analítica ou pressione <F9> para abrir a pesquisa.
5. Selecione uma conta do tipo analítica na janela de pesquisa.
6. O sistema preenche automaticamente a descrição da conta ao lado do campo.
7. Salve o parâmetro.

Resultado esperado: O parâmetro do DLPA fica vinculado à conta contábil informada. Ao gerar o relatório DLPA, o sistema buscará automaticamente o saldo dessa conta.

Tentativa de salvar sem preencher a conta

1. Acesse a tela TCB014 — Parâmetros do DLPA.
2. Defina TP_VALOR como A e deixe CD_CONTA em branco.
3. Tente salvar.

Resultado esperado: O sistema exibe o erro W-1257 e o foco vai para o campo CD_CONTA, impedindo o salvamento.

Alteração de TP_VALOR para diferente de A

1. Acesse a tela TCB014 — Parâmetros do DLPA.
2. Em um parâmetro com TP_VALOR = 'A' e CD_CONTA preenchido, altere TP_VALOR para M (Manual).
3. O campo CD_CONTA é automaticamente limpo e travado (ReadOnly).

Resultado esperado: O valor de CD_CONTA é removido e o campo não aceita mais edição enquanto TP_VALOR não voltar para A.

Exceção / Importante: Somente contas do tipo A (Analítica) são aceitas. Se o usuário digitar manualmente o código de uma conta sintética, o sistema exibe o erro W-1265 ao validar.