Lista de Modelos
Criado por Igor Ribeiro em 13 de novembro de 2025
Atualizado por Igor Ribeiro em 02 de setembro de 2026
Lista de Modelos
Módulo Contabilidade > Demonstrativos — cadastro do “Modelo de Demonstrativo Contábil”, a estrutura reutilizável (mapa de contas/linhas) que descreve como um demonstrativo (Balanço, DRE, DFC, DMPL, DLPA etc.) deve ser montado a partir do plano de contas.
Visão Geral da Rotina
O cadastro de Modelo de Demonstrativo Contábil, no módulo Contabilidade, define a estrutura reutilizável (o mapa de contas/linhas) que descreve como um demonstrativo contábil — Balanço Patrimonial, DRE, DFC, DMPL, DLPA, entre outros — deve ser montado a partir do plano de contas.
Cada modelo é composto por um cabeçalho e por uma lista de “Planos” — as linhas/itens do modelo, cada uma com sua “Origem de Dados”: de onde vem o valor daquela linha (um intervalo de contas do plano de contas, um intervalo de linhas do próprio demonstrativo, ou contas do bloco K300 do SPED). Essa estrutura é depois consumida pela rotina de Demonstrativo Contábil para gerar os demonstrativos reais, com valores calculados a partir dos lançamentos contábeis do período.
Vídeo Tutorial da Lista de Modelos
Pré-requisitos e Contexto de Acesso da Lista de Modelos
Para acessar a tela, o usuário precisa da permissão de rotina “ListViewDeModeloDemonstrativoContabil” (ID 1116).
Modelo
“ModeloDemonstrativoContabil/Novo” (ID 417), “/Editar” (ID 414), “/Excluir” (ID 415), “/Exportar” (ID 416), “/Importar” — layout SPED (ID 794), “/Copiar” (ID 3992).
Plano e Origem de Dados
“NovoPlano” (541), “EditarPlano” (542), “ExcluirPlano” (543), “IncluirPlanoDado” (3989), “EditarPlanoDado” (3990), “ExcluirPlanoDado” (3991).
Processo de Criação — Passo a Passo
Criar o cabeçalho do modelo
O usuário informa o código do modelo, o nome/descrição, a máscara de formatação do código de plano de contas usada por este modelo, a quantidade de colunas de valor do demonstrativo e o identificador de demonstração para o SPED Contábil, além do tipo de demonstrativo.
Incluir as linhas (planos) do demonstrativo
Para cada linha, o usuário inclui um “Plano”, informando o código hierárquico, a descrição, o tipo de linha (sintética ou analítica), a natureza contábil e devedora/credora, o nível hierárquico e, quando aplicável, o código do plano “pai”.
Vincular a origem de dados de cada linha
Para cada linha, o usuário cadastra de onde vem o valor: um intervalo de contas do plano de contas, um intervalo de linhas de outro demonstrativo, ou um intervalo de contas referenciais do SPED (bloco K300). É possível combinar até 6 origens por linha, cada uma associada a uma coluna de valor e a uma operação (soma, subtração etc.).
Salvar o modelo
Ao gravar, se a lista de planos já vier preenchida junto com o cabeçalho, todos os planos são salvos em conjunto. O sistema registra um log de auditoria da inclusão e confirma a gravação.
Descrição de Cada Campo da Tela da Lista de Modelos
Código do Modelo
Tipo: texto (chave)
Obrigatoriedade: obrigatório
Descrição: identificador único do modelo de demonstrativo contábil.
Comportamento: usado como chave em toda a estrutura de planos e origens de dados vinculada ao modelo.
Impacto: referenciado pela rotina de Demonstrativo Contábil ao gerar um demonstrativo real a partir deste modelo.
Nome do Modelo
Tipo: texto
Obrigatoriedade: obrigatório
Descrição: descrição do modelo de demonstrativo (ex: “Balanço Patrimonial”, “DRE”).
Comportamento: exibido na listagem e nas telas de seleção do demonstrativo.
Impacto: identifica o modelo para o usuário nas telas de geração de demonstrativos.
Máscara do Plano
Tipo: texto
Obrigatoriedade: obrigatório
Descrição: máscara de formatação usada para exibir o código do plano de contas dentro deste modelo.
Comportamento: aplicada na exibição dos códigos de conta relacionados às linhas do modelo.
Impacto: define como os códigos de conta aparecem nos relatórios gerados a partir deste modelo.
Quantidade de Colunas de Valor
Tipo: número
Obrigatoriedade: obrigatório
Descrição: quantidade de colunas de valor que o demonstrativo terá (relevante para o DMPL, que pode ter até 6 colunas/períodos).
Comportamento: determina quantas origens de dados (de 1 a 6) podem ser preenchidas em cada linha.
Impacto: define a estrutura de colunas exibida no demonstrativo gerado.
Identificador de Demonstração SPED
Tipo: seleção
Obrigatoriedade: obrigatório
Descrição: identifica o tipo de demonstração para fins do SPED Contábil (1 = pessoa jurídica; 2 = consolidada/outras).
Comportamento: usado na geração dos arquivos do SPED Contábil relacionados a este modelo.
Impacto: afeta a classificação do demonstrativo nos arquivos fiscais gerados.
Tipo de Demonstrativo
Tipo: seleção
Obrigatoriedade: obrigatório
Descrição: define o comportamento estrutural do modelo — se permite combinar contas de nível superior e inferior (tipos 1, 2 e 3), se é do tipo DLPA (tipo 4) ou DMPL (tipo 5).
Comportamento: altera as regras de validação de intervalo aplicadas às origens de dados das linhas.
Impacto: determina qual conjunto de validações e comportamentos de tela se aplica ao modelo.
Código do Plano (linha do demonstrativo)
Tipo: texto hierárquico (ex: “1.1.01”)
Obrigatoriedade: obrigatório
Descrição: código que posiciona a linha dentro da estrutura hierárquica do demonstrativo.
Comportamento: usado para validar intervalos de origem de dados que referenciam outras linhas do mesmo demonstrativo.
Impacto: define a ordem e a hierarquia de exibição da linha no demonstrativo gerado.
Nome da Linha
Tipo: texto
Obrigatoriedade: obrigatório
Descrição: descrição da linha do demonstrativo (ex: “Ativo Circulante”).
Comportamento: exibida no demonstrativo gerado.
Impacto: aparece como rótulo da linha no relatório final.
Tipo do Plano
Tipo: seleção
Obrigatoriedade: obrigatório
Descrição: indica se a linha é sintética (agrupadora) ou analítica.
Comportamento: usado nas validações de intervalo quando a origem de dados vem do plano de contas.
Impacto: define se a linha soma outras linhas (sintética) ou recebe valor diretamente de contas (analítica).
Tipo da Conta / Natureza da Conta
Tipo: seleção
Obrigatoriedade: obrigatório
Descrição: natureza contábil da linha (devedora/credora) e sua classificação.
Comportamento: usado para orientar o sinal do valor apresentado na linha do demonstrativo.
Impacto: afeta o cálculo do valor exibido no demonstrativo gerado.
Nível do Plano
Tipo: número
Obrigatoriedade: calculado/obrigatório conforme a hierarquia
Descrição: nível hierárquico da linha dentro da estrutura do modelo.
Comportamento: comparado entre a linha inicial e final de um intervalo de origem de dados — os dois devem ter o mesmo nível.
Impacto: garante consistência entre linhas de mesmo nível ao montar intervalos de dados.
Código do Plano Superior
Tipo: texto (lookup)
Obrigatoriedade: opcional
Descrição: código do plano “pai” — a linha imediatamente superior na hierarquia do demonstrativo.
Comportamento: ao editar um plano informando este campo, o sistema resolve o código do plano superior correspondente antes de gravar.
Impacto: define a estrutura de agrupamento/hierarquia exibida no demonstrativo.
Origem do Valor
Tipo: seleção (lista de domínio)
Obrigatoriedade: obrigatório
Descrição: de onde vem o valor da linha — intervalo de contas do plano de contas, intervalo de linhas de outro demonstrativo, ou contas do SPED (K300).
Comportamento: determina quais dos demais campos de origem de dados são obrigatórios e como são validados.
Impacto: define de onde o sistema busca o valor ao gerar o demonstrativo real.
Operação
Tipo: seleção (lista de domínio)
Obrigatoriedade: obrigatório
Descrição: operação aplicada ao valor obtido pela origem de dados (soma, subtração etc.).
Comportamento: combinada com o valor de origem para compor o resultado final da linha.
Impacto: afeta o cálculo do valor apresentado na linha do demonstrativo.
Coluna de Valor
Tipo: seleção
Obrigatoriedade: obrigatório
Descrição: qual coluna de valor do demonstrativo recebe o resultado desta origem de dados (ex: Saldo Inicial ou Saldo Final).
Comportamento: relevante principalmente em modelos com múltiplas colunas (como o DMPL).
Impacto: posiciona o valor calculado na coluna correta do demonstrativo gerado.
Conta Inicial / Conta Final (Plano de Contas)
Tipo: texto (lookup, código de conta)
Obrigatoriedade: obrigatório quando a origem do valor é o plano de contas
Descrição: intervalo de contas do plano de contas cujos saldos alimentam a linha.
Comportamento: as duas contas devem ter o mesmo nível hierárquico e o mesmo tipo (ambas sintéticas, ou inicial sintética e final analítica); a inicial não pode ser maior que a final.
Impacto: define o intervalo de contas somado para compor o valor da linha.
Demonstrativo Inicial / Demonstrativo Final
Tipo: texto (código de linha)
Obrigatoriedade: obrigatório quando a origem do valor é outro demonstrativo
Descrição: intervalo de linhas de outro demonstrativo (ou do próprio) que alimenta esta linha.
Comportamento: o código inicial e final do intervalo deve ser menor ou igual ao código da própria linha, exceto quando o tipo de demonstrativo permite contas de nível superior/inferior (tipos 1, 2 e 3).
Impacto: define quais linhas do demonstrativo são somadas para compor o valor desta linha.
Centro de Custos Inicial / Centro de Custos Final
Tipo: texto (lookup, opcional)
Obrigatoriedade: opcional
Descrição: filtro opcional de intervalo de centro de custos aplicado à origem de dados.
Comportamento: quando informado, restringe o cálculo do valor da linha àquele intervalo de centros de custo.
Impacto: permite montar demonstrativos segmentados por centro de custo.
Conta K300 Inicial / Conta K300 Final
Tipo: texto/número (código de conta referencial SPED)
Obrigatoriedade: obrigatório quando o modelo precisa gerar o bloco K300 do SPED Contábil
Descrição: intervalo de contas referenciais do SPED (registro K300) associadas a esta linha.
Comportamento: as duas contas do intervalo devem ter o mesmo nível hierárquico e a inicial não pode ser maior que a final.
Impacto: usado na geração do bloco K do arquivo do SPED Contábil.
Utilização e Consulta de Registros da Lista de Modelos
O usuário localiza modelos já cadastrados na listagem principal, que aceita paginação e um filtro de texto sobre nome/código do modelo; também é possível filtrar diretamente por um código de modelo específico. Há ainda uma consulta que retorna apenas o campo “Tipo de Demonstrativo” de um modelo, usada por telas dependentes para decidir regras específicas de exibição (por exemplo, no DMPL ou no DLPA), e uma listagem estruturada especificamente para telas do tipo DMPL.
A tela “Dados Relacionados” permite consultar os planos (linhas) já cadastrados de um modelo, buscar por demonstrativo e código, obter os planos “filhos” de um plano pai (estrutura hierárquica) e listar/consultar planos no formato específico usado pelo layout DLPA. Nenhuma dessas consultas grava dados — toda a manutenção é feita pela tela principal do modelo.
Processo de Edição da Lista de Modelos
O cabeçalho do modelo (nome, máscara, quantidade de colunas, tipo de demonstrativo etc.) pode ser editado a qualquer momento, desde que o usuário tenha a permissão “ModeloDemonstrativoContabil/Editar” (ID 414). Ao editar, toda a lista de planos (linhas) é reprocessada: para cada plano novo enviado na lista (sem um identificador ainda atribuído), o sistema gera um novo identificador sequencial antes de gravar.
As linhas (planos) e as origens de dados de cada linha são editadas individualmente pelas ações próprias de edição de plano e de edição de origem de dados, sujeitas às mesmas validações de intervalo aplicadas na criação.
Estrutura Técnica e Comportamento do Sistema da Lista de Modelos
O Modelo de Demonstrativo Contábil é a estrutura de base consumida pela rotina de Demonstrativo Contábil: é a partir do modelo (cabeçalho, planos e origens de dados) que os demonstrativos reais são calculados e gerados, buscando os valores no plano de contas, em outros demonstrativos já gerados, ou nas contas referenciais do SPED, conforme a origem de dados configurada em cada linha.
Excluir um modelo é uma operação em cascata: na mesma transação de banco, o sistema remove as linhas de demonstrativos já gerados a partir deste modelo, os cabeçalhos desses demonstrativos, as origens de dados dos planos, os próprios planos e, por fim, o modelo — a operação não pode ser desfeita depois de concluída.
A importação de layouts do SPED processa exatamente um tipo de arquivo por vez (BP, DR, DFC Direto, DFC Indireto, DLPA, DMPL ou DVA, verificados nessa ordem), populando automaticamente as linhas do modelo a partir dos arquivos-texto padrão do Manual de Orientação do SPED Contábil.
Regras de Negócio e Restrições da Lista de Modelos
Exclusão de origem de dados exige seleção
A ação de excluir uma origem de dados de um plano exige que tanto o plano quanto a sequência da origem de dados sejam informados.
Validação de intervalo quando a origem do valor é outro demonstrativo
Ao incluir ou editar uma origem de dados cuja origem do valor é uma linha de outro demonstrativo, o código inicial informado deve ser menor ou igual ao código da própria linha — a menos que o tipo de demonstrativo permita contas de nível superior/inferior (tipos 1, 2 e 3). O código inicial do intervalo também não pode ser maior que o final.
Validação de intervalo quando a origem do valor é o plano de contas
As contas inicial e final do intervalo devem ter o mesmo nível hierárquico e devem ser do mesmo tipo (ambas sintéticas, ou inicial sintética e final analítica). Essa validação se aplica de forma independente a cada uma das 6 origens de dados possíveis da linha.
Validação de intervalo de contas K300 (SPED)
Quando são informadas contas K300 inicial/final (em qualquer das 6 combinações possíveis), elas devem ter o mesmo nível hierárquico e a inicial não pode ser maior que a final.
Cópia de modelo exige código novo inexistente e modelo de origem válido
A ação de copiar um modelo exige que o novo código informado ainda não exista e que o modelo de origem tenha sido informado e realmente exista.
Exclusão em cascata
Excluir um modelo remove, na mesma operação, todos os demonstrativos contábeis já gerados a partir dele (cabeçalho e linhas), todos os planos e todas as origens de dados dos planos. A operação não pode ser desfeita.
Importação de layout SPED processa um tipo por vez
A importação processa exatamente um dos sete layouts de arquivo por chamada (DVA, DFC Direto, DFC Indireto, DLPA, DMPL, DR ou BP, verificados nessa ordem de prioridade); o usuário decide, através da opção “manter itens”, se os itens já cadastrados no modelo devem ser preservados durante a importação ou substituídos.
