Телеграм-бот для поиска ИИН, присвоенного негражданину Казахстана.
Для поиска ИИН боту необходимо на его запрос отправить текстом:
- полную дату рождения;
- имя и первую букву фамилии.
Пример работы бота можно увидеть в Telegram: @iin_find_bot
Телеграм-бот будет полезен тем негражданам Казахстана, которые:
- ранее получили ИИН, но потом его забыли;
- подали заявку на присвоение ИИН, но не получили уведомления о готовности с номером ИИН.
- Бот по дате рождения генерирует ~300 идущих подряд теоретически возможных ИИН для неграждан Казахстана.
- Далее он проверяет все сгенерированные ИИН в налоговой базе через API на сайте Казпочты (сравнивает имена для всех ИИН с именем, введённым пользователем).
- ИИН с совпавшими именами (а также ИИН с незаполненными именами в налоговой базе) далее проверяются в базе ГБД ФЛ через сайт НУЦ РК.
- Совпадения выдаются ботом как результат поиска ИИН.
Бот написан на языке Python v.3
Телеграм-бот написан на основе библиотеки aiogram v.3 - в этой библиотеке реализовано взаимодействие с Telegram Bot API
Прочие зависимости для работы бота указаны в файле requirements.txt
Проект некоммерческий. Если этот исходный код был вам полезен, вы можете поддержать автора донатом.
⚠️ Примечание:
Если вы просто хотите найти свой ИИН, то вам ничего устанавливать не нужно. В этом случае просто в Telegram найдите бота @iin_find_bot и на его запросы отправьте дату рождения и имя.
Скачивание и установка нужна только тем, кто сам занимается разработкой программ, хочет изучить исходный код этого бота и запустить свою копию этого бота или использовать его исходный код в своём проекте.
-
Скачайте и установите Python 3, если он у вас ещё не установлен.
-
Скачайте все файлы iin_find_bot из репозитория GitHub.
а) Если вы используете Git, тогда перейдите в директорию, где вы сохраняете проекты (например: ~/Projects) и клонируйте iin_find_bot из репозитория GitHub:
cd ~/Projects git clone https://github.com/mvgolubev/iin_find_bot.git
б) Если вы НЕ используете Git, тогда можно скачать все файлы с сайта GitHub в виде одного ZIP-файла (с последующей распаковкой файлов проекта):
- Откройте страницу репозитория на GitHub
- Зелёная кнопка Code 🡒 Download ZIP
-
Через диалог с телеграм-ботом @BotFather создайте своего телеграм-бота (если ещё не создали) и получите для него API Token.
-
Перейдите в директорию с ботом. Создайте там текстовый файл с именем ".env", куда сохраните полученный от @BotFather токен вашего бота (для примера возьмём значение API Token:
1234567890:AbcDefGhiJklMnoPqrStuVwxYz
) в переменную API_TOKEN
Linux/macOS/Windows (через bash/zsh или cmd/PowerShell):cd iin_find_bot echo API_TOKEN=1234567890:AbcDefGhiJklMnoPqrStuVwxYz > ".env"
-
Находясь в директории с ботом, создайте там виртуальное окружение Python (venv) и активируйте его:
Linux/macOS (в терминале через bash/zsh):python3 -m venv .venv source .venv/bin/activate
Windows (в терминале через cmd.exe или PowerShell):
python -m venv .venv .venv\Scripts\Activate
-
В виртуальное окружение установите зависимости из файла
requirements.txt
:pip install -r requirements.txt
-
Запустите телеграм-бота:
Linux/macOS/Windows (через bash/zsh или cmd/PowerShell)python main.py
-
После этого можно переходить в Telegram и пробовать подключаться к своему боту.
- Prepare Bot files:
mkdir /opt/bots
cd /opt/bots
git clone https://github.com/mvgolubev/iin_find_bot.git
cd iin_find_bot
echo API_TOKEN=1234567890:AbcDefGhiJklMnoPqrStuVwxYz > ".env"
- Prepare Python Virtual Environment:
apt install python3-venv
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
deactivate
- Create systemd service file:
cd /etc/systemd/system
nano iin_find_bot.service
- Save config to file:
[Unit]
Description=Python bot for IIN search
After=multi-user.target
[Service]
WorkingDirectory=/opt/bots/iin_find_bot
ExecStart=/opt/bots/iin_find_bot/.venv/bin/python main.py
Restart=always
RestartSec=60
[Install]
WantedBy=multi-user.target
Ctrl-O, Enter
Ctrl-X
- Enable Service autostart & Start Service
systemctl daemon-reload
systemctl enable iin_find_bot.service
systemctl start iin_find_bot.service
systemctl status iin_find_bot.service
A: ИИН (Индивидуальный Идентификационный Номер) — это уникальная последовательность из 12 десятичных цифр, которая единожды (и пожизненно) присваивается человеку в Республике Казахстан для его уникальной идентификации в банках, налоговых органах и других организациях и государственных структурах в Казахстане.
A: Нет. ИНН — это в России, и только для целей налогового учёта. В Казахстане нет ИНН, там есть только ИИН, и он используется не только для целей налогового учёта, а гораздо шире, для идентификации физических лиц в самых разных сферах жизни.
A: ИИН присваивается только физическим лицам — как гражданам Республики Казахстан (РК), так и негражданам, обратившимся за его получением.
Негражданам РК ИИН может потребоваться для:
- открытия счетов/карт в банках Казахстана;
- трудоустройства в Казахстане;
- регистрации юридического лица (например ТОО) в Казахстане;
- получения ЭЦП (электронной подписи) в Казахстане;
- взаимодействия с государственными органами Казахстана.
A: Этот бот позволяет найти только ИИН, присвоенные негражданам Республики Казахстан. У таких ИИН первые 6 цифр в номере — это год, месяц и день рождения, а 7-8 цифры в номере 05 или 00
ИИН, присвоенные гражданам РК, этот бот не найдёт.
A: Есть разные варианты, почему так может происходить:
- Возможно, вы некорректно указали дату рождения и/или имя с первой буквой фамилии (проверьте внимательно).
- Возможно, заявка на получение ИИН ещё не подавалась или была подана, но ещё не обработана (повторите попытку поиска позже).
- Возможно, вы пытаетесь найти ИИН для гражданина Республики Казахстан. Бот ищет ИИН только для неграждан РК.
- Возможно, сейчас какой-то технический сбой на серверах, через которые бот проверяет ИИН (повторите попытку поиска позже).
- Возможно, при выпуске ИИН была допущена ошибка, и вам выпустили ИИН, у которого первые 6 цифр номера не соответствуют дате вашего рождения (YYMMDD). Такое редко, но бывает. В этом случае бот вам не поможет найти ИИН.
A: Телеграм-бот проверяет ИИН в двух базах:
- ГБД ФЛ (Государственная база данных «Физические лица»);
- налоговая база КГД МФ РК (база налоговой службы Казахстана).
Сразу после присвоения физическому лицу ИИН попадает в базу ГБД ФЛ.
Через 1-3 рабочих дня после присвоения ИИН должен автоматически пройти налоговую регистрацию, в результате чего он автоматически должен попасть в налоговую базу КГД МФ РК.
A: Возможно, ИИН был создан (присвоен) недавно и ещё пока не успел попасть в налоговую базу КГД МФ РК. Подождите 1-3 рабочих дня.
Если вам ИИН нужен для оформления банковской карты, то имейте в виду, что не для всех банков Казахстана требуется, чтобы ИИН был загружен в налоговую базу.
A: Это зависит от банка Казахстана, в котором вы хотите оформить счета/карты.
Для открытия счетов/карт в банках Kaspi и Freedom Bank достаточно, чтобы ИИН просто существовал (был в базе ГБД ФЛ). Для открытия счетов/карт в этих двух банках не нужно ждать добавления ИИН в налоговую базу.
А для открытия счетов/карт во многих других банках Казахстана (БЦК, Forte, Home Credit, Jusan, Bereke, Halyk, RBK, Eurasian и др.) нужно, чтобы ИИН обязательно загрузился в налоговую базу. До этого обращаться в эти банки для оформления счетов/карт не имеет смысла.
A: Если после присвоения ИИН прошло уже более недели, а ИИН до сих пор не попал в налоговую базу, тогда он в эту налоговую базу автоматически, скорее всего, уже сам не попадёт. Увы, такое иногда случается.
В этом случае вам нужно обратиться в любое налоговое управление КГД МФ РК (лично или по телефону). Сообщите им, что вы давно получили ИИН, но он до сих пор не попал в налоговую базу, укажите свой ИИН и попросите добавить его в налоговую базу. После этих действий уже на следующий рабочий день ИИН должен оказаться в налоговой базе.