> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Предупреждения верификации бизнеса (KYB) и коды ошибок

> Коды предупреждений Didit KYB по функциям: реестр, документы, ключевые лица, AML, телефон, email, анкеты, Device & IP Analysis.

Верификация бизнеса выводит предупреждения для элемента функции, который их сформировал. Каждое предупреждение имеет стандартную структуру, общую для всей платформы: `feature`, `risk`, `log_type`, `short_description`, `long_description`, необязательный `additional_data` и `node_id`. Это позволяет направлять задачи на проверку нужной команде.

## Обзор

Сессии KYB генерируют предупреждения под тремя основными тегами функций, которые соответствуют отдельным массивам функций в ответе с решением V3:

| Тег функции | Ключ ответа с решением | Что проверяется |
| - | - | - |
| `KYB_REGISTRY` | `registry_checks[].warnings[]` | Запросы к официальным реестрам компаний. Статус активности, ограничения по странам, вывод структуры владения, отсутствие данных о должностных лицах и бенефициарных владельцах. |
| `KYB_DOCUMENTS` | `document_verifications[].warnings[]` | Учредительные документы, документы о структуре владения, документы, подтверждающие адрес, и документы об акционерах, которые загружает пользователь. Согласованность между документами, OCR, метаданные, манипуляции, возраст и правила подтипов. |
| `KYB_KEY_PEOPLE` | `key_people_checks[].warnings[]` | Сигналы по отдельным лицам: директорам, должностным лицам, конечным бенефициарным владельцам или сторонам, указанным пользователем. Сюда входят результаты PEP и санкционных проверок, которые передаются из AML, а также повторное использование результатов предыдущего отказа. |

Тот же сценарий KYB может также включать общие функции, перечисленные ниже. Они выводят предупреждения в собственных массивах:

| Тег функции | Ключ ответа с решением |
| - | - |
| `AML` | `aml_screenings[].warnings[]` |
| `PHONE` | `phone_verifications[].warnings[]` |
| `EMAIL` | `email_verifications[].warnings[]` |
| `QUESTIONNAIRE` | `questionnaire_responses` (предупреждения находятся в журнале сессии) |
| `LOCATION` | `ip_analyses[].warnings[]` |

## Предупреждения реестра KYB

Предупреждения реестра используют `feature: "KYB_REGISTRY"` и находятся в `registry_checks[].warnings[]`.

| Тег | Описание |
| - | - |
| `KYB_COUNTRY_RESTRICTED` | Страна компании не входит в число разрешённых стран, настроенных для сценария. |
| `KYB_OFFICERS_DATA_NOT_FOUND` | Данные о должностных лицах недоступны в реестре. |
| `KYB_OWNERSHIP_DATA_NOT_FOUND` | Данные о структуре владения недоступны в реестре. |
| `KYB_BENEFICIAL_OWNERSHIP_NOT_DERIVABLE` | Не удалось установить конечное бенефициарное владение по данным реестра. |
| `KYB_COMPANY_NOT_ACTIVE` | Согласно реестру компания не имеет статуса активной. |
| `KYB_COMPANY_NOT_FROM_REGISTRY` | Компания была введена вручную и не могла быть проверена по реестру компаний. |
| `KYB_REGISTRY_DATA_MISMATCH_WITH_EXPECTED` | Регистрационный номер компании, полученный из реестра, не совпадает с `expected_details.registration_number`, который вы передали при создании сессии. |
| `KYB_REGISTRY_DATA_PARTIAL_MATCH_WITH_EXPECTED` | Регистрационный номер, полученный из реестра, лишь частично совпадает с ожидаемым, например из-за суффикса филиала или дочерней компании. |
| `KYB_COMPANY_VAT_INVALID` | В официальном налоговом реестре нет активной регистрации для VAT-номера или налогового номера компании, либо VAT-номер не соответствует формату страны или правилам контрольной цифры. Применяется настроенное значение `kyb_vat_invalid_action` (по умолчанию: На проверке). |
| `KYB_COMPANY_VAT_COULD_NOT_VALIDATE` | VAT-номер или налоговый номер не удалось проверить, так как официальный реестр временно недоступен. Применяется настроенное значение `kyb_vat_unverified_action` (по умолчанию: без эффекта). |
| `KYB_COMPANY_VAT_NAME_MISMATCH` | Название, зарегистрированное в официальном реестре для этого номера, отличается от указанного названия компании. Информационное предупреждение. В `additional_data` передаются `registry_name`, `registry_source` и `submitted_name`, а также `vies_name`, если источником реестра является VIES. |

Предупреждения VAT применяются везде, где можно проверить VAT-номер или налоговый номер компании. Страны и источники перечислены в разделе [Проверка VAT и налогового номера](https://docs.didit.me/ru/business-verification/company-data.md#vat-и-проверка-налогового-номера).

## Предупреждения по документам KYB

Предупреждения по документам используют `feature: "KYB_DOCUMENTS"` и появляются в `document_verifications[].warnings[]`.

| Тег | Описание |
| - | - |
| `KYB_DOCUMENT_MISSING_REQUIRED_FIELD` | Обязательное поле компании, например название компании или регистрационный номер, не найдено в документе. |
| `KYB_DOCUMENT_NAME_MISMATCH` | Название компании в документе не совпадает с данными реестра. |
| `KYB_DOCUMENT_REG_NUMBER_MISMATCH` | Регистрационный номер в документе не совпадает с данными реестра. |
| `KYB_DOCUMENT_INCORPORATION_DATE_MISMATCH` | Дата регистрации компании в документе не совпадает с данными реестра. |
| `KYB_DOCUMENT_ADDRESS_MISMATCH` | Зарегистрированный адрес в документе не совпадает с данными реестра. |
| `KYB_CROSS_DOCUMENT_MISMATCH` | Данные компании различаются в разных загруженных корпоративных документах. |
| `KYB_DOCUMENT_METADATA_MISMATCH` | Подпись, метаданные или структура файла документа указывают на возможную проблему. |
| `KYB_ASSOCIATED_PARTY_MISMATCH` | Директора или акционеры, указанные в документе, не совпадают с данными реестра. |
| `KYB_DOCUMENT_GRAPHIC_EDITOR` | Похоже, что документ обрабатывался в графическом редакторе. |
| `KYB_DOCUMENT_SUSPECTED_MANIPULATION` | Система обнаружила признаки возможной манипуляции с корпоративным документом. |
| `KYB_DOCUMENT_UNPROVEN_TEXT_REPLACEMENT` | Текстовое поле корпоративного документа было стёрто и набрано заново другим шрифтом, при этом в файле нет доказательств того, изменилось ли его содержимое. Это предупреждение также появляется, если файл не удалось проверить полностью: тогда в `additional_data.detection_method` указано `analysis_incomplete`, поскольку непроверенная часть файла может содержать такое поле. Управляется параметром `kyb_document_unproven_text_replacement_action` (по умолчанию Review). Сценарий, который никогда не отправляет документы на проверку, использует собственный `kyb_document_tampering_action`, если тот равен Decline; в остальных случаях действие No action. |
| `KYB_ADDITIONAL_DATA_NOT_FOUND` | Поле документа не удалось проверить, так как соответствующие данные реестра недоступны. |
| `KYB_DOCUMENT_EXPIRED` | Возраст корпоративного документа превышает настроенное максимальное значение. |
| `KYB_DOCUMENT_UNSUPPORTED_SUBTYPE` | Загруженный подтип документа отключён для сценария. |
| `KYB_DOCUMENT_MAX_ATTEMPTS_EXCEEDED` | Превышено максимальное количество попыток загрузки корпоративного документа. |

Для манипуляций с текстовым наложением в PDF `KYB_DOCUMENT_SUSPECTED_MANIPULATION` может содержать `additional_data.manipulated_regions`. Текстовое поле, которое стёрли и набрали заново другим шрифтом, вызывает `KYB_DOCUMENT_UNPROVEN_TEXT_REPLACEMENT` с той же структурой `manipulated_regions`, но никогда не вызывает `KYB_DOCUMENT_SUSPECTED_MANIPULATION` само по себе: онлайн-редакторы также перенабирают нетронутый текст, поэтому это предупреждение не означает, что содержимое изменилось. Если на том же документе другой сигнал вызывает `KYB_DOCUMENT_SUSPECTED_MANIPULATION`, решает более строгое из двух действий. Эти прямоугольники в координатах страницы указывают предположительно изменённые области и совпадают с прямоугольниками, которые возвращаются в `document_verifications[].items[].document_metadata.overlay_manipulation.manipulated_regions`.

## Предупреждения по ключевым лицам KYB

Предупреждения по ключевым лицам используют `feature: "KYB_KEY_PEOPLE"` и появляются в `key_people_checks[].warnings[]`. Они показывают проблемы на уровне отдельных лиц: директоров, должностных лиц, UBO и сторон, которые указал пользователь.

| Тег | Описание |
| - | - |
| `KYB_PREVIOUSLY_DECLINED_INDIVIDUAL` | Лицо, связанное с компанией, ранее было отклонено в другой верификации бизнеса по той же заявке. |
| `KYB_KEY_PEOPLE_MISMATCH_WITH_DOCUMENTS` | Директора или акционеры, указанные на экране ключевых лиц, не совпадают с людьми, названными в загруженных корпоративных документах: человек из документов не был указан, имя почти совпадает, акционер, указанный в документах, был заявлен без роли в структуре владения, или заявленный процент владения противоречит документам. Применяется настроенный параметр `kyb_key_people_document_mismatch_action` (по умолчанию: На проверке). |

> [!NOTE]
>
> **Совпадения с PEP и санкционными списками у ключевых лиц** передаются как стандартные AML-совпадения в соответствующем элементе `aml_screenings[]`, а не как предупреждение KYB по ключевым лицам. Проверка ключевых лиц переносит полученный статус `Declined` или `In Review` на каждую затронутую сторону, поэтому общий итог проверки ключевых лиц отражает результат AML.

## Предупреждения общих функций

Перечисленные ниже функции могут работать внутри сценария KYB. Они используют тот же каталог предупреждений, что и Верификация пользователей. Полный справочник находится на странице предупреждений каждой функции.

### AML

`feature: "AML"` в `aml_screenings[].warnings[]`.

| Тег | Описание |
| - | - |
| `POSSIBLE_MATCH_FOUND` | AML-скрининг обнаружил возможное совпадение, требующее проверки. |
| `COULD_NOT_PERFORM_AML_SCREENING` | Didit не смог выполнить AML-скрининг, так как необходимые данные для скрининга отсутствовали или были недоступны. |

### Телефон

`feature: "PHONE"` в `phone_verifications[].warnings[]`.

| Тег | Описание |
| - | - |
| `DISPOSABLE_NUMBER_DETECTED` | Номер телефона одноразовый. |
| `VERIFICATION_CODE_ATTEMPTS_EXCEEDED` | Превышено максимальное количество попыток ввода кода подтверждения. |
| `VOIP_NUMBER_DETECTED` | Номер телефона является VoIP-номером. |
| `DUPLICATED_PHONE_NUMBER` | Номер телефона был использован в другом процессе верификации. |
| `HIGH_RISK_PHONE_NUMBER` | Номер телефона имеет высокий уровень риска. |
| `PHONE_NUMBER_IN_BLOCKLIST` | Номер телефона совпадает с записью в вашем списке блокировки. |

### Электронная почта

`feature: "EMAIL"` в `email_verifications[].warnings[]`.

| Тег | Описание |
| - | - |
| `BREACHED_EMAIL_DETECTED` | Адрес электронной почты фигурирует в известных утечках данных. |
| `DISPOSABLE_EMAIL_DETECTED` | Адрес электронной почты одноразовый. |
| `UNDELIVERABLE_EMAIL_DETECTED` | Доставка на адрес электронной почты невозможна. |
| `DUPLICATED_EMAIL` | Адрес электронной почты был использован в другом процессе верификации. |
| `EMAIL_IN_BLOCKLIST` | Адрес электронной почты совпадает с записью в вашем списке блокировки. |
| `EMAIL_CODE_ATTEMPTS_EXCEEDED` | Превышено максимальное количество попыток ввода кода подтверждения из электронного письма. |

### Анкета

`feature: "QUESTIONNAIRE"`.

| Тег | Описание |
| - | - |
| `CUSTOM_STATUS_RULE_TRIGGERED` | Правило статуса в сценарии оценило ответ в анкете и изменило статус функции. |

### Анализ устройства и IP

`feature: "LOCATION"` в `ip_analyses[].warnings[]`.

| Тег | Описание |
| - | - |
| `COUNTRY_FROM_DOCUMENT_DOES_NOT_MATCH_COUNTRY_FROM_IP` | Страна из документа не совпадает со страной по IP-адресу. |
| `PRIVATE_NETWORK_DETECTED` | Обнаружена частная сеть, VPN, прокси или сигнал Tor. |
| `EXPECTED_IP_ADDRESS_MISMATCH` | IP-адрес не совпадает с ожидаемым IP-адресом, указанным для сессии. |
| `IP_ADDRESS_IN_BLOCKLIST` | IP-адрес совпадает с записью в вашем списке блокировки. |
| `DEVICE_FINGERPRINT_IN_BLOCKLIST` | Отпечаток устройства совпадает с записью в вашем списке блокировки. |
| `DUPLICATED_IP_ADDRESS` | Тот же IP-адрес был использован в другой верификации с другим `vendor_data`. |
| `DUPLICATED_DEVICE_FINGERPRINT` | Тот же отпечаток устройства был использован в другой верификации с другим `vendor_data`. |

## Примеры

### Реестр: компания не активна

```json theme={null}
{
  "registry_checks": [
    {
      "node_id": "feature_kyb_registry",
      "status": "Declined",
      "warnings": [
        {
          "feature": "KYB_REGISTRY",
          "risk": "KYB_COMPANY_NOT_ACTIVE",
          "log_type": "error",
          "short_description": "Company is not active",
          "long_description": "The company is not active according to the registry.",
          "additional_data": null,
          "node_id": "feature_kyb_registry"
        }
      ]
    }
  ]
}
```

### Документы: подозрение на манипуляцию наложением

```json theme={null}
{
  "document_verifications": [
    {
      "node_id": "feature_kyb_documents",
      "status": "In Review",
      "warnings": [
        {
          "feature": "KYB_DOCUMENTS",
          "risk": "KYB_DOCUMENT_SUSPECTED_MANIPULATION",
          "log_type": "warning",
          "short_description": "Possible document manipulation",
          "long_description": "The system detected signs of possible corporate-document manipulation.",
          "additional_data": {
            "manipulated_regions": [
              { "page": 1, "x": 120, "y": 240, "width": 180, "height": 22, "page_width": 612, "page_height": 792 }
            ]
          },
          "node_id": "feature_kyb_documents"
        }
      ]
    }
  ]
}
```

### Ключевые лица: ранее отклонённое физическое лицо

```json theme={null}
{
  "key_people_checks": [
    {
      "node_id": "feature_kyb_key_people",
      "status": "In Review",
      "warnings": [
        {
          "feature": "KYB_KEY_PEOPLE",
          "risk": "KYB_PREVIOUSLY_DECLINED_INDIVIDUAL",
          "log_type": "warning",
          "short_description": "Previously declined individual",
          "long_description": "A person associated with the company was previously declined in another business verification for the same application.",
          "additional_data": null,
          "node_id": "feature_kyb_key_people"
        }
      ]
    }
  ]
}
```

## Связанные материалы

> [card] [Схема ответа](https://docs.didit.me/ru/business-verification/response-schema.md)
>
> Посмотрите, где предупреждения появляются в массиве каждой функции KYB.

> [card] [Статусы](https://docs.didit.me/ru/business-verification/statuses.md)
>
> Узнайте, как серьёзность предупреждения соотносится со статусом верификации.

> [card] [Документы](https://docs.didit.me/ru/business-verification/documents.md)
>
> Изучите группы документов, OCR и порядок выполнения перекрёстных проверок.

> [card] [Ключевые лица](https://docs.didit.me/ru/business-verification/key-people.md)
>
> Процесс верификации должностного лица, UBO и представленной стороны.

> [card] [Отчёт AML](https://docs.didit.me/ru/core-technology/aml-screening/report-aml-screening.md)
>
> Структура результатов на уровне совпадений для AML-скрининга компаний и физических лиц.

> [card] [Справочные модели данных](https://docs.didit.me/ru/reference/data-models.md)
>
> Канонические структуры для предупреждений и массивов функций.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.