A library to check for existing obligations to KAT Bulgaria
Project description
Summary
This is a python library to check for obligations to KAT Bulgaria programatically.
It does NOT save or log your data anywhere and it works with a single HTTPS request.
Installation
pip install kat_bulgaria
Usage:
from kat_bulgaria.obligations import KatError, KatPersonDetails, check_obligations
egn = "0011223344"
driver_license_number = "123456789"
# Validates EGN and Driver License Number internally
# Throws ValueError on invalid input
person = KatPersonDetails(egn, driver_license_number)
try:
response = check_obligations(person)
except KatError as err:
print(f"Error: {str(err)}")
return
has_obligations = response.has_obligations
print(f"Has obligations: {has_obligations}")
Known raw API responses (debug info):
# No fines/obligations:
{"obligations":[],"hasNonHandedSlip":false}
# One or more fines/obligations, which have not been served
{"obligations":[],"hasNonHandedSlip":true}
# One or more fines/obligations, which *have* been served
### MISSING
# Invalid EGN or Driver License Number:
{"code":"GL_00038_E","message":"Няма данни за посоченото СУМПС/ЕГН или не се намира съответствие за издадено СУМПС на лице с посочения ЕГН/ЛНЧ"}
# The service is down, that happens a couple of times a day:
{"code":"GL_UNDELIVERED_AND_UNPAID_DEBTS_E","message":"По технически причини към момента не може да бъде извършена справка за невръчени и неплатени НП и/или електронни фишове по Закона за движението по пътищата и/или по Кодекса за застраховането."}
# Timeout:
# From time to time the API hangs and it takes more than 10s to load.
# You can retry immediately, you can wait a couple of minutes
# Господине, не виждате ли че сме в обедна почивка???
# At this point it's out of your hands
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
kat_bulgaria-0.2.2.tar.gz
(3.9 kB
view hashes)
Built Distribution
Close
Hashes for kat_bulgaria-0.2.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 352aa4663926c0a582bd6c24f27a9edc18df1522ee02556af6afab2545f241c4 |
|
MD5 | 16763a36b8d3a71037cfbe3d4c8b5d63 |
|
BLAKE2b-256 | 02a572a02ea857fd542d7356804717f471ad9178e49fe4249567ce522479ca17 |