Entidades
Criado por Igor Ribeiro em 13 de novembro de 2025
Atualizado por Igor Ribeiro em 03 de setembro de 2026
Entidades
Módulo Contabilidade > Orçamento — cadastro das “Entidades de Gastos”, agrupadores usados para organizar os Centros de Custo do Plano de Contas por área de responsabilidade orçamentária.
Visão Geral de Entidades
A rotina de Entidades, dentro do módulo Contabilidade / Orçamento, permite cadastrar as “Entidades de Gastos” — agrupadores usados para organizar os Centros de Custo do Plano de Contas por área de responsabilidade orçamentária (por exemplo, “Despesas Administrativas”, “Despesas Comerciais”). Cada Entidade de Gastos criada aqui pode ser vinculada a um ou mais Centros de Custo e a Gestores, permitindo consolidar valores de orçamento por entidade nos relatórios do módulo.
Vídeo Tutorial de Entidades
Pré-requisitos e Contexto de Acesso de Entidades
Para visualizar a tela de Entidades, o usuário precisa ter a permissão “ListViewDeEntidadeDeGastos” (ID 483) atribuída ao seu perfil de acesso.
Cadastro Básico
“EntidadeDeGastos/Novo” (ID 482), “EntidadeDeGastos/Editar” (ID 479), “EntidadeDeGastos/Excluir” (ID 480).
Exportação
“EntidadeDeGastos/Exportar” (ID 481).
Processo de Criação — Passo a Passo de Entidades
Acessar a rotina
O usuário navega até “Contabilidade / Orçamento / Entidades” e aciona a opção de novo registro.
Preencher o Código
O usuário informa o campo “Código” (ID) da nova Entidade de Gastos. Este campo é obrigatório.
Preencher o Nome
O usuário informa o campo “Nome” da Entidade de Gastos. Este campo é obrigatório e aceita até 100 caracteres.
Selecionar o Status
O usuário seleciona o “Status da entidade” entre as opções disponíveis (Ativo, Inativo ou Fechado). Este campo é obrigatório.
Confirmar a criação
O usuário aciona o botão de salvar. O sistema grava a nova Entidade de Gastos e exibe a confirmação “Entidade de Gastos inserida com sucesso”.
Descrição de Cada Campo da Tela de Entidades
Código
Tipo: número
Obrigatoriedade: obrigatório
Descrição: identificador único da Entidade de Gastos dentro do sistema.
Comportamento: no cadastro de uma nova Entidade, o usuário informa o código manualmente (o sistema não gera automaticamente). Na edição, este campo identifica o registro e não deve ser alterado.
Impacto: usado para vincular Centros de Custo e Gestores a esta Entidade de Gastos, e para localizar o registro em consultas e relatórios de orçamento.
Nome
Tipo: texto
Obrigatoriedade: obrigatório
Descrição: nome descritivo da Entidade de Gastos (ex: “Despesas Administrativas”).
Comportamento: aceita até 100 caracteres. Se deixado em branco, o sistema bloqueia o salvamento com a mensagem de validação “Campo obrigatório”.
Impacto: aparece nas listagens da tela de Entidades, nas telas de vínculo (Entidades/Gestores) e nos relatórios que referenciam a Entidade de Gastos.
Status da entidade
Tipo: seleção
Obrigatoriedade: obrigatório
Descrição: indica a situação da Entidade de Gastos: Ativo, Inativo ou Fechado.
Comportamento: o usuário escolhe um dos três valores predefinidos do sistema. Se for informado um código de status diferente desses três valores, o sistema não sinaliza erro — apenas grava o status como vazio internamente.
Impacto: usado para filtrar/considerar a Entidade de Gastos como disponível ou não em consultas e vínculos do módulo de Orçamento.
Lista de centros de custo
Tipo: lista (somente exibição)
Obrigatoriedade: não aplicável (campo somente leitura, não editável nesta tela)
Descrição: relação dos Centros de Custo do Plano de Contas atualmente vinculados a esta Entidade de Gastos.
Comportamento: exibida apenas na consulta de uma Entidade específica; não é possível incluir ou remover vínculos por aqui.
Impacto: reflete o vínculo definido no cadastro do Centro de Custo; usado para conferência antes de excluir ou reorganizar uma Entidade.
Utilização e Consulta de Registros de Entidades
O usuário localiza Entidades de Gastos cadastradas na grid principal da tela, podendo filtrar pelo campo de busca por Código (se digitado um valor numérico) ou por Nome (busca parcial — encontra qualquer Entidade cujo nome contenha o texto digitado). A listagem é paginada.
Processo de Edição de Entidades
Todos os campos do cadastro (Nome e Status da entidade) podem ser alterados após a criação. O Código (ID) identifica o registro e funciona como chave — o sistema busca a Entidade de Gastos pelo Código informado e sobrepõe os demais campos recebidos; não há bloqueio adicional de campos além das validações de obrigatoriedade e tamanho já descritas na seção 5. Não há histórico de alterações (log de edição) identificado no fluxo desta rotina.
Estrutura Técnica e Comportamento do Sistema de Entidades
A Entidade de Gastos se integra com o cadastro de Centro de Custo do Plano de Contas (relação de consulta, um Centro de Custo pode apontar para uma Entidade de Gastos) e com o cadastro de Gestores (rotina “Entidades/Gestores”), que associa usuários responsáveis a uma ou mais Entidades de Gastos. Não foram identificadas integrações automáticas com lançamento contábil, estoque ou documentos fiscais nesta rotina.
Regras de Negócio e Restrições de Entidades
Nome e Status são obrigatórios
Ao salvar uma Entidade de Gastos sem preencher o Nome ou o Status, o sistema bloqueia o salvamento.
Limite de tamanho do Nome
O campo Nome aceita até 100 caracteres na regra de negócio, embora a mensagem de validação exibida ao usuário, quando o limite é ultrapassado, mencione “no máximo 50 caracteres” — trata-se de uma inconsistência do texto da mensagem em relação ao limite real (100), identificada na análise de código; recomenda-se validar esse comportamento com a equipe técnica antes de orientar o usuário final.
Exclusão sem verificação de vínculo
O sistema não verifica, na camada de regra de negócio, se a Entidade de Gastos possui Centros de Custo ou Gestores vinculados antes de permitir a exclusão. Caso exista uma restrição de integridade no banco de dados impedindo a exclusão de um registro referenciado, o erro pode aparecer de forma genérica (não foi identificada uma mensagem de negócio específica para esse cenário).
Consulta por Gestor
A tela de Entidades também é usada, internamente, para buscar todas as Entidades de Gastos vinculadas a um Gestor específico (usado pela rotina de Entidades/Gestores) — este comportamento não é uma tela separada, mas um modo alternativo da mesma consulta de detalhe.
