Valor Monetário
Configure campos para valores monetários
O campo do tipo Valor Monetário é utilizado para registrar valores financeiros em formulários, tarefas e telas do ENSPACE.
Ele é ideal para preços, valores a pagar, orçamentos, despesas, salários, benefícios, investimentos e qualquer informação que represente uma quantia em moeda.
Além do armazenamento do valor, o campo permite selecionar a moeda desejada e, quando habilitada, aplicar correção monetária automática com base em índices oficiais.
Quando usar este campo
Utilize o campo Valor Monetário quando precisar armazenar e tratar quantias financeiras no sistema.
Ele é ideal para:
- Cadastros de produtos e serviços
- Faturas e valores a pagar
- Orçamentos e despesas
- Contratos financeiros com correção monetária
- Registro de salários e benefícios
- Controle de investimentos e rendimentos
- Custos operacionais e ajustes por inflação
- Cálculo de preços de venda
- Estimativas de custos em processos judiciais
- Qualquer valor que exiba moeda e possa sofrer correção monetária
Informações básicas do campo
Todo campo no ENSPACE possui quatro informações básicas que são definidas no momento da criação:
- Nome do campo — nome interno utilizado nas configurações da categoria. Possui limite de 31 caracteres. Não é necessariamente o nome exibido para o usuário final.
- Rótulo Visível (Label) — nome exibido para os usuários em formulários, tarefas e telas. Possui limite de 255 caracteres. Pode ser mais descritivo que o nome interno e pode ser alterado posteriormente sem impactar automações ou referências técnicas.
- Referência técnica — identificador técnico do campo, gerado automaticamente em formato
snake_case. É utilizado em expressões, variáveis, fluxos, automações e referências internas. - Descrição — descrição interna para adicionar contexto ao campo. Ajuda configuradores a entenderem a finalidade do campo e auxilia recursos de IA do ENSPACE durante pesquisas e interpretações automáticas.
Como o campo funciona
O campo Valor Monetário funciona como um campo numérico especializado para finanças.
No formulário, o usuário pode selecionar a moeda desejada, como Real Brasileiro (BRL) ou Dólar Americano (USD), e inserir o valor numérico a ser armazenado.
Se a opção Configurar Correção Monetária estiver habilitada, o sistema aplica regras de correção sobre o valor com base em um dos 41 índices disponíveis.
O valor pode ser utilizado em formulários, relatórios, filtros, expressões e automações.
Configurações específicas
O campo Valor Monetário possui configurações próprias relacionadas a moeda e correção monetária.
| Configuração | Descrição |
|---|---|
| Configurar Correção Monetária | Permite definir opções de correção monetária no formulário. |
Configurar Correção Monetária
Ao habilitar esta opção, o campo permite configurar períodos de correção monetária sobre o valor armazenado.
Períodos de Correção
A correção monetária ocorre em períodos definidos pelo usuário. Você pode adicionar múltiplos períodos, 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.
- Data Inicial: data a partir da qual a correção será aplicada.
- Data Final: data até a qual a correção será aplicada (opcional).
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.
Correção Automática
Ao submeter o formulário, o ENSPACE verifica se há necessidade de aplicar correção monetária imediatamente com base nas configurações definidas.
Os seguintes critérios são considerados:
- O primeiro (ou único) período está apto para correção:
- Se for percentual, sempre está apto.
- Se for baseado em índice, é 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 aguardará até a publicação de uma atualização do índice para aplicar a correção posteriormente. A verificação ocorre diariamente, sempre à meia-noite.
- Quando uma data final não é fornecida, o ENSPACE aplica a correção monetária sempre que um novo valor do índice for publicado, atualizando o valor armazenado. Quando é fornecida e é uma data futura, a correção ocorre 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:
Í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 |
Como configurar
Crie um novo campo
Acesse Configurações > Categorias > Campos e clique em Criar.
Preencha as informações básicas
Defina o nome do campo, a referência técnica, o rótulo visível (Label) e selecione o tipo Valor Monetário.
Configure a correção monetária
Na seção Configurações Específicas, habilite e defina as opções de correção monetária conforme a necessidade.
Ajuste a interface do campo
Na aba Interface e Formatação, configure a moeda padrão e o modo de exibição, se aplicável.
Salve o campo
Após salvar, o campo poderá ser utilizado em formulários, tarefas e telas.
Comportamento dos dados
Algumas alterações feitas no campo afetam apenas novos preenchimentos:
- Alterar a moeda padrão não modifica registros antigos.
- Adicionar ou remover correção monetária não retroage automaticamente em valores já armazenados.
- Mudanças nos períodos de correção só serão aplicadas caso o item seja editado novamente.
O valor continua sendo numérico internamente mesmo quando exibido com símbolo de moeda ou correção aplicada.
Boas práticas
- Utilize o campo Valor Monetário para todos os valores que representem quantias financeiras reais.
- Configure a correção monetária para contratos, processos judiciais e valores sujeitos a atualização por índices.
- Prefira índices oficiais ao invés de percentuais arbitrários quando a correção deve seguir legislação ou normas técnicas.
- Defina datas de início e fim claras para evitar correções indeterminadas indevidas.
- Utilize múltiplos períodos apenas quando o valor realmente necessitar de índices diferentes em intervalos distintos.
- Evite utilizar este campo para identificadores numéricos que não representem dinheiro, como códigos de produto ou números de protocolo.