CD_MODELOPLANO - Modelo do Plano de Contas (DFC)

Tela de configuração: TCB024 - Parâmetros do DFC Tabela: PARMDFC.CD_MODELOPLANO (DOM_INTEGER) Valor padrão: Preenchido via pesquisa (<F9>) na tabela MODELOPLANO Campo editável: Sim (edtCD_MODELO, cursor crDrag)

Descrição

Define qual modelo do plano de contas será utilizado para filtrar os parâmetros do DFC (Demonstração do Fluxo de Caixa). O modelo selecionado aqui vincula os parâmetros DFC ao plano de contas correspondente, garantindo que a geração do relatório DFC considere apenas as contas contábeis daquele modelo.

A tabela MODELOPLANO contém os modelos cadastrados na tela TCB005 (Manutenção de Modelos do Plano de Contas).

Telas impactadas

Tela	Arquivo	Impacto
TCB024 - Parâmetros do DFC	UTCB024.pas	Tela principal onde o campo é editado
TCB005 - Modelos do Plano	UTCB005.pas	Cadastro dos modelos (MODELOPLANO)
TCB007 - Plano Modelo	UTCB007.pas	Associação de contas ao modelo (PLANOMODELO)
RCB017 - Relatório DFC	GERA_DFC_RCB017.sql	Usa CD_MODELOPLANO de PARMCONTABIL para filtrar parâmetros DFC

Campos envolvidos

Campo	Tabela	Tipo	Descrição
CD_MODELOPLANO	PARMDFC	INTEGER	Código do modelo do plano de contas vinculado ao parâmetro DFC
DS_MODELOPLANO	PARMDFC (lookup)	STRING	Descrição do modelo (preenchido automaticamente via validação)
CD_MODELOPLANO	MODELOPLANO	INTEGER	PK da tabela de modelos do plano
DS_MODELOPLANO	MODELOPLANO	VARCHAR(60)	Descrição do modelo

Regras de preenchimento

• O campo é opcional (aceita nulo na tabela PARMDFC).
• Ao preencher, o código é validado contra a tabela MODELOPLANO — se não existir, exibe erro W-1276.
• O campo DS_MODELOPLANO (descrição) é preenchido automaticamente na validação.

Opções disponíveis

O que faz	Detalhe
Editável diretamente	Sim — aceita digitação do código
Pesquisa via <F9>	Sim — abre lista de modelos de plano de contas
Obrigatório	Não — campo aceita valor nulo

Preenchimento via pesquisa <F9>

Simulação passo a passo

1. Acesse a tela TCB024 - Parâmetros do DFC.
2. Posicione o cursor no campo Modelo do Plano (edtCD_MODELO).
3. Pressione <F9> para abrir a janela de pesquisa.
4. A janela exibe a lista de modelos do plano de contas (MODELOPLANO) com colunas Descrição e Código.
5. Selecione o modelo desejado e confirme.
6. O código do modelo é preenchido no campo e a descrição é exibida automaticamente.

Resultado esperado: O parâmetro DFC fica vinculado ao modelo do plano de contas selecionado. Ao gerar o DFC (ex: via GERA_DFC_RCB017), o sistema filtrará os parâmetros DFC cujo CD_MODELOPLANO corresponda ao modelo configurado em PARMCONTABIL.CD_MODELOPLANO.

Preenchimento por digitação direta

Simulação passo a passo

1. Acesse a tela TCB024 - Parâmetros do DFC.
2. Posicione o cursor no campo Modelo do Plano.
3. Digite o código do modelo (ex: 1).
4. Ao sair do campo, o sistema valida o código contra a tabela MODELOPLANO.
5. Se o código existir, a descrição é preenchida automaticamente.

Exceção / Importante: Se o código digitado não existir na tabela MODELOPLANO, o sistema exibe o erro W-1276 e impede a gravação. Se o campo for deixado em branco, a descrição é limpa e o parâmetro DFC fica sem vínculo a um modelo específico — nesse caso, na geração do relatório, a procedure GERA_DFC_RCB017 usa COALESCE(P.CD_MODELOPLANO, 0), tratando nulos como zero.

Lógica de filtragem na geração do DFC

Na procedure GERA_DFC_RCB017, o sistema:

1. Obtém o CD_MODELOPLANO da tabela PARMCONTABIL (configurado em TCB001 - Parâmetros Contábeis).
2. Filtra os registros de PARMDFC onde CD_MODELOPLANO corresponde ao modelo da empresa.
3. Para cada parâmetro DFC com TP_CONTA = 'S', busca as contas contábeis associadas via PARMDFC_PLANOCONTAS e VIEW_PLANOCONTAS.

Procedures impactadas

Rotinas Delphi

Rotina	Arquivo	Evidência
edtCD_MODELOKeyDown	UTCB024.pas:280	Abre pesquisa <F9> na tabela MODELOPLANO e preenche CD_MODELOPLANO
tabPARMDFCCD_MODELOPLANOValidate	UdmTCB024.pas:120	Valida existência do modelo e preenche DS_MODELOPLANO

Scripts SQL com referência direta ao campo

Procedure/View	Arquivo	Evidência
GERA_DFC_RCB017	GERA_DFC_RCB017.sql:49	Filtra PARMDFC por CD_MODELOPLANO obtido de PARMCONTABIL
GERA_DMPL	GERA_DMPL.sql:43	Declara variável V_CD_MODELOPLANO
GERA_DRE	GERA_DRE.sql:39	Declara variável V_CD_MODELOPLANO
GERA_DRECC	GERA_DRECC.sql:40	Declara variável V_CD_MODELOPLANO
GERA_DRERCB016	GERA_DRERCB016.sql:38	Declara variável V_CD_MODELOPLANO
GERA_DREREGIMECAIXA	GERA_DREREGIMECAIXA.sql:38	Declara variável V_CD_MODELOPLANO
GERA_DRERES	GERA_DRERES.sql:39	Declara variável V_CD_MODELOPLANO
JV_GERA_DRE	JV_GERA_DRE.sql:37	Declara variável V_CD_MODELOPLANO
RETORNA_DOAR	RETORNA_DOAR.sql:22	Declara variável V_CD_MODELOPLANO
RETORNA_LALUR	RETORNA_LALUR.sql:33	Declara variável V_CD_MODELOPLANO
VIEW_SPEDJ150	VIEW_SPEDJ150.sql:46	Declara variável V_CD_MODELOPLANO

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

Procedure/View	Arquivo	Observação
GERA_DFC	GERA_DFC.sql	Recebe O_CD_PARMDFC como parâmetro; pode filtrar indiretamente via PARMDFC
GERA_DFC_COMPARATIVO	GERA_DFC_COMPARATIVO.sql	Recebe O_CD_PARMDFC; mesmo padrão
GERA_DFCMTF	GERA_DFCMTF.sql	Recebe O_CD_PARMDFC; mesmo padrão
GERA_DFCMTF_RCB017	GERA_DFCMTF_RCB017.sql	Recebe O_CD_PARMDFC; mesmo padrão

Tabelas relacionadas

Tabela	Relação	Descrição
MODELOPLANO	FK (RPARMDFC_MODELOPLANO)	Tabela de modelos do plano de contas
PLANOMODELO	Referência	Contas contábeis associadas a cada modelo
PARMDFC_PLANOCONTAS	Referência	Associação entre parâmetro DFC e contas contábeis
PARMCONTABIL	Contexto	Contém o CD_MODELOPLANO padrão da empresa