KAT България - Python пакет за програмна проверка за задължения към КАТ
Този пакет позволява да се извършват лесни програмни проверки за налични глоби към МВР.
Цялата библиотека е обикновен wrapper около официалната система. Библиотеката НЕ запазва или логва вашите данни никъде. Данните са директно предадени на системата на МВР
Причината да създам този пакет е че системата на МВР понякога е нестабилна и хвърля различни видове грешки и timeouts. С негова помощ се стандартизират и валидират отговорите от системата и се извличат данни във формат, готов за употреба, или в случай на грешки - биват извлечени категорияи на грешката и смислено съобщение за грешка.
Ако харесвате работата ми, почерпете ме с 1 бира в Ko-Fi:
Инсталиране
pip install kat_bulgaria
Примерен скрипт:
Добавил съм примерен работещ скрипт в репото - sample_usage_script.py.
Преди да се изпълни скрипта, обновете примерните данни с реални ваши такива.
# Проверка за физически лица - лична карта:
obligations = await KatApiClient().get_obligations_individual(
egn="валидно_егн",
identifier_type=PersonalDocumentType.NATIONAL_ID,
identifier="номер_лична_карта"
)
print(f"Брой задължения - ФЛ/ЛК: {len(obligations)}\n")
print(f"Raw JSON: {obligations}\n")
# Проверка за физически лица - шофьорска книжка:
obligations = await KatApiClient().get_obligations_individual(
egn="валидно_егн",
identifier_type=PersonalDocumentType.DRIVING_LICENSE,
identifier="номер_шофьорска_книжка"
)
print(f"Брой задължения - ФЛ/ШК: {len(obligations)}\n")
print(f"Raw JSON: {obligations}\n")
# Проверка за юридически лица - лична карта:
obligations = await KatApiClient().get_obligations_business(
egn="валидно_егн",
govt_id="номер_лична_карта",
bulstat="валиден_булстат"
)
print(f"Брой задължения - ЮЛ: {len(obligations)}\n")
print(f"Raw JSON: {obligations}\n")
API отговори:
Примерни API отговори може да бъдат намерени в /tests/fixtures.
Старая се да документирам всички API отговори до които имам достъп в това issue с набавяне на по-голям сет тестови данни.
Ако някой има активни глоби, бих се радвал да получа целия JSON отговор от системата на МВР. Можете да го добавите в коментар в issue-то линкнато по-горе.
Можете да си набавите JSON-а, като копирате адреса отдолу и замените EGN_GOES_HERE и LICENSE_GOES_HERE с вашите ЕГН и номер на шофьорска книжка.
Силно препоръчително е преди публикуване да заредите JSON-a в тесктов едитор и да редактирате всички ваши лични данни в него.
1 maintainer
Metadata
1 maintainer
Release files for kat-bulgaria 3.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| kat_bulgaria-3.2.0.tar.gz | 11.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| kat_bulgaria-3.2.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 20.3 kB
Release files / kat_bulgaria-3.2.0.tar.gz
| Download URL | kat_bulgaria-3.2.0.tar.gz |
|---|---|
| Size | 11.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c71e4a4f316341487c1a6c81703cfab8979efbc78c888892d4990ab3aa408943
|
|
BLAKE2b-256 checksum How to use checksums |
896bcb8c6a96efbab2aee1b3bb83e0fcddabd7690e0bf674e36d432ef82739df
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 19, 2025.
Transparency logRelease files / kat_bulgaria-3.2.0-py3-none-any.whl
| Download URL | kat_bulgaria-3.2.0-py3-none-any.whl |
|---|---|
| Size | 8.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0ca84eda74dd429c0f15cb67123dc0eb3fb156e3cd25fbd433eddb889f59a8fe
|
|
BLAKE2b-256 checksum How to use checksums |
0d9f2bd37f2ecfc76bdfbe93ca1c9c1967ebfef917aa7beb4d619807cc50321e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 19, 2025.
Transparency log
