Tasa BCV en Google Sheets
Una función personalizada, tu tasa siempre actualizada.
Crear tu API key gratis en Cotizave
Entra a app.cotizave.com, crea una cuenta gratuita y genera una API key desde el dashboard. El plan gratuito incluye suficientes llamadas para uso personal y de equipos pequeños.
Abrir Extensions → Apps Script
En tu hoja de cálculo, ve al menú Extensions → Apps Script. Se abrirá el editor de scripts en una nueva pestaña. Si ya tienes un proyecto, puedes añadir el código al mismo archivo.
Pegar el código y guardar
Reemplaza pon-tu-api-key-aqui con tu clave real, pega el siguiente código en el editor y guarda el proyecto:
const TU_API_KEY = 'pon-tu-api-key-aqui';
function COTIZAVE_BCV() {
const url = 'https://api.cotizave.com/v1/fx/rates/reference';
const opts = {
headers: { 'X-API-Key': TU_API_KEY },
muteHttpExceptions: true,
};
const res = UrlFetchApp.fetch(url, opts);
if (res.getResponseCode() !== 200) return 'Error ' + res.getResponseCode();
return JSON.parse(res.getContentText()).mid;
}Guardar, autorizar y usar
Guarda el proyecto con Ctrl+S y cierra el editor. La primera vez que ejecutes la función desde una celda, Google pedirá autorización para realizar llamadas externas — acepta los permisos.
Después de autorizar, úsala en cualquier celda como =COTIZAVE_BCV(). Google Sheets la trata como una función normal y devuelve el valor numérico de la tasa.
Para actualización automática, configura un trigger en Extensions → Apps Script → Triggers (ícono del reloj). Crea un trigger de tiempo para que la función se ejecute cada hora o cada día según necesites.
Casos de uso frecuentes
Reportes de contabilidad
Cierra el mes con la tasa BCV exacta de cada día sin buscarla a mano.
Proyecciones de flujo de caja
Convierte tus proyecciones USD a VES y ve el impacto de la tasa en tiempo real.
Presupuestos de proyectos
Calcula costos en bolívares a partir de precios base en dólares, siempre actualizados.
Preguntas frecuentes
¿La tasa se actualiza sola?
Apps Script no actualiza la celda por sí solo a menos que configures un trigger. Ve a Extensions → Apps Script → Triggers (ícono del reloj) y crea un trigger de tiempo para que la función se ejecute cada hora o cada día según necesites.
¿Cada llamada de la función cuenta contra mi rate limit?
Sí, cada ejecución de COTIZAVE_BCV() consume una llamada a la API. Con un trigger de una hora, el consumo diario es de 24 llamadas, muy por debajo del límite del plan gratuito.
¿Puedo traer también el paralelo o el P2P?
Sí. Duplica la función y cambia el segmento de la URL: /v1/fx/rates/parallel para el paralelo, /v1/fx/rates/binance para Binance P2P, etc. Consulta la documentación para ver todos los markets disponibles.