/** * APIs AR para Google Sheets: funciones para validar CUIT y CBU, pasar teléfonos a WhatsApp, * consultar el dólar, calcular aguinaldo, monotributo, aumentos de alquiler, inflación y días * hábiles, y normalizar direcciones, con datos oficiales argentinos. * * Instalación: * 1. En tu planilla: Extensiones → Apps Script. Borrá lo que haya, pegá este archivo y guardá. * 2. Recargá la planilla. Aparece el menú "APIs AR": elegí "Configurar key" y pegá tu key. * Key de prueba gratis (50 créditos, sin registro): https://ar-tools-api-103907796853.us-east1.run.app/#key * 3. Usá las funciones en cualquier celda, por ejemplo =CUIT_VALIDO(A2) o =ALQUILER_ICL(B2; C2; 3). * * Una misma key sirve en AR Tools, Índices AR y Direcciones AR. Cada consulta descuenta créditos; * los resultados se guardan unas horas para no cobrar dos veces la misma consulta. * Guías y precios: https://indices-ar-api-103907796853.us-east1.run.app/plantillas */ var APIS_AR = { "ar-tools": "https://ar-tools-api-103907796853.us-east1.run.app", "indices-ar": "https://indices-ar-api-103907796853.us-east1.run.app", "direcciones-ar": "https://direcciones-ar-api-103907796853.us-east1.run.app", }; var APIS_AR_PROPIEDAD = "AR_API_KEY"; var SEIS_HORAS = 21600; var DIEZ_MINUTOS = 600; /** Agrega el menú "APIs AR" al abrir la planilla. */ function onOpen() { SpreadsheetApp.getUi() .createMenu("APIs AR") .addItem("Configurar key", "apisArConfigurarKey") .addItem("Ver saldo de créditos", "apisArVerSaldo") .addToUi(); } function apisArConfigurarKey() { var ui = SpreadsheetApp.getUi(); var r = ui.prompt("APIs AR", "Pegá tu API key (empieza con ak_). Si no tenés, pedí una gratis en " + APIS_AR["ar-tools"] + "/#key", ui.ButtonSet.OK_CANCEL); if (r.getSelectedButton() !== ui.Button.OK) return; var key = r.getResponseText().trim(); if (key.indexOf("ak_") !== 0) { ui.alert("La key tiene que empezar con ak_."); return; } PropertiesService.getScriptProperties().setProperty(APIS_AR_PROPIEDAD, key); ui.alert("Key guardada. Ya podés usar las funciones, por ejemplo =CUIT_VALIDO(\"20-12345678-6\")."); } function apisArVerSaldo() { var ui = SpreadsheetApp.getUi(); var key = PropertiesService.getScriptProperties().getProperty(APIS_AR_PROPIEDAD); if (!key) return ui.alert("Primero configurá la key (menú APIs AR → Configurar key)."); var res = UrlFetchApp.fetch(APIS_AR["ar-tools"] + "/v1/balance", { headers: { Authorization: "Bearer " + key }, muteHttpExceptions: true }); var j = JSON.parse(res.getContentText()); ui.alert(res.getResponseCode() === 200 ? "Te quedan " + j.credits + " créditos (sirven en las tres APIs). Recargá en " + j.checkout_url : "No se pudo consultar: " + (j.message || res.getResponseCode())); } /** Fechas de celdas (Date) a YYYY-MM-DD, en la zona horaria de la planilla. */ function apisArFecha_(x) { if (x instanceof Date) return Utilities.formatDate(x, SpreadsheetApp.getActive().getSpreadsheetTimeZone(), "yyyy-MM-dd"); return x === "" || x === null || x === undefined ? undefined : String(x); } function apisArNumero_(x) { return x === "" || x === null || x === undefined ? undefined : Number(x); } /** Llama a una tool. Devuelve el `result`, o { error } con un mensaje legible (nunca tira excepción). */ function apisArLlamar_(api, tool, args, segundos) { var key = PropertiesService.getScriptProperties().getProperty(APIS_AR_PROPIEDAD); if (!key) return { error: "Falta la key: menú APIs AR → Configurar key" }; var limpio = {}; for (var k in args) if (args[k] !== undefined && args[k] !== "" && !(typeof args[k] === "number" && isNaN(args[k]))) limpio[k] = args[k]; var cuerpo = JSON.stringify(limpio); // La clave de caché no incluye la key: solo la tool y los argumentos. var clave = "apisar_" + Utilities.base64EncodeWebSafe(Utilities.computeDigest(Utilities.DigestAlgorithm.SHA_256, tool + "|" + cuerpo)); var cache = CacheService.getScriptCache(); var guardado = cache.get(clave); if (guardado) return JSON.parse(guardado); var res = UrlFetchApp.fetch(APIS_AR[api] + "/v1/tools/" + tool, { method: "post", contentType: "application/json", headers: { Authorization: "Bearer " + key }, payload: cuerpo, muteHttpExceptions: true, }); var codigo = res.getResponseCode(); var j; try { j = JSON.parse(res.getContentText()); } catch (e) { return { error: "Respuesta inválida (" + codigo + ")" }; } if (codigo === 402) return { error: "Sin créditos: recargá en " + (j.checkout_url || APIS_AR[api] + "/comprar") }; if (codigo === 401) return { error: "Key inválida: menú APIs AR → Configurar key" }; if (codigo !== 200) return { error: j.message || "Error " + codigo }; if (segundos) cache.put(clave, JSON.stringify(j.result), segundos); return j.result; } function apisArValor_(r, f) { if (r && r.error) return "⚠ " + r.error; return f(r); } // --- AR Tools --- /** * Valida un CUIT o CUIL (dígito verificador). Devuelve VERDADERO o FALSO. * @param {string} cuit CUIT o CUIL, con o sin guiones * @customfunction */ function CUIT_VALIDO(cuit) { return apisArValor_(apisArLlamar_("ar-tools", "validar_cuit", { cuit: String(cuit) }, SEIS_HORAS), function (r) { return r.valido; }); } /** * Devuelve el CUIT con el formato XX-XXXXXXXX-X, o "inválido". * @param {string} cuit CUIT o CUIL * @customfunction */ function CUIT_FORMATO(cuit) { return apisArValor_(apisArLlamar_("ar-tools", "validar_cuit", { cuit: String(cuit) }, SEIS_HORAS), function (r) { return r.valido ? r.formateado : "inválido"; }); } /** * Devuelve el banco o la billetera de un CBU o CVU, o "CBU inválido". * @param {string} cbu CBU o CVU de 22 dígitos * @customfunction */ function BANCO_CBU(cbu) { return apisArValor_(apisArLlamar_("ar-tools", "validar_cbu", { cbu: String(cbu) }, SEIS_HORAS), function (r) { return r.valido ? r.entidad_nombre : "CBU inválido"; }); } /** * Pasa un teléfono argentino al formato de WhatsApp (549...), o "inválido". * @param {string} telefono Teléfono como esté escrito (con 0, 15, +54) * @customfunction */ function WHATSAPP(telefono) { return apisArValor_(apisArLlamar_("ar-tools", "normalizar_telefono_ar", { telefono: String(telefono) }, SEIS_HORAS), function (r) { return r.valido ? r.whatsapp : "inválido"; }); } /** * Cotización actual del dólar (venta, o compra si se indica). * @param {string} casa oficial, blue, bolsa, contadoconliqui, mayorista, cripto o tarjeta * @param {string} tipo "venta" (por defecto) o "compra" * @customfunction */ function DOLAR(casa, tipo) { return apisArValor_(apisArLlamar_("ar-tools", "cotizacion_dolar", { casa: casa ? String(casa) : "oficial" }, DIEZ_MINUTOS), function (r) { return r.cotizaciones[0][tipo === "compra" ? "compra" : "venta"]; }); } /** * Aguinaldo (SAC) en mano, con aportes del 17 %. * @param {number} mejor_sueldo Mejor sueldo bruto mensual del semestre * @param {number} anio Año * @param {number} semestre 1 (enero a junio) o 2 (julio a diciembre) * @customfunction */ function AGUINALDO(mejor_sueldo, anio, semestre) { return apisArValor_(apisArLlamar_("ar-tools", "calcular_aguinaldo", { mejor_sueldo: apisArNumero_(mejor_sueldo), anio: apisArNumero_(anio), semestre: apisArNumero_(semestre) }, SEIS_HORAS), function (r) { return r.sac_neto; }); } /** * Categoría del monotributo (A a K) según lo facturado en 12 meses, o "Excluido". * @param {number} ingresos_anuales Ingresos brutos de los últimos 12 meses * @param {string} actividad "servicios" o "venta" * @customfunction */ function CATEGORIA_MONOTRIBUTO(ingresos_anuales, actividad) { return apisArValor_(apisArLlamar_("ar-tools", "categoria_monotributo", { ingresos_anuales: apisArNumero_(ingresos_anuales), actividad: actividad === "venta" ? "venta" : "servicios" }, SEIS_HORAS), function (r) { return r.excluido ? "Excluido" : r.categoria; }); } /** * Cuota mensual del monotributo según lo facturado en 12 meses. * @param {number} ingresos_anuales Ingresos brutos de los últimos 12 meses * @param {string} actividad "servicios" o "venta" * @customfunction */ function CUOTA_MONOTRIBUTO(ingresos_anuales, actividad) { return apisArValor_(apisArLlamar_("ar-tools", "categoria_monotributo", { ingresos_anuales: apisArNumero_(ingresos_anuales), actividad: actividad === "venta" ? "venta" : "servicios" }, SEIS_HORAS), function (r) { return r.excluido ? "Excluido" : r.cuota_mensual.total; }); } // --- Índices AR --- /** * Alquiler vigente hoy de un contrato que ajusta por ICL. * @param {number} monto_inicial Alquiler del primer mes * @param {Date} fecha_inicio Inicio del contrato * @param {number} periodicidad_meses Cada cuántos meses ajusta (3, 4, 6, 12) * @customfunction */ function ALQUILER_ICL(monto_inicial, fecha_inicio, periodicidad_meses) { return ALQUILER(monto_inicial, fecha_inicio, "icl", periodicidad_meses); } /** * Alquiler vigente hoy de un contrato que ajusta por ICL, IPC o UVA. * @param {number} monto_inicial Alquiler del primer mes * @param {Date} fecha_inicio Inicio del contrato * @param {string} indice "icl", "ipc" o "uva" * @param {number} periodicidad_meses Cada cuántos meses ajusta (3, 4, 6, 12) * @customfunction */ function ALQUILER(monto_inicial, fecha_inicio, indice, periodicidad_meses) { return apisArValor_(apisArLlamar_("indices-ar", "actualizar_alquiler", { monto_inicial: apisArNumero_(monto_inicial), fecha_inicio: apisArFecha_(fecha_inicio), indice: indice ? String(indice).toLowerCase() : "icl", periodicidad_meses: apisArNumero_(periodicidad_meses) || 3 }, SEIS_HORAS), function (r) { return r.monto_vigente; }); } /** * Actualiza un monto por inflación (IPC) entre dos fechas (por defecto, hasta hoy). * @param {number} monto Monto original en pesos * @param {Date} desde Fecha del monto * @param {Date} hasta Fecha de destino (opcional) * @customfunction */ function AJUSTAR_IPC(monto, desde, hasta) { return apisArValor_(apisArLlamar_("indices-ar", "ajustar_monto", { monto: apisArNumero_(monto), indice: "ipc", desde: apisArFecha_(desde), hasta: apisArFecha_(hasta) }, SEIS_HORAS), function (r) { return r.monto_ajustado; }); } /** * Cantidad de días hábiles entre dos fechas (con feriados nacionales). * @param {Date} desde Fecha inicial * @param {Date} hasta Fecha final * @customfunction */ function DIAS_HABILES(desde, hasta) { return apisArValor_(apisArLlamar_("indices-ar", "dias_habiles", { desde: apisArFecha_(desde), hasta: apisArFecha_(hasta) }, SEIS_HORAS), function (r) { return r.dias_habiles; }); } /** * Fecha de vencimiento sumando días hábiles (salteando fines de semana y feriados). * @param {Date} desde Fecha inicial * @param {number} dias Días hábiles a sumar * @customfunction */ function VENCIMIENTO_HABIL(desde, dias) { return apisArValor_(apisArLlamar_("indices-ar", "dias_habiles", { desde: apisArFecha_(desde), sumar_dias_habiles: apisArNumero_(dias) }, SEIS_HORAS), function (r) { return r.vencimiento; }); } /** * Cotización del dólar en una fecha pasada (venta). * @param {string} casa oficial, blue, bolsa, contadoconliqui, mayorista, cripto o tarjeta * @param {Date} fecha Fecha * @customfunction */ function DOLAR_FECHA(casa, fecha) { return apisArValor_(apisArLlamar_("indices-ar", "dolar_historico", { casa: casa ? String(casa) : "oficial", fecha: apisArFecha_(fecha) }, SEIS_HORAS), function (r) { return r.venta; }); } /** * Valor de la UVA en una fecha (por defecto, el último publicado). * @param {Date} fecha Fecha (opcional) * @customfunction */ function VALOR_UVA(fecha) { return apisArValor_(apisArLlamar_("indices-ar", "indice_valor", { indice: "uva", fecha: apisArFecha_(fecha) }, SEIS_HORAS), function (r) { return r.valor; }); } // --- Direcciones AR --- /** * Dirección normalizada según el callejero oficial, o "no encontrada". * @param {string} direccion Dirección como esté escrita * @param {string} provincia Provincia (opcional, reduce ambigüedad) * @customfunction */ function NORMALIZAR_DIRECCION(direccion, provincia) { return apisArValor_(apisArLlamar_("direcciones-ar", "normalizar_direccion", { direccion: String(direccion), provincia: provincia ? String(provincia) : undefined }, SEIS_HORAS), function (r) { return r.mejor ? r.mejor.direccion_normalizada : "no encontrada"; }); } /** * Provincia de una localidad (la primera coincidencia). * @param {string} localidad Nombre de la localidad * @customfunction */ function PROVINCIA_DE(localidad) { return apisArValor_(apisArLlamar_("direcciones-ar", "buscar_localidad", { nombre: String(localidad) }, SEIS_HORAS), function (r) { return r.localidades.length ? r.localidades[0].provincia : "no encontrada"; }); }