Pacotes/Gestores
Criado por Igor Ribeiro em 13 de novembro de 2025
Atualizado por Igor Ribeiro em 03 de setembro de 2026
Pacotes/Gestores
Módulo Contabilidade > Orçamento — define, para cada Filial, quem são os responsáveis (Gestor Principal e Gestor Auxiliar) por acompanhar um Pacote de Gastos previamente cadastrado.
Visão Geral da Rotina
A rotina “Pacotes/Gestores” (Contabilidade / Orçamento / Pacotes/Gestores) permite definir, para cada Filial, quem são os responsáveis por acompanhar um Pacote de Gastos previamente cadastrado na rotina “Pacotes”. Cada registro desta rotina vincula uma Filial, um Pacote de Gastos, um Gestor Principal e, opcionalmente, um Gestor Auxiliar.
Vídeo Tutorial de Pacotes/Gestores
Pré-requisitos e Contexto de Acesso de Pacotes/Gestores
Para acessar a tela de Pacotes/Gestores, o usuário precisa da permissão “ListViewDeGestorDePacoteDeGasto” (ID 493), vinculada ao seu perfil de acesso no módulo Contabilidade. Sem essa permissão, o menu “Contabilidade / Orçamento / Pacotes/Gestores” não é exibido.
Cadastro Básico
“GestorDePacoteDeGasto/Novo” (ID 492), “GestorDePacoteDeGasto/Editar” (ID 489), “GestorDePacoteDeGasto/Excluir” (ID 490).
Exportação
“GestorDePacoteDeGasto/Exportar” (ID 491).
Processo de Criação — Passo a Passo
Acessar a tela de Pacotes/Gestores
O usuário acessa o menu “Contabilidade / Orçamento / Pacotes/Gestores”. O sistema exibe a listagem dos Gestores 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.
Selecionar a Filial
O usuário seleciona a Filial responsável pelo pacote. Este campo é obrigatório.
Selecionar o Pacote de Gastos
O usuário seleciona o Pacote de Gastos (cadastrado previamente na rotina “Pacotes”) que será acompanhado por este Gestor. Este campo é obrigatório.
Selecionar o Gestor Principal
O usuário seleciona, a partir do Cadastro Geral, a pessoa/entidade responsável principal pelo pacote nessa filial. Este campo é obrigatório.
Selecionar o Gestor Auxiliar
O usuário seleciona, a partir do Cadastro Geral, a pessoa/entidade que atua como responsável auxiliar. Este campo é obrigatório no momento do cadastro: se deixado em branco, o sistema bloqueia a gravação (ver Regra de Negócio 1).
Salvar o cadastro
O usuário confirma a gravação. O sistema grava o novo vínculo, atribui um código (ID) automático e exibe a confirmação “Gestor de Pacote de Gastos inserido com sucesso”. Se, por concorrência de cadastro, o código gerado já estiver em uso, o sistema tenta automaticamente obter o próximo código disponível e gravar novamente, sem exigir nova ação do usuário.
Descrição de Cada Campo da Tela de Pacotes/Gestores
Código
Tipo: número (somente leitura)
Obrigatoriedade: gerado automaticamente pelo sistema
Descrição: identificador único do vínculo entre Filial, Pacote de Gastos e Gestores.
Comportamento: atribuído automaticamente na gravação; se houver conflito de código na gravação, o sistema tenta novamente com o próximo código disponível.
Impacto: usado internamente para localizar, editar e excluir o registro.
Filial
Tipo: autocomplete/seleção
Obrigatoriedade: obrigatório
Descrição: filial à qual este vínculo de gestão se aplica.
Comportamento: exige uma Filial válida já cadastrada no sistema.
Impacto: usado para segmentar a responsabilidade de acompanhamento orçamentário por unidade da empresa.
Pacote de Gastos
Tipo: autocomplete/seleção
Obrigatoriedade: obrigatório
Descrição: Pacote de Gastos (rotina “Pacotes”) que este Gestor acompanha.
Comportamento: exige um Pacote de Gastos válido já cadastrado.
Impacto: define qual grupo de despesas está sob a responsabilidade deste gestor; a tela de Pacote de Gastos também exibe o(s) gestor(es) vinculados a ela.
Gestor Principal
Tipo: autocomplete/seleção
Obrigatoriedade: obrigatório
Descrição: pessoa/entidade (Cadastro Geral) responsável principal pelo acompanhamento do pacote na filial informada.
Comportamento: exige um Cadastro Geral válido já existente.
Impacto: identifica o principal responsável em relatórios e consultas de acompanhamento orçamentário.
Gestor Auxiliar
Tipo: autocomplete/seleção
Obrigatoriedade: obrigatório no cadastro pela tela (o sistema bloqueia a gravação de um novo registro se este campo estiver vazio — ver Regra de Negócio 1); a entidade de domínio, por si só, permite o campo vazio.
Descrição: pessoa/entidade (Cadastro Geral) que atua como responsável auxiliar/substituto do Gestor Principal.
Comportamento: exige um Cadastro Geral válido; se não for selecionado ao criar um novo Gestor, o sistema exibe mensagem de bloqueio e não grava o registro.
Impacto: identificado em relatórios e consultas como o responsável auxiliar pelo pacote.
Utilização e Consulta de Registros de Pacotes/Gestores
O usuário localiza Gestores de Pacote de Gastos já cadastrados na grid principal da tela “Contabilidade / Orçamento / Pacotes/Gestores”. A busca aceita: um texto (parte do nome da Filial, do Gestor Principal, do Gestor Auxiliar ou do Pacote de Gastos vinculados); ou um número (o Código do próprio registro, ou o código da Filial, do Gestor Principal, do Gestor Auxiliar ou do Pacote de Gastos).
A tela de Pacote de Gastos também permite localizar o Gestor vinculado diretamente a partir do código do pacote (consulta relacionada), sem que o usuário precise saber o código do próprio registro de Gestor.
Processo de Edição de Pacotes/Gestores
Os campos Filial, Pacote de Gastos, Gestor Principal e Gestor Auxiliar podem ser alterados após o cadastro — a edição sobrescreve todos os valores informados sobre o registro existente. O Código (ID) do vínculo não é editável, pois é a chave do registro. Não há indicação, no código analisado, de bloqueio de edição por status ou período — não foi identificada nenhuma condição que impeça a edição de um Gestor já cadastrado.
Estrutura Técnica e Comportamento do Sistema de Pacotes/Gestores
Pacotes de Gastos: cada Gestor referencia obrigatoriamente um Pacote de Gastos já existente (rotina “Pacotes”); a tela de Pacote de Gastos exibe a lista de Gestores vinculados a ele.
Filiais: o vínculo é sempre feito por Filial, permitindo que um mesmo Pacote de Gastos tenha gestores diferentes em cada unidade da empresa.
Cadastro Geral: os campos Gestor Principal e Gestor Auxiliar apontam para registros do Cadastro Geral (pessoas físicas/jurídicas ou entidades cadastradas no sistema).
Regras de Negócio e Restrições de Pacotes/Gestores
Gestor Auxiliar obrigatório na criação
Ao tentar cadastrar um novo Gestor de Pacote de Gastos sem informar o Gestor Auxiliar, o sistema bloqueia a operação. O usuário deve selecionar um Gestor Auxiliar válido para conseguir concluir o cadastro.
Filial, Pacote de Gastos e Gestor Principal sempre obrigatórios
Não é possível gravar um Gestor de Pacote de Gastos sem informar uma Filial, um Pacote de Gastos e um Gestor Principal válidos — esses três vínculos são exigidos pela própria estrutura do cadastro.
Recuperação automática em caso de conflito de código
Se, ao gravar um novo Gestor, ocorrer um conflito no código gerado automaticamente, o sistema tenta novamente de forma transparente ao usuário, buscando o próximo código disponível. Caso essa segunda tentativa também falhe, o usuário recebe uma mensagem de erro técnica (não tratada com uma mensagem de negócio específica).
