Metric Export para Excel

Metric Export entrega cualquier métrica de tus plantas como un archivo CSV que Excel y LibreOffice abren directamente. Esta página muestra los casos habituales como enlaces listos para usar, y cómo conectar Excel a un enlace para que un libro se actualice solo.

Requisitos previos

Una cuenta de Mirox que pueda leer las mediciones de la planta que exportas.
Un token de API del grupo Metric Export: consulta Uso de tokens de API. En un navegador en el que has iniciado sesión, un enlace funciona sin token.

La forma fácil: copia el enlace desde la aplicación

No tienes que construir un enlace a mano.

Abrir en Mirox

Exportación de datos ▸ Métricas — elige plantas, métricas, periodo y paso. La URL de la API de debajo de la vista previa es el enlace de exactamente esa selección, incluidos los componentes que has elegido. Probar prepara un token y comandos listos para usar.

Las recetas siguientes muestran cómo son estos enlaces, para que puedas adaptarlos.

Receta 1: producción de una planta cada 15 minutos

Una semana de inyección a red, como energía por cada 15 minutos:

curl --compressed "https://service.mirox.io/api/v1/export/series?park=ABC123DEF456&metrics=plant.grid_feedin&start=2026-07-01&end=2026-07-07&step=15min&values=delta" \
  -H "Authorization: Bearer YOUR_API_TOKEN" -o production_week.csv

Date;UTC offset;Grid feed-in (kWh)
2026-07-01 00:00;+02:00;0,0
2026-07-01 00:15;+02:00;0,0
2026-07-01 06:15;+02:00;1,3
...

Las horas son la hora local de la planta. La columna Desfase UTC (UTC offset con los nombres en inglés) hace inequívoca cada fila, también el día del cambio de hora. offset_column=false la omite; tz=utc exporta en UTC.
end=2026-07-07 incluye el 7 de julio.
Para una curva de la potencia en lugar de la energía, exporta plant.grid_power.

Receta 2: el mes anterior, todos los meses

Un enlace con un periodo predefinido entrega siempre el periodo completo más reciente. Este es el enlace para un libro que se actualiza una vez al mes:

curl --compressed "https://service.mirox.io/api/v1/export/series?park=ABC123DEF456&metrics=plant.grid_feedin,plant.rad_pyranometer,availability.inverter_park&window=previous_month&step=day" \
  -H "Authorization: Bearer YOUR_API_TOKEN" -o previous_month.csv

Date;Grid feed-in (kWh);Plant-plane radiation, pyranometer (kWh/m²);Inverter availability (park) (%)
2026-08-01;5321,4;6,8;99,6
...

Receta 3: varias plantas una junto a otra

Una columna por planta con multi_park_agg=split:

curl --compressed "https://service.mirox.io/api/v1/export/series?park=ABC123DEF456,DEF456ABC123&metrics=plant.grid_feedin&window=previous_month&step=day&multi_park_agg=split" \
  -H "Authorization: Bearer YOUR_API_TOKEN" -o plants_compare.csv

Date;Sunnyside - Grid feed-in (kWh);Riverbend - Grid feed-in (kWh)
2026-08-01;5321,4;4102,9
...

multi_park_agg=merge, el valor predeterminado, da una columna para todas las plantas juntas.
portfolio=<uid> selecciona todas las plantas de un portfolio.

Receta 4: cada inversor

Una métrica del nivel de inversor da una columna por inversor:

curl --compressed "https://service.mirox.io/api/v1/export/series?park=ABC123DEF456&metrics=inverter.ac&start=2026-07-01&end=2026-07-07&step=15min" \
  -H "Authorization: Bearer YOUR_API_TOKEN" -o inverters.csv

Date;UTC offset;WR 01.01 - AC production per inverter (kWh);WR 01.02 - AC production per inverter (kWh);...
2026-07-01 06:15;+02:00;0,6;0,6;...

Sin selección, el archivo lleva todos los inversores, 50 por página. lane_page=2 da los 50 siguientes; lane_limit=100 da 100 por página.
Para exportar solo determinados inversores, añade components=inverter:1043,inverter:1044. El diálogo de componentes de la pestaña Métricas pone las referencias en el enlace por ti.
Los strings y las cajas de conexión funcionan igual, con string.power (energía por string) y gak.power (energía por caja de conexión).

Receta 5: cada sensor de irradiancia

Cada sensor por separado, sin promediar:

curl --compressed "https://service.mirox.io/api/v1/export/series?park=ABC123DEF456&metrics=sensor.irradiance&window=yesterday&step=15min" \
  -H "Authorization: Bearer YOUR_API_TOKEN" -o sensors.csv

sensor.irradiation da la irradiación por sensor en kWh/m², con cualquier paso hasta un año. La plantilla del sistema Sensores de irradiancia (CAFE1030CAFE) lleva ambas, junto con la irradiación del piranómetro de la planta.

Receta 6: aerogeneradores

Energía y velocidad del viento de cada aerogenerador, por día:

curl --compressed "https://service.mirox.io/api/v1/export/series?park=ABC123DEF456&metrics=turbine.energy_ac,turbine.wind_speed&window=previous_month&step=day" \
  -H "Authorization: Bearer YOUR_API_TOKEN" -o turbines.csv

La potencia de un aerogenerador, turbine.power_ac, es una métrica de 15 minutos: expórtala con step=15min.

Receta 7: batería

Energía cargada y descargada y el estado de carga del almacenamiento, por día:

curl --compressed "https://service.mirox.io/api/v1/export/series?park=ABC123DEF456&metrics=battery.energy_in_ac,battery.energy_out_ac,battery.soc&window=previous_month&step=day" \
  -H "Authorization: Bearer YOUR_API_TOKEN" -o battery.csv

Para contenedores, racks, módulos o celdas individuales, usa las métricas de esos niveles, por ejemplo battery_box.soc o battery_cell.voltage. Una planta tiene muchas celdas; elige las que necesites en el diálogo de componentes.

Excel con Power Query

Power Query lee un enlace directamente, con el token en el encabezado Authorization. El libro se actualiza después con Datos ▸ Actualizar todo.

En Excel, elige Datos ▸ Obtener datos ▸ De otras fuentes ▸ Consulta en blanco.
Abre el Editor avanzado y pega la consulta siguiente. Sustituye la planta, las métricas y el token.
Cuando Excel pregunte cómo conectarse, elige Anónimo. El token ya está en el encabezado; cualquier otra opción hace que Excel rechace el encabezado.

let
    Source = Csv.Document(
        Web.Contents(
            "https://service.mirox.io",
            [
                RelativePath = "api/v1/export/series",
                Query = [
                    park = "ABC123DEF456",
                    metrics = "plant.grid_feedin,plant.rad_pyranometer",
                    window = "previous_month",
                    step = "day",
                    header = "id",
                    separator_csv = ",",
                    separator_decimal = "."
                ],
                Headers = [Authorization = "Bearer YOUR_API_TOKEN"]
            ]
        ),
        [Delimiter = ",", Encoding = 65001, QuoteStyle = QuoteStyle.Csv]
    ),
    Promoted = Table.PromoteHeaders(Source, [PromoteAllScalars = true]),
    Typed = Table.TransformColumnTypes(
        Promoted,
        {
            {"timestamp", type date},
            {"plant.grid_feedin", type number},
            {"plant.rad_pyranometer", type number}
        },
        "en-US"
    )
in
    Typed

header=id convierte los encabezados de columna en ids estables. La consulta sigue funcionando cuando una métrica cambia de nombre o cambia el idioma.
Con separator_decimal = "." y la referencia cultural "en-US", las cifras se leen igual en todos los equipos, sea cual sea su configuración regional.
Con un paso inferior a un día, la columna timestamp contiene fecha y hora: usa type datetime. La columna utc_offset es un texto.
Las celdas vacías se quedan vacías. Significan «sin datos», no cero.
Para una plantilla, usa RelativePath = "api/v1/export/series/template/CAFE1000CAFE" y omite metrics.

Mantén el token fuera de los libros compartidos

El token forma parte de la consulta y viaja con el libro. Crea un token del grupo Metric Export solo para este fin: puede leer exportaciones y nada más, y puedes revocarlo sin tocar tus otros tokens.

Abrir el archivo CSV en Excel

Separadores: los valores predeterminados (; entre columnas, , como separador decimal) se abren directamente en un Excel con configuración regional alemana o española. Para una configuración inglesa añade separator_csv=,&separator_decimal=. — ambos deben ser distintos.
Fechas: datetime_format acepta un patrón como %d.%m.%Y %H:%M si necesitas otro formato.
Codificación: los archivos son UTF-8. Si los caracteres especiales se ven mal, importa el archivo con Datos ▸ De texto/CSV.
Nombres de columna: language=es (o de, fr, it, pt) los traduce.
Tamaño: los archivos grandes se comprimen por el camino cuando el cliente lo acepta, de ahí --compressed en los ejemplos. Los navegadores y Excel lo hacen por sí solos.

Límites

Límite	Valor
Métricas por enlace	20
Plantas por enlace	50
Componentes por métrica y página	50, como máximo 100
Columnas	400
Valores por columna	180 000 — 125 días con 1 minuto, cinco años con 15 minutos
Valores en total	1 800 000

Un enlace que pide más se rechaza con 400 over_budget, y la respuesta nombra el paso o el periodo que cabría. Cómo dividir una exportación grande se describe en la API de Metric Export.

Los enlaces que ya usas siguen funcionando

Los enlaces de la anterior exportación de datos brutos siguen entregando las mismas columnas. No hay que cambiar nada en un libro que los usa:

https://service.mirox.io/api/v1/export/raw/query?metrics=raw_grid_energy_total&park=ABC123DEF456&start=2026-07-01T00:00:00Z&end=2026-07-08T00:00:00Z&step=15m&value=use_delta

https://service.mirox.io/api/v1/export/raw/query?metrics=raw_grid_energy_total&park=ABC123DEF456,DEF456ABC123&start=2026-07-01T00:00:00Z&end=2026-08-01T00:00:00Z&step=1h&value=use_delta&multi_park_agg=split

https://service.mirox.io/api/v1/export/raw/component/query?metrics=comp_raw_inverter_energy_ac&park=ABC123DEF456&component_type=inverter&start=2026-07-01T00:00:00Z&end=2026-07-08T00:00:00Z&step=15m&value=use_delta

https://service.mirox.io/api/v1/export/raw/component/query?metrics=comp_raw_string_energy&park=ABC123DEF456&component_type=string&components=1084279778457255938&start=2026-07-01T00:00:00Z&end=2026-07-08T00:00:00Z&step=15m&value=use_delta

Sus equivalentes en Metric Export son las recetas 1, 3 y 4 de arriba. Difieren tres cosas: la energía está en kWh en lugar de Wh, las horas son la hora local de la planta en lugar de UTC, y las métricas tienen los nombres que usan los informes. La guía de migración enumera cada id anterior con su métrica; los enlaces anteriores se describen en la API de exportación heredada.

Metric Export: la página Exportación de datos
API de Metric Export: todos los parámetros, límites y errores
Generador de informes externos: un ejemplo completo en Python
Uso de tokens de API: crea el token que usan los ejemplos
Preguntas frecuentes sobre la exportación de datos