API – Индивидуальный предприниматель
Подробная информация об индивидуальном предпринимателе по ОГРНИП или ИНН. Проверка на вхождение в реестр недобросовестных поставщиков.
Формат запроса
Используются GET-запросы следующего вида
https://api.checko.ru/json?object=entrepreneur
&key={ваш API-ключ}
&ogrn={ОГРНИП предпринимателя}
&inn={ИНН предпринимателя}
&source=true
Параметр запроса | Описание |
---|---|
object |
Обязательный параметр, указывающий на конкретный интерфейс API, в данном случае принимает значение entrepreneur . |
key |
Обязательный параметр, ваш API-ключ. Вы получаете его автоматически после регистрации. |
ogrn |
Рекомендуемый параметр, ОГРНИП предпринимателя, 15 цифр. Служит уникальным идентификатором для всех индивидуальных предпринимателей. |
inn |
Если вы не указали ОГРНИП, вы можете указать ИНН предпринимателя. В случае определения нескольких предпринимателей с указанным ИНН — такое бывает, если человек прекращал и начинал новую предпринимательскую деятельность — будет возвращена информация по последнему зарегистрированному предпринимателю. |
source |
При применении параметра source=true вы получите ответ с добавлением исходного набора данных из ЕГРИП. Подробнее об этом наборе данных читайте ниже. |
Формат ответа
{
"data": {
Основная информация ответа
"type": "ИП",
Тип результата, принимает значения
ОРГАНИЗАЦИЯ
или ИП
"ogrn": <STRING>,
ОГРНИП
"inn": <STRING>,
ИНН
"okpo": <STRING>,
ОКПО
"reg_date": <STRING>,
Дата регистрации индивидуального предпринимателя
"report_date": <STRING>,
Дата последнего изменения записи об индивидуальном предпринимателе в ЕГРЮЛ
"status": {
Особое состояние (статус) индивидуального предпринимателя
"code": <STRING>,
Код статуса по справочнику СИПСТ
"reason": <STRING>
Причина применения статуса
},
"liquidation": {
Прекращение деятельности индивидуального предпринимателя
"date": <STRING>,
Дата прекращения деятельности
"reason": <STRING>
Причина прекращения деятельности
},
"name": <STRING>,
Ф. И. О. индивидуального предпринимателя
"business_type": <STRING>,
Наименование вида индивидуального предпринимателя
"business_type_lite": <STRING>,
Сокращеное наименование вида индивидуального предпринимателя
"gender": <STRING>,
Пол индивидуального предпринимателя, принимает значения
М
или Ж
"location": {
Место регистрации индивидуального предпринимателя
"region_code": <STRING>,
Код региона
"locality": <STRING>
Локация
},
"okved": {
Основной вид экономической деятельности
"code": <STRING>,
Код ОКВЭД
"name": <STRING>,
Наименование вида деятельности согласно ОКВЭД
"version": <STRING>"
Версия справочника ОКВЭД, принимает значения
2001
или 2014
},
"okved_extra": [ {
Дополнительные виды экономической деятельности
"code": <STRING>,
Код ОКВЭД
"name": <STRING>,
Наименование вида деятельности согласно ОКВЭД
"version": <STRING>"
Версия справочника ОКВЭД
}, ... ],
"tax_service": {
Постановка на учет в налоговом органе
"ogrn_date": <STRING>,
Дата присвоения ОГРНИП
"code": <STRING>,
Код налогового органа
"name": <STRING>,
Наименование налогового органа
"address": <STRING>
Адрес налогового органа
},
"state_funds": {
Регистрация во внебюджетных фондах
"pfr": {
ПФР
"reg_date": <STRING>,
Дата регистрации
"reg_number": <STRING>,
Регистрационный номер
"code": <STRING>,
Код территориального органа ПФР
"name": <STRING>
Наименование территориального органа ПФР
},
"fss": {
ФСС
"reg_date": <STRING>,
Дата регистрации
"reg_number": <STRING>,
Регистрационный номер
"code": <STRING>,
Код территориального органа ФСС
"name": <STRING>
Наименование территориального органа ФСС
}
},
"licenses": [ {
Полученные лицензии
"number": <STRING>,
Номер лицензии
"issue_date": <STRING>,
Дата выдачи
"licensing_organization": <STRING>,
Орган, выдавший лицензию
"activities": [ <STRING>, ... ],
Виды лицензируемой деятельности
"locations": [ <STRING>, ... ],
Адреса мест осуществления лицензируемой деятельности
"date_start": <STRING>,
Дата начала действия лицензии
"date_finish": <STRING>
Дата окончания действия лицензии
}, ... ]
"is_unfair_supplier": <BOOLEAN>,
Признак вхождения в реестр недобросовестных поставщиков
"unfair_supplier_reasons": [ {
Записи реестра недобросовестных поставщиков
"registry_number": <STRING>,
Реестровый номер
"publish_date": <STRING>,
Дата публикации
"approve_date": <STRING>,
Дата утверждения
"customer_name": <STRING>,
Наименование заказчика
"customer_inn": <STRING>,
ИНН заказчика
"customer_кпп": <STRING>,
КПП заказчика
"purchase_number": <STRING>,
Номер закупки
"purchase_description": <STRING>,
Описание закупки
"contract_price": <INTEGER>
Цена контракта, руб.
}, ... ]
},
"source_data": {
Исходные данные ЕГРИП
},
"meta": {
Информация о результате запроса
"status": <STRING>,
Статус ответа, принимает значения
ok
или error
"message": <STRING>,
Сообщение, поясняющее результат запроса, не указывается в случае успешной обработки запроса и получении ответа, содержащего требуемые данные
"today_request_count": <INTEGER>
Количество успешно обработанных запросов с вашим API-ключом за сегодняшний день
}
}
Формат ответа при запросе исходных данных
При добавлении в запрос параметра source=true вы получите ответ с добавлением исходного набора данных из ЕГРИП. Эти данные являются точной копией XML-данных, поставляемых ФНС, конвертированных в формат JSON. Для удобства, названия ключей переведены в нижний регистр.
Вы можете скачать официальную документацию, описывающую структуру исходных XML-данных по следующим ссылкам