KZ Info Service

Описание#

KZ Info - это комплексный сервис, который обеспечивает интеграцию с различными открытыми и закрытыми источниками данных, предоставляя доступ к широкому спектру информации о гражданах Республики Казахстан.

Для комфортной интеграции через Backend API воспользуйтесь Swagger (OpenAPI)

Термины#

ИИН - индивидуальный идентификационный номер гражданина Республики Казахстан.
Субъект - это человек, который является объектом запроса на получение информации с открытых источников о нем.
АИС ОИП - Автоматизированная Информационная Система Оранов Исполнительного производства

Этапы:#

1. Получение API-KEY организации#

Первый этап для использования технологии - получение API-KEY организации. Чтобы получить API-KEY организации, необходимо зайти в Личный Кабинет по данной ссылке. API-KEY находится в поле Backend Api Key

backend_api_key

Пример API-KEY организации:

API-KEY: Efy202XKbVAWRu...

Примечание

Для наглядности используется укороченная длина API KEY. Его фактическая длина составляет 47 и более символов.

2. Отправка запроса на получение информации о наличии в реестре должников через АИС ОИП #

При отправке запроса на получение электронного документа используются данные в формате JSON.

Важно

Чтобы использовать данный сервис, необходимо иметь на него подписку. Подробнее о подписках можно прочитать здесь.

URL запроса:

https://kyc.biometric.kz/api/v1/backend/info/kz/exec_proc_info/

Формат запроса	Метод запроса
JSON	POST

API KEY необходимо передать в теле запроса:

Наименование поля	Тип	Обязательно	Описание
api_key	String	Да	API KEY организации в личном кабинете
iin	String	Да	ИИН субъекта

Примеры запроса:

cURLPythonJavaScript

    curl -X 'POST' \
    'https://kyc.biometric.kz/api/v1/backend/info/kz/exec_proc_info/' \
    -H 'accept: application/json' \
    -H 'Content-Type: application/json' \
    -d '{
    "api_key": "<organization_api_key>",
    "iin": "<subjects_iin>",
    }'

import requests

url = 'https://kyc.biometric.kz/api/v1/backend/info/kz/exec_proc_info/'

headers = {
    'Accept': 'application/json',
    'Content-Type': 'application/json',
}

data = {
    'api_key': '<organization_api_key>',
    'iin': '<subjects_iin>',
}

response = requests.post(url, headers=headers, json=data)

print(response.json())

const url = 'https://kyc.biometric.kz/api/v1/backend/info/kz/exec_proc_info/';

const apiKey = '<organization_api_key>';

const headers = {
    'Accept': 'application/json',
    'Content-Type': 'application/json'
};

const data = {
    api_key: apiKey,
    iin: '<subjects_iin>',
};

fetch(url, {
    method: 'POST',
    headers: headers,
    body: JSON.stringify(data)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error(error));

В качестве ответа придет JSON со следующими полями:

exec_proc - Номер исполнительного производства;
exec_proc_num - Номер исполнительного производства;
ip_start_date - Дата начала исполнительного производства;
il_date - Дата принятия решения судебным исполнителем;
debtor_iin - ИИН должника;
debtor_name - Имя должника;
debtor_secondname - Отчество должника;
il_organ_ru - Наименование органа, принявшего решение (на русском);
il_organ_kz - Наименование органа, принявшего решение (на казахском);
category_ru - Категория должника (на русском);
category_kz - Категория должника (на казахском);
recovery_amount - Сумма взыскания;
officer_surname - Фамилия судебного исполнителя;
officer_name - Имя судебного исполнителя;
officer_secondname - Отчество судебного исполнителя;
disa_name_ru - Наименование подразделения, осуществляющего взыскание (на русском);
disa_department_name_ru - Наименование отдела, осуществляющего взыскание (на русском);
recoverer_type_ru - Тип взыскателя (на русском);
recoverer_type_kz - Тип взыскателя (на казахском);
recoverer_iin - ИИН взыскателя;
recoverer_surname - Фамилия взыскателя;
recoverer_name - Имя взыскателя;
recoverer_secondname - Отчество взыскателя;
recoverer_bin - БИН взыскателя;
recoverer_title - Название компании взыскателя;

Пример ответа:

[
  {
    "exec_proc": "14501874",
    "exec_proc_num": "1164/20-75-3430",
    "ip_start_date": "2020-06-11T00:00:00.000+05:00",
    "il_date": "2020-05-22T00:00:00.000+05:00",
    "debtor_iin": "901231400567",
    "debtor_name": "ЛЕОНАРДО",
    "debtor_secondname": "ДИКАПРИО",
    "il_organ_ru": "Нотариальная палата по г.Алматы",
    "il_organ_kz": "Нотариальная палата по г.Алматы",
    "category_ru": "Взыскание суммы",
    "category_kz": "Сомманы өндіру",
    "recovery_amount": "144167.000",
    "officer_surname": "ДЕПП",
    "officer_name": "ДЖОННИ",
    "officer_secondname": [
      "КРИСТОФЕРОВИЧ",
      "Алматы қаласының жеке сот орындаушылары",
      "Частные судебные исполнители г.Алматы",
      "Алматы қ."
    ],
    "disa_name_ru": "Частные судебные исполнители г.Алматы",
    "disa_department_name_ru": "Частные судебные исполнители г.Алматы",
    "recoverer_type_ru": "Физическое лицо",
    "recoverer_type_kz": "Жеке тұлға",
    "recoverer_iin": "880514600789",
    "recoverer_surname": "ПИТТ",
    "recoverer_name": "БРЭД",
    "recoverer_secondname": "УИЛЬЯМОВИЧ"
  },
  {
    "exec_proc": "15521919",
    "exec_proc_num": "279/20-75-5929",
    "ip_start_date": "2020-10-01T00:00:00.000+05:00",
    "il_date": "2020-09-14T00:00:00.000+05:00",
    "debtor_iin": "921104600234",
    "debtor_name": "ТОМ",
    "debtor_secondname": "ХЕНКС",
    "il_organ_ru": "Нотариальная палата по г.Астана",
    "il_organ_kz": "Нотариальная палата по г.Астана",
    "category_ru": "В пользу иных юридических лиц",
    "category_kz": "Басқа заңды тұлғалардың пайдасына",
    "recovery_amount": "69997.000",
    "officer_surname": "КЛУНИ",
    "officer_name": "ДЖОРДЖ",
    "officer_secondname": [
      "ТИМОФЕЕВИЧ",
      "Алматы қаласының жеке сот орындаушылары",
      "Частные судебные исполнители г.Алматы",
      "Алматы қ."
    ],
    "disa_name_ru": "Частные судебные исполнители г.Алматы",
    "disa_department_name_ru": "Частные судебные исполнители г.Алматы",
    "recoverer_type_ru": "Юридическое лицо",
    "recoverer_type_kz": "Заңды тұлға",
    "recoverer_bin": "210640000789",
    "recoverer_title": "Товарищество с ограниченной ответственностью \"MEDIA-SOLUTIONS\""
  },
  {
    "exec_proc": "22325829",
    "exec_proc_num": "1214/22-75-4353",
    "ip_start_date": "2022-02-14T00:00:00.000+05:00",
    "il_date": "2022-01-26T00:00:00.000+05:00",
    "debtor_iin": "850624300987",
    "debtor_name": "МОРГАН",
    "debtor_secondname": "ФРИМАН",
    "il_organ_ru": "Нотариальная палата по г.Алматы",
    "il_organ_kz": "Нотариальная палата по г.Алматы",
    "category_ru": "Взыскание суммы",
    "category_kz": "Сомманы өндіру",
    "recovery_amount": "75031.000",
    "officer_surname": "ВАШИНГТОН",
    "officer_name": "ДЕНЗЕЛ",
    "officer_secondname": [
      "РОБЕРТОВИЧ",
      "Алматы қаласының жеке сот орындаушылары",
      "Частные судебные исполнители г.Алматы",
      "Алматы қ."
    ],
    "disa_name_ru": "Частные судебные исполнители г.Алматы",
    "disa_department_name_ru": "Частные судебные исполнители г.Алматы",
    "recoverer_type_ru": "Юридическое лицо",
    "recoverer_type_kz": "Заңды тұлға",
    "recoverer_bin": "230540000432",
    "recoverer_title": "Товарищество с ограниченной ответственностью \"Коллекторское агентство \"IMPERIUM\""
  }
]

Ошибки#

Код состояния	Ответ	Описание
400	Subscription has not started	Подписка еще не активировалась
400	No active or future subscription for technology	Нет активной или будущей подписки на технологию
400	Client does not have subscription	У клиента отсутствует подписка, подробнее о подписках можно прочитать здесь
400	Client does not have access to KZ Info technology	У клиента нет доступа к технологии. Причины: подписка отсутствует, либо она истекла, или технология не активна
404	Subject not found	Данные по субъекту не найдены
503	KZ Citizen Info service is not available now	Сервис KZ Citizen Info в данное время не доступен