Crea un seguimiento de cartera de oro en Google Sheets

Si tienes lingotes, monedas o joyas, un único total es difícil de revisar. Esta plantilla da una fila a cada tenencia, separa el coste de compra del valor spot actual y muestra la marca de tiempo del precio utilizado. Sirve para una valoración indicativa; no es una tasación ni promete lo que pagará un comprador.

Descarga e importa la plantilla

Descarga el seguimiento de cartera de oro. En Google Drive, elige Nuevo → Subir archivo, abre el archivo .xlsx y selecciona Archivo → Guardar como Hojas de cálculo de Google. La ayuda de Google explica cómo abrir y descargar archivos de hojas de cálculo: https://support.google.com/docs/answer/49114.

La plantilla tiene tres hojas:

• Portfolio: introduces las tenencias y lees el resumen.
• Price Data: contiene la moneda, el endpoint, la marca de tiempo y el precio de 24K usado por las fórmulas.
• Read me: explica las hipótesis y los límites del cálculo.

Los nombres de hojas y columnas permanecen en inglés para que coincidan con el archivo, las fórmulas y las instrucciones de soporte.

Introduce tus tenencias

En Portfolio, sustituye las tres filas de ejemplo. Una fila representa una tenencia o un grupo de piezas iguales.

Usa una sola moneda para todos los costes. La plantilla convierte onzas troy con 31.1034768 gramos y mantiene visible la cantidad original para que puedas comprobar la conversión.

Actualiza el precio de referencia

El endpoint de la plantilla es:

GET https://api.goldprice.dev/v1/carat?currency=USD

La respuesta incluye price_gram_24k, una timestamp y la currency. Copia el precio numérico de 24K en Price Data → B6, la marca de tiempo en B5 y la moneda de la cotización en B7. Actualiza las tres celdas juntas. Cambia B3 solo cuando tengas una cotización nueva para esa moneda y usa la misma moneda para los costes. No conviertas una cotización antigua en USD en una cotización IDR cambiando solo B3. Los precios llegan como cadenas decimales en JSON; en la hoja se introducen como números para que las fórmulas puedan calcular.

El archivo trae datos de ejemplo claramente marcados para que las fórmulas funcionen al importarlo. Sustituye el precio de ejemplo antes de utilizar el resultado. La plantilla no consulta la API automáticamente y no guarda ninguna clave. Si un archivo compartido necesita autenticación, usa un proxy del servidor; no pongas la credencial en la hoja ni en un script vinculado que otros editores puedan inspeccionar.

Actualización manual con un clic

Si quieres añadir un menú de actualización, descarga el script complementario de Apps Script, abre el archivo en Google Sheets, elige Extensions → Apps Script, reemplaza el código inicial y pega el contenido del archivo. Guarda y vuelve a cargar la hoja. El menú Gold portfolio → Refresh price data hace una sola solicitud sin clave usando la moneda de Price Data → B3. Comprueba el estado HTTP, la moneda de respuesta, un price_gram_24k positivo y válido y la marca de tiempo antes de escribir B5:B7 juntas. Si falla, conserva el precio, la marca de tiempo y la moneda anteriores. Si pegas los valores manualmente, actualiza B5, B6 y B7 desde la misma respuesta. No crea temporizadores ni consulta en segundo plano.

Cómo se calcula

Cada fila sigue cuatro pasos visibles:

1. Weight (g) convierte la cantidad a gramos.
2. Spot price/g enlaza con el precio de 24K de Price Data.
3. Indicative value calcula Weight (g) × Purity × Spot price/g.
4. Change calcula Indicative value − Purchase cost.

Por ejemplo, 10 gramos al 75% de pureza y un precio de 24K de 128.24 por gramo producen 10 × 0.75 × 128.24 = 961.80 en la moneda del precio. Es el valor del contenido de oro al precio spot de referencia. No incluye trabajo artesanal, piedras, impuestos, prima local, margen del vendedor ni descuento de recompra.

El resumen cuenta las cantidades rellenadas, suma el peso convertido, suma los costes y agrega los valores indicativos. Las filas vacías permanecen vacías en las columnas de cálculo.

Conserva la marca de tiempo

Los precios spot cambian. Price timestamp (UTC) indica qué respuesta usan las fórmulas. Al actualizar el precio, actualiza también la marca de tiempo. Si guardas el archivo como informe, conserva la respuesta original o anota su marca de tiempo para que otra persona pueda repetir el cálculo.

Errores frecuentes

• Escribir 0.999 como texto en vez de 99.9% como porcentaje.
• Mezclar costes en USD con un precio de referencia en IDR.
• Confundir gramos con onzas troy.
• Leer Change como beneficio garantizado: solo compara con el spot y no resta costes de venta.
• Dejar el precio de ejemplo después de añadir tenencias reales.

Límites

Esta plantilla organiza tenencias y permite revisar la aritmética de una estimación basada en spot. No es una tasación, registro contable, declaración fiscal, recomendación de inversión ni precio garantizado de venta. Una oferta real puede variar por márgenes, primas, refinado, impuestos locales, estado y condiciones de la operación. Comprueba las normas locales y la oferta real antes de tomar una decisión financiera.

Para consultar precios de oro actuales e históricos en una hoja, visita el tutorial de Gold Price API para Google Sheets.