Skip to content

nedevski/hass_kat_bulgaria

Repository files navigation

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

Downloads Last release Code size Quality Gate Code coverage

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

Config flow

Инсталиране

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

След това изпозлвайте търсачката за намиране на интеграцията "KAT Bulgaria" или използвайте бутона по-долу

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

След сваляне трябва да се рестартира Home Assistant за да е видима интеграцията в списъка!

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

Как работи

Интеграцията поддържа както физически, така и юридически лица.

  • За физически лица проверката се извършва по ЕГН плюс едно от:
    • Номер на лична карта
    • Номер на шофьорска книжка
    • Номер на автомобил във формат A0000AA, без интервали
  • За юридически лица са нужни ЕГН и лична карта на собственика, както и БУЛСТАТ на фирмата

За всеки конфигуриран човек се създават няколко entities, които се обновяват на всеки 2 часа:

Превод на Български език

За да работят преводите правилно, трябва и езика на системата, и езика на потребителя да са зададени на Български.

Python библиотека

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

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


Ако харесвате работата ми, почерпете ме с 1 бира в Ko-Fi:

ko-fi


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).

Config flow

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

The integrations supports checks for both individuals and businesses

  • For individuals you need a combination of EGN (Unified Civil Number) and one of the following:
    • National ID number
    • Driving License Number
    • Car Plate Number, formatted as A0000AA, no blank spaces
  • For businesses you need the EGN and National ID Number of the owner, as well as the BULSTAT of the company

For each configured instance, a couple of entities are created and updated every 2 hours:

  • Count Non-Served (sensor, int) - total count of non-served fines
  • Count Served (sensor, int) - total count of non-served fines
  • Count Total (sensor, int) - total count of existing fines
  • Has Non-Served Tickets (binary_sensor)
  • Has Tickets (binary_sensor)
  • Total EUR Owed (sensor, int) - the total sum that needs to be paid, which takes into account the active discounts for early payment

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.


If you like my work - consider supporting me:

ko-fi

About

HomeAssistant/HACS интеграция за лесна проверка за налични глоби/фишове към КАТ

Topics

Resources

Stars

18 stars

Watchers

2 watching

Forks

Sponsor this project

Contributors