Valor Monetário

O campo Valor Monetário permite que o usuário armazene valores monetários como preços, valores a pagar, etc. Além disso, com ele é possível configurar regras de correção para o valor armazenado, fazendo-o variar acompanhando um dos 41 índices disponíveis no ENSPACE.

Como funciona

  • No formulário, o usuário pode selecionar a moeda desejada, como Real Brasileiro (BRL) ou Dólar Americano (USD), por exemplo e inserir o valor numérico a ser armazenado.
  • Se a opção Configurar Correção Monetária estiver habilitada, é possível configurar opções de correção monetária sobre o valor.
  • Pode ser utilizado em formulários e relatórios.

Como configurar

  1. No menu esquerdo, vá até a seção "Configurações".
  2. Acesse "Categorias" e selecione a categoria desejada.
  3. Vá em "Campos" e clique em "Criar".
  4. Dê um nome curto ao seu campo (com até 31 caracteres; a referência será preenchida automaticamente).
  5. Defina o label do seu campo — aqui você pode inserir um nome mais longo e descritivo.

    ⚠️ Atenção: O nome exibido no formulário será sempre o definido no campo "Label".

  6. Selecione o tipo "Valor Monetário".
Configuração do campo Valor Monetário

Configurações do tipo

  • Configurar Correção Monetária: permite que o usuário defina opções de correção monetária no formulário:
  1. Resultado esperado:Visualização do campo Valor Monetário

Exemplo de uso

  • Armazenar valores monetários em cadastros de produtos, serviços ou faturas.
  • Aplicar correção monetária em contratos financeiros.
  • Gerenciar orçamentos e despesas com atualização automática de valores.
  • Registrar salários e benefícios com ajustes periódicos.
  • Controlar investimentos e rendimentos financeiros com base em índices econômicos.
  • Monitorar custos operacionais e ajustar conforme a inflação.
  • Calcular preços de venda considerando variações econômicas.
  • Estimar custos em processos judiciais com correção monetária.

Configurações de Correção Monetária

Ao habilitar a opção Configurar Correção Monetária, você pode definir as seguintes configurações clicando no ícone de menu à direita do campo nos formulários:

Configuração de períodos de correção

Períodos de Correção

A correção monetária de um valor ocorre em períodos definidos pelo usuário. Você pode adicionar múltiplos períodos de correção monetária, cada um com suas próprias configurações:

  1. Índice ou Alíquota: selecione um dos 41 índices disponíveis no ENSPACE para aplicar a correção monetária.
  2. Data Inicial: defina a data a partir da qual a correção monetária será aplicada.
  3. Data Final: opcionalmente, defina a data até a qual a correção monetária será aplicada.

Caso opte por efetuar a correção com base em um percentual, selecione a opção "Percentual" no seletor "Índice ou Alíquota" e insira o valor desejado no campo que aparecerá.

Múltiplos Períodos

Ao habilitar a opção "Múltiplos Períodos", você pode definir diferentes períodos de correção monetária para o mesmo valor. Isso é útil quando o valor precisa ser corrigido em diferentes intervalos de tempo com índices distintos. A correção será aplicada sequencialmente, respeitando as datas definidas para cada período.

Múltiplos períodos de correção

💡 No modo Múltiplos Períodos, apenas o último deles pode ter o campo "Data Final" vazio.

Correção Automática

Ao submeter o formulário, o ENSPACE verificará se há necessidade de aplicar correção monetária imediatamente com base nas configurações definidas. Os seguintes critérios são considerados para determinar se a correção deve ser aplicada no momento da submissão:

  1. O primeiro (ou único) período está apto para correção, ou seja:
  • se ele for percentual, ele sempre está apto;
  • se for baseado em índice, ele é corrigível se:
    • não possui data final e o Índice escolhido tem competência sobre a data inicial. Ex: Data Inicial: 01/06/2023; Índice: IPCA com última competência em 01/05/2023. A última competência do índice cobre até um mês à frente, para índices de atualização mensal, ou um dia à frente para taxas de câmbio (Euro e Dólar).
  • possui data final e o Índice escolhido tem competência sobre a data final. Ex: Data Final: 01/06/2023; Índice: IPCA com última competência em 01/05/2023.
  1. Caso não seja corrigível, o ENSPACE irá aguardar até a publicação de uma atualização do índice para aplicar a correção monetária posteriormente. A verificação ocorre diariamente, sempre à meia-noite.
  2. Quando uma data final não é fornecida, o ENSPACE irá aplicar a correção monetária sempre que um novo valor do índice for publicado, atualizando o valor armazenado no campo. Quando é fornecida, e é uma data futura, a correção ocorrerá quando saírem atualizações do índice até a data final.

Visualização de valores corrigidos

O campo de Valor Monetário é exibido no seguinte formato em tabelas e pastas: Visualização do campo de valor monetário

O valor exibido considera a correção monetária aplicada, se houver. Ao passar o mouse sobre o valor, uma tooltip exibe o valor original e os detalhes da correção aplicada: Tooltip com detalhes da correção monetária

Importação de Valores Monetários

Para procedimentos de importação relacionados e para detalhes sobre ações em massa, acesse: Ações em Massa.

Ao baixar o modelo de planilha para importação de itens, os campos do tipo Valor Monetário serão representados em 4 colunas na aba principal e 5 em abas à parte. Um campo com a referência valor será representado da seguinte forma:

Coluna na PlanilhaDescrição
valorUma referência única e arbitrária para ser usada na aba correspondente às configurações de períodos. Ex.: valor_1
valor_currencyCódigo da moeda (ex: BRL, USD)
valor_valueValor corrente (ex: 1500.75)
valor_original_valueValor original antes da correção (ex: 1300.00)
Representação do campo Valor Monetário na planilha de importação

Cada campo do tipo Valor Monetário terá uma aba própria na planilha, nomeada segundo a referência do campo, para configurar os períodos de correção. No nosso exemplo, a aba será chamada valor. Aba de configuração de períodos de correção na planilha de importação

Coluna na PlanilhaDescrição
refReferência para uma linha da primeira aba, indicando a qual linha da aba principal o período corresponde. Ex.: valor_1
index_codeCódigo do índice (ex: ipca, cdi)
start_dateData inicial do período de correção (ex: 01/06/2023)
end_dateData final do período de correção (ex: 30/06/2023). Esta coluna é opcional se houver apenas um período ou se for o último dos períodos de correção do campo
percentagePercentual de correção aplicado no período (ex: 0.3), aplicado somente se a coluna index_code for definida como percentage

💡 Se mais de uma linha na aba de períodos referenciar uma mesma linha da aba principal, isso habilita Múltiplos Períodos de correção para aquele campo. É importante que as datas sejam períodos contíguos de tempo, com a data inicial do período subsequente iniciando um dia após a data final do anterior.

Índices Disponíveis

nameindex_code
SELICselic
IPCA-15ipca_15
CDIcdi
TJDF (não expurgada)tjdf_nao_expurgada
INPCinpc
TJSCtjsc
JAM - 4jam_4_percent
TJACtjac
TJMAtjma
IPCA-Eipcae
IPCAipca
TJSEtjse
TJRStjrs
JAM - 6jam_6_percent
JAM - 3jam_3_percent
TJCEtjce
JAM - 5jam_5_percent
TJTOtjto
TJDF (expurgada)tjdf_expurgada
TJPItjpi
TJALtjal
TJGOtjgo
IGP-DIigp_di
TJSPtjsp
TJBAtjba
TJEStjes
IGPMigpm
TJMGtjmg
TJAMtjam
TJPEtjpe
TJMTtjmt
TJAPtjap
TJMStjms
TJRRtjrr
Poupançasavings_account
TJROtjro
TJRJtjrj
TJPAtjpa
TJRNtjrn
TRtr
TBFtbf
Euroeuro
Dólardolar
Percentualpercentage