Skip to content

Интеграция ЭнергосбыТ.Плюс для Home Assistant

Notifications You must be signed in to change notification settings

alryaz/hass-energosbyt-plus

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

45 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ЛК «ЭнергосбыТ Плюс» для Home Assistant

Логотип интеграции

Предоставление информации о текущем состоянии ваших лицевых счетов в ЛК ЭнергосбыТ Плюс. Передача показаний по счётчикам.

EnergosbyT Plus personal cabinet information and status retrieval, with meter indications submission capabilities.

hacs_badge Лицензия Поддержка

💵 Пожертвование на развитие проекта
Пожертвование YooMoney Пожертвование Тинькофф Пожертвование PayPal Пожертвование Cбербанк

💬 Техническая поддержка
Группа в Telegram

Скриншоты

Информация о лицевом счёте Скриншот: Информация о лицевом счёте
Общие начисления Скриншот: Общие начисления
Начисления по услуге Скриншот: Начисления по услуге
Последний зарегистрированный платёж Скриншот: Последний зарегистрированный платёж
Счётчик коммунальных услуг Скриншот: Счётчик коммунальных услуг
Служба отправки показаний Скриншот: Служба отправки показаний

Установка

  1. Установите HACS (инструкция по установке на оф. сайте)
  2. Найдите EnergosbyT Plus (ЭнергосбыТ Плюс) в поиске по интеграциям 1
  3. Установите последнюю версию компонента, нажав на кнопку Установить (Install)
  4. Перезапустите Home Assistant

Конфигурация компонента:

  • Вариант А: Через Интеграции (в поиске - "ЭнергосбыТ Плюс" или "EnergosbyT Plus")
  • Вариант Б: YAML

Пример конфигурации YAML

...
energosbyt_plus:
  # Выбран филиал в г. Киров
  branch: kirov
  username: 1234567890
  password: super_password

Описание конфигурационной схемы

...
energosbyt_plus:
  
  # Филиал / регион
  # Доступные филиалы на момент релиза:
  # - vladimir: Владимирский филиал
  # - ivanovo: Ивановский филиал
  # - kirov: Кировский филиал
  # - chuvashia: Филиал Марий Эл и Чувашии
  # - oren: Оренбургский филиал
  # - samara: Самарский филиал
  # - saratov: Саратовский филиал
  # - ekb: Свердловский филиал (Екатеринбург)
  # - udm: Удмуртский филиал
  # - ulyanov: Ульяновский филиал
  branch: "..."

  # Имя пользователя (номер лицевого счёта)
  # Обязательный параметр
  username: "..."

  # Пароль
  # Обязательный параметр
  password: "..."

  # Конфигурация по умолчанию для лицевых счетов
  # Необязательный параметр
  #  # Данная конфигурация применяется, если отсутствует  # конкретизация, указанная в разделе `accounts`.
  default:

    # Добавлять ли объект(-ы): Информация о лицевом счёте
    # Значение по умолчанию: истина (true)
    accounts: true | false

    # Добавлять ли объект(-ы): Счётчик коммунальных услуг
    # Значение по умолчанию: истина (true)
    meters: true | false

    # Добавлять ли объект(-ы): Последний зарегистрированный платёж
    # Значение по умолчанию: истина (true)
    last_payment: true | false
    
    # Добавлять ли объект(-ы): Общие начисления
    # Значение по умолчанию: истина (true)
    charges: true | false
    
    # Добавлять ли объект(-ы): Начисления по услугам
    # Значение по умолчанию: истина (true)
    service_charges: true | false
    
    # Скрытие персональных данных
    #
    # Внимание! Данный параметр является техническим, и используется исключительно для
    # разработки и создания скриншотов (например, для тикетов). Его использование не
    # рекомендовано! Данный параметр не скрывает Ваши личные данные из логов.
    #
    # Значение по умолчанию: ложь (false)
    dev_presentation: true | false

  # Настройки для отдельных лицевых счетов
  # Необязательный параметр
  accounts:

    # Номер лицевого счёта
    "...":

      # Конфигурация по конкретным лицевым счетам выполняется аналогично
      # конфигурации по умолчанию для лицевых счетов (раздел `default`).
      ...

Вариант конфигурации "Чёрный список"

Для реализации белого списка, конфигурация выполняется следующим образом:

...
energosbyt_plus:
  ...
  # Выборочное исключение лицевых счетов
  accounts:
    # Все указанные ниже лицевые счета будут добавлены
    "123123123000": false
    "321321321000": false
    "333222111001": false

Вариант конфигурации "Белый список"

Для реализации белого списка, конфигурация выполняется следующим образом:

...
energosbyt_plus:
  ...
  # Отключение добавление лицевых счетов по умолчанию
  default: false

  # Выборочное включение лицевых сченов
  accounts:
    # Все указанные ниже лицевые счета будут добавлены
    "123123123000": true
    "321321321000": true
    "333222111001": true

Также возможно использовать укороченную запись:

...
energosbyt_plus:
  ...
  # Данный пример функционально эквивалентен предыдущему примеру
  default: false
  accounts: ["123123123000", "321321321000", "333222111001"]

Использование

Служба передачи показаний - energosbyt_plus.push_indications

Служба передачи показаний позволяет отправлять показания по счётчикам в личный кабинет, и имеет следующий набор параметров:

Название Описание
target Выборка целевых объектов, для которых требуется передавать показания
data.indications Список / именованный массив показаний, передаваемых в ЛК
data.incremental Суммирование текущих показаний с передаваемыми
data.ignore_period Игнорировать период передачи показаний
data.ignore_indications Игнорировать ограничения по значениям

Примеры вызова службы

1. Обычная передача показаний
  • Например, если передача показаний активна с 15 по 25 число, а сегодня 11, то показания не будут отправлены1.
  • Например, если текущие, последние или принятые значения по счётчику – 321, 654 и 987 по зонам Т1, Т2 и Т3 соответственно, то показания не будут отправлены1.
service: energosbyt_plus.push_indications
data:
  indications: "123, 456, 789"
target:
  entity_id: sensor.1243145122_meter_123456789

... или, с помощью именованного массива:

service: energosbyt_plus.push_indications
data:
  indications:
    t1: 123
    t2: 456
    t3: 789
target:
  entity_id: sensor.1243145122_meter_123456789

... или, с помощью списка:

service: energosbyt_plus.push_indications
data:
  indications: [123, 456, 789]
target:
  entity_id: sensor.1243145122_meter_123456789
2. Форсированная передача показаний

Отключение всех ограничений по показаниям.

  • Например, если передача показаний активна с 15 по 25 число, а сегодня 11, то показания будут отправлены1.
  • Например, если текущие, последние или принятые значения по счётчику – 321, 654 и 987 по зонам Т1, Т2 и Т3 соответственно, то показания будут отправлены1.
service: energosbyt_plus.push_indications
data_template:
  indications: [123, 456, 789]
  ignore_indications: true
  ignore_periods: true
target:
  entity_id: sensor.1243145122_meter_123456789
3. Сложение показаний
  • Например, если передача показаний активна с 15 по 25 число, а сегодня 11, то показания не будут отправлены1.
  • Например, если текущие, последние или принятые значения по счётчику – 321, 654 и 987 по зонам Т1, Т2 и Т3 соответственно, то показания будут отправлены1.

Внимание: в данном примере будут отправлены показания 444, 1110 и 1776, а не 123, 456 и 789.

service: energosbyt_plus.push_indications
data_template:
  indications: [123, 456, 789]
  incremental: true
target:
  entity_id: sensor.1243145122_meter_123456789