Exportación de Datos en Bruto para Excel

La exportación en bruto entrega las mediciones tal como se registraron — cualquier ventana temporal, cualquier resolución (desde 5 minutos hasta un día), sin limitarse a días completos — como un CSV que puede abrir directamente en Excel o LibreOffice. Esta guía recorre los cuatro casos cotidianos: la producción de un solo parque, varios parques uno al lado del otro, inversores individuales y strings individuales.

Mientras que la exportación de plantillas está pensada para scripts de informes automatizados y repetibles, la exportación en bruto está hecha para el análisis manual: lleve una ventana a una hoja de cálculo, cree una tabla dinámica, trace un gráfico y listo.

Requisitos previos

Cuenta de Mirox con permiso para leer el parque que exporta
Token de API con el grupo de permisos Reporting — consulte Uso de Tokens de API. (En un navegador con sesión iniciada, el enlace compartible funciona sin token.)

La vía fácil: copiar el enlace desde la interfaz

Nunca tiene que construir una URL a mano. Abra Exportación de datos ▸ Datos en bruto, elija sus parques, métricas, ventana y resolución — la página muestra en vivo una vista previa de la URL de la API que refleja exactamente su selección, incluidas las elecciones de componentes. Cópiela, añada la cabecera con su token en curl (o simplemente ábrala en el navegador) y ya tiene el CSV.

Los ejemplos siguientes muestran el aspecto de esas URL, para que pueda adaptarlas en scripts o guardar variaciones como marcadores.

Los modos de valor

Los contadores de energía en los datos en bruto son acumulativos — solo crecen. El parámetro value decide qué acaba en su hoja de cálculo:

`value`	Significado	Úselo para
`plain` (predeterminado)	El contador tal como se registró, acumulándose a lo largo de la ventana de exportación	Comprobaciones al estilo de lectura de contador
`start_at_zero`	Cada serie desplazada para que empiece en 0	Comparar curvas de crecimiento
`use_delta`	El cambio por intervalo — p. ej., la energía producida en cada tramo de 15 minutos	Análisis de producción — esto es lo que normalmente quiere en Excel

Receta 1: Producción de un solo parque

Una semana de la producción de red de un parque con resolución de 15 minutos, como energía por intervalo:

curl --compressed "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" \
  -H "Authorization: Bearer YOUR_API_TOKEN" -o production_week.csv

Date;Grid Production (Wh)
2026-07-01 00:00;0,00
2026-07-01 00:15;0,00
2026-07-01 06:15;1250,50
...

Un año completo a 15 minutos funciona de la misma manera — establezca start/end con un año de diferencia (el selector de la aplicación tiene los preajustes Este año y Año pasado precisamente para esto). Esa es la ventana más grande por serie que permite la exportación; para ventanas de varios años cambie a step=1h o 1d.

El catálogo de métricas en bruto (ids, nombres, unidades) está en GET /v1/metrics/raw; hasta 20 métricas por solicitud, separadas por comas.

Receta 2: Comparación multiparque

Varios parques en un solo archivo, una columna por parque (multi_park_agg=split):

curl --compressed "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" \
  -H "Authorization: Bearer YOUR_API_TOKEN" -o parks_compare.csv

Date;Sunnyside - Grid Production (Wh);Riverbend - Grid Production (Wh)
2026-07-01 00:00;0,00;0,00
...

multi_park_agg=merge (el valor predeterminado) combina en cambio los parques en una columna por métrica — sumada para energía/potencia, promediada para temperaturas y ratios.
portfolio=<uid> delimita la exportación a todos los parques de una cartera sin tener que listarlos.
Una exportación separada (split) está limitada a 50 columnas (métricas × parques).

Receta 3: Inversores individuales

La exportación de componentes profundiza en los componentes de un parque. Los ids de métrica llevan el prefijo comp_raw_ (catálogo: GET /v1/metrics/components?component_type=inverter):

curl --compressed "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" \
  -H "Authorization: Bearer YOUR_API_TOKEN" -o inverters.csv

Date;WR 01.01 - Inverter Production (Wh);WR 01.02 - Inverter Production (Wh);...
2026-07-01 06:15;620,25;618,75;...

Sin una selección de components, la exportación pagina por todos los inversores del parque (page/limit, hasta 50 por página).
Para elegir algunos concretos, pase components=<id1>,<id2>,... — los ids aparecen en el selector de componentes de la interfaz (y en su URL copiada), o en la lista components de la respuesta de la exportación.
component_type=gak funciona de forma idéntica para las cajas de conexiones (GAK).
multi_component_agg=merge colapsa la selección en una sola columna (suma para energía, promedio para tensiones/temperaturas).

Receta 4: Strings individuales

El mismo endpoint con component_type=string — ideal para comprobar un string sospechoso frente a sus vecinos:

curl --compressed "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" \
  -H "Authorization: Bearer YOUR_API_TOKEN" -o string.csv

La forma más sencilla de obtener los ids de string es el selector de la aplicación en la pestaña Datos en bruto (nivel de detalle String): seleccione los strings y copie la URL previsualizada — ya lleva incluida la lista components.

Abrir el CSV en Excel

Separadores: los valores predeterminados (; de campo, , decimal) se abren directamente en Excel con configuración regional alemana. Para configuraciones de EE. UU./Reino Unido pase separator_csv=,&separator_decimal=. — ambos deben ser diferentes.
Fechas: los pasos inferiores a un día incluyen la hora del día; datetime_format acepta un patrón strftime (p. ej., %d.%m.%Y) si su configuración regional lo necesita.
Codificación: los archivos son UTF-8; use Datos ▸ Desde texto/CSV si las diéresis se ven mal.
Encabezados localizados: language=de (o es, fr, it, pt) traduce los nombres de las columnas.
Tamaño: las respuestas grandes se comprimen con gzip en el transporte cuando el cliente lo acepta — de ahí el --compressed de los ejemplos; los navegadores lo gestionan automáticamente.

Límites

Límite	Valor
Métricas por solicitud	20
Puntos de datos por serie (nivel parque)	180.000 — caben 5 años a resolución de 15 minutos
Muestras totales (nivel parque)	1.800.000 (series × puntos de datos por serie)
Puntos de datos por serie (nivel componente)	36.000 — cabe un año completo a resolución de 15 minutos
Columnas en `split` por parque	50 (métricas × parques)
Componentes seleccionados explícitamente	50
Columnas en `split` por componente	100 (métricas × componentes)

Una solicitud que supere el presupuesto se rechaza con 400 y un mensaje que indica el límite — aumente el paso, acorte la ventana o reduzca la selección. La referencia completa está en la Guía de la API de Exportación de Métricas.

Funciones relacionadas

Generador de Informes Externos — la contraparte de la exportación de plantillas: informes automatizados en Python
API de Exportación de Métricas — referencia completa de parámetros y límites para todas las vías de exportación
Uso de Tokens de API — cree el token que usan los ejemplos con curl
MiroxQL — cree métricas derivadas para las exportaciones agregadas