CotacaoSerieBCB

A função CotacaoSerieBCB recebe um variável do tipo tMFCotacao, contendo, dentre outros elementos, uma data e um código de série e retorna o valor da série usando o Web Service do Banco Central do Brasil.

Tipo de Retorno

Number

Pacote

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

Sintaxe

Move (CotacaoSerieBCB(&{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. Verifique a documentação do Banco Central do Brasil para identificar o código desejado. Aguns exemplos:

Dólar Comercial de Venda: 1 (C_COTACAO_DOLAR_US_VENDA_BCB)

Euro de Venda: 21619 (C_COTACAO_EURO_VENDA_BCB)

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 da série consultada ou -1, caso tenha ocorrido algum erro.

Exemplo

Um exemplo de utilização da função CotacaoSerieBCB pode ser encontrado dentro do próprio pacote cWSCotacao.pkg:

ExemploCotacaoSerieBCBExemploBuscarCEP

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.
  • 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