Integración de Indexa Capital con Google Sheets

En este tutorial descubrirás como importar tus datos de Indexa Capital en Google Sheets (valor de la cartera y rentabilidad) ya sea mediante un botón o de manera totalmente desatendida (mientras duermes), por lo que nunca más tendrás que entrar a la web de Indexa Capital para consultar tu saldo o tu rentabilidad.

Las posibilidades son inmensas aunque en este manual sólo cubre la funcionalidad más básica. He intentado explicarlo de la manera más clara posible pero ten en cuenta que es un tutorial un poco técnico y si no tienes conocimientos de programación quizá te resulte un poco difícil de entender.

Contenido

1. Conseguir un token
2. Crear un Google Apps Script
3. Crear script properties
4. Programar la integración
 4.1. Descargar la información mediante un botón
 4.2. Descargar la información sin interacción del usuario
5. Fin

1. Conseguir un token

Lo primero que hay que hacer es solicitar un token a Indexa Capital, puedes conseguirlo en Área de cliente > Tu nombre > Configuración de usuario > Aplicaciones.

Cómo conseguir un token de Indexa Capital

Este token no es más que una cadena de letras y números que servirá para autenticar nuestras llamadas a la API (Application Programming Interface) de Indexa Capital, sin él, nuestra integración no funcionará.

El token es único, personal, intransferible y no tiene fecha de caducidad por lo que deberemos guardarlo a buen recaudo y no compartirlo.

Nuestro token tendrá un aspecto similar a este: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJ0ZXN0QGluZGV4YWNhcGl0YWwuY29tIiwiaXNzIjoiSW5kZXhhIENhcGl0YWwiLCJpYXQiOjE1MTkxMjY0NDgsImV4cCI6MTUxOTE4NjQ0OCwiZW5kcG9pbnQiOiJodHRwczovL2ludGFwaS5pbmRleGFjYXBpdGFsLmNvbSJ9.P82WNPoxpTSUf9AJfpYFelON4xy6EBec9vE4qEHee1c

2. Crear un Google Apps Script

Aunque la funcionalidad no es muy conocida, se puede programar desde Google Sheets vía Google Apps Script, esto brinda posibilidades ilimitadas, en nuestro caso, lo vamos a utilizar para conectarnos al servicio REST de Indexa Capital.

Lo siguiente que haremos será crear una nueva hoja de cálculo de Google Sheets y una vez creada vamos a Tools > Script editor.

Se abrirá una nueva pantalla que parece un editor de texto / bloc de notas, aquí es donde vamos a programar nuestras llamadas a la API de Indexa Capital. El archivo por defecto se llama Code.gs, puedes cambiarle el nombre si quieres, pero no es necesario.

También puedes poner un título al proyecto, ya que actualmente se llamará Untitled project, esto sí lo recomiendo, simplemente para tener todo bien organizado.

3. Crear script properties

Actualmente las script properties están obsoletas. Se puede seguir haciendo uso de ellas pero Google ha ocultado un poco el botón para acceder a ellas. La mejor solución es saltarse este paso e introducir las variables que indico a continuación directamente en el código.

Las script properties viene a ser lo que se conoce en los lenguajes de programación habituales como variables globales / constantes / macros. Están compuestas por:

• Property: Es el nombre (clave) de la script property.
• Value: Es el valor que tomará la script property.

En nuestro caso vamos a definir dos script properties:

1. IndexaCapitalToken: donde introduciremos el valor del token.
2. IndexaCapitalAccount: donde introduciremos el valor de la cuenta de Indexa Capital ya que podemos tener múltiples, una para plan de pensiones, otra para cuenta de menores, otra para nuestra cuenta de fondos…

Para rellenar las script properties vamos a File > Project properties > Script properties. El resultado será similar a la siguiente imagen:

Google Apps Script – Script properties

4. Programar la integración

Ahora viene lo divertido, sustituimos la función myFunction que viene por defecto en el archivo Code.gs por el siguiente fragmento de código.

Si finalmente no has usado las script properties (ya que están obsoletas), tendrás que quitar la línea var scriptProperties = PropertiesService.getScriptProperties(); y sustituir las cadenas de texto scriptProperties.getProperty(«IndexaCapitalToken») y scriptProperties.getProperty(«IndexaCapitalAccount») por sus valores reales dentro del siguiente código.

//Begin Indexa Capital functions by InversorProvinciano (https://inversorprovinciano.wordpress.com)
function IndexaCapitalPortfolioValue(token, account) {
    const options = {
    "method"  : "GET",
    "headers": {
      "Content-Type": "application/json",
      "Accept": "*/*",
      "Cache-Control" : "no-cache",
      "Accept-Encoding" : "gzip, deflate, br",
      "Connection" : "keep-alive",
      "X-Auth-Token" : token
    } 
  };

  const result = UrlFetchApp.fetch("https://api.indexacapital.com/accounts/" + account + "/portfolio", options);
      
    if (result.getResponseCode() == 200) {
      const response = JSON.parse(result.getContentText());

      return response.portfolio.total_amount;
    }
  
    return undefined;
}

function IndexaCapitalPerformanceValue(token, account) {
    const options = {
    "method"  : "GET",
    "headers": {
      "Content-Type": "application/json",
      "Accept": "*/*",
      "Cache-Control" : "no-cache",
      "Accept-Encoding" : "gzip, deflate, br",
      "Connection" : "keep-alive",
      "X-Auth-Token" : token
    } 
  };

  const result = UrlFetchApp.fetch("https://api.indexacapital.com/accounts/" + account + "/performance", options);
      
    if (result.getResponseCode() == 200) {
      const response = JSON.parse(result.getContentText());

      return response.return.time_return;
    }
  
    return undefined;
}

function IndexaCapitalTrigger() {
  
  var scriptProperties = PropertiesService.getScriptProperties();
  
  SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Sheet1').getRange('A1').setValue(IndexaCapitalPortfolioValue(scriptProperties.getProperty("IndexaCapitalToken"), scriptProperties.getProperty("IndexaCapitalAccount")));
  SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Sheet1').getRange('A2').setValue(IndexaCapitalPerformanceValue(scriptProperties.getProperty("IndexaCapitalToken"), scriptProperties.getProperty("IndexaCapitalAccount")));
}
//End Indexa Capital functions by InversorProvinciano (https://inversorprovinciano.wordpress.com)

Te explico lo que contiene:

• IndexaCapitalPortfolioValue: Es la función que nos devolverá el valor de nuestras inversiones.
• IndexaCapitalPerformanceValue: Es la función que nos devolverá la rentabilidad de nuestras inversiones.
• IndexaCapitalTrigger: Es la función principal que escribe los valores en las celdas A1 y A2. Por cierto, la celda A2 has de ponerla en formato porcentaje.

Ya tenemos todo, sólo necesitamos una manera de llamar a estas funciones para que funcione todo, te propongo dos maneras de hacerlo.

4.1. Descargar la información mediante un botón

Se pueden rellenar los datos bajo demanda mediante la creación de un botón, para ello añadimos el siguiente fragmento de código al archivo Code.gs.

//Begin Indexa Capital functions by InversorProvinciano (https://inversorprovinciano.wordpress.com)
function onOpen()
{
  var spreadsheet = SpreadsheetApp.getActive();
  var menuItems = [
    { name: 'Descargar datos de Indexa Capital', functionName: 'IndexaCapitalTrigger' }
  ];
  
  spreadsheet.addMenu('FIRE', menuItems);
}
//End   Indexa Capital functions by InversorProvinciano (https://inversorprovinciano.wordpress.com)

Acto seguido:

1. Guarda el script.
2. Cierra la hoja de cálculo.
3. Vuelve a abrirla hoja de cálculo.

El resultado será un nuevo menú llamado «FIRE» con una opción que responde al nombre de «Descargar datos de Indexa Capital».

Al hacer click, te pedirá permiso en tu cuenta de Google. Acepta todo lo que te aparezca en pantalla y en cuestión de un par de segundos tendrás tus datos de Indexa Capital reflejados en las celdas A1 y A2.

Si tienes activada la autenticación en dos pasos de Google, también te llegará una notificación al móvil que has de aceptar.

Por último, se podría hacer que los datos se cargaran cada vez que se abre la hoja de cálculo pero no lo recomiendo ya que es posible que accedamos al documento constantemente.

4.2. Descargar la información sin interacción del usuario

Soy un poco exigente y no me gusta hacer clic en el botón del punto anterior, prefiero que se descarguen mis datos por las noches, mientras duermo, así que vamos a crear un activador / trigger.

Desde el script editor hacemos clic en el botón que parece un reloj (Current project’s triggers) y se abrirá una pantalla un tanto extraña llamada Activadores.

Google Apps Script Triggers (Activadores)

Añadimos un activador y lo configuramos de la siguiente manera para que se ejecute cada noche de 4:00 a 5:00 de la madrugada. De esta manera, al despertarnos cada mañana, tendremos nuestros datos volcados en las celdas A1 y A2.

Configuración del activador de Google Apps Script

5. Fin

Esto es todo, como puedes ver, el ejemplo es básico pero se pueden hacer multitud de cosas, ya que la información que devuelve cada llamada es muy extensa. Personalmente ya no me queda ninguna razón para seguir consultando la web de Indexa Capital.

Si quieres ampliar la funcionalidad, te recomiendo que pruebes Postman, para controlar bien las llamadas y la información resultante antes de plasmarlo en la hoja de cálculo.

Si te ha resultado útil, no olvides compartir y/o dejar un comentario.