MMCalcularCorrecaoMonetaria
O objetivo desta função é retornar a correção monetária de determinado valor, em determinada data, para uma moeda específica (diferente da moeda padrão da empresa), relacionando essa data a uma data e cotação de emissão. Dependendo da correção encontrada, o valor corrigido será retornado na variável pVlrCor (caso a variação da moeda tenha sido positiva), ou na variável pVlrOde (caso a variação da moeda tenha sido negativa).
Sintaxe: Funcao MMCalcularCorrecaoMonetaria(Alfa pCodMoe, Data pDatEmi, Numero pCotEmi, Data pDatPgt, Numero pVlrBas, Numero end pVlrCor, Numero end pVlrOde);
Parâmetros:
Nome | Tipo | Descrição |
---|---|---|
pCodMoe | Alfa | Código da moeda base para cálculo da correção monetária. |
pDatEmi | Data | Data de emissão. Base para início do cálculo da correção monetária. |
pCotEmi | Número | Cotação da moeda na data de emissão. |
pDatPgt | Data | Data que será utilizada para a comparação com a cotação da data de emissão. |
pVlrBas | Número | Valor base a ser corrigido. |
Tipo de retorno:
Nome | Tipo | Descrição |
---|---|---|
pVlrCor | Número | Valor da correção em caso de aumento da cotação da moeda com relação a emissão (correção monetária positiva). |
pVlrOde | Número | Valor da correção em caso de diminuição da cotação da moeda com relação a emissão (correção monetária negativa). |
Exemplo: MMCalcularCorrecaoMonetaria(E606CCR.CodMoe, E606CCR.DatBcj, nCotEmi, dPreAtu, nVlrPre, nVlrCor, nVlrOde);
Observações: A moeda passada sempre deverá ser diferente da moeda da empresa logada no momento da chamada da função, pois se não for, não haverá correção monetária.
Utilização da Função (dependentes): MMCria e MMLibera. É preciso executar a função de programador MMCria antes de utilizar essa função. Ao finalizar o uso de funções multimoeda na regra, executar a função MMLibera para destruir os objetos em memória.