Regras de conversão de moeda

Editar online

Nas regras Envizi™ ESG Suite de atribuição, você pode configurar uma função SQL CURRENCYCONVERT especial para converter moedas.

A função é declarada como CURRENCYCONVERT(target_currency, source_currency, field, conversion_rate_date). A tabela a seguir lista os parâmetros de entrada:
Tabela 1. Parâmetros de entrada da função de conversão de moeda
Parâmetro de entrada Tipo Descrição Valores padrão e valores de entrada especiais Campos de itens de conta suportados
target_currency Número Inteiro Pode ser um ID específico ou um campo de item da conta ( C1 para C40 ) se o ID for proveniente de uma lista suspensa no modelo da conta. Moeda de destino, que pode ser um ID de moeda interna IBM® ESG Suite específico ou um campo de item de conta ( C_1 a C_40 ) se o ID vier de uma lista suspensa no estilo da conta. Para a lista interna de IDs de moedas, consulte Envizi ESG Suite currency IDs.
Por exemplo:
  • 114 - USD
  • 10 - AUD
  • 39 - EUR
  • 57 - JPY
NULL
O valor padrão é 114 dólares americanos
-1
O padrão é a moeda do local com base na região do local
-2
O padrão é a moeda padrão de relatório da organização.
 C_1 para C_40
source_currency Número Inteiro Moeda de origem a ser usada na conversão, cujo valor deve ser um ID de Envizi ESG Suite moeda interna. Para a lista interna de IDs de moedas, consulte Envizi ESG Suite currency IDs.
Por exemplo:
  • 114 - USD
  • 10 - AUD
  • 39 - EUR
  • 57 - JPY
NULL
O padrão é a moeda do local com base na região do local
-1
Padrão para a moeda do local com base na região do local, igual a NULL
-2
O padrão é a moeda padrão de relatório da organização.
 C_1 para C_40
field Dinheiro Valor gasto ou custo a ser convertido, normalmente a partir da entrada do usuário. Não aplicável C_1 para C_40
conversion_rate_date Data/hora Data utilizada para determinar a taxa de câmbio com base no ID da moeda de origem para o mês especificado.
  • Apenas a taxa de câmbio vinculada ao último dia do mês é utilizada. Por exemplo, se a data inserida for 2025-Feb-24, será utilizada a taxa para 2025-Feb-28.
  • Se nenhuma taxa de câmbio for encontrada para o mês, a taxa padrão será a última taxa de câmbio disponível com base no ID da moeda de origem. Por exemplo, se a data de entrada for 2025-Feb-24, mas não houver taxa disponível para 2025-Feb-28, será utilizada a última taxa disponível em 2025-Jan-31.
não aplicável
Start_Period
End_Period
Nota:
  • Se você tiver uma taxa de câmbio personalizada pré-carregada na plataforma, a função sempre priorizará a taxa de câmbio personalizada em relação à taxa Envizi ESG Suite padrão para qualquer mês.
  • A função ignora o sinalizador de moeda Historical ou de Single associação e se comporta como se o sinalizador estivesse definido como Historical.

Casos de Uso de Exemplo

Os campos C utilizados nos exemplos da tabela a seguir são apenas opções representativas. Você pode ajustar os campos C para qualquer outro campo C, conforme necessário para o seu caso de uso. No entanto, o C_20 campo é usado universalmente em tipos de dados para contabilizar o custo total e é acumulado sob o custo total em painéis e relatórios padrão.

Tabela 2. Casos de uso e exemplos de regras de estilo de conta
Número de cenário Exemplo de caso de uso Descrição da regra Exemplo de regra de estilo de conta
1 Nos estilos de conta do escopo 3, converta os valores locais para USD. Um usuário captura os gastos ou custos locais no campo de C_20custo total. A regra converte o valor da moeda local, que é determinada pela região onde a conta existe, para USD e o armazena no campo de destino em C_1. 
 C_1 = CURRENCYCONVERT(114, -1, C_20, End_Period)
ou
 C_1 = CURRENCYCONVERT(114, NULL, C_20, End_Period)
2 O usuário precisa ter a capacidade de registrar custos quando a moeda inserida não corresponder à moeda da região do local.

Por exemplo, útil para contas de despesas internacionais em que várias moedas são capturadas em uma única conta.

 C_20 cenário em que o usuário escolhe um código de moeda de origem em uma lista suspensa em C_11 e captura um valor de custo na moeda de origem em C_10. A regra converte o valor do custo para a moeda local padrão do local e armazena.C_20 
C_20 = CURRENCYCONVERT( -1, C_11, C_10, End Period)
O campo da C_11 moeda de origem deve ser configurado para ter o ID da Envizi ESG Suite moeda interna nos valores da lista suspensa. Para obter informações sobre a lista de IDs de moedas disponíveis, consulte a página de códigos e IDs de moedas.
3 Útil para estilos de conta de escopo 3 baseados em gastos, nos quais os usuários desejam poder selecionar a moeda de entrada. Utiliza a taxa do final do período. O usuário seleciona um código de moeda de origem em uma lista suspensa em C_11 e captura um valor de custo na moeda de origem C_10. A regra converte o valor do custo para a moeda local padrão do local usando a taxa do período final e o armazena em C_1. 
C_1 = CURRENCYCONVERT(114, C_11, C_10, End Period)

O campo da C_11 moeda de origem deve ser configurado para ter o ID da Envizi ESG Suite moeda interna nos valores da lista suspensa. Para obter informações sobre a lista de IDs de moedas disponíveis, consulte a página de códigos e IDs de moedas.
4 Como no Cenário 3, mas utilizando a última taxa disponível. O usuário seleciona um código de moeda de origem em uma lista suspensa em C_11 e captura um valor de custo na moeda de origem C_10. A regra converte o valor do custo para a moeda local padrão do local, utilizando a última taxa disponível, e o armazena em C_1. 
C_1 = CURRENCYCONVERT(114, C_11, C_10, NULL)