Orçamento
Criado por Rafaella Domingues em 13 de novembro de 2025
Atualizado por Rafaella Domingues em 25 de agosto de 2026
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.
Visão Geral da Rotina
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.
Vídeo Tutorial
Pré-requisitos e Contexto de Acesso
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.
Processo de Criação — Passo a Passo
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.
Gravar o cabeçalho
O sistema cria o registro do orçamento a partir do cabeçalho informado.
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).
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.
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).
Descrição de Cada Campo da Tela
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 ao editar o orçamento — indicadores não reenviados na lista são excluídos.
Impacto: usado como referência de acompanhamento do orçamento, sem afetar diretamente o cálculo de valor orçado/realizado dos itens.
Tela “Geração de Orçamento” — item do orçamento
Pacote de Gastos
Tipo: exibição informativa (associado automaticamente ao plano de contas do item)
Obrigatoriedade: não aplicável — herdado do cadastro do plano de contas
Descrição: pacote de gastos vinculado ao plano de contas do item.
Comportamento: é exigido pelo sistema ao importar itens a partir do plano de contas ou de arquivo Excel — contas sem pacote de gastos são rejeitadas nessas importações (ver Regra de Negócio 6).
Impacto: usado como critério de agrupamento em relatórios de acompanhamento de gastos.
Código Reduzido / Código Contábil / Nome do Plano de Contas
Tipo: seleção (autocomplete de plano de contas)
Obrigatoriedade: obrigatório
Descrição: conta do plano de contas orçada neste item.
Comportamento: precisa ser uma conta analítica cadastrada — contas sintéticas ou inexistentes são rejeitadas nas importações (ver Regra de Negócio 6).
Impacto: é a chave usada para cruzar o valor orçado com o valor movimentado nos documentos, na tela “Manutenção de Orçamentos”.
Centro de Custo
Tipo: seleção (autocomplete de centro de custo/controle)
Obrigatoriedade: obrigatório (com fallback automático para “0” em algumas importações)
Descrição: centro de custo/controle vinculado ao item do orçamento.
Comportamento: nas importações a partir do plano de contas, quando a conta não tem centro de custo próprio vinculado, o sistema usa o centro de custo “0” como padrão; na importação de Excel, um centro de custo informado que não exista é rejeitado (ver Regra de Negócio 6).
Impacto: junto com o plano de contas, é a chave usada para cruzar valor orçado x realizado.
Percentual Orçado
Tipo: número (percentual)
Obrigatoriedade: condicional — usado como alternativa ao “Valor Orçado”
Descrição: percentual orçado para o item, como alternativa a informar um valor fixo.
Comportamento: se o usuário informar um percentual maior que zero, o sistema zera automaticamente o “Valor Orçado” desse item — os dois campos nunca ficam preenchidos ao mesmo tempo (ver Regra de Negócio 2).
Impacto: usado no lugar do valor orçado nos cálculos de acompanhamento do item.
Valor Orçado
Tipo: valor monetário
Obrigatoriedade: condicional — usado como alternativa ao “Percentual Orçado”
Descrição: valor orçado fixo para o item.
Comportamento: se não houver percentual informado (ou for zero), este é o valor considerado; caso contrário, é automaticamente zerado (ver Regra de Negócio 2).
Impacto: é o valor comparado com o valor realizado na tela “Manutenção de Orçamentos”.
Valor Orçado na Moeda
Tipo: valor monetário (calculado a partir da moeda alternativa)
Obrigatoriedade: opcional — depende de o orçamento ter moeda alternativa configurada
Descrição: valor orçado convertido para a moeda alternativa do orçamento.
Comportamento: calculado/gravado junto com o valor orçado quando há moeda configurada.
Impacto: exibido nos relatórios e na exportação para Excel.
Status do Item
Tipo: exibição informativa (calculado pelo sistema)
Obrigatoriedade: não aplicável — não editado diretamente pelo usuário
Descrição: situação do item do orçamento (por exemplo, “Somente para análise” ou “Bloqueio realizado maior que orçado”).
Comportamento: recalculado automaticamente nas importações (ver Regra de Negócio 4) e na criação implícita de itens pela tela de Manutenção (ver Regra de Negócio 9).
Impacto: usado para sinalizar ao usuário itens que merecem atenção (por exemplo, realizado acima do orçado).
Valor Utilizado
Tipo: valor monetário (calculado, geralmente somente leitura na tela de Geração)
Obrigatoriedade: não aplicável
Descrição: valor efetivamente realizado (movimentado) para aquele item.
Comportamento: alimentado principalmente pela tela “Manutenção de Orçamentos”.
Impacto: é comparado com o valor orçado para indicar excesso ou sobra de orçamento.
Tela “Manutenção de Orçamentos” — item conferido
Plano de Contas
Tipo: exibição informativa (código reduzido e código contábil)
Obrigatoriedade: obrigatório
Descrição: conta do plano de contas do item sendo conferido.
Comportamento: vem do item de orçamento já existente ou do documento que originou um item novo “on the fly”.
Impacto: chave de cruzamento com os documentos de entrada/saída do período.
Centro de Custo
Tipo: exibição informativa (ID e nome do centro de custo)
Obrigatoriedade: obrigatório
Descrição: centro de custo do item sendo conferido.
Comportamento: idem ao plano de contas — vem do item existente ou do documento de origem.
Impacto: chave de cruzamento, junto com o plano de contas.
Valor Orçado (conferido)
Tipo: valor monetário
Obrigatoriedade: opcional (itens criados “on the fly” a partir de um documento começam com valor orçado zero)
Descrição: valor orçado do item, exibido para comparação direta com o valor realizado.
Comportamento: ao salvar, se o item já existir, o valor orçado é atualizado; se não existir, um novo item é criado com esse valor.
Impacto: junto com o percentual orçado, segue a mesma regra de exclusividade descrita na Regra de Negócio 2.
Valor Realizado
Tipo: valor monetário (calculado, somente leitura)
Obrigatoriedade: não aplicável — calculado pelo sistema
Descrição: valor apurado a partir dos documentos de entrada e saída da filial do orçamento, dentro do período (ou subintervalo filtrado), excluindo documentos cancelados e sem centro de custo.
Comportamento: recalculado a cada consulta com base nos filtros de tipo de documento, tipo de movimento e perfil aplicados na tela.
Impacto: é este valor, junto com o “Valor Orçado”, que é gravado no item ao confirmar a atualização (ver Regra de Negócio 10).
Valor Orçado na Moeda / Valor Realizado na Moeda
Tipo: valor monetário (calculado a partir da moeda alternativa)
Obrigatoriedade: opcional — depende de o orçamento ter moeda alternativa
Descrição: mesmos valores de orçado/realizado, convertidos para a moeda alternativa do orçamento.
Comportamento: calculado junto com os valores em moeda corrente.
Impacto: exibido apenas como referência complementar na tela.
Utilização e Consulta de Registros
Na tela “Geração de Orçamento”, o usuário localiza orçamentos já cadastrados em uma listagem com paginação e ordenação, com um campo de busca que aceita data, código numérico do orçamento/filial ou nome da filial.
Na tela “Manutenção de Orçamentos”, o usuário seleciona o orçamento a conferir e pode filtrar a grade de conferência por tipo de documento, tipo de movimento, perfil (este último só é considerado se o tipo de movimento não for informado) e por um intervalo de datas — que precisa estar contido no período do orçamento (ver Regra de Negócio 7).
Processo de Edição
Na tela “Geração de Orçamento”, a edição do orçamento (ação “Editar”) permite alterar o cabeçalho e sincronizar por completo a lista de indicadores e a lista de itens: indicadores/itens que estavam gravados mas não constam mais na lista enviada são excluídos; os já existentes são atualizados; e os novos são incluídos.
Estrutura Técnica e Comportamento do Sistema
O orçamento se integra com o Plano de Contas (cada item do orçamento está vinculado a uma conta analítica e a um pacote de gastos) e com o Centro de Custo/Controle. A tela “Manutenção de Orçamentos” se integra diretamente com os documentos de Entrada e Saída do módulo de Movimentação: o valor realizado exibido é somado diretamente a partir desses documentos (não é uma leitura de saldo contábil já lançado), filtrando por filial, período, tipo de documento, tipo de movimento e perfil, e excluindo documentos cancelados. A importação de arquivo Excel usa um arquivo temporário no servidor, que é sempre excluído ao final do processamento, tenha a importação sido bem-sucedida ou não. A exportação para Excel gera um arquivo chamado “TabelaDeOrcamentoNoPeriodo.xlsx”.
Regras de Negócio e Restrições
Duas telas, um mesmo dado
“Geração de Orçamento” cria e estrutura o cabeçalho e os itens do orçamento (inclusive geração automática de itens); “Manutenção de Orçamentos” apenas confere e ajusta valores orçado x realizado de um orçamento já existente, item a item, sem editar cabeçalho nem indicadores.
Percentual e valor orçado são exclusivos
Ao gravar a lista de itens (tanto pela edição do orçamento quanto pela atualização na tela de Manutenção), se o item tem o percentual orçado maior que zero, o valor orçado desse item é zerado automaticamente; caso contrário, é o percentual que é zerado. Um item de orçamento nunca guarda percentual e valor orçado preenchidos ao mesmo tempo — o percentual tem prioridade quando informado.
Sincronização por diferença na edição
Na edição do orçamento, tanto a lista de indicadores quanto a lista de itens são substituídas por completo: os que estavam gravados mas não vieram na lista enviada pela tela são excluídos; os que vieram são atualizados (se já existirem) ou incluídos como novos.
Importação de outro orçamento
Ao importar itens de um orçamento de origem, cada item copiado recebe um status recalculado: se o status original do item de origem era o inicial (sem bloqueio), o novo item recebe o status “Somente para análise”; qualquer outro status original resulta no status “Bloqueio realizado maior que orçado”. A importação sempre executa, mesmo que o orçamento de origem esteja sem itens — nesse caso, simplesmente nada é copiado.
Importação a partir do Plano de Contas
Duas condições bloqueiam esta importação: se o código de conta inicial ou final informado não corresponder a uma conta analítica cadastrada; ou se o orçamento de destino já possuir algum item cadastrado (para evitar duplicar itens). Contas da faixa que já existem como item do orçamento de destino são automaticamente excluídas da lista a importar. Contas sem centro de custo próprio vinculado recebem o centro de custo “0” como padrão.
Importação de arquivo Excel
Somente arquivos “.xls” ou “.xlsx” são aceitos. Cada linha é validada nesta ordem: a linha precisa ter exatamente 5 colunas e código reduzido ou centro de custo não vazios; o plano de contas precisa existir e ser conta analítica; o centro de custo informado precisa existir; a conta precisa ter pacote de gastos associado; os valores de percentual/valor orçado precisam ser numéricos válidos; e se já existir um item para o mesmo plano de contas + centro de custo, a linha é reportada como “já existem no orçamento” e não é duplicada. O arquivo temporário enviado é sempre excluído do servidor ao final, com sucesso ou não.
Consulta para Manutenção com data fora do período
Na tela “Manutenção de Orçamentos”, o filtro de data informado precisa estar contido no período do orçamento (entre a data inicial e a data final do período); fora desse intervalo, a consulta é bloqueada.
Atualização pela Manutenção sem itens
Se a lista de itens conferidos enviada pela tela de Manutenção estiver vazia, a atualização é bloqueada.
Criação implícita de item na Manutenção
Ao gravar pela tela de Manutenção, um item sem um item de orçamento correspondente informado não é rejeitado: o sistema cria um novo item de orçamento a partir do plano de contas e centro de custo informados, com status inicial “Somente para análise” — mesmo que esse item tenha aparecido na grade apenas porque um documento de entrada/saída movimentou aquela combinação sem orçamento prévio.
Origem do valor realizado na Manutenção
O valor realizado exibido e gravado na tela de Manutenção vem exclusivamente dos documentos de Entrada e Saída da filial do orçamento, dentro do período (ou do subintervalo de datas filtrado), excluindo documentos com status “Cancelado” e sem centro de custo. Não é uma leitura de saldo contábil já lançado — é uma soma direta do valor líquido dos itens desses documentos.
