> For the complete documentation index, see [llms.txt](https://docs.npck.kz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.npck.kz/servisy-coid/servis-proverki-yuridicheskogo-lica-pervogo-rukovoditelya.md).

# Сервис проверки юридического лица (первого руководителя)

В сервисах биометрической и двухфакторной аутентификации реализована возможность проверки полномочий первого руководителя юридического лица и получения сведений о юридическом лице по БИН.

{% hint style="info" %}
Сервис доступен только в рамках сервиса биометрической аутентификации и FinID.
{% endhint %}

### Возможности сервиса

Сервис позволяет:

* провести идентификацию физического лица с использованием биометрической проверки и получением согласия;
* получить из ГБД ЮЛ сведения о юридическом лице по БИН, включая данные о первом руководителе;
* сопоставить ИИН идентифицированного физического лица с ИИН первого руководителя, указанным в ГБД ЮЛ, и подтвердить наличие соответствующих полномочий;
* в случае успешного сопоставления передать сведения о юридическом лице в рамках соответствующего сервиса.

### Использование

Для запроса сведений о юридическом лице необходимо передать scope `legal_entity` и дополнительный параметр `legalEntityScopeData` с БИН организации в методе `POST /v1/auth/generate-user-url`:

```json
{
  "scopes": ["legal_entity"],
  "legalEntityScopeData": {
    "bin": "971110300091"
  }
}
```

{% hint style="warning" %}
Параметр `legalEntityScopeData.bin` обязателен при использовании scope `legal_entity`. БИН должен соответствовать проверяемой организации.
{% endhint %}

### Пример запроса (Stage)

```bash
curl --location 'https://api.stage.npck.kz/v1/auth/generate-user-url' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Basic <base64(ClientID:ClientSecret)>' \
--data '{
  "scopes": [
    "iin",
    "legal_entity"
  ],
  "redirectUri": "Ваш redirect URL",
  "state": "Test",
  "phone": "Телефон",
  "iin": "ИИН руководителя",
  "legalEntityScopeData": {
    "bin": "БИН организации"
  },
  "language": "en",
  "blockTimeMinutes": 1
}'
```

### Получение сведений о юридическом лице

При успешном прохождении биометрии сведения о юридическом лице передаются в методе `POST /oauth2/introspect`:

```bash
curl --location 'https://api.stage.npck.kz/oauth2/introspect' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Accept: application/json' \
--header 'Authorization: Basic <base64(ClientID:ClientSecret)>' \
--data-urlencode 'token=<string>'
```

{% hint style="info" %}
Токен можно получить через [`POST /oauth2/token`](https://auth-openapi.npck.kz/#tag/Auth/operation/getOauthToken).

Сведения о юридическом лице из ГБД ЮЛ возвращаются в ответе только при успешной идентификации первого руководителя и совпадении его ИИН с данными ГБД ЮЛ.
{% endhint %}

### Набор полей по юридическому лицу (ГБД ЮЛ)

| №  | Наименование                             | Поле                    |
| -- | ---------------------------------------- | ----------------------- |
| 1  | Код статуса                              | `Code`                  |
| 2  | Наименование статуса (RU)                | `NameRu`                |
| 3  | Наименование статуса (KZ)                | `NameKz`                |
| 4  | БИН юридического лица                    | `BIN`                   |
| 5  | Статус регистрации                       | `RegStatus`             |
| 6  | Дата регистрации                         | `RegistrationDate`      |
| 7  | Дата последней регистрации               | `RegistrationLastDate`  |
| 8  | Полное наименование (RU)                 | `FullNameRu`            |
| 9  | Полное наименование (KZ)                 | `FullNameKz`            |
| 10 | Краткое наименование (RU)                | `ShortNameRu`           |
| 11 | Краткое наименование (KZ)                | `ShortNameKz`           |
| 12 | Организационная форма                    | `OrgForm`               |
| 13 | Организационно-правовая форма            | `FormOfLaw`             |
| 14 | Тип предпринимательства                  | `PrivateEnterpriseType` |
| 15 | Признак налоговой организации            | `TaxOrgStatus`          |
| 16 | Код регистрирующего органа               | `Code`                  |
| 17 | Наименование регистрирующего органа (RU) | `NameRu`                |
| 18 | Наименование регистрирующего органа (KZ) | `NameKz`                |
| 19 | Способ создания                          | `CreationMethod`        |
| 20 | Форма собственности                      | `PropertyType`          |
| 21 | Признак типового устава                  | `TypicalCharter`        |
| 22 | Признак коммерческой организации         | `CommerceOrg`           |
| 23 | Признак субъекта предпринимательства     | `EnterpriseSubject`     |
| 24 | Признак аффилированности                 | `Affiliated`            |
| 25 | Признак международной организации        | `International`         |
| 26 | Признак иностранного участия             | `ForeignInvest`         |
| 27 | Признак единого гражданства              | `OneCitizenShip`        |
| 28 | Признак наличия филиалов                 | `branchesExistence`     |
| 29 | Тип должности руководителя               | `PositionType`          |
| 30 | Дата назначения руководителя             | `IssueDate`             |
| 31 | Страна руководителя                      | `Country`               |
| 32 | Страна гражданства руководителя          | `CitizenCountry`        |
| 33 | Отношение к гражданству                  | `NationalityRelation`   |
| 34 | ИИН первого руководителя                 | `IIN`                   |
| 35 | Фамилия первого руководителя             | `SurName`               |
| 36 | Имя первого руководителя                 | `Name`                  |
| 37 | Отчество первого руководителя            | `MiddleName`            |
| 38 | Признак основного вида деятельности      | `Main`                  |
| 39 | Код ОКЭД                                 | `OKED`                  |
| 40 | Наименование вида деятельности (RU)      | `ActivityNameRu`        |
| 41 | Наименование вида деятельности (KZ)      | `ActivityNameKz`        |
| 42 | РКА                                      | `RKA`                   |
| 43 | Почтовый индекс                          | `ZIPCode`               |
| 44 | КАТО                                     | `KATO`                  |
| 45 | АТЕ                                      | `ATE`                   |
| 46 | Код геонима                              | `GeonimCode`            |
| 47 | Район/город (RU)                         | `DistrictRu`            |
| 48 | Район/город (KZ)                         | `DistrictKz`            |
| 49 | Регион/район (RU)                        | `RegionRu`              |
| 50 | Регион/район (KZ)                        | `RegionKz`              |
| 51 | Город (RU)                               | `CityRu`                |
| 52 | Город (KZ)                               | `CityKz`                |
| 53 | Улица (RU)                               | `StreetRu`              |
| 54 | Улица (KZ)                               | `StreetKz`              |
| 55 | Тип здания                               | `BuildingType`          |
| 56 | Номер здания                             | `BuildingNumber`        |
| 57 | Фамилия учредителя                       | `SurName`               |
| 58 | Имя учредителя                           | `Name`                  |
| 59 | Отчество учредителя                      | `MiddleName`            |
| 60 | Общее количество учредителей             | `FoundersCount`         |
| 61 | Количество учредителей ЮЛ                | `FoundersCountUL`       |
| 62 | Количество учредителей ФЛ                | `FoundersCountFL`       |
| 63 | Размер организации                       | `OrgSize`               |