Importera finansiell data till Google Sheets automatiskt

/**
 * BörsAPI.se - Officiell Google Sheets-integration med CacheService
 * 
 * Användning i celler:
 * Svenska Sheets (semikolon): =BORSAPI("SE0011166610"; "2024"; "revenue")
 * Engelska Sheets (komma):    =BORSAPI("SE0011166610", "2024", "revenue")
 */

const BORSAPI_KEY = "DIN_API_NYCKEL_HÄR"; // Ersätt med din nyckel från borsapi.se/dashboard
const CACHE_TTL_SECONDS = 21600; // Cacha svar i 6 timmar (21 600 s)

/**
 * Hämtar ett specifikt finansiellt fält från BörsAPI för ett bolag och en period.
 *
 * @param {string} isin Bolagets ISIN-kod (t.ex. "SE0011166610")
 * @param {string} period Period (t.ex. "2024", "2025-Q1 TTM", "2024-Q3", "latest")
 * @param {string} field Rapportfält (t.ex. "revenue", "operating_income", "net_income")
 * @return {number|string} Finansiellt värde i rå form
 * @customfunction
 */
function BORSAPI(isin, period, field) {
  if (!isin || !period || !field) {
    return "Fel: Ange isin, period och field";
  }

  const cacheKey = "borsapi_" + isin.trim() + "_" + period.trim() + "_" + field.trim();
  const cache = CacheService.getScriptCache();
  const cachedVal = cache.get(cacheKey);

  if (cachedVal !== null) {
    return isNaN(cachedVal) ? cachedVal : Number(cachedVal);
  }

  const url = "https://borsapi.se/api/v1/companies/" + isin.trim() + "/reports/" + period.trim();
  const options = {
    "method": "GET",
    "headers": {
      "Authorization": "Bearer " + BORSAPI_KEY,
      "Accept": "application/json"
    },
    "muteHttpExceptions": true
  };

  try {
    const response = UrlFetchApp.fetch(url, options);
    const code = response.getResponseCode();

    if (code !== 200) {
      return "HTTP Fel " + code;
    }

    const json = JSON.parse(response.getContentText());
    if (json.error) {
      return "API-fel: " + json.error;
    }

    const val = json[field.trim()];
    if (val === undefined || val === null) {
      return "Fält saknas";
    }

    // Lagra i cache
    cache.put(cacheKey, String(val), CACHE_TTL_SECONDS);
    return typeof val === "number" ? val : val;

  } catch (e) {
    return "Nätverksfel: " + e.toString();
  }
}

/**
 * Hämtar senaste insynstransaktioner för ett bolag.
 * @param {string} isin Bolagets ISIN-kod
 * @return {string} Sammanfattning av senaste köp/sälj
 * @customfunction
 */
function BORSAPI_INSIDER(isin) {
  if (!isin) return "Fel: Ange ISIN";
  const url = "https://borsapi.se/api/v1/companies/" + isin.trim() + "/insider-statistics";
  const options = {
    "headers": { "Authorization": "Bearer " + BORSAPI_KEY },
    "muteHttpExceptions": true
  };
  try {
    const res = UrlFetchApp.fetch(url, options);
    const data = JSON.parse(res.getContentText());
    if (!data || data.error) return "Ingen insynsdata";
    return "Nettoköp 90d: " + (data.net_buy_amount_90d ? data.net_buy_amount_90d.toLocaleString() + " SEK" : "0 SEK");
  } catch(e) {
    return "Fel";
  }
}