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
- No menu esquerdo, vá até a seção "Configurações".
- Acesse "Categorias" e selecione a categoria desejada.
- Vá em "Campos" e clique em "Criar".
- Dê um nome curto ao seu campo (com até 31 caracteres; a referência será preenchida automaticamente).
- 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".
- Selecione o tipo "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:
- Resultado esperado:

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:

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:
- Índice ou Alíquota: selecione um dos 41 índices disponíveis no ENSPACE para aplicar a correção monetária.
- Data Inicial: defina a data a partir da qual a correção monetária será aplicada.
- 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.

💡 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:
- 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.
- 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.
- 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:

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:

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 Planilha | Descrição |
|---|---|
valor | Uma referência única e arbitrária para ser usada na aba correspondente às configurações de períodos. Ex.: valor_1 |
valor_currency | Código da moeda (ex: BRL, USD) |
valor_value | Valor corrente (ex: 1500.75) |
valor_original_value | Valor original antes da correção (ex: 1300.00) |

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.

| Coluna na Planilha | Descrição |
|---|---|
ref | Referência para uma linha da primeira aba, indicando a qual linha da aba principal o período corresponde. Ex.: valor_1 |
index_code | Código do índice (ex: ipca, cdi) |
start_date | Data inicial do período de correção (ex: 01/06/2023) |
end_date | Data 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 |
percentage | Percentual 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
| name | index_code |
|---|---|
| SELIC | selic |
| IPCA-15 | ipca_15 |
| CDI | cdi |
| TJDF (não expurgada) | tjdf_nao_expurgada |
| INPC | inpc |
| TJSC | tjsc |
| JAM - 4 | jam_4_percent |
| TJAC | tjac |
| TJMA | tjma |
| IPCA-E | ipcae |
| IPCA | ipca |
| TJSE | tjse |
| TJRS | tjrs |
| JAM - 6 | jam_6_percent |
| JAM - 3 | jam_3_percent |
| TJCE | tjce |
| JAM - 5 | jam_5_percent |
| TJTO | tjto |
| TJDF (expurgada) | tjdf_expurgada |
| TJPI | tjpi |
| TJAL | tjal |
| TJGO | tjgo |
| IGP-DI | igp_di |
| TJSP | tjsp |
| TJBA | tjba |
| TJES | tjes |
| IGPM | igpm |
| TJMG | tjmg |
| TJAM | tjam |
| TJPE | tjpe |
| TJMT | tjmt |
| TJAP | tjap |
| TJMS | tjms |
| TJRR | tjrr |
| Poupança | savings_account |
| TJRO | tjro |
| TJRJ | tjrj |
| TJPA | tjpa |
| TJRN | tjrn |
| TR | tr |
| TBF | tbf |
| Euro | euro |
| Dólar | dolar |
| Percentual | percentage |