CotacaoDolarVendaBCB

A função CotacaoDolarVendaBCB recebe um variável do tipo tMFCotacao, contendo, dentre outros elementos, uma data de referência e retorna o valor do Dólar comercial de venda nesta data, consultando o Web Service do Banco Central do Brasil.

Tipo de Retorno

Number

Pacote

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

Sintaxe

Move (CotacaoDolarVendaBCB(&{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. Por exemplo, se a série consultada for o valor do dólar comercial de venda, então dData é a data da cotaçã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 na data consultada 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 CotacaoSerieBCB.
  • 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