kat-bulgaria 2.1.0

A library to check for existing obligations from KAT Bulgaria

Summary

This library allows you to check if you have fines from KAT Bulgaria programatically.

The code here is a simple wrapper around the API, providing you with error validation and type safety.

It does NOT save or log your data anywhere and it works with a single API endpoint.

The reason this library is needed is because the government website is highly unstable and often throws random errors and Timeouts. This library handles all known bad responses (as of the time of writing) and provides a meaningful error message and an error code for every request.

---

If you like my work, please consider donating

---

Installation

pip install kat_bulgaria

Example usage script:

For a full working sample usage script, check out sample_usage_script.py.

Remember to replace the dummy data in the constants with your own data.

# For individuals:
# Validates EGN and Driver License Number locally and with the API.
is_valid = await KatApiClient().validate_credentials_individual(EGN, DRIVER_LICENSE)
print(f"Individual Credentials Valid: {is_valid}\n")

# Checks if an individual has obligations, returns true or false.
obligations = await KatApiClient().get_obligations_individual(EGN, DRIVER_LICENSE)
print(f"Individual Obligation Count: {len(obligations)}\n")
print(f"Raw: {obligations}\n")

################

# For businesses:
# Validates EGN, Government ID and BULSTAT locally and with the API.
is_valid = await KatApiClient().validate_credentials_business(EGN, GOVT_ID, BULSTAT)
print(f"Business Credentials Valid: {is_valid}\n")

# Checks if an individual has obligations, returns true or false.
obligations = await KatApiClient().get_obligations_business(EGN, GOVT_ID, BULSTAT)
print(f"Business Obligation Count: {len(obligations)}\n")
print(f"Raw: {obligations}\n")

Known raw API responses:

You can find sample API responses in /tests/fixtures.

I also document all sample responses in this issue for clarity.

If you have any fines, I would appreciate it if you attach the full JSON API response as a comment to the issue above.

You can get it by copying the url below and replacing EGN_GOES_HERE and LICENSE_GOES_HERE with your own data, then loading it in a browser.

https://e-uslugi.mvr.bg/api/Obligations/AND?obligatedPersonType=1&additinalDataForObligatedPersonType=1&mode=1&obligedPersonIdent=EGN_GOES_HERE&drivingLicenceNumber=LICENSE_GOES_HERE

After that place the JSON in any text editor and remove personal data, but do not change the JSON structure itself.