Variáveis

Valores vinculados a variáveis do projeto e variáveis de usuário.

Visão geral

Uma variável é um valor do projeto que pode ser vinculado a um campo numérico, no lugar de um número fixo. Em vez de digitar "R$ 1.200.000" como o custo de corretagem de um terreno, você informa "3% da aquisição do terreno". O Orbit calcula o valor e o recalcula sempre que a variável mudar.

Variáveis são o equivalente das datas relativas para valores. Elas mantêm a simulação coerente: se o preço de aquisição de um terreno for renegociado, tudo que estiver vinculado a ele, como a corretagem, o ITBI ou uma taxa de estruturação, acompanha automaticamente.

Elas podem ser usadas em campos de valor em todo o Orbit, como orçamentos de obras e aprovações, montantes de composições e métodos de pagamento, financiamentos e parcerias.

Tipos de variável

O Orbit oferece três tipos de variável, e cada um é combinado com o campo de uma forma:

TipoExemplosComo o valor é calculado
Valores do projetoVGV, orçamento de obra, aquisição de terrenoUm percentual do valor da variável
ÁreasÁrea privativa, área do terrenoUm valor em reais por m² multiplicado pela área
Variáveis de usuárioÁrea verde, área de lazer, qualquer valor criado por vocêUm fator multiplicado pelo valor da variável

Valores do projeto

São os principais valores calculados pelo Orbit a partir do cadastro do projeto:

O campo Fração define o percentual aplicado. Uma corretagem de 3% sobre a aquisição do terreno é a variável Aquisição de Terreno com fração de 3%. Se a fração ficar em branco, o valor é considerado por inteiro, a 100%.

Áreas

As variáveis de área permitem informar custos por metro quadrado:

  • Área Privativa – A área privativa dos produtos, do projeto inteiro, de uma linha de receita, de uma fase de aprovação ou de uma obra.
  • Área do Terreno – A área total de um ou de todos os terrenos.

O campo R$ define o valor por metro quadrado. Um custo de paisagismo de R$ 45/m² de área do terreno é a variável Área do Terreno com R$ 45.

Variáveis de usuário

Variáveis de usuário são valores criados por você, com um nome e um tipo, e reaproveitados em quantos campos forem necessários. Elas são úteis para dados do projeto que o Orbit não calcula, como as áreas de um loteamento:

  • Área Institucional, Área Verde, Área de Lazer, Área de Preservação
  • Área de Vias, Área Recuada, Área Pública, Área de Implantação
  • Área Construída, Área Computável da Construção, Área Não Computável da Construção, Área Permeável
  • Outros, para qualquer outro valor

O campo Fator define o multiplicador. Uma taxa de manutenção de R$ 2,50 por m² de área verde é a variável de área verde com fator 2,50.

As variáveis de usuário pertencem à simulação: cada simulação tem as suas, e elas não são compartilhadas entre simulações ou projetos.

Vincular uma variável a um campo

  1. Passe o mouse sobre o campo de valor e clique em Vincular, no canto esquerdo do campo
  2. Escolha a variável no menu
  3. Para variáveis que existem em mais de um objeto, escolha Geral ou o objeto específico no submenu, conforme descrito abaixo
  4. Informe a fração, o valor por m² ou o fator, no topo do menu

O campo passa a mostrar o valor calculado, com um ícone de Vincular abaixo dele indicando que ele está vinculado. Para voltar a um valor fixo, passe o mouse sobre o campo e clique em Desvincular. O campo passa a guardar o valor que a variável representava naquele momento, que não muda mais.

Geral ou objeto específico

A maioria das variáveis pode se referir ao projeto inteiro ou a um objeto específico:

  • Geral – O valor consolidado do projeto, como o orçamento de todas as obras.
  • Um objeto específico – O valor de uma obra, terreno, linha de receita ou fase em particular, como o orçamento da "Torre A".
Dica

Vincule ao objeto específico quando o custo pertence a ele. Uma taxa de 2% sobre o orçamento da "Torre A" não deve crescer quando uma nova torre for cadastrada.

Gerenciar variáveis de usuário

  1. Passe o mouse sobre o campo de valor e clique em Vincular
  2. Em Variáveis de Usuário, clique em Criar variável
  3. Escolha o Tipo, digite o Nome e informe o Valor
  4. Confirme a criação clicando em Concluir
  1. No menu lateral da simulação, clique em Biblioteca
  2. Selecione a seção Variáveis
  3. Clique em Nova variável
  4. Preencha o nome, a descrição (opcional), o valor e o tipo de variável
  5. Clique em Adicionar

Na biblioteca, você também pode buscar, filtrar por tipo, editar e excluir as variáveis da simulação. Ao editar o valor de uma variável, todos os campos vinculados a ela são recalculados.

Importante

Uma variável em uso não pode ser excluída. Remova os vínculos dos campos que a utilizam antes de excluí-la.

Variáveis definidas pelo sistema

Alguns campos têm a variável definida pelo Orbit, porque o seu valor precisa acompanhar uma referência específica para que o cálculo esteja correto. O ITBI, por exemplo, é sempre um percentual da aquisição do terreno. Nesses casos:

  • O campo não pode ser desvinculado, e o menu mostra apenas a variável definida pelo sistema.
  • Você ainda pode ajustar a fração, como a alíquota do ITBI.

Alguns campos também não aceitam variáveis de usuário, como a corretagem de terrenos. Nesses campos, a opção Variáveis de Usuário não aparece no menu.

Vínculos quebrados

Se o objeto de uma variável específica for excluído, como uma obra ou um terreno, o campo perde a sua referência e indica que o vínculo está quebrado. Escolha outra variável ou desvincule o campo para manter o último valor calculado como um valor fixo.

Exemplos

Corretagem sobre a aquisição

Uma corretagem de 3% sobre a aquisição do terreno "Lote 12".

  • Variável – Aquisição de Terreno, do "Lote 12"
  • Fração – 3%

Com uma aquisição de R$ 4.000.000, a corretagem é de R$ 120.000. Se a aquisição for renegociada para R$ 4.500.000, a corretagem passa a R$ 135.000.

Custo por metro quadrado

Um custo de projeto de arquitetura de R$ 35 por m² de área privativa da "Torre A".

  • Variável – Área Privativa, da obra "Torre A"
  • R$ – 35,00

Com 12.000 m² de área privativa, o custo é de R$ 420.000.

Áreas de um loteamento

Uma taxa de manutenção de R$ 1,80 por m² de área verde, em um loteamento com 25.000 m² de área verde.

  1. Crie a variável de usuário "Área verde do loteamento", com o tipo Área Verde e o valor 25.000
  2. Vincule o campo à variável, com fator 1,80

O valor do campo é de R$ 45.000. Se o projeto urbanístico mudar a área verde, basta editar a variável na biblioteca.

Conteúdo relacionado

  • Datas relativas – O equivalente das variáveis para datas.
  • Conceitos – Definições de VGV bruto, VGV líquido e outros indicadores.
  • Métodos de pagamento – Onde as variáveis definem os montantes das composições.
  • Operações aritméticas – Como calcular valores diretamente nos campos numéricos.
  • Biblioteca – Onde as variáveis de usuário da simulação são criadas, editadas e excluídas.

FAQ

Encontrou o que procurava nesta página?
© 2026 Midwest Labs S/A.
Esta documentação foi escrita por humanos.