Clientes para la lectura de contadores electricos de distribuidoras españolas.
IMPORTANTE: Este software no está vinculado con ninguna compañia electrica. Es un proyecto personal que se pone a disposición de todo el que quiera utilizarlo bajo su propia responsabilidad.
Este software agradece y da el credito a otros autores:
- inspirado por: https://github.com/hectorespert/python-oligo
- El driver para la lectura de los datos de ENDESA distribucion está integrado con ligeras modificaciones pero no es desarrollo propio sino de https://github.com/jagalindo/edistribucion
De momento está soportados contadores de las redes de:
- I-DE (Grupo Iberdrola). Identificativo: 'iberdrola'
- EREDES DISTRIBUCION (Total Energies. Antiguo HC o EDP). Identificativo: 'eredes'
- ENDESA DISTRIBUCION: Todo el grupo ENDESA. Sevillana, Fecsa, Enher. Identificativo: 'endesa'
Para poder consultar el contador es necesario darse de alta previamente en la correspondiente web y que los datos se obtiene de esa pagina mediante técnicas de webscraping. Las webs de las distribuidoras son:
- I-DE: https://www.i-de.es/consumidores/web/guest/login
- EREDES: https://misconsumos.eredesdistribucion.es/
- ENDESA DISTRIBUCION: https://www.edistribucion.com/
Adicionalmente obtienen los precios de la energia oficiales de la web de REE https://www.esios.ree.es/es/pvpc. Recupera los segmentos:
- EDCGASPCB: Precio por el concepto de 'tope al gas'
- TEUPCB: Precio correspondiente a los peajes y cargos
- PMHPCB: Precio correspondiente los mercados diario e intradiario
- TAHPCB: Precio correspondiente los mercados a plazos
- PCB: Precio total para el PVPC. Incorpora los dos anteriores mas el precio de la energia en los mercados mayoristas y otros conceptos menores.
Este programa utiliza el directorio definido en la variable de entorno KWHMETER_HOME para almacenar las credenciales y el cache de precios del eSios. Por defecto KWHMETER_HOME es $HOME/.kwhmeter
IMPORTANTE: Tanto los valores de energia como los de precio se almacenan a hora venciada. Es decir p.e. el consumo desde las 7:00 hasta las 7:59 se almacena con la marca de tiempo 8:00. Se tiene en cuenta el dia de cambio de hora y las timestamp están 'localizados' para la españa peninsular.
Existen dos ejecutables de la linea de comandos (CLI):
- kwhmeter_set_credenciales SUMINISTRO DISTRIBUIDORA USER PASSWORD. Mediante este comando se crea o actualiza el fichero de configuración $KWHMETER_HOME/credenciales.yml donde se almacenan las credenciales correspondientes a un suministro concreto.
- kwhmeter. Es el comando principal mediante el cual se recuperan las medidas
kwhmeter --help
Usage: kwhmeter [OPTIONS] SUMINISTRO
Options: --lista-facturas Muestra los periodos de facturación disponibles [default: False]
--n INTEGER Consumos para las facturas especificadas por indice. Se puede usar tantas veces como facturas se quieran recuperar [default: False]
--m INTEGER Consumos para las ultimas m facturas [default: False]
--factura TEXT Consumos para las facturas especificadas. Se puede usar tantas veces como facturas se quieran recuperar [default: False]
--fecha-ini [%Y-%m-%d] Fecha inicio consumos por fecha --fecha-fin [%Y-%m-%d] Fecha fin consumos por fecha --precios Añade los precios a cada hora [default: False]
--format [screen|cnmc_csv|excel|html] Formato de salida [default: screen] -t, --periodo [horario|diario|semanal|mensual|anual] Periodo a considerar para obtener el valor promedio/acumulado [default: horario]
-a, --acumulado / -p, --promedio Periodo a considerar para obtener el valor acumulado [default: True]
--fichero TEXT Fichero de salida (sin extensión) [default: consumos]
--help Show this message and exit.
El formato de salida cnmc_csv produce un CSV adaptado para poderlo usar en el simulador de facturas de la CNMC: https://comparador.cnmc.gob.es/facturaluz/inicio/
Tambien se puede invocar desde un script de python. Ver el directorio jupyter con ejemplos de uso.