Rateio
Documentação Técnica Rateio Módulo Contabilidade — conjunto de rotinas que permite distribuir automaticamente o valor de um lançamento contábil (ou de um saldo do DRE) entre várias contas e centros de custo, em percentuais definidos pelo usuário. VISÃO GERAL O que o sistema faz A área de Rateio reúne as rotinas usadas para dividir automaticamente um valor contábil entre múltiplas contas do plano de contas e centros de custo, evitando que o usuário precise calcular e digitar manualmente cada parcela. Existem duas formas de rateio no sistema, que trabalham em conjunto: Rateio percentual (Critério Rateio) Cadastra-se um “Critério de Rateio” com uma lista de contas/centros de custo e o percentual do valor total que cabe a cada um (a soma sempre precisa fechar 100%). Esse critério pode ser referenciado diretamente em lançamentos contábeis, em lotes contábeis, ou usado dentro de um Modelo de Rateio. Rateio off-line (Modelo + Geração) Cadastra-se um “Modelo de Rateio” que informa, para cada conta de origem, para qual conta/centro de custo de destino (ou para qual Critério de Rateio) o saldo deve ser direcionado. Esse modelo, por si só, não gera nenhum lançamento — ele só produz efeito quando é aplicado pela rotina “Geração Rateio off-line”, que busca os saldos do DRE de um período e gera automaticamente os lançamentos de rateio em um lote contábil. ROTINAS DESTA ÁREA Cadastros e Processamento Critério Rateio Cadastro das regras de distribuição percentual usadas diretamente em lançamentos contábeis e lotes contábeis: cada critério define uma lista de contas/centros de custo e o percentual do valor que cabe a cada um, podendo variar por filial e data de vigência. Lista de Modelos Rateio Off-line Cadastro dos “modelos de rateio”: para cada conta de origem, define a conta/centro de custo de destino diretamente, ou aponta para um Critério de Rateio já cadastrado para desdobrar o valor em percentuais. É apenas um cadastro de referência — não gera lançamento por si só. Geração Rateio Off-line Aplica um Modelo de Rateio já cadastrado sobre os saldos do DRE (Demonstração de Resultado do Exercício) de um período escolhido, calculando os valores rateados e gravando automaticamente os lançamentos contábeis correspondentes em um lote contábil. PRÉ-REQUISITOS GERAIS Contexto de Acesso O acesso a cada uma das três telas é controlado por uma permissão própria (“ListViewDeCriterioRateio”, “ListViewDeModeloRateio” e a permissão da rotina de Geração Rateio off-line), com permissões adicionais e independentes para criar, editar, excluir, exportar e importar em cada uma. Antes de usar essas rotinas, o Plano de Contas e os Centros de Custo referenciados nos critérios e modelos precisam já estar cadastrados no sistema.
Apuração Custeio
Documentação Técnica Apuração Custeio Módulo Contabilidade > Custeio — apuração do custo dos itens de estoque movimentados em um período, com base nas fases de um Modelo de Custeio, com contabilização automática do valor apurado por fase. 01 — VISÃO GERAL Visão Geral da Apuração Custeio A rotina de Custeio, dentro do módulo Contabilidade, é onde o usuário apura o custo dos itens de estoque movimentados em um determinado período, com base nas fases configuradas em um Modelo de Custeio previamente cadastrado. O usuário informa a filial e o período (data inicial e data final), seleciona o Modelo de Custeio a aplicar e o sistema gera a lista de itens movimentados, permite ajustar o valor econômico de referência de cada item, calcula o rateio de custo fase a fase e, por fim, contabiliza os valores apurados em um lote contábil. Duas formas de processamento O Custeio pode ser processado de forma síncrona pela tela (ação “Atualizar Entradas e Saídas”), que trava a tela até concluir, ou de forma assíncrona (“Iniciar Custeio”), disparada para um serviço externo de processamento, acompanhada por um log de progresso enquanto roda em segundo plano. Dependência do Modelo de Custeio Esta rotina depende diretamente do cadastro de Modelo de Custeio (rotina “Contabilidade / Modelo de Custeio”), que define as fases, a origem do valor de cada fase e os planos de contas usados na contabilização. 02 — VÍDEO TUTORIAL Vídeo Tutorial ▶ Tutorial em vídeo: ainda não disponível para esta rotina. 03 — PRÉ-REQUISITOS Pré-requisitos e Contexto de Acesso da Apuração Custeio O usuário precisa ter a permissão “Apuração Custeio” para acessar a tela. Para criar, editar ou excluir um Custeio, são necessárias as permissões específicas de cada ação (Novo, Editar, Excluir). Para executar as etapas de apuração, são necessárias as permissões de “Obter Lista Para Gerar Itens”, “Aplicar Conteúdo Econômico”, “Calcular Custo dos Itens”, “Atualizar Entradas e Saídas”, “Contabilizar Valores da Fase” e/ou “Iniciar Custeio”, conforme as etapas executadas. Pré-requisitos de dados É pré-requisito a existência de um Modelo de Custeio já cadastrado e configurado (fases, origem do valor de cada fase, planos de contas de débito/crédito quando aplicável). Para Modelos de Custeio do tipo Fiscal ou Fiscal (Simplificado), é pré-requisito que exista fechamento de inventário de estoque fechado para o período apurado (ver Regra de Negócio 4). 04 — PASSO A PASSO Processo de Criação — Passo a Passo da Apuração Custeio 1 Criar o Custeio O usuário acessa “Contabilidade / Custeio / Apuração Custeio” e inicia um novo registro, informando Nome, Filial, Data Inicial, Data Final e o Modelo de Custeio a ser utilizado. O sistema grava o cabeçalho do Custeio. 2 Gerar a lista de itens O usuário aciona a geração da lista de itens do período (“Obter Lista Para Gerar Itens”). O sistema percorre cada fase do Modelo de Custeio e busca, para a filial e o período informados, as entradas e saídas de estoque associadas aos tipos de movimento configurados em cada fase, aplicando a visão de Ficha Técnica quando a fase estiver configurada dessa forma. 3 Aplicar o conteúdo econômico O usuário seleciona uma Lista de Preço e uma data de vigência e aciona “Aplicar Conteúdo Econômico”. O sistema busca o valor unitário de referência de cada item na lista de preço informada (exceto para itens de fase “Ficha Técnica”, cujo valor unitário é sempre 1), calcula o Valor Total Econômico de cada item e recalcula o percentual de participação de cada item dentro da sua fase. 4 Atualizar entradas e saídas (apurar o custo) O usuário aciona “Atualizar Entradas e Saídas”. O sistema valida se todos os itens têm valor econômico preenchido, verifica se existe fechamento de estoque compatível com o período (quando aplicável ao tipo de modelo), processa cada fase do Modelo de Custeio calculando o custo apurado e grava o resultado. Esta etapa pode demorar; o andamento pode ser acompanhado pelo log do processo. 5 Contabilizar os valores da fase O usuário aciona “Contabilizar Valores da Fase” informando a Filial e a Data Final do período. O sistema gera (ou reutiliza) um lote contábil do mês e cria um lançamento de débito/crédito para cada fase que tenha planos de contas configurados no Modelo de Custeio, com o valor apurado na fase. 6 (Alternativa aos passos 4 e 5) Iniciar Custeio Em vez de rodar a apuração pela tela, o usuário pode acionar “Iniciar Custeio”, que dispara o mesmo processamento de forma assíncrona em um serviço externo, liberando a tela imediatamente. O acompanhamento é feito pelo log do processo. 05 — CAMPOS DA TELA Descrição de Cada Campo da Tela da Apuração Custeio Nome Tipo: texto Obrigatoriedade: obrigatório Descrição: nome/descrição que identifica o registro de Custeio. Comportamento: texto livre. Impacto: exibido nas listagens e nos filtros de busca do Custeio. Filial Tipo: seleção Obrigatoriedade: obrigatório Descrição: filial para a qual o custeio será apurado. Comportamento: seleção de uma filial cadastrada no sistema. Impacto: usada para localizar as entradas/saídas de estoque e o fechamento de inventário do período; também usada na geração do lote contábil. Data Inicial / Data Final Tipo: data Obrigatoriedade: obrigatório Descrição: início e fim do período apurado. Comportamento: a Data Final também é usada para compor o número do lote contábil gerado na contabilização (ano/mês/dia). Impacto: usadas como filtro nas buscas de movimentação de estoque, na verificação de fechamento de inventário e na numeração do lote contábil. Modelo de Custeio Tipo: seleção Obrigatoriedade: obrigatório Descrição: modelo que define as fases de apuração e a contabilização do custeio. [informação não disponível na análise de código — validar com analista/vídeo do sistema: se a seleção do modelo é bloqueada após a geração de itens] Comportamento: ao ser selecionado, define quais fases serão percorridas na geração de itens e no cálculo de custo. Impacto: determina o tipo do modelo (Fiscal, Gerencial – RCPE, Fiscal Simplificado, Gerencial – RCPE Simplificado), que define qual fluxo de processamento e validações de fechamento de estoque serão aplicados. Lista de Preço / Data em Vigor Tipo: seleção + data Obrigatoriedade: obrigatório
Custeio
Documentação Técnica Custeio Módulo Contabilidade > Custeio — apuração do custo dos itens de estoque movimentados em um período, com base nas fases de um Modelo de Custeio, com contabilização automática do valor apurado por fase. 01 — VISÃO GERAL Visão Geral da Rotina A rotina de Custeio, dentro do módulo Contabilidade, é onde o usuário apura o custo dos itens de estoque movimentados em um determinado período, com base nas fases configuradas em um Modelo de Custeio previamente cadastrado. O usuário informa a filial e o período (data inicial e data final), seleciona o Modelo de Custeio a aplicar e o sistema gera a lista de itens movimentados, permite ajustar o valor econômico de referência de cada item, calcula o rateio de custo fase a fase e, por fim, contabiliza os valores apurados em um lote contábil. Duas formas de processamento O Custeio pode ser processado de forma síncrona pela tela (ação “Atualizar Entradas e Saídas”), que trava a tela até concluir, ou de forma assíncrona (“Iniciar Custeio”), disparada para um serviço externo de processamento, acompanhada por um log de progresso enquanto roda em segundo plano. Dependência do Modelo de Custeio Esta rotina depende diretamente do cadastro de Modelo de Custeio (rotina “Contabilidade / Modelo de Custeio”), que define as fases, a origem do valor de cada fase e os planos de contas usados na contabilização. 02 — VÍDEO TUTORIAL Vídeo Tutorial ▶ Tutorial em vídeo: ainda não disponível para esta rotina. 03 — PRÉ-REQUISITOS Pré-requisitos e Contexto de Acesso O usuário precisa ter a permissão “Apuração Custeio” (ListViewDeCusteio) para acessar a tela. Para criar, editar ou excluir um Custeio, são necessárias as permissões específicas de cada ação (Novo, Editar, Excluir). Para executar as etapas de apuração, são necessárias as permissões de “Obter Lista Para Gerar Itens”, “Aplicar Conteúdo Econômico”, “Calcular Custo dos Itens”, “Atualizar Entradas e Saídas”, “Contabilizar Valores da Fase” e/ou “Iniciar Custeio”, conforme as etapas executadas. Pré-requisitos de dados É pré-requisito a existência de um Modelo de Custeio já cadastrado e configurado (fases, origem do valor de cada fase, planos de contas de débito/crédito quando aplicável). Para Modelos de Custeio do tipo Fiscal ou Fiscal (Simplificado), é pré-requisito que exista fechamento de inventário de estoque fechado para o período apurado (ver Regra de Negócio 4). 04 — PASSO A PASSO Processo de Criação — Passo a Passo 1 Criar o Custeio O usuário acessa “Contabilidade / Custeio / Apuração Custeio” e inicia um novo registro, informando Nome, Filial, Data Inicial, Data Final e o Modelo de Custeio a ser utilizado. O sistema grava o cabeçalho do Custeio. 2 Gerar a lista de itens O usuário aciona a geração da lista de itens do período (“Obter Lista Para Gerar Itens”). O sistema percorre cada fase do Modelo de Custeio e busca, para a filial e o período informados, as entradas e saídas de estoque associadas aos tipos de movimento configurados em cada fase, aplicando a visão de Ficha Técnica quando a fase estiver configurada dessa forma. 3 Aplicar o conteúdo econômico O usuário seleciona uma Lista de Preço e uma data de vigência e aciona “Aplicar Conteúdo Econômico”. O sistema busca o valor unitário de referência de cada item na lista de preço informada (exceto para itens de fase “Ficha Técnica”, cujo valor unitário é sempre 1), calcula o Valor Total Econômico de cada item e recalcula o percentual de participação de cada item dentro da sua fase. 4 Atualizar entradas e saídas (apurar o custo) O usuário aciona “Atualizar Entradas e Saídas”. O sistema valida se todos os itens têm valor econômico preenchido, verifica se existe fechamento de estoque compatível com o período (quando aplicável ao tipo de modelo), processa cada fase do Modelo de Custeio calculando o custo apurado e grava o resultado. Esta etapa pode demorar; o andamento pode ser acompanhado pelo log do processo. 5 Contabilizar os valores da fase O usuário aciona “Contabilizar Valores da Fase” informando a Filial e a Data Final do período. O sistema gera (ou reutiliza) um lote contábil do mês e cria um lançamento de débito/crédito para cada fase que tenha planos de contas configurados no Modelo de Custeio, com o valor apurado na fase. 6 (Alternativa aos passos 4 e 5) Iniciar Custeio Em vez de rodar a apuração pela tela, o usuário pode acionar “Iniciar Custeio”, que dispara o mesmo processamento de forma assíncrona em um serviço externo, liberando a tela imediatamente. O acompanhamento é feito pelo log do processo. 05 — CAMPOS DA TELA Descrição de Cada Campo da Tela Nome Tipo: texto Obrigatoriedade: obrigatório Descrição: nome/descrição que identifica o registro de Custeio. Comportamento: texto livre. Impacto: exibido nas listagens e nos filtros de busca do Custeio. Filial Tipo: seleção Obrigatoriedade: obrigatório Descrição: filial para a qual o custeio será apurado. Comportamento: seleção de uma filial cadastrada no sistema. Impacto: usada para localizar as entradas/saídas de estoque e o fechamento de inventário do período; também usada na geração do lote contábil. Data Inicial / Data Final Tipo: data Obrigatoriedade: obrigatório Descrição: início e fim do período apurado. Comportamento: a Data Final também é usada para compor o número do lote contábil gerado na contabilização (ano/mês/dia). Impacto: usadas como filtro nas buscas de movimentação de estoque, na verificação de fechamento de inventário e na numeração do lote contábil. Modelo de Custeio Tipo: seleção Obrigatoriedade: obrigatório Descrição: modelo que define as fases de apuração e a contabilização do custeio. [informação não disponível na análise de código — validar com analista/vídeo do sistema: se a seleção do modelo é bloqueada após a geração de itens] Comportamento: ao ser selecionado, define quais fases serão percorridas na geração de itens e no cálculo de custo. Impacto: determina o tipo do modelo (Fiscal, Gerencial – RCPE, Fiscal Simplificado, Gerencial – RCPE Simplificado), que define qual fluxo de processamento e validações de fechamento de estoque serão aplicados. Lista de Preço / Data em Vigor Tipo: seleção + data Obrigatoriedade: obrigatório para executar a ação “Aplicar Conteúdo Econômico” Descrição: lista de
Indicadores
Documentação Técnica Indicadores Módulo Contabilidade > Orçamento — cadastro simples de apoio usado para classificar os Pacotes de Gastos, para fins de organização e análise do orçamento. 01 — VISÃO GERAL Visão Geral da Rotina A rotina “Indicadores” (Contabilidade / Orçamento / Indicadores) é um cadastro simples de apoio, usado para classificar os Pacotes de Gastos (rotina “Pacotes”). Cada Pacote de Gastos pode ser vinculado a um Indicador para fins de organização e análise do orçamento. 02 — VÍDEO TUTORIAL Vídeo Tutorial dos Indicadores ▶ Tutorial em vídeo: ainda não disponível para esta rotina. 03 — PRÉ-REQUISITOS Pré-requisitos e Contexto de Acesso dos Indicadores Para acessar a tela de Indicadores, o usuário precisa da permissão “ListViewDeIndicador” (ID 458), vinculada ao seu perfil de acesso no módulo Contabilidade. Sem essa permissão, o menu “Contabilidade / Orçamento / Indicadores” não é exibido. Cadastro Básico “Indicador/Novo” (ID 457), “Indicador/Editar” (ID 454), “Indicador/Excluir” (ID 455). Exportação “Indicador/Exportar” (ID 456). Sem dependência de cadastro prévio Não há dependência de outro cadastro prévio para criar um Indicador — é uma rotina independente, geralmente cadastrada antes de se usar o vínculo “Código do indicador de gastos” na rotina “Pacotes”. 04 — PASSO A PASSO Processo de Criação — Passo a Passo dos Indicadores 1 Acessar a tela de Indicadores O usuário acessa o menu “Contabilidade / Orçamento / Indicadores”. O sistema exibe a listagem dos Indicadores já cadastrados. 2 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. 3 Preencher o nome do indicador O usuário informa o “Nome” do Indicador. Este campo é obrigatório e aceita até 100 caracteres. 4 Selecionar o status O usuário seleciona o “Status do indicador” (Ativo, Inativo ou Fechado). O campo é obrigatório. 5 Salvar o cadastro O usuário confirma a gravação. O sistema grava o novo Indicador, atribui um código (ID) automático e exibe a confirmação “Indicador inserido com sucesso”. 05 — CAMPOS DA TELA Descrição de Cada Campo da Tela dos Indicadores Código Tipo: número (somente leitura) Obrigatoriedade: gerado automaticamente pelo sistema, não preenchido pelo usuário Descrição: identificador único do Indicador. Comportamento: atribuído automaticamente na gravação do novo registro. Impacto: é o valor gravado no campo “Código do indicador de gastos” dos Pacotes de Gastos que apontam para este indicador. Nome Tipo: texto Obrigatoriedade: obrigatório Descrição: nome descritivo do indicador de classificação (ex: “Consumo de Energia”). 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 Indicador é referenciado, como no cadastro de Pacote de Gastos. Status do indicador Tipo: seleção Obrigatoriedade: obrigatório Descrição: indica a situação do indicador no seu ciclo de vida — Ativo (A), Inativo (I) ou Fechado (F). Comportamento: 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 indicador em outras telas quando Inativo/Fechado]. 06 — CONSULTA DE REGISTROS Utilização e Consulta de Registros dos Indicadores O usuário localiza Indicadores já cadastrados na grid principal da tela “Contabilidade / Orçamento / Indicadores”. A busca aceita: um texto (parte do Nome do indicador — localiza qualquer indicador cujo nome contenha o texto digitado); ou um número (o Código/ID exato do indicador). 07 — EDIÇÃO Processo de Edição dos Indicadores Os campos Nome e Status do indicador podem ser alterados livremente após o cadastro. O Código (ID) do indicador não é editável, pois é a chave usada pelo vínculo com o Pacote de Gastos. 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. 08 — ESTRUTURA TÉCNICA Estrutura Técnica e Comportamento do Sistema dos Indicadores Pacotes de Gastos: cada Pacote de Gastos pode apontar para um Indicador através do campo “Código do indicador de gastos” do seu próprio cadastro; a rotina de Indicadores não sabe, no entanto, quais pacotes estão vinculados a ela (essa consulta reversa não é exposta nesta rotina). Diferentemente do Pacote de Gastos, a exclusão de um Indicador não possui uma validação de negócio própria para bloquear a exclusão quando ele está em uso (ver Regra de Negócio 2). 09 — REGRAS DE NEGÓCIO Regras de Negócio e Restrições dos Indicadores 1 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 Indicador. 2 Exclusão sem verificação própria de vínculo Ao contrário do Pacote de Gastos, a exclusão de um Indicador não possui um tratamento específico de mensagem quando ele está vinculado a um Pacote de Gastos. Se o usuário tentar excluir um Indicador em uso, o sistema pode apresentar um erro técnico de banco de dados em vez de uma mensagem de negócio explicando o motivo do bloqueio. Recomenda-se, antes de excluir um Indicador, verificar se ele não está mais sendo usado em nenhum Pacote de Gastos. 3 Status restrito a três opções O campo Status do indicador só reconhece os valores Ativo, Inativo e Fechado; qualquer valor fora dessa lista não é reconhecido pelo sistema como um status válido.
Pacotes/Gestores
Documentação Técnica 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. 01 — VISÃO GERAL 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. Dependência Essa rotina depende da rotina “Pacotes” (Pacote de Gastos) já ter pelo menos um registro cadastrado, pois todo Gestor precisa apontar para um Pacote de Gastos existente. 02 — VÍDEO TUTORIAL Vídeo Tutorial ▶ Tutorial em vídeo: ainda não disponível para esta rotina. 03 — PRÉ-REQUISITOS Pré-requisitos e Contexto de Acesso do Pacotes/Gestores Para acessar a tela de Pacotes/Gestores, o usuário precisa da permissão “Visualizar Gestores de Pacote de Gastos” (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 “Novo Gestor de Pacote de Gastos” (ID 492), “Editar Gestor de Pacote de Gastos” (ID 489), “Excluir Gestor de Pacote de Gastos” (ID 490). Exportação “Exportar Gestores de Pacote de Gastos” (ID 491). Pré-requisito de cadastro É necessário que exista previamente ao menos um Pacote de Gastos (rotina “Pacotes”) e uma Filial cadastrada, pois ambos são obrigatórios no vínculo do Gestor. 04 — PASSO A PASSO Processo de Criação — Passo a Passo do Pacotes/Gestores 1 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. 2 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. 3 Selecionar a Filial O usuário seleciona a Filial responsável pelo pacote. Este campo é obrigatório. 4 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. 5 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. 6 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). 7 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. 05 — CAMPOS DA TELA Descrição de Cada Campo da Tela do 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); o banco de dados, 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. 06 — CONSULTA DE REGISTROS Utilização e Consulta de Registros do 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. 07 — EDIÇÃO Processo de Edição do 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. 08 — ESTRUTURA TÉCNICA Estrutura Técnica e Comportamento do Sistema do 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 é
Pacotes
Documentação Técnica 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. 01 — VISÃO GERAL 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”. Observação importante 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. 02 — VÍDEO TUTORIAL Vídeo Tutorial ▶ Tutorial em vídeo: ainda não disponível para esta rotina. 03 — PRÉ-REQUISITOS 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). Dependências de cadastro 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. 04 — PASSO A PASSO Processo de Criação — Passo a Passo 1 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. 2 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. 3 Preencher o nome do pacote O usuário informa o “Nome” do Pacote de Gastos. Este campo é obrigatório e aceita até 100 caracteres. 4 Selecionar o status O usuário seleciona o “Status do pacote de gastos” (Ativo, Inativo ou Fechado). O campo é obrigatório. 5 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. 6 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”. 05 — CAMPOS DA TELA 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. 06 — CONSULTA DE REGISTROS 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). Detalhe do registro 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. 07 — PROCESSO DE EDIÇÃO 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. Observação 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. 08 — ESTRUTURA TÉCNICA 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
Entidades/Gestores
Documentação Técnica Entidades/Gestores Módulo Contabilidade > Orçamento — vincula uma Entidade de Gastos a uma Filial e a dois responsáveis (Gestor e Gestor auxiliar), definindo quem acompanha o orçamento daquela Entidade em cada Filial. 01 — VISÃO GERAL Visão Geral de Entidades/Gestores A rotina de Entidades/Gestores, dentro do módulo Contabilidade / Orçamento, permite vincular uma Entidade de Gastos a uma Filial e a dois responsáveis: um Gestor e um Gestor auxiliar. Esse vínculo define quem acompanha o orçamento de uma determinada Entidade de Gastos em cada Filial da empresa. É uma rotina complementar ao cadastro de Entidades (Contabilidade / Orçamento / Entidades). 02 — VÍDEO TUTORIAL Vídeo Tutorial de Entidades/Gestores ▶ Tutorial em vídeo: ainda não disponível para esta rotina. 03 — PRÉ-REQUISITOS Pré-requisitos e Contexto de Acesso de Entidades/Gestores Para visualizar a tela de Entidades/Gestores, o usuário precisa ter a permissão para visualizar Entidades/Gestores (ID 498) atribuída ao seu perfil de acesso. Cadastro Básico Criar Entidades/Gestores (ID 497), Editar Entidades/Gestores (ID 494), Excluir Entidades/Gestores (ID 495). Exportação Exportar Entidades/Gestores (ID 496). Pré-requisito de cadastro Antes de criar um vínculo, é necessário que já existam cadastrados: a Entidade de Gastos (rotina Contabilidade / Orçamento / Entidades), a Filial e os Cadastros Gerais (pessoas) que serão indicados como Gestor e Gestor auxiliar. 04 — PASSO A PASSO Processo de Criação — Passo a Passo de Entidades/Gestores 1 Acessar a rotina O usuário navega até “Contabilidade / Orçamento / Entidades/Gestores” e aciona a opção de novo registro. 2 Selecionar a Entidade de gastos O usuário seleciona a Entidade de Gastos que será vinculada. Campo obrigatório. 3 Selecionar a Filial O usuário seleciona a Filial à qual o vínculo se aplica. Campo obrigatório. 4 Selecionar o Gestor O usuário seleciona a pessoa (Cadastro Geral) responsável principal pela Entidade de Gastos nesta Filial. Campo obrigatório. 5 Selecionar o Gestor auxiliar O usuário seleciona a pessoa (Cadastro Geral) que atua como responsável auxiliar. Campo obrigatório apenas no momento da criação do vínculo — se deixado em branco, o sistema bloqueia o salvamento. 6 Confirmar a criação O usuário aciona o botão de salvar. Se o Gestor auxiliar não tiver sido informado, o sistema exibe a mensagem de bloqueio e não grava o registro. Caso todos os campos obrigatórios estejam preenchidos, o sistema grava o vínculo e exibe a confirmação “Gestor de entidade de gastos inserida com sucesso”. 05 — CAMPOS DA TELA Descrição de Cada Campo da Tela de Entidades/Gestores Entidade de gastos Tipo: seleção (autocomplete) Obrigatoriedade: obrigatório Descrição: Entidade de Gastos (cadastrada na rotina Contabilidade / Orçamento / Entidades) à qual este vínculo de gestão se refere. Comportamento: o usuário busca e seleciona a Entidade de Gastos desejada dentre as já cadastradas. Impacto: relaciona este vínculo à Entidade de Gastos correspondente; aparece nas listagens e exportações da rotina. Filial Tipo: seleção (autocomplete) Obrigatoriedade: obrigatório Descrição: Filial da empresa à qual este vínculo de gestão orçamentária se aplica. Comportamento: o usuário busca e seleciona a Filial dentre as cadastradas no sistema. Impacto: permite segmentar a responsabilidade orçamentária de uma mesma Entidade de Gastos por Filial. Gestor Tipo: seleção (autocomplete) Obrigatoriedade: obrigatório Descrição: pessoa (Cadastro Geral) responsável principal pelo acompanhamento da Entidade de Gastos na Filial selecionada. Comportamento: o usuário busca e seleciona a pessoa dentre os Cadastros Gerais existentes. Impacto: identifica o responsável principal em relatórios e consultas de gestão orçamentária. Gestor auxiliar Tipo: seleção (autocomplete) Obrigatoriedade: obrigatório na criação do vínculo (validação aplicada apenas na tela/ação de criação; não há a mesma exigência marcada na estrutura de dados interna do sistema) Descrição: pessoa (Cadastro Geral) que atua como responsável auxiliar/substituto pelo acompanhamento da Entidade de Gastos. Comportamento: se deixado em branco ao criar o vínculo, o sistema bloqueia o salvamento. Impacto: identifica o responsável auxiliar em relatórios e consultas de gestão orçamentária; pode aparecer em branco em listagens de vínculos já existentes. 06 — CONSULTA DE REGISTROS Utilização e Consulta de Registros de Entidades/Gestores O usuário localiza vínculos Gestor de Entidade cadastrados na grid principal da tela. O filtro de busca aceita: código do vínculo, código da Entidade de Gastos, código do Gestor ou código do Gestor auxiliar (quando um valor numérico é digitado); ou nome/código da Filial, nome do Gestor, nome do Gestor auxiliar ou nome da Entidade de Gastos (quando um texto é digitado, busca parcial). A listagem é paginada. 07 — EDIÇÃO Processo de Edição de Entidades/Gestores Todos os campos do vínculo (Entidade de gastos, Filial, Gestor e Gestor auxiliar) podem ser alterados após a criação — o sistema busca o vínculo pelo Código (ID) e sobrepõe os demais campos recebidos. Diferente da criação, não foi identificada, no código analisado, uma validação que bloqueie a edição caso o Gestor auxiliar seja removido/deixado em branco — essa exigência aparece apenas no fluxo de criação. Não há histórico de alterações (log de edição) identificado no fluxo desta rotina. 08 — ESTRUTURA TÉCNICA Estrutura Técnica e Comportamento do Sistema de Entidades/Gestores Esta rotina integra três cadastros do sistema: Entidade de Gastos (Contabilidade / Orçamento / Entidades), Filial e Cadastro Geral (usado tanto para o Gestor quanto para o Gestor auxiliar). Não foram identificadas integrações automáticas com lançamento contábil, estoque ou documentos fiscais. 09 — REGRAS DE NEGÓCIO Regras de Negócio e Restrições de Entidades/Gestores 1 Gestor auxiliar obrigatório apenas na criação Ao criar um novo vínculo sem informar o Gestor auxiliar, o sistema bloqueia a operação. Essa validação existe apenas no processo de criação — a estrutura interna de dados não marca esse campo como obrigatório de forma permanente, o que pode gerar diferença de comportamento entre criar e editar um vínculo; recomenda-se validar esse ponto com a equipe técnica. Mensagem exibida “Não foi possível concluir a operação. O gestor auxiliar está vazio. Preencha o campo e tente novamente.” 2 Demais campos sempre obrigatórios Entidade de gastos, Filial e Gestor são sempre obrigatórios, tanto na criação quanto na estrutura interna de dados. Mensagem exibida “Campo obrigatório” 3 Exclusão sem verificação adicional O sistema não realiza, na camada de regra de negócio analisada, nenhuma
Entidades
Documentação Técnica 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. 01 — VISÃO GERAL Visão Geral da Rotina 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. Operações disponíveis O usuário cria, edita, consulta e exclui Entidades de Gastos, e também exporta a listagem completa para arquivo. 02 — VÍDEO TUTORIAL Vídeo Tutorial de Entidades ▶ Tutorial em vídeo: ainda não disponível para esta rotina. 03 — PRÉ-REQUISITOS 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). Sem dependência de cadastro prévio Não há dependência de cadastro prévio de outra rotina para acessar esta tela; porém, para que uma Entidade de Gastos seja útil no orçamento, o Centro de Custo correspondente deve, em algum momento, ser vinculado a ela (esse vínculo é somente consultado aqui — a associação em si é feita no cadastro de Centro de Custo). 04 — PASSO A PASSO Processo de Criação — Passo a Passo de Entidades 1 Acessar a rotina O usuário navega até “Contabilidade / Orçamento / Entidades” e aciona a opção de novo registro. 2 Preencher o Código O usuário informa o campo “Código” (ID) da nova Entidade de Gastos. Este campo é obrigatório. 3 Preencher o Nome O usuário informa o campo “Nome” da Entidade de Gastos. Este campo é obrigatório e aceita até 100 caracteres. 4 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. 5 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 “EntidadeDeGastos inserida com sucesso”. 05 — CAMPOS DA TELA 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. 06 — CONSULTA DE REGISTROS 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. 07 — EDIÇÃO 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. 08 — ESTRUTURA TÉCNICA 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. 09 — REGRAS DE NEGÓCIO Regras de Negócio e Restrições de Entidades 1 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. Mensagem exibida “Campo obrigatório” (validação do campo, aplicada tanto ao Nome quanto ao Status da entidade) 2 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
Geração de Orçamento
Documentação Técnica Geração de Orçamento Módulo Contabilidade > Orçamento — cadastro do cabeçalho do orçamento e manutenção manual/automática dos itens (plano de contas x centro de custo x valor/percentual orçado). Conteúdo compartilhado com “Manutenção de Orçamentos”, tela derivada que confere e ajusta valores orçado x realizado. 01 — VISÃO GERAL Visão Geral da Geração de Orçamento O Orçamento no Período é a rotina do módulo Contabilidade que reúne duas telas sobre o mesmo dado de negócio (o orçamento e seus itens vinculados ao plano de contas): Contabilidade > Orçamento > Geração de Orçamento Tela principal de cadastro do cabeçalho do orçamento (filial, período, moeda alternativa, indicadores de gastos) e de manutenção manual dos itens do orçamento (plano de contas x centro de custo x valor/percentual orçado), com rotinas de geração automática de itens: importar de outro orçamento, importar a partir de uma faixa do plano de contas, importar de arquivo Excel, e exportar (grid e Excel). Contabilidade > Orçamento > Manutenção de Orçamentos Tela derivada, usada para conferir e ajustar rapidamente os valores orçado x realizado de um orçamento já existente, cruzando os itens do orçamento com os documentos de entrada e saída (movimentações) do período. Relação entre as duas telas A primeira tela cria e estrutura o orçamento; a segunda apenas atualiza valores orçado/realizado de itens já existentes (ou cria itens novos automaticamente quando aparece um documento sem item correspondente), sem alterar cabeçalho, indicadores ou o vínculo de plano de contas de um item já existente. 02 — VÍDEO TUTORIAL Vídeo Tutorial da Geração de Orçamento ▶ Tutorial em vídeo: ainda não disponível para esta rotina. 03 — PRÉ-REQUISITOS Pré-requisitos e Contexto de Acesso da Geração de Orçamento Para acessar a tela “Geração de Orçamento”, o usuário precisa da permissão “ListViewDeOrcamentoNoPeriodo” (ID 1117). A partir dessa permissão de acesso, as ações de gravação exigem permissões próprias: “OrcamentoNoPeriodo/Novo” (ID 537), “OrcamentoNoPeriodo/Editar” (ID 534), “OrcamentoNoPeriodo/Excluir” (ID 535), “OrcamentoNoPeriodo/Exportar” (ID 536), “OrcamentoNoPeriodo/ImportarItensDoOrcamento” (ID 538), “OrcamentoNoPeriodo/ImportarItensDoOrcamentoAPartirDoPlanoDeContas” (ID 539), “OrcamentoNoPeriodo/ImportarItensDoOrcamentoDeArquivoExcel” (ID 792) e “OrcamentoNoPeriodo/ExportarParaExcel” (ID 793). Para acessar a tela “Manutenção de Orçamentos”, o usuário precisa da permissão “EditViewDeManutencaoDeOrcamento” (ID 3295). Essa tela não tem permissões granulares próprias por ação — toda a interação é controlada nessa única permissão de acesso à rotina. Pré-requisito de negócio A tela “Manutenção de Orçamentos” só é útil sobre um orçamento já criado previamente na tela “Geração de Orçamento” — não é possível criar um orçamento novo a partir dela. 04 — PASSO A PASSO Processo de Criação da Geração de Orçamento — Passo a Passo 1 Abrir a tela “Geração de Orçamento” e iniciar um novo orçamento O usuário informa o cabeçalho: filial, período inicial e final orçado, e a moeda alternativa (câmbio), se aplicável. 2 Gravar o cabeçalho O sistema cria o registro do orçamento a partir do cabeçalho informado. 3 Preencher os itens do orçamento O usuário pode inserir os itens manualmente (plano de contas x centro de custo x valor ou percentual orçado) ou usar uma das rotinas de geração automática: • Importar itens de outro orçamento já existente — o usuário informa o orçamento de origem e o de destino; o sistema copia todos os itens do orçamento de origem para o de destino, recalculando o status de cada item copiado (ver Regra de Negócio 4). • Importar itens a partir de uma faixa do plano de contas — o usuário informa o código de conta inicial e final; o sistema gera um item para cada conta analítica com pacote de gastos associado dentro da faixa, usando o centro de custo vinculado à conta (ou o centro de custo “0” quando a conta não tiver um centro de custo próprio). Esta importação só é permitida se o orçamento de destino ainda não tiver nenhum item cadastrado (ver Regra de Negócio 5). • Importar itens de um arquivo Excel — o usuário envia um arquivo “.xls” ou “.xlsx” com as colunas código reduzido, centro de custo, percentual orçado, valor orçado e valor orçado na moeda; o sistema processa linha a linha, valida cada linha e devolve um relatório das linhas importadas com sucesso e das rejeitadas, agrupadas por motivo (ver Regra de Negócio 6). 4 Revisar e editar os itens do orçamento O usuário confere os itens do orçamento (gerados automaticamente ou digitados) e ajusta valores/percentuais e a lista de indicadores de gastos. 5 Gravar as alterações Ao salvar, o sistema sincroniza a lista completa de indicadores e de itens do orçamento em uma única operação: os itens/indicadores que já estavam gravados mas não aparecem mais na lista enviada são excluídos, os que já existem são atualizados e os novos são incluídos (ver Regra de Negócio 3). 05 — CAMPOS DA TELA Descrição de Cada Campo da Tela da Geração de Orçamento Tela “Geração de Orçamento” — cabeçalho Filial Tipo: seleção (combo/autocomplete de filiais) Obrigatoriedade: obrigatório Descrição: filial à qual o orçamento pertence. Comportamento: ao ser selecionada, o nome da filial é exibido automaticamente ao lado (somente leitura). Impacto: define o conjunto de documentos de entrada/saída considerados na conferência de “Manutenção de Orçamentos”. Período Inicial e Período Final Tipo: data Obrigatoriedade: obrigatório Descrição: intervalo de datas coberto pelo orçamento. Comportamento: define o período que será usado depois para conferir os valores realizados na tela “Manutenção de Orçamentos” — qualquer filtro de data usado naquela tela precisa estar dentro deste intervalo (ver Regra de Negócio 7). Impacto: usado para restringir os documentos financeiros/contábeis considerados na apuração do valor realizado. Moeda Tipo: seleção (código da moeda alternativa/câmbio) Obrigatoriedade: opcional Descrição: moeda alternativa usada para exibir os valores do orçamento convertidos, além do valor em moeda corrente. Comportamento: quando informada, os valores orçado e realizado dos itens passam a ter também sua versão convertida na moeda alternativa. Impacto: aparece nos campos “Valor Orçado na Moeda” e “Valor Utilizado na Moeda” dos itens do orçamento. Indicadores de Gastos Tipo: lista editável (indicador + valor do indicador) Obrigatoriedade: opcional Descrição: indicadores de referência vinculados ao orçamento (parâmetros usados para acompanhamento de gastos). Comportamento: toda a lista é substituída
Manutenção de Orçamentos
Documentação Técnica Manutenção de Orçamentos Módulo Contabilidade > Orçamento — tela derivada de “Geração de Orçamento”, usada para conferir e ajustar rapidamente os valores orçado x realizado de um orçamento já existente, cruzando os itens com os documentos de entrada e saída do período. 01 — VISÃO GERAL Visão Geral da Manutenção de Orçamentos O Orçamento no Período é a rotina do módulo Contabilidade que reúne duas telas sobre o mesmo dado de negócio (o orçamento e seus itens vinculados ao plano de contas): Contabilidade > Orçamento > Geração de Orçamento Tela principal de cadastro do cabeçalho do orçamento (filial, período, moeda alternativa, indicadores de gastos) e de manutenção manual dos itens do orçamento (plano de contas x centro de custo x valor/percentual orçado), com rotinas de geração automática de itens: importar de outro orçamento, importar a partir de uma faixa do plano de contas, importar de arquivo Excel, e exportar (grid e Excel). Contabilidade > Orçamento > Manutenção de Orçamentos Tela derivada, usada para conferir e ajustar rapidamente os valores orçado x realizado de um orçamento já existente, cruzando os itens do orçamento com os documentos de entrada e saída (movimentações) do período. Relação entre as duas telas A primeira tela cria e estrutura o orçamento; a segunda apenas atualiza valores orçado/realizado de itens já existentes (ou cria itens novos automaticamente quando aparece um documento sem item correspondente), sem alterar cabeçalho, indicadores ou o vínculo de plano de contas de um item já existente. 02 — VÍDEO TUTORIAL Vídeo Tutorial da Manutenção de Orçamentos ▶ Tutorial em vídeo: ainda não disponível para esta rotina. 03 — PRÉ-REQUISITOS Pré-requisitos e Contexto de Acesso da Manutenção de Orçamentos Para acessar a tela “Geração de Orçamento”, o usuário precisa da permissão “ListViewDeOrcamentoNoPeriodo” (ID 1117). A partir dessa permissão de acesso, as ações de gravação exigem permissões próprias: “OrcamentoNoPeriodo/Novo” (ID 537), “OrcamentoNoPeriodo/Editar” (ID 534), “OrcamentoNoPeriodo/Excluir” (ID 535), “OrcamentoNoPeriodo/Exportar” (ID 536), “OrcamentoNoPeriodo/ImportarItensDoOrcamento” (ID 538), “OrcamentoNoPeriodo/ImportarItensDoOrcamentoAPartirDoPlanoDeContas” (ID 539), “OrcamentoNoPeriodo/ImportarItensDoOrcamentoDeArquivoExcel” (ID 792) e “OrcamentoNoPeriodo/ExportarParaExcel” (ID 793). Para acessar a tela “Manutenção de Orçamentos”, o usuário precisa da permissão “EditViewDeManutencaoDeOrcamento” (ID 3295). Essa tela não tem permissões granulares próprias por ação — toda a interação é controlada nessa única permissão de acesso à rotina. Pré-requisito de negócio A tela “Manutenção de Orçamentos” só é útil sobre um orçamento já criado previamente na tela “Geração de Orçamento” — não é possível criar um orçamento novo a partir dela. 04 — PASSO A PASSO Processo de Criação — Passo a Passo da Manutenção de Orçamentos 1 Abrir a tela “Geração de Orçamento” e iniciar um novo orçamento O usuário informa o cabeçalho: filial, período inicial e final orçado, e a moeda alternativa (câmbio), se aplicável. 2 Gravar o cabeçalho O sistema cria o registro do orçamento a partir do cabeçalho informado. 3 Preencher os itens do orçamento O usuário pode inserir os itens manualmente (plano de contas x centro de custo x valor ou percentual orçado) ou usar uma das rotinas de geração automática: • Importar itens de outro orçamento já existente — o usuário informa o orçamento de origem e o de destino; o sistema copia todos os itens do orçamento de origem para o de destino, recalculando o status de cada item copiado (ver Regra de Negócio 4). • Importar itens a partir de uma faixa do plano de contas — o usuário informa o código de conta inicial e final; o sistema gera um item para cada conta analítica com pacote de gastos associado dentro da faixa, usando o centro de custo vinculado à conta (ou o centro de custo “0” quando a conta não tiver um centro de custo próprio). Esta importação só é permitida se o orçamento de destino ainda não tiver nenhum item cadastrado (ver Regra de Negócio 5). • Importar itens de um arquivo Excel — o usuário envia um arquivo “.xls” ou “.xlsx” com as colunas código reduzido, centro de custo, percentual orçado, valor orçado e valor orçado na moeda; o sistema processa linha a linha, valida cada linha e devolve um relatório das linhas importadas com sucesso e das rejeitadas, agrupadas por motivo (ver Regra de Negócio 6). 4 Revisar e editar os itens do orçamento O usuário confere os itens do orçamento (gerados automaticamente ou digitados) e ajusta valores/percentuais e a lista de indicadores de gastos. 5 Gravar as alterações Ao salvar, o sistema sincroniza a lista completa de indicadores e de itens do orçamento em uma única operação: os itens/indicadores que já estavam gravados mas não aparecem mais na lista enviada são excluídos, os que já existem são atualizados e os novos são incluídos (ver Regra de Negócio 3). 05 — CAMPOS DA TELA Descrição de Cada Campo da Tela da Manutenção de Orçamentos Tela “Geração de Orçamento” — cabeçalho Filial Tipo: seleção (combo/autocomplete de filiais) Obrigatoriedade: obrigatório Descrição: filial à qual o orçamento pertence. Comportamento: ao ser selecionada, o nome da filial é exibido automaticamente ao lado (somente leitura). Impacto: define o conjunto de documentos de entrada/saída considerados na conferência de “Manutenção de Orçamentos”. Período Inicial e Período Final Tipo: data Obrigatoriedade: obrigatório Descrição: intervalo de datas coberto pelo orçamento. Comportamento: define o período que será usado depois para conferir os valores realizados na tela “Manutenção de Orçamentos” — qualquer filtro de data usado naquela tela precisa estar dentro deste intervalo (ver Regra de Negócio 7). Impacto: usado para restringir os documentos financeiros/contábeis considerados na apuração do valor realizado. Moeda Tipo: seleção (código da moeda alternativa/câmbio) Obrigatoriedade: opcional Descrição: moeda alternativa usada para exibir os valores do orçamento convertidos, além do valor em moeda corrente. Comportamento: quando informada, os valores orçado e realizado dos itens passam a ter também sua versão convertida na moeda alternativa. Impacto: aparece nos campos “Valor Orçado na Moeda” e “Valor Utilizado na Moeda” dos itens do orçamento. Indicadores de Gastos Tipo: lista editável (indicador + valor do indicador) Obrigatoriedade: opcional Descrição: indicadores de referência vinculados ao orçamento (parâmetros usados para acompanhamento de gastos). Comportamento: toda a lista é substituída por completo
