alryaz / hass-energosbyt-plus

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

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

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

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

💵 Пожертвование на развитие проекта

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

Скриншоты

Информация о лицевом счёте

Общие начисления

Начисления по услуге

Последний зарегистрированный платёж

Счётчик коммунальных услуг

Служба отправки показаний

Установка

1. Установите HACS (инструкция по установке на оф. сайте)
2. Найдите EnergosbyT Plus (ЭнергосбыТ Плюс) в поиске по интеграциям ¹
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, то показания не будут отправлены¹.
• Например, если текущие, последние или принятые значения по счётчику – 321, 654 и 987 по зонам Т1, Т2 и Т3 соответственно, то показания не будут отправлены¹.

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, то показания будут отправлены¹.
• Например, если текущие, последние или принятые значения по счётчику – 321, 654 и 987 по зонам Т1, Т2 и Т3 соответственно, то показания будут отправлены¹.

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, то показания не будут отправлены¹.
• Например, если текущие, последние или принятые значения по счётчику – 321, 654 и 987 по зонам Т1, Т2 и Т3 соответственно, то показания будут отправлены¹.

Внимание: в данном примере будут отправлены показания 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