// ================================================================================================ // EasyBankData para Power BI y Excel (Power Query, lenguaje M) // ================================================================================================ // // Diez consultas para pegar, una a una, en Power Query. Guía completa: // https://easybankdata.com/docs/plantillas // // CÓMO SE PEGAN // Power BI Desktop: Inicio > Transformar datos > (en el editor) Nueva fuente > Consulta en blanco. // Excel: Datos > Obtener datos > De otras fuentes > Consulta en blanco. // Con la consulta en blanco abierta: Inicio > Editor avanzado, borra lo que haya y pega el bloque de // UNA consulta (de su línea «let» o su primera línea hasta el siguiente separador). Después, en el panel // de la derecha, ponle EXACTAMENTE el nombre que dice su separador (EBD_Clave, EBD_Leer…): las // consultas se llaman unas a otras por su nombre. // // LA CLAVE // Usa una clave de «Solo leer» (panel > API y webhooks). Va en el parámetro EBD_Clave y, por // tanto, DENTRO del fichero .pbix o .xlsx: quien tenga el fichero tiene la clave. No lo compartas con // ella puesta; si lo haces, revoca la clave en el panel y saca otra. La clave viaja en la cabecera // «Authorization: Bearer», así que cuando Power BI o Excel pregunten cómo conectar con la dirección de // la API, elige «Anónimo»: la autenticación ya la lleva la consulta. Si al actualizar sale «las // credenciales no son válidas», es la CLAVE (mal copiada o revocada): cámbiala en EBD_Clave. // // SOLO LEE. Todas las llamadas son GET, y leer por la API no llama al banco ni gasta cupo de refrescos. // Los importes llegan como decimal en texto («-19.95») y se convierten a número decimal fijo (Currency.Type, // cuatro decimales, sin coma flotante); los indicadores llegan en céntimos enteros y se pasan a euros. // // EasySoft Tech S.L. · info@easysoft.es // ================================================================================================ // ──────────── Consulta 1 de 10 · nombre: EBD_Clave · (parámetro) ───────────────────────────────── // Tu clave de la API. Cámbiala en Inicio > Administrar parámetros. "ebd_live_pega_aqui_tu_clave" meta [IsParameterQuery = true, Type = "Text", IsParameterQueryRequired = true] // ──────────── Consulta 2 de 10 · nombre: EBD_Empresa · (parámetro) ─────────────────────────────── // El identificador de la empresa. Si no lo sabes, carga primero la consulta «Empresas» (la 6): lo trae. "pega_aqui_el_id_de_la_empresa" meta [IsParameterQuery = true, Type = "Text", IsParameterQueryRequired = true] // ──────────── Consulta 3 de 10 · nombre: EBD_Base · (parámetro) ────────────────────────────────── // La dirección de la API. La guía la ajusta a la instalación desde la que descargas este fichero. "https://app.easybankdata.com/v1" meta [IsParameterQuery = true, Type = "Text", IsParameterQueryRequired = true] // ──────────── Consulta 4 de 10 · nombre: EBD_Leer · (función) ──────────────────────────────────── // Una llamada GET a la API. `ruta` es la del contrato (/v1/openapi.json), con {tenant} donde va la empresa. // La base va aparte y la ruta en RelativePath: así Power BI puede programar la actualización en su servicio. let EBD_Leer = (ruta as text, optional consulta as nullable record) as any => let Relativa = Text.Replace(Text.TrimStart(ruta, "/"), "{tenant}", Uri.EscapeDataString(EBD_Empresa)), Respuesta = Web.Contents( EBD_Base, [ RelativePath = Relativa, Query = if consulta = null then [] else consulta, Headers = [Authorization = "Bearer " & EBD_Clave, Accept = "application/json"], // El 401 y el 403 no están a propósito: Power Query los trata él y no deja leerlos. Con una // clave que no vale o revocada sale su aviso de «credenciales no válidas»: cambia EBD_Clave. ManualStatusHandling = {400, 404, 429, 500, 502, 503} ] ), // Con un 401 o un 403 el estado llega vacío: se deja pasar y el aviso lo da Power Query al leer. EstadoLeido = Record.FieldOrDefault(Value.Metadata(Respuesta), "Response.Status", null), Estado = if EstadoLeido = null then 200 else EstadoLeido, Fallo = if Estado >= 400 then (try Json.Document(Respuesta) otherwise null) else null, DelFallo = (campo as text) as text => if Fallo is record then Text.From(Record.FieldOrDefault(Fallo, campo, "")) else "" in if Estado >= 400 then error Error.Record( "EasyBankData respondió " & Text.From(Estado) & " (" & DelFallo("code") & ")", DelFallo("message") & (if Estado = 429 then " Espera un minuto y vuelve a actualizar." else ""), [ruta = ruta, request_id = DelFallo("request_id")] ) else Json.Document(Respuesta) in EBD_Leer // ──────────── Consulta 5 de 10 · nombre: EBD_Todas · (función) ─────────────────────────────────── // Todas las páginas de una lista, siguiendo el testigo de la API (pagination.next_cursor), de 500 en 500. let EBD_Todas = (ruta as text, optional consulta as nullable record) as list => let Filtros = if consulta = null then [] else consulta, Pagina = (cursor as nullable text) => EBD_Leer(ruta, Filtros & [limit = "500"] & (if cursor = null then [] else [cursor = cursor])), Paginas = List.Generate( () => Pagina(null), (p) => p <> null, (p) => if p[pagination][has_more] = true and p[pagination][next_cursor] <> null then Pagina(p[pagination][next_cursor]) else null, (p) => p[data] ) in List.Combine(Paginas) in EBD_Todas // ──────────── Consulta 6 de 10 · nombre: Empresas ──────────────────────────────────────────────── // Las empresas que alcanza la clave: copia de aquí el id para EBD_Empresa. let Filas = EBD_Todas("/tenants"), Tabla = Table.FromRecords(Filas, {"id", "name", "role", "parent_id"}, MissingField.UseNull) in Tabla // ──────────── Consulta 7 de 10 · nombre: Cuentas ───────────────────────────────────────────────── let Filas = EBD_Todas("/tenants/{tenant}/accounts"), Tabla = Table.FromRecords( Filas, { "id", "connection_id", "name", "type", "subtype", "identifier", "currency", "balance_available", "balance_current", "transactions_count", "balance_check_status", "last_seen_at", "is_demo" }, MissingField.UseNull ), Tipos = Table.TransformColumnTypes( Tabla, { {"balance_available", Currency.Type}, {"balance_current", Currency.Type}, {"transactions_count", Int64.Type}, {"last_seen_at", type datetimezone}, {"is_demo", type logical} }, "en-US" ) in Tipos // ──────────── Consulta 8 de 10 · nombre: Movimientos ───────────────────────────────────────────── // Todos los movimientos en cada actualización. Para traer menos, pon una fecha en Desde ("2025-01-01"). let Desde = null, Filas = EBD_Todas("/tenants/{tenant}/transactions", if Desde = null then [] else [from = Desde]), Campo = (r, nombre) => if r is record then Record.FieldOrDefault(r, nombre, null) else null, Planas = List.Transform( Filas, (m) => [ id = m[id], fecha = m[date], fecha_valor = Campo(m, "value_date"), cuenta = m[account_id], concepto = Campo(m, "description"), contraparte = let c = Campo(m, "counterparty") in if Campo(c, "masked") = true then "(enmascarada)" else Campo(c, "name"), importe = m[amount], divisa = m[currency], saldo = Campo(m, "balance"), categoria = Campo(Campo(m, "classification"), "label"), codigo_categoria = Campo(Campo(m, "classification"), "category"), origen_categoria = Campo(Campo(m, "classification"), "source"), categoria_del_banco = Campo(m, "category"), etiquetas = Text.Combine( List.Transform( (let t = Campo(m, "tags") in if t = null then {} else t), (e) => Campo(e, "name") ), ", " ), centro_de_coste = Campo(Campo(m, "cost_center"), "name"), traspaso = Campo(m, "transfer_status"), de_ejemplo = m[is_demo], modificado = Campo(m, "updated_at") ] ), Tabla = Table.FromRecords( Planas, { "id", "fecha", "fecha_valor", "cuenta", "concepto", "contraparte", "importe", "divisa", "saldo", "categoria", "codigo_categoria", "origen_categoria", "categoria_del_banco", "etiquetas", "centro_de_coste", "traspaso", "de_ejemplo", "modificado" } ), Tipos = Table.TransformColumnTypes( Tabla, { {"fecha", type date}, {"fecha_valor", type date}, {"importe", Currency.Type}, {"saldo", Currency.Type}, {"de_ejemplo", type logical}, {"modificado", type datetimezone} }, "en-US" ) in Tipos // ──────────── Consulta 9 de 10 · nombre: IndicadoresMensuales ──────────────────────────────────── // Entradas, salidas y neto de los últimos 12 meses completos, con el mismo mes del año anterior. // Para otro intervalo: EBD_Leer("/tenants/{tenant}/insights/monthly", [from = "2025-01", to = "2025-12"]) // (como mucho 24 meses). let Datos = EBD_Leer("/tenants/{tenant}/insights/monthly"), Euros = (c) => if c = null then null else Currency.From(c / 100), Filas = List.Transform( Datos[months], (m) => let a0 = Record.FieldOrDefault(m, "previous_year", null), a = if a0 is record then a0 else [] in [ mes = m[period], entradas = Euros(m[inflows_cents]), salidas = Euros(m[outflows_cents]), neto = Euros(m[net_cents]), movimientos = m[transactions], mes_anio_anterior = Record.FieldOrDefault(a, "period", null), entradas_anio_anterior = Euros(Record.FieldOrDefault(a, "inflows_cents", null)), salidas_anio_anterior = Euros(Record.FieldOrDefault(a, "outflows_cents", null)), neto_anio_anterior = Euros(Record.FieldOrDefault(a, "net_cents", null)), variacion_entradas_pct = Record.FieldOrDefault(m, "inflows_change_percent", null), variacion_salidas_pct = Record.FieldOrDefault(m, "outflows_change_percent", null), datos_de_ejemplo = Datos[sample_data] ] ), Tabla = Table.FromRecords( Filas, { "mes", "entradas", "salidas", "neto", "movimientos", "mes_anio_anterior", "entradas_anio_anterior", "salidas_anio_anterior", "neto_anio_anterior", "variacion_entradas_pct", "variacion_salidas_pct", "datos_de_ejemplo" } ), Tipos = Table.TransformColumnTypes( Tabla, { {"entradas", Currency.Type}, {"salidas", Currency.Type}, {"neto", Currency.Type}, {"movimientos", Int64.Type}, {"entradas_anio_anterior", Currency.Type}, {"salidas_anio_anterior", Currency.Type}, {"neto_anio_anterior", Currency.Type}, {"variacion_entradas_pct", Int64.Type}, {"variacion_salidas_pct", Int64.Type}, {"datos_de_ejemplo", type logical} } ) in Tipos // ──────────── Consulta 10 de 10 · nombre: Categorias ───────────────────────────────────────────── // Entradas y salidas por categoría y mes (la categoría del cliente, no la del banco), una fila por pareja. let Datos = EBD_Leer("/tenants/{tenant}/insights/categories"), Euros = (c) => if c = null then null else Currency.From(c / 100), Filas = List.Combine( List.Transform( Datos[categories], (c) => List.Transform( c[months], (m) => [ mes = m[period], codigo_categoria = c[category], categoria = c[label], entradas = Euros(Record.FieldOrDefault(m, "inflows_cents", null)), salidas = Euros(Record.FieldOrDefault(m, "outflows_cents", null)), movimientos = Record.FieldOrDefault(m, "transactions", null) ] ) ) ), Tabla = Table.FromRecords(Filas, {"mes", "codigo_categoria", "categoria", "entradas", "salidas", "movimientos"}), Tipos = Table.TransformColumnTypes( Tabla, {{"entradas", Currency.Type}, {"salidas", Currency.Type}, {"movimientos", Int64.Type}} ) in Tipos