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()).rate;
}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.
Nota sobre =IMPORTDATA(...): una fórmula directa tipo =IMPORTDATA("...?key=...") requiere que la API exponga un endpoint CSV con autenticación por query string, lo cual no existe actualmente. Estamos evaluando soportarlo. Por ahora, Apps Script es la forma estable de conectar Cotizave a Google Sheets.