Сервис для комплаенс пре-скоринга клиента при открытии ему расчетного счета
Модель комплаенс пре-скоринга оценивает вероятность возникновения комплаенс мер в течение года с момента прихода клиента в банк.
Для оценки различных типов клиентов используются отдельные ресурсы:
- /ie/score для ИП, 12-значный ИНН.
- /llc/score для компаний (ООО), 10-значный ИНН.
Скоринг производится для каждого запроса к API, поэтому значение может меняться с течением времени, т.е. значения, рассчитанные, например, в январе и феврале, могут отличаться.
Полученное значение скоринга обычно относится к одной из трех категорий: зеленая, желтая или красная. Категории определяют какое решение рекомендуется вынести по данному клиенту и какие бизнес-действия с ним стоит предпринять. Величины и действия могут быть различными для разных партнеров банка, поэтому, пожалуйста, свяжитесь насчет данных категорий с вашим партнерским менеджером от Банка или командой поддержки данного комплаенс-сервиса (scoring_openapi_support@alfabank.ru).
Коды ошибок
Основные коды ошибок, возвращаемые API.
| Код ошибки | Описание |
|---|---|
| #1000 | ИНН является валидным, но компания с данным ИНН не найдена в базе ФНС. |
| #1001 | Запрос не передал тело запроса в формате JSON. Проверьте заголовки и тело запроса. |
| #1002 | Переданное тело запроса не является валидным JSON объектом. Проверьте тело запроса. |
| #2001 | Не удалось получить данные от поставщика данных из ФНС. Попробуйте позднее. |
| #2002 | Ошибка в процессе скоринга. Если ошибка повторяется, пожалуйста обратитесь к поддержке данного API |
TLS RSA
TLS ГОСТ Режим разработки
TLS ГОСТ Промышленный режим
Paths
/v3/ie/score
Получить вероятность комплаенс-риска для ИП
Получить вероятность комплаенс-риска для переданного ИНН Индивидуального Предпринимателя
x509 сертификат в Base64 формате
Тело запроса
Неверные параметры запроса
Ошибка сервера при выполнении запроса
/v3/llc/score
Получить вероятность комплаенс-риска для компании
Получить вероятность комплаенс-риска для переданного ИНН компании
x509 сертификат в Base64 формате
Тело запроса
Неверные параметры запроса
Ошибка сервера при выполнении запроса
Definitions
{
"properties": {
"result": {
"example": "",
"description": "",
"$ref": "#/definitions/Score success response result key definition"
}
},
"additionalProperties": false,
"required": [
"result"
]
}
{
"properties": {
"errors": {
"items": {
"type": "string"
},
"description": "Список с ошибками в запросе",
"$ref": "#/definitions/Score response errors list"
}
},
"additionalProperties": false,
"required": [
"errors"
]
}
{
"type": "array",
"items": {
"$ref": "#/definitions/Score response error item"
}
}
{
"properties": {
"error": {
"type": "string",
"description": "Описание ошибки"
},
"target": {
"type": "array",
"description": "Путь к полю, которому соответствует описание ошибки из поля error",
"items": {
"type": "string"
}
}
},
"additionalProperties": false,
"required": [
"error"
]
}
{
"properties": {
"errors": {
"description": "Список с ошибками в запросе",
"$ref": "#/definitions/Score response errors list",
"example": "{\\n \"errors\": [\\n {\\n \"error\": \"(#100) This INN is not found in the FNS DB.\", \\n \"path\": \"score_value\"\\n }\\n ]\\n}"
}
},
"additionalProperties": false,
"required": [
"errors"
]
}
{
"properties": {
"score_value": {
"type": "number",
"format": "float",
"example": 0.10146406557381153,
"description": "Рассчитанная вероятность комплаенс риска"
}
},
"additionalProperties": false,
"required": [
"score_value"
]
}
/v3/ie/score body definition
{
"properties": {
"inn_code": {
"type": "string",
"example": "165046731229"
}
},
"additionalProperties": false,
"required": [
"inn_code"
]
}
/v3/llc/score body definition
{
"properties": {
"inn_code": {
"type": "string",
"example": "2536281741"
}
},
"additionalProperties": false,
"required": [
"inn_code"
]
}