Skip to content

Проверка связи с юр. лицами

personAffiliationV2

Тип HTTP запроса: POST

URL вызова: https://api.id-x.org/idx/api2/personAffiliationV2

Поддерживаются следующие форматы передачи параметров:

  • JSON, Content-Type: application/json

  • Form submit, Content-Type: application/x-www-form-urlencoded

Параметры:

Параметр Тип Обязательный Описание
accessKey String Да Ключ доступа, выданный при регистрации в Системе IDX
secretKey String Да Секретный ключ, выданный при регистрации в Системе IDX
inn String Да ИНН физического лица

Функция возвращает:

Параметр Тип Обязательный Описание
resultCode Int Да Результат выполнения функции (0 – успешное завершение функции, -100 – данные не найдены, иные значения – ошибка выполнения)
resultMessage String Нет Сообщение об ошибке
operationToken String Нет Уникальный идентификатор операции
founderInfo Массив типа FounderInfo Нет Массив объектов – данных об учрежденных данным лицом компаниях. Подробнее см. данные об учрежденных компаниях
ceoInfo Массив типа CeoInfo Нет Массив объектов – данных о компаниях, где данное лицо является руководителем. Подробнее см. данные о компании, где лицо является директором
individualInfo Массив типа IndividualInfo Нет Объект репрезентующий информаци об индивидуальном предпринимателе. Подробнее см. данные об ИП

Пример вызова:

POST /idx/api2/personAffiliationV2
Host: api.id-x.org
Content-Type: application/json
Accept: application/json

{
    "accessKey": "выданный accessKey",
    "secretKey": "выданный secretKey",
    "inn": "123456789012"
}

Пример успешного ответа:

{
    "resultCode": 0,
    "resultMessage": "",
    "operationToken": "a09062d0a75847b39f427b335c84da9b",
    "founderInfo": [*массив учрежденных компаний*],
    "ceoInfo": [*массив компаний, где лицо является директором*],
    "individualInfo": [*массив данных об ИП*]
}

Пример неуспешного ответа:

{
    "resultCode": -100,
    "resultMessage": "Информация не найдена"
}

Данные об учрежденных компаниях

Это объект, содержащий следующие атрибуты:

Атрибут Тип Описание
shares Массив объектов Share Информация о долях физического лица в компании. Подробнее см. акции
objectType String Тип компании
companyName String Название компании
capital Int Капитал компании
regDate String Дата регистрации компании
inn String ИНН компании
kpp String КПП компании
ogrn String ОГРН компании
status String Статус компании

Пример объекта "Данные об учрежденных компаниях" в формате json:

{
    "shares": [*акции*],
    "objectType": "Company",
    "companyName": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"РОГА И КОПЫТА\"",
    "capital": 10000,
    "regDate": "27.03.2010",
    "inn": "1234567890",
    "kpp": "123456789",
    "ogrn": "1234567890123",
    "status": "Active"
}

Акции

Это объект, содержащий следующие атрибуты:

Атрибут Тип Описание
grn Long ОГРН компании, акционером которой является физическое лицо
sharesPercent Int Процент от общего числа акций
sharesValue Int Доля в денежном эквиваленте (рубли)
isActual Boolean Актуальность информации (True – информация актуальна, False – неактуальна)

Пример объекта "Акции" в формате json:

{
    "grn": 1234567890123,
    "sharesPercent": 33,
    "sharesValue": 3300,
    "isActual": true
}

Данные о компании, где лицо является директором

Это объект, содержащий следующие атрибуты:

Атрибут Тип Описание
name String Название компании
type String Тип компании
capital String Капитал компании
isActive String Статус компании (основные статусы: Active - действующая организация, Terminated - организация ликвидирована, InTerminationProcess - организация в процессе ликвидации)
inn String ИНН компании
ogrn String ОГРН компании
regDate String Дата регистрации компании
closeDate String Дата ликвидации компании
okved String ОКВЕД

Пример объекта "Данные о компании, где лицо является директором" в формате json:

{        
    "name": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"РОГА И КОПЫТА\"",
    "type": "Company",
    "capital": "10000",
    "isActive": "Terminated",
    "inn": "1234567890",
    "ogrn": "1234567890123",
    "regDate": "27.03.2010",
    "closeDate": "27.03.2015",
    "okved": "61.10.1 ДЕЯТЕЛЬНОСТЬ ПО ПРЕДОСТАВЛЕНИЮ УСЛУГ ТЕЛЕФОННОЙ СВЯЗИ"
}

Данные об ИП

Это объект, содержащий следующие атрибуты:

Атрибут Тип Описание
okved String ОКВЕД
ogrn String ОГРНИП
inn String ИНН ИП
name String Название ИП
regDate String Дата регистрации ИП
status String Статус ИП (Active - действующий ИП, Terminated - ИП ликвидирован)

Пример объекта "Данные об ИП" в формате json:

{        
    "okved": "62.01 РАЗРАБОТКА КОМПЬЮТЕРНОГО ПРОГРАММНОГО ОБЕСПЕЧЕНИЯ",
    "ogrn": "123456789012345",
    "inn": "123456789012",
    "name": "ИП ИВАНОВ ИВАН ИВАНОВИЧ",
    "regDate": "27.03.2010",
    "status": "Active"
}