andresmg07/bccr-indicadores-economicos

Interfaz para consumo del servicio web de indicadores económicos del Banco Central de Costa Rica (BCCR).

BCCR indicadores económicos

Interfaz para consumo del servicio web de indicadores económicos del Banco Central de Costa Rica (BCCR).

Pre-requisitos

Registro a servicio web de indicadores económicos del BCCR

Es necesario el registro en el servicio web del BCCR: Formulario de registro a servicio web BCCR.

El correo electrónico registrado y el token generado por el servicio web del BCCR son necesarios para el funcionamiento de esta biblioteca.

Tabla de contenidos

• BCCR indicadores económicos
  • Pre-requisitos
    • Registro a servicio web de indicadores económicos del BCCR
  • Tabla de contenidos
  • Instalación
  • Uso
    • Importación
    • Clase BCCRWebService
    • Recuperar el valor actual de un indicador
    • Recuperar el valor de un indicador en una fecha específica
    • Recuperar el valor de un indicador en un rango de fechas
  • Lista de indicadores públicos
  • Limitaciones
  • Versionamiento
  • Autor
  • Licencia

Instalación

$ npm install bccr-indicadores-economicos

Uso

ANTES DE UTILIZAR: Completar los pasos indicados en pre-requisitos y chequear la lista de indicadores públicos en lista de indicadores públicos.

Importación

No ES6

const BCCRWebService = require("bccr-indicadores-economicos");

ES6

import BCCRWebService from "bccr-indicadores-economicos";

Clase BCCRWebService

El constructor de la clase BCCRWebService recibe como parámetros el correo electrónico registrado y el token generado por el sistema del Banco Central.

const bccrWS = new BCCRWebService("ejemplo@email.com", "EJEMPLOTOKEN");

Esta clase cuenta con un único método: request el cual es asincrónico y sobrecargado.

request(code)
request(code, targetDate)
request(code, startDate, endDate)

Recuperar el valor actual de un indicador

Utilice el método bccrWS.request(code) para recuperar el valor actual (último valor publicado por el BCCR) de un indicador económico.

// Ejemplo con código 318: Tipo de cambio venta dólar/colón.
const currentColonDollarSellPrice = await bccrWS.request("318");

Resultado

{ code: '318', date: '2024-02-26T00:00:00-06:00', value: 511.27 }

Recuperar el valor de un indicador en una fecha específica

Utilice el método bccrWS.request(code, targetDate) para recuperar el valor de un indicador económico en una fecha específica.

// Fecha que de la cual desea recuperar el indicador económico.
const targetDate = new Date(2024, 0, 1);
// Ejemplo con código 318: Tipo de cambio venta dólar/colón.
const singleColonDollarSellPrice = await bccrWS.request( "318", targetDate);

Resultado

{ code: '318', date: '2024-01-01T00:00:00-06:00', value: 519.21 }

Recuperar el valor de un indicador en un rango de fechas

Utilice el método bccrWS.request(code, startDate, endDate) para recuperar el valor de un indicador económico en un rango de fechas.

// Fecha que de inicio del rango que se desea recuperar.
const startDate = new Date(2024, 0, 1);
// Fecha que de fin del rango que se desea recuperar.
const endDate = new Date(2024, 0, 5);
// Ejemplo con código 318: Tipo de cambio venta dólar/colón.
const rangedColonDollarSellPrice = await bccrWS.request(
    "318",
    startDate,
    endDate,
);

Resultado

[
    { code: "318", date: "2024-01-01T00:00:00-06:00", value: 519.21 },
    { code: "318", date: "2024-01-02T00:00:00-06:00", value: 519.21 },
    { code: "318", date: "2024-01-03T00:00:00-06:00", value: 518.92 },
    { code: "318", date: "2024-01-04T00:00:00-06:00", value: 518.01 },
    { code: "318", date: "2024-01-05T00:00:00-06:00", value: 516.88 },
]

Lista de indicadores públicos

Listado de indicadores económicos populares:

Código	Descripción
317	Tipo de cambio: compra colón/dólar
318	Tipo de cambio: venta colón/dólar
3323	Tipo de cambio: promedio MONEX
23698	TED: Tasa Efectiva en Dólares
3541	TPM: Tasa de Política Monetaria
423	TBP: Tasa Básica Pasiva

Para obtener el listado completo de indicadores económicos públicos en el servicio web del BCCR consulte el siguiente archivo: Lista de indicadores públicos BCCR.

Limitaciones

ESTA BIBLIOTECA ESTÁ DESARROLLADA PARA SU USO DESDE EL LADO DEL SERVIDOR.

Debido al bloqueo solicitudes de origen cruzado (CORS), toda petición debe ejecutarse desde un servidor web. Aquellas llamadas provenientes de un cliente (buscador web) serán rechazadas por el BCCR.

Versionamiento

El sistema de versionamiento utilizado para esa biblioteca es SemVer.

Autor

Andrés Montero Gamboa
Estudiante de ingeniería en computación
Tecnológico de Costa Rica (TEC)
LinkedIn | GitHub

Licencia

MIT License

Copyright (c) 2024 Andrés Montero Gamboa

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.