Pacotes
Criado por Rafaella Domingues em 13 de novembro de 2025
Atualizado por Elton Parma em 06 de setembro de 2026
Pacotes de Gastos
A rotina “Pacotes” (Contabilidade / Orçamento / Pacotes) permite cadastrar “Pacotes de Gastos”, agrupamentos de contas do Plano de Contas usados para acompanhar o orçamento por grupo de despesas.
Visão Geral da Rotina
A rotina “Pacotes” (Contabilidade / Orçamento / Pacotes) permite cadastrar “Pacotes de Gastos”, que são agrupamentos de contas do Plano de Contas usados para acompanhar o orçamento por grupo de despesas. Cada Pacote de Gastos pode ser vinculado a um “Indicador” (rotina Indicadores) para fins de classificação, e recebe um ou mais “Gestores” responsáveis por filial através da rotina “Pacotes/Gestores”.
O Pacote de Gastos é referenciado diretamente pelo campo “Pacote de Gastos” do cadastro de Plano de Contas — cada conta contábil pode apontar para um pacote, permitindo agrupar o resultado de várias contas sob o mesmo rótulo orçamentário.
Vídeo Tutorial
▶ Tutorial em vídeo: ainda não disponível para esta rotina.
Pré-requisitos e Contexto de Acesso
Para acessar a tela de Pacotes de Gastos, o usuário precisa da permissão “ListViewDePacoteDeGastos” (ID 468), vinculada ao seu perfil de acesso no módulo Contabilidade. Sem essa permissão, o menu “Contabilidade / Orçamento / Pacotes” não é exibido.
Para executar ações específicas dentro da tela, são exigidas permissões adicionais:
Novo
Permissão “PacoteDeGastos/Novo” (ID 467).
Editar
Permissão “PacoteDeGastos/Editar” (ID 464).
Excluir
Permissão “PacoteDeGastos/Excluir” (ID 465).
Exportar
Permissão “PacoteDeGastos/Exportar” (ID 466).
Não há dependência de cadastro prévio obrigatório para criar um Pacote de Gastos — o vínculo com um Indicador é opcional. Já o vínculo com o Plano de Contas é feito no sentido inverso: é a conta contábil que seleciona o Pacote de Gastos, não o contrário.
Processo de Criação — Passo a Passo
Acessar a tela de Pacotes
O usuário acessa o menu “Contabilidade / Orçamento / Pacotes”. O sistema exibe a listagem dos Pacotes de Gastos já cadastrados.
Abrir o formulário de novo cadastro
O usuário aciona a opção de “Novo” registro. O sistema exibe o formulário em branco para preenchimento.
Preencher o nome do pacote
O usuário informa o “Nome” do Pacote de Gastos. Este campo é obrigatório e aceita até 100 caracteres.
Selecionar o status
O usuário seleciona o “Status do pacote de gastos” (Ativo, Inativo ou Fechado). O campo é obrigatório.
Vincular um Indicador (opcional)
O usuário pode selecionar um “Indicador de gastos” previamente cadastrado na rotina Indicadores. Se nenhum indicador for selecionado, o pacote é salvo sem vínculo.
Salvar o cadastro
O usuário confirma a gravação. O sistema grava o novo Pacote de Gastos, atribui um código (ID) automático e exibe a confirmação “PacoteDeGastos inserido com sucesso”.
Descrição de Cada Campo da Tela
Código (Pacote de Gastos)
Tipo: número (somente leitura)
Obrigatoriedade: gerado automaticamente pelo sistema, não preenchido pelo usuário
Descrição: identificador único do Pacote de Gastos.
Comportamento: atribuído automaticamente na gravação do novo registro; usado para localizar o pacote em consultas e nos vínculos do Plano de Contas.
Impacto: é o valor gravado no campo “Pacote de Gastos” das contas do Plano de Contas que apontam para este pacote.
Nome (Pacote de Gastos)
Tipo: texto
Obrigatoriedade: obrigatório
Descrição: nome descritivo do agrupamento de gastos (ex: “Despesas Administrativas”).
Comportamento: aceita até 100 caracteres; usado como critério de busca por texto na listagem (busca por “contém”).
Impacto: exibido em todas as telas onde o Pacote de Gastos é referenciado, como na listagem de Gestores e no cadastro de Plano de Contas.
Status do pacote de gastos
Tipo: seleção
Obrigatoriedade: obrigatório
Descrição: indica a situação do pacote no seu ciclo de vida — Ativo (A), Inativo (I) ou Fechado (F).
Comportamento: controla se o pacote deve ou não continuar sendo usado para novos vínculos e apurações; o sistema aceita apenas esses três valores.
Impacto: [informação não disponível na análise de código — validar com analista/vídeo do sistema; não foi possível confirmar se o Status bloqueia a seleção do pacote em outras telas quando Inativo/Fechado].
Código do indicador de gastos
Tipo: autocomplete/seleção (busca de outro cadastro)
Obrigatoriedade: opcional
Descrição: vincula o Pacote de Gastos a um “Indicador” cadastrado na rotina Indicadores, usado para classificação/análise do gasto.
Comportamento: se não for selecionado nenhum indicador, o pacote é salvo sem vínculo (campo aceita nulo).
Impacto: usado para agrupar/filtrar pacotes de gastos por indicador em relatórios de orçamento.
Utilização e Consulta de Registros
O usuário localiza Pacotes de Gastos já cadastrados na grid principal da tela “Contabilidade / Orçamento / Pacotes”. A busca aceita:
Busca por texto
Um texto (parte do Nome do pacote — a busca localiza qualquer pacote cujo nome contenha o texto digitado).
Busca por número
Um número (o Código/ID exato do pacote).
Ao abrir o detalhe de um pacote específico, o sistema também exibe a lista de contas do Plano de Contas vinculadas a ele e a lista de Gestores associados.
Processo de Edição
Os campos Nome, Status do pacote de gastos e Código do indicador de gastos podem ser alterados livremente após o cadastro. O Código (ID) do pacote não é editável, pois é a chave usada pelos vínculos com o Plano de Contas e com os Gestores.
Não há registro de histórico/log de alterações de campo a campo exposto ao usuário nesta rotina — o sistema apenas grava um log técnico interno de auditoria de cada edição.
Estrutura Técnica e Comportamento do Sistema
Plano de Contas
Cada conta contábil pode apontar para um Pacote de Gastos através do campo “Pacote de Gastos” do seu próprio cadastro; por isso, um Pacote de Gastos com contas vinculadas não pode ser excluído (ver Regra 1).
Pacotes/Gestores
Cada Gestor cadastrado na rotina relacionada referencia obrigatoriamente um Pacote de Gastos e uma Filial, definindo quem é responsável pelo acompanhamento orçamentário daquele pacote naquela filial.
Indicadores
O vínculo com um Indicador é usado apenas para classificação — não há regra de bloqueio associada a essa ligação.
Regras de Negócio e Restrições
Bloqueio de exclusão quando há contas do Plano de Contas vinculadas
Se o usuário tentar excluir um Pacote de Gastos que ainda esteja referenciado por alguma conta do Plano de Contas, o sistema impede a exclusão e exibe a mensagem:
“Registro não excluído. O registro está vinculado a um plano de contas. Registro não pode ser excluído.”
Para conseguir excluir, o usuário deve primeiro remover o vínculo (trocar ou limpar o campo “Pacote de Gastos”) em todas as contas do Plano de Contas que apontam para esse pacote.
Nome obrigatório e limitado a 100 caracteres
O campo Nome não pode ficar em branco e não pode exceder 100 caracteres. Essa validação é aplicada pela própria entidade de domínio do Pacote de Gastos.
Status restrito a três opções
O campo Status do pacote de gastos só reconhece os valores Ativo, Inativo e Fechado; qualquer valor fora dessa lista não é reconhecido pelo sistema como um status válido.
Vínculo com Indicador é opcional
Diferente do vínculo com o Plano de Contas, a associação com um Indicador de gastos não é obrigatória: o Pacote de Gastos pode ser criado e mantido sem nenhum indicador vinculado.
