CotacaoDolarVendaBCBHoje

A função CotacaoDolarVendaBCBHoje recebe um variável do tipo tMFCotacao e retorna o valor do Dólar comercial de venda da data corrente, consultando o Web Service do Banco Central do Brasil.

Tipo de Retorno

Number

Pacote

A função CotacaoDolarVendaBCBHoje está definida dentro do pacote cWSCotacao.pkg.

Sintaxe

Move (CotacaoDolarVendaBCBHoje(&{vMFCotacao})) to {nRetorno} 

Onde:

  • {vMFCotacao} é uma variável do tipo tMFCotacao, que deve ser passada por referência. Abaixo a definição do tipo tMFCotacao:

tMFCotacao

dData: é a data do valor a ser consultado. No caso da chamada desta função, este elemento não precisa ser preenchido, pois ele será automaticamente preenchido com a data atual pela própria função.

iSerie: é o código da série que será consultada. No caso da chamada desta função, este elemento não precisa ser preenchido, pois ele será preenchido automaticamente pela função com a constante C_COTACAO_DOLAR_US_VENDA_BCB (1).

sMsgErro: no caso de ocorrer algum erro na execução da função, será devolvida a descrição literal do erro nesta variável.

bExibeErro: por padrão, a função não exibirá nenhum erro que ocorra durante a chamada da função. Se o desenvolvedor desejar que a própria função faça a exibição do erro, então deve mover True para este elemento, antes de chamar a função.

  • {nRetorno} recebe o valor do Dólar ou -1, caso tenha ocorrido algum erro.

Exemplo

ExemploCotacaoDolarVendaBCBExemploBuscarCEP

Observações

  • Um exemplo de utilização desta função pode ser encontrado na view ExemploCotacao.vw.
  • Esta função está disponível a partir da versão 18.0.11 do MenuFlex.
  • Internamente, para consultar a cotação, esta função faz uso da função CotacaoDolarVendaBCB.
  • Esta função faz uso do Web Service do Banco Central do Brasil. Se este serviço apresentar instabilidade ou for descontinuando pelo BCB, a função deixará de funcionar.

Tópicos relacionados