{
  "schemaVersion": "1.0.0",
  "generatedAt": "2026-09-25",
  "territory": "ES",
  "currency": "EUR",
  "purpose": "Registro local, versionado y trazable de referencias energéticas para Wattely.",
  "tabularExports": [
    "electricidad_hogares_es_2025_componentes.csv",
    "omie_day_ahead_es_2026-09-24.csv"
  ],
  "rules": {
    "demoPolicy": "Un valor solo deja de ser DEMO cuando tiene fuente, periodo, territorio, unidad y alcance identificados.",
    "tariffPolicy": "Una referencia estadística nacional no se presenta como la tarifa personal de una vivienda.",
    "updatePolicy": "La fecha de consulta y el periodo del dato se conservan separados; no se actualiza un valor silenciosamente."
  },
  "sources": [
    {
      "id": "eurostat.nrg_pc_204_c",
      "organization": "Eurostat",
      "dataset": "Electricity price components for household consumers - annual data",
      "url": "https://ec.europa.eu/eurostat/cache/visualisations/energy-prices/enprices.html?geos=ES&product=6000&consumer=HOUSEHOLD&consoms=TOT_KWH&unit=KWH&taxs=I_TAX%2CX_TAX%2CX_VAT&nrg_prc=NETC%2CNRG_SUP%2COTH%2CTAX_CAP%2CTAX_ENV%2CTAX_NUC%2CTAX_RNW%2CVAT&currency=EUR&language=EN&detail=1&component=1&order=DESC&dataset=nrg_pc_204_c&time=2025&chartInDetails=1&chartId=mainChart&chartGeo=&percentage=0&share=false",
      "datasetUrl": "https://ec.europa.eu/eurostat/databrowser/view/nrg_pc_204_c/default/table?lang=EN",
      "accessedAt": "2026-09-23",
      "period": "2025",
      "method": "Lectura de la visualización oficial de Eurostat para España; los componentes se suman conservando cuatro decimales.",
      "unit": "EUR/kWh",
      "scope": "Hogares de España; todas las bandas de consumo del conjunto anual.",
      "limitations": [
        "Es una referencia estadística agregada, no una oferta comercial ni una factura individual.",
        "El conjunto anual y todas las bandas no deben confundirse con una banda semestral concreta.",
        "Incluye componentes de energía, red, otros conceptos e IVA según el conjunto mostrado."
      ]
    },
    {
      "id": "eurostat.nrg_pc_204",
      "organization": "Eurostat",
      "dataset": "Electricity prices for household consumers - bi-annual data",
      "url": "https://ec.europa.eu/eurostat/cache/visualisations/energy-prices/enprices.html?geos=ES&product=6000&consumer=HOUSEHOLD&consoms=KWH2500-4999&unit=KWH&taxs=I_TAX&nrg_prc=undefined&currency=EUR&language=EN&detail=0&component=0&order=DESC&dataset=nrg_pc_204&time=2025-S2&chartInDetails=0&chartId=mainChart&chartGeo=&percentage=0&share=false",
      "datasetUrl": "https://ec.europa.eu/eurostat/databrowser/view/nrg_pc_204/default/table?lang=EN",
      "accessedAt": "2026-09-23",
      "period": "2025-S2",
      "method": "Comprobación de la banda DC en la visualización oficial; el valor observado por el filtro I_TAX se conserva como control técnico y no se usa como tarifa por defecto hasta confirmar la dimensión fiscal en una descarga de datos.",
      "unit": "EUR/kWh",
      "scope": "Hogares de España; banda DC, 2.500 a menos de 5.000 kWh/año.",
      "limitations": [
        "La herramienta mostró una dimensión fiscal que debe cotejarse con la descarga estructurada antes de usarla como precio total.",
        "La estadística cubre medias de seis meses, no el contrato de una persona."
      ]
    },
    {
      "id": "cnmc.factura",
      "organization": "CNMC",
      "dataset": "Entiende tu factura",
      "url": "https://www.cnmc.es/prensa/entiende-tu-factura-20231002",
      "accessedAt": "2026-09-23",
      "period": "Guía de interpretación",
      "method": "Mapa de campos para separar energía, potencia, redes, impuestos, alquiler y servicios.",
      "unit": "Campos de factura",
      "scope": "Facturas domésticas españolas.",
      "limitations": [
        "No produce por sí sola un precio €/kWh personalizado."
      ]
    },
    {
      "id": "omie.day_ahead",
      "organization": "OMIE",
      "dataset": "Precio del mercado diario",
      "url": "https://www.omie.es/es/market-results/daily/daily-market/day-ahead-price",
      "datasetUrl": "https://www.omie.es/es/file-access-list",
      "accessedAt": "2026-09-23",
      "period": "Diario e intradiario según fichero",
      "method": "Fuente de series de mercado mayorista para una futura gráfica temporal.",
      "unit": "EUR/MWh (convertible a EUR/kWh dividiendo entre 1.000)",
      "scope": "Mercado diario ibérico.",
      "limitations": [
        "No incluye por sí solo red, margen comercial, alquiler, impuestos ni la factura final del hogar."
      ]
    },
    {
      "id": "idae.spahousec_iii",
      "organization": "IDAE",
      "dataset": "SPAHOUSEC III",
      "url": "https://informesweb.idae.es/spahousec-iii/informe.php",
      "accessedAt": "2026-09-23",
      "period": "Estudio residencial publicado por IDAE",
      "method": "Contexto estadístico para consumos, equipamiento y hábitos del hogar.",
      "unit": "Según tabla del estudio",
      "scope": "Sector residencial español.",
      "limitations": [
        "Una media del estudio no predice una vivienda concreta ni sustituye una medición."
      ]
    },
    {
      "id": "pvgis.api",
      "organization": "Comisión Europea - Joint Research Centre",
      "dataset": "PVGIS 5.3",
      "url": "https://joint-research-centre.ec.europa.eu/photovoltaic-geographical-information-system-pvgis/using-pvgis-5/api-non-interactive-service_en",
      "accessedAt": "2026-09-23",
      "period": "Según coordenadas y periodo solicitado",
      "method": "Adaptador futuro para producción fotovoltaica por ubicación; requiere coordenadas, potencia, orientación e inclinación.",
      "unit": "kWh y series temporales solares",
      "scope": "Ubicación concreta indicada por la persona usuaria.",
      "limitations": [
        "Es una estimación de modelo solar y no una medición del tejado."
      ]
    },
    {
      "id": "ree.pvpc.report.2025",
      "organization": "Red Eléctrica / Redeia",
      "dataset": "Informe del sistema eléctrico 2025 · PVPC",
      "url": "https://www.sistemaelectrico-ree.es/es/informe-del-sistema-electrico/mercados/precio-voluntario-pequeno-consumidor-pvpc",
      "accessedAt": "2026-09-25",
      "period": "2025",
      "method": "Escenario oficial de seguimiento PVPC con 4,6 kW y 3.900 kWh/año, reparto 45% valle, 26% llano y 29% punta.",
      "unit": "EUR/year and EUR components",
      "scope": "Tarifa regulada 2.0 TD, consumer sample",
      "limitations": [
        "Es una factura tipo anual, no una tarifa individual ni un precio puro por kWh.",
        "No se debe extrapolar automáticamente a cualquier comunidad, potencia o contrato.",
        "El informe indica que los datos eran provisionales en enero de 2026."
      ]
    },
    {
      "id": "ree.monthly_markets_2025",
      "organization": "Red Eléctrica / Redeia",
      "dataset": "Boletín mensual diciembre 2025 · mercado eléctrico",
      "url": "https://www.ree.es/es/datos/publicaciones/boletines-mensuales/boletin-mensual-diciembre-2025",
      "datasetUrl": "https://www.ree.es/sites/default/files/11_PUBLICACIONES/Documentos/06-mercados-diciembre-2025.xlsx",
      "accessedAt": "2026-09-25",
      "period": "2025-01 to 2025-12",
      "method": "Extracción de la hoja Dat_01: evolución de los componentes del precio final medio de la energía.",
      "unit": "EUR/MWh; converted to EUR/kWh",
      "scope": "National/system market series",
      "limitations": [
        "No es factura doméstica personalizada.",
        "No incluye contrato, potencia, impuestos ni cuotas individuales.",
        "No se presenta como precio por comunidad autónoma."
      ]
    }
  ],
  "verifiedRecords": [
    {
      "id": "es.household.electricity.reference.2025",
      "sourceId": "eurostat.nrg_pc_204_c",
      "status": "verified_reference",
      "period": "2025",
      "territory": "ES",
      "band": "Todas las bandas de hogares",
      "unit": "EUR/kWh",
      "value": 0.2839,
      "calculation": "0.0005 + 0.1159 + 0.0110 + 0.0806 + 0.0000 + 0.0246 + 0.0035 + 0.0478",
      "components": {
        "capacityTaxes": 0.0005,
        "energyAndSupply": 0.1159,
        "environmentalTaxes": 0.011,
        "networkCosts": 0.0806,
        "nuclearTaxes": 0,
        "other": 0.0246,
        "renewableTaxes": 0.0035,
        "vat": 0.0478
      },
      "recommendedUse": "Referencia inicial para mostrar un orden de magnitud y sustituir el precio DEMO en calculadoras lineales que permitan cambiarlo.",
      "notRecommendedFor": "Tarifa contractual personalizada, PVPC horario, comparación de una comercializadora concreta o factura exacta.",
      "confidence": "alta para el conjunto y periodo consultados; limitada para una vivienda concreta"
    },
    {
      "id": "es.omie.day_ahead.2026-09-24",
      "sourceId": "omie.day_ahead",
      "status": "verified_market_snapshot",
      "period": "2026-09-24",
      "territory": "ES",
      "unit": "EUR/MWh",
      "average": 157.24,
      "averageEurPerKwh": 0.15724,
      "maximum": 288.23,
      "minimum": 17.62,
      "tradedEnergyGWh": 541,
      "recommendedUse": "Gráfica de referencia del mercado mayorista del día siguiente y contraste de volatilidad intradiaria.",
      "notRecommendedFor": "Sustituir el precio de una factura doméstica: faltan red, comercialización, potencia, alquiler e impuestos.",
      "confidence": "alta para la fotografía publicada por OMIE en la fecha de consulta"
    },
    {
      "id": "es.pvpc.sample_bill.2025",
      "sourceId": "ree.pvpc.report.2025",
      "status": "verified_sample",
      "period": "2025",
      "territory": "ES",
      "tariff": "2.0 TD",
      "contractedPowerKw": 4.6,
      "annualConsumptionKwh": 3900,
      "annualBillEur": 885,
      "energyComponentEur": 416,
      "networkChargesEur": 280,
      "taxesEur": 189,
      "profile": {
        "punta": 0.29,
        "llano": 0.26,
        "valle": 0.45
      },
      "recommendedUse": "Contraste de orden de magnitud y explicación de componentes",
      "notRecommendedFor": "Precio universal por kWh o factura personalizada",
      "confidence": "alta para el escenario publicado; limitada fuera de ese perfil"
    },
    {
      "id": "es.ree.monthly_markets_2025",
      "sourceId": "ree.monthly_markets_2025",
      "status": "verified_official_market_series",
      "period": "2025",
      "territory": "ES",
      "file": "ree_market_final_mean_2025.json",
      "records": 12,
      "recommendedUse": "Gráfica mensual de referencia del mercado y capa temporal de estimación",
      "notRecommendedFor": "Factura real individual o precio final regional",
      "confidence": "alta para el fichero oficial extraído"
    }
  ],
  "pendingRecords": [
    {
      "id": "es.household.electricity.band_dc.2025_s2.total",
      "sourceId": "eurostat.nrg_pc_204",
      "status": "pending_tax_dimension_download",
      "period": "2025-S2",
      "territory": "ES",
      "band": "DC: 2.500 a menos de 5.000 kWh/año",
      "unit": "EUR/kWh",
      "value": null,
      "nextCheck": "Descargar la tabla estructurada y confirmar el código de nivel fiscal antes de convertirlo en referencia total."
    },
    {
      "id": "es.solar.pvgis.location",
      "sourceId": "pvgis.api",
      "status": "pending_location",
      "period": "A elección del usuario",
      "territory": "Ubicación por coordenadas",
      "unit": "kWh",
      "value": null,
      "nextCheck": "Solicitar ubicación y parámetros del sistema antes de producir una serie solar."
    }
  ],
  "adapterPlan": [
    {
      "priority": 1,
      "sourceId": "eurostat.nrg_pc_204",
      "result": "Precio semestral por banda y nivel fiscal",
      "guard": "No mezclar bandas ni impuestos"
    },
    {
      "priority": 3,
      "sourceId": "omie.day_ahead",
      "result": "Serie mayorista horaria/diaria",
      "guard": "Mostrarla como referencia de mercado, no como factura"
    },
    {
      "priority": 4,
      "sourceId": "idae.spahousec_iii",
      "result": "Contexto de consumos y equipamiento",
      "guard": "No usar una media como predicción individual"
    },
    {
      "priority": 5,
      "sourceId": "pvgis.api",
      "result": "Producción solar por ubicación",
      "guard": "Exigir ubicación y parámetros de instalación"
    }
  ]
}