Skip to content

This is a custom component that checks periodically if you have any fines from KAT Bulgaria.

Notifications You must be signed in to change notification settings

Nedevski/hass_kat_bulgaria

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

31 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DEPRECATED / НЕРАБОТЕЩА ИНТЕГРАЦИЯ




КАТ обновиха системата си и библиотеката/интеграцията вече не работи.

Освен това не съм сигурен дали при проверка онлайн глобите не се броят за връчени - т.е. да започва да тече срока за плащане с 30% отстъпка.

Докато това не стане ясно - интеграцията няма да бъде поправена и няма да работи.




КАТ България - HACS интеграция за Home Assistant

English description is at the bottom!

Last release Code size


Тази интеграция позволява да се следи дали човек има нови глоби към КАТ България. Интеграцията взима информацията директно от официалния сайт на КАТ (e-uslugi.mvr.bg) без да логва абсолютно нищо. Единственото място на което се пазят данните е локално, като конфигурация на интеграцията.

Инсталиране

Тъй като това е неофициална интеграция е необходимо първо да се инсталира HACS - официалния туул за сваляне на неофициални интеграции и добавки към Home Assistant.

След инсталация, в основното меню ще се появи линк към HACS. В неговата страница има търсачка, която филтрира всички неофициални интеграции - там може да се потърси "KAT Bulgaria" и след отваряне на интеграцията да се свали чрез Download бутона.

След сваляне е задължително да се рестартира Home Assistant!

След рестарт се добавя като нормална интеграция: Настройки => Устройства и услуги => Добавяне на интеграция => KAT Bulgaria.

Как работи

За всеки конфигуриран потребител, тази интеграция ще създаде единичен бинарен сензор, който показва дали има чакаща глоба или не. Можете да добавяте колкото инстанции желаете - за всеки нов човек просто добавете нова интеграция. Записите се обновяват на всеки 20 минути.

За да настроите интеграцията, трябва да дадете име на човек, неговото ЕГН, както и номера на шофьорската му книжка.

За всяка конфигурирана инстанция се създава единично entity във формат globi_{име на човека}.

За момента генерираното entity не излиза към прилежащата му инстанция на интеграцията, за да го намерите трябва да влезете в списъка с ентитита и да го намерите там.

Config flow

Python библиотека

Тази интеграция използва моята Python библиотека - py_kat_bulgaria.

Библиотеката е изцяло независима от тази интеграция и може да се използва самостоятелно. Повече информация има в нейното readme.md.



KAT Bulgaria - a HACS integration for Home Assistant

The KAT Bulgaria custom integration allows users to check if they have any new fines from the Bulgarian Traffic Police (KAT). The integration is a wrapper around the official government website (e-uslugi.mvr.bg).

Installation

Since this is an unofficial integration, you have to download the HACS (Home Assistant Community Store).

After installing it you will have a link to HASS on the left menu. There you can search for "KAT Bulgaria", open the integration and click Download.

You have to restart Home Assistant in order to be able to see the integration!

After restarting you add the integration as usual: Settings => Devices and services => Add integration => KAT Bulgaria.

How it works

For each configured user this integration will create a single binary_sensor indicating if you have a fine or not. You can add as many entries as you need. Entries are updated once every 20 minutes.

In order to set up the integration, you need to provide a name, the person's EGN and the person's Driver License Number.

For every configured instance, a single entity is created in the format of globi_{name}.

Please note that the integration will not show any entities that belong to its instance, you need to go in the entity list screen in order to find your entity.

Config flow

Standalone Python library

The integration uses my py_kat_bulgaria library.

It's entirely separate from this integration and can be used on its own. Check out its description for more information.