Saltar a contenido

Consumo Eléctrico Comunal

Carril: candidate / deprecated — NO incluido en el bundle público. Fuente confirmada caída (2026-07-07): el catálogo Junar de energiaabierta.cl (subdominio datos.energiaabierta.cl) fue decomisionado por la CNE. El dominio raíz fue migrado a WordPress; la página descriptiva del dataset sigue existiendo, pero no ofrece ningún archivo descargable ni endpoint de API — el enlace "API" del propio sitio apunta a /visualizaciones/en-mantencion/. El extractor nunca logró un fetch en vivo exitoso desde que se agregó este dataset: los datos publicados corresponden a FALLBACK_ROWS, una muestra mínima fabricada de 3 filas (Santiago y Concepción, 2023), no a datos reales de la CNE. Ver data/source_registry.json (consumo_electrico_comunal) y AGENTS.md §6 ("Protocolo ante fuente permanentemente caída"). Se reevaluará solo si la CNE publica un reemplazo oficial del catálogo de datos abiertos.

Consumo eléctrico anual por comuna y tipo de cliente, publicado por la Comisión Nacional de Energía (CNE) en el portal Energía Abierta. Los datos provienen de la información que las empresas distribuidoras entregan a la CNE.

Fuente y licencia

  • Fuente: CNE — Energía Abierta
  • Formato de origen: Excel (descarga directa, sin API key) — actualmente sin endpoint funcional
  • Reutilización: CC BY con atribución requerida
  • URL: http://energiaabierta.cl/datasets-estadistica/consumo-electrico-anual-por-comuna-y-tipo-de-cliente/ (página descriptiva sin archivo descargable)

Esquema

codigo_region, codigo_comuna, nombre_comuna, anio, tipo_cliente (Residencial, Comercial, Industrial, Agrícola, Alumbrado Público, Otros), consumo_kwh, numero_clientes, fuente, url_fuente, fecha_fuente

Uso

from chile_hub import ChileHub
import polars as pl

hub = ChileHub()
df = hub.load_polars("consumo_electrico_comunal")

# Consumo residencial 2023, top 10 comunas
top_residencial = (
    df.filter(pl.col("tipo_cliente") == "Residencial")
    .sort("consumo_kwh", descending=True)
    .head(10)
)
print(top_residencial)

SELECT codigo_comuna, nombre_comuna, tipo_cliente,
       consumo_kwh / 1e6 AS consumo_gwh
FROM 'data/normalized/consumo_electrico_comunal.parquet'
WHERE tipo_cliente = 'Industrial'
ORDER BY consumo_kwh DESC;

Limitaciones

  • Nombres de comuna sin CUT en la fuente original: el Excel de Energía Abierta usa nombres de comuna, no códigos CUT. El extractor cruza contra la DPA de chile-hub para asignar codigo_comuna; comunas sin match son excluidas.
  • Rezago de publicación: los datos anuales se publican con 1-2 años de rezago respecto al año de consumo.
  • Cambios de dominio: el portal Energía Abierta ha cambiado de dominio históricamente (energiaabierta.cl, energiaabierta.cne.cl, datos.energiaabierta.cl). Se monitorea la URL.
  • Cobertura de tipo de cliente: la clasificación por tipo de cliente sigue la nomenclatura de la CNE, que puede variar entre años.

Registro de cambios

  • v2 (2026-07-07): Degradado a deprecated / candidate, excluido del bundle público. La fuente Junar de energiaabierta.cl fue confirmada permanentemente caída; el dataset nunca tuvo un fetch en vivo exitoso y solo publicaba datos de muestra fabricados.
  • v1 (2026-06-30): Primera versión. Datos de consumo eléctrico anual por comuna desde Energía Abierta (CNE).

Estado: retirado de la señal de salud (ADR-015)

La fuente está permanentemente caída: CNE decomisionó el catálogo Junar de energiaabierta.cl (investigado 2026-07-07, ver AGENTS.md §6 y el next_action de data/source_registry.json). No hay archivo ni API de reemplazo, y el dataset nunca tuvo un fetch en vivo exitoso — solo publica filas de muestra.

Desde el 2026-07-29 aparece marcado retired: true en hub_health.json y no participa en los contadores de salud (drifted_count, warn_count, etc.). Esto no lo elimina: sigue en el catálogo, en el enum Dataset y accesible vía hub.load_polars("consumo_electrico_comunal"), y drift_report.json lo sigue reportando como drifted. Lo que cambia es que un drift que nadie puede resolver dejó de contar como señal.

No consumas este dataset para análisis. Si CNE publica un reemplazo oficial, revertir el retiro es una línea en data/source_registry.json.

Schema (auto-generado desde contracts/datasets/consumo_electrico_comunal.schema.json)

Columna Tipo Ejemplo Requerida Nota
codigo_region VARCHAR(2) "01" Sí —
codigo_comuna VARCHAR(5) "01101" Sí PK
nombre_comuna VARCHAR "Santiago" Sí —
anio INTEGER 2023 Sí PK
tipo_cliente VARCHAR "Residencial" Sí PK
consumo_kwh DOUBLE 1523400.5 Sí —
numero_clientes INTEGER 45800 Sí —
fuente VARCHAR "CNE — Energía Abierta" Sí —