Сервис API-Скоринг предназначен для интеграции скоринговых моделей в любые информационные системы. Основная цель – автоматизация расчёта скорингов и рисков контрагентов. Наши скоринговые модели основаны на интеллектуальном анализе данных ФНС, Росстата, арбитражных судов и государственных реестров и применении современных методов машинного обучения.
Сервис предоставляет возможность интеграции собственных скоринговых моделей, созданных с использованием системы DaMIA-Скоринг.
С помощью сервиса вы сможете автоматизировать заполнение отчета о рисках контрагента.
| Название метода | Команда | Описание |
|---|---|---|
| Расчет рисков контрагента | score | Расчет рисков контрагента в соответствии с заданной скоринговой моделью |
| Информация о скоринговой модели | info | Возвращает информацию о скоринговой модели по заданному идентификатору |
| Финансовые коэффициенты компании | fincoefs | Возвращает финансовые коэффициенты компании и результаты их сравнения со средними по отрасли / региону |
Позволяет получить информацию о рисках контрагента в соответствии с заданной скоринговой моделью.
На вход подается ИНН компании, на выходе – строка JSON.
Адрес сервиса: https://damia.ru/api-scoring/score
Используется запрос GET.
Параметры запроса
| Параметр | Тип данных и пример | Описание |
|---|---|---|
| inn | string inn=6663003127 | ИНН искомой компании (юридического лица) |
| model | string model=_problemCredit | Идентификатор используемой скоринговой модели (модели DaMIA либо пользовательской модели).
Для скоринга доступны 5 предобученных моделей: _bankrots2016 – скоринг компаний-банкротов _tech – скоринг компаний по "черному списку" 115-ФЗ _diskf – скоринг компаний дисквалифицированных лиц _problemCredit – скоринг компаний с проблемными кредитами _zsk – скоринг рискованной деятельности компаний с точки зрения антиотмывочного законодательства по данным Платформы «Знай своего клиента» |
| bNNNN | integer b1230=38483 b1600=284771 b2110=116922 | Балансовые данные компании (на конец года), в тыс. руб., NNNN - код строки баланса (например, 1100, 1200, 1210, 1220, 2110, 2100 и т.д.). Необязательный параметр, при указании будет проведен скоринг как по данным отчетности Росстата, так и по введенным балансовым данным |
| key | string key=67ac454f6a3fa85355aee5e41b6d154efc589aab | Ваш ключ доступа к API |
Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON, содержащий информацию о рисках контрагента.
Поля возвращаемого документа
| Имя | Тип | Описание |
|---|---|---|
| ИНН | object | Указанный в запросе ИНН компании |
| Модель | object | Идентификатор скоринговой модели |
| Год | object | Год использованных для скоринга данных о компании в формате YYYY (например, 2015, 2016 и т.д.) либо 'custom' при использовании балансовых данных из адресной строки |
| РискЗнач | float | Значение риска в интервале от 0 до 1 (вероятность принадлежности к скоринговой группе) |
| РискЗона | string | Зона риска (возможные варианты: 'Низкий риск', 'Средний риск', 'Высокий риск') |
| БаллЗнач | float | Скоринговый балл по пятибалльной системе (0 - минимальный риск, 5 - максимальный риск) |
| БаллЗона | string | Зона скорингового балла (возможные варианты: 'Низкий балл', 'Средний балл', 'Высокий балл') |
| НадежностьЗнач | float | Надежность оценки риска в интервале от 0 до 1 (0 - минимальная надежность, 1 - максимальная надежность) |
| НадежностьЗона | string | Зона надежности оценки риска (возможные варианты: 'Низкая надежность', 'Средняя надежность', 'Высокая надежность') |
| Показатели | array | Список показателей, внесших наибольший вклад в оценку риска (в порядке уменьшения значимости) |
| Наименование | string | Наименование показателя. В наименовании используются номера строк финансовой (бухгалтерской) отчетности, на основе которых рассчитан показатель |
| Значение | float | Значение показателя |
| nWoE | float | Значение nWoE (negative Weight of Evidence) для данного признака. nWoE может интерпретироваться как степень статистической схожести значения признака с теми, которые характерны для компаний скоринговой группы. Высокие положительные значения nWoE говорят о том, что данный признак вносит положительный вклад в итоговое значение риска. Если значение nWoE отрицательное, то значение признака является «хорошим» и не связано с возможным высоким значением риска |
Примеры запросов
https://damia.ru/api-scoring/score?inn=6663003127&model=myModel1&key=<Ваш ключ>
Ответ сервера...https://damia.ru/api-scoring/score?inn=7708175593&model=_bankrots2016&b1100=4487229&1200=20096348&b1250=802&b1600=24583577&b1300=-8765928&b1520=10851992&b2110=320101&b2400=-736275&key=<Ваш ключ>
Ответ сервера...Позволяет получить информацию о скоринговых моделях.
На вход подается идентификатор модели, на выходе – строка JSON.
Адрес сервиса: https://damia.ru/api-scoring/info
Используется запрос GET.
Параметры запроса
| Параметр | Тип данных и пример | Описание |
|---|---|---|
| model | string model=_bankrots2016, model=myModel | Идентификатор скоринговой модели (модели DaMIA либо пользовательской модели) |
| key | string key=67ac454f6a3fa85355aee5e41b6d154efc589aab | Ваш ключ доступа к API |
Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON, содержащий информацию о скоринговой модели.
Поля возвращаемого документа
| Имя | Тип | Описание |
|---|---|---|
| Модель | object | Указанный в запросе идентификатор модели |
| Название | string | Название модели |
| Тип | string | Тип модели (возможные варианты: bayes, logistic regresion) |
| Описание | string | Описание модели |
| Год | array | Год(ы) бухгалтерских отчетностей в формате YYYY, по данным которых была построена модель |
| Train | object | Показатели качества модели на обучающей выборке |
| FPR | string | Вероятность ошибки 1-го рода модели (неверного отнесения компании к скоринговой группе) |
| FNR | string | Вероятность ошибки 2-го рода модели (неверного отнесения компании к непринадлежащей скоринговой группе) |
| J | string | Индекс Юдена (Youden's J statistic) модели |
| AUC | string | Характеристика AUC ROC модели |
| Gini | string | Коэффициент Gini модели |
| Test | object | Показатели качества модели на тестовой выборке |
| FPR | string | Вероятность ошибки 1-го рода модели (неверного отнесения компании к скоринговой группе) |
| FNR | string | Вероятность ошибки 2-го рода модели (неверного отнесения компании к непринадлежащей скоринговой группе) |
| J | string | Индекс Юдена (Youden's J statistic) модели |
| AUC | string | Характеристика AUC ROC модели |
| Gini | string | Коэффициент Gini модели |
Примеры запросов
https://damia.ru/api-scoring/info?model=_bankrots2016&key=<Ваш ключ>
Ответ сервера...Позволяет получить финансовые коэффициенты компании и результаты их сравнения со средними по отрасли / региону.
На вход подается ИНН компании, на выходе – строка JSON.
Адрес сервиса: https://damia.ru/api-scoring/fincoefs
Используется запрос GET.
Параметры запроса
| Параметр | Тип данных и пример | Описание |
|---|---|---|
| inn | string inn=6663003127 | ИНН искомой компании (юридического лица) |
| okved | string okved=47.9 | ОКВЭД, используемый для расчета средних финансовых показателей по отрасли и сравнения с ними. Необязательный параметр. Если опущен, то будет использован ОКВЭД компании. Если указано 0, то будет проведено сравнение со средними, рассчитанными по всем отраслям |
| region | integer region=77 | Код региона, используемый для расчета средних финансовых показателей по региону и сравнения с ними. Необязательный параметр. Если параметр опущен, то будет использован регион компании. Если указано 0, то будет проведено сравнение со средними, рассчитанными по всем регионам |
| key | string key=67ac454f6a3fa85355aee5e41b6d154efc589aab | Ваш ключ доступа к API |
Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON, содержащий финансовые коэффициенты и результаты сравнения со средними по отрасли / региону.
Поля возвращаемого документа
| Имя | Тип | Описание |
|---|---|---|
| ИНН | object | Указанный в запросе ИНН компании |
| Фин. коэффициент | object | Идентификатор финансового коэффициента |
| Год | object | Год использованных для расчёта данных о компании в формате YYYY (например, 2015, 2016 и т.д.) |
| Знач | float | Значение финансового коэффициента |
| Норма | float | Среднее значение финансового коэффициента по отрасли / региону |
| НормаНижн | float | Нижняя граница интервала значений финансового коэффициента по отрасли / региону, находящихся в пределах нормы |
| НормаВерхн | float | Верхняя граница интервала значений финансового коэффициента по отрасли / региону, находящихся в пределах нормы |
| Балл | integer | Скоринговый балл, характеризующий значение финансового коэффициента (0 - минимальный балл, 5 - максимальный балл). Низкий балл означает возможные финансовые риски, оцениваемые данным коэффиентом, средний балл – значение коэффициента находится в пределах нормы, высокий балл – отсутствие рисков |
| НормаСравн | string | Результат сравнения значения финансового коэффициента со средними по отрасли / региону. Возможные варианты: "Отрицательный", "Много ниже нормы", "Ниже нормы", "В пределах нормы", "Выше нормы", "Много выше нормы" |
Список имен возвращаемых финансовых коэффициентов приведен в таблице.
| Имя | Фин. коэффициент |
|---|---|
| КоэфОборЗапасов | Коэффициент оборачиваемости запасов |
| ПериодОборЗапасов | Период оборота запасов |
| КоэфОборДЗ | Коэффициент оборачиваемости дебиторской задолженности |
| ПериодОборДЗ | Период оборота дебиторской задолженности |
| КоэфОборКЗ | Коэффициент оборачиваемости кредиторской задолженности |
| ПериодОборКЗ | Период оборота кредиторской задолженности |
| КоэфОборАктивов | Коэффициент оборачиваемости активов |
| РентАктивов | Рентабельность активов |
| РентСК | Рентабельность собственного капитала |
| РентПродаж | Рентабельность продаж |
| ЧистРентПродаж | Чистая рентабельность продаж |
| КоэфТекЛикв | Коэффициент текущей ликвидности |
| КоэфАбсЛикв | Коэффициент абсолютной ликвидности |
| КоэфФинАвт | Коэффициент финансовой автономии |
| КоэфФинЗав | Коэффициент финансовой зависимости |
| КоэфФинЛевер | Коэффициент финансового левериджа |
Подробное описание финансовых коэффициентов приведено здесь.
Примеры запросов
https://damia.ru/api-scoring/fincoefs?inn=7722699944&key=<Ваш ключ>
Ответ сервера...| Метод | Требуемое кол-во запросов в год | Способ тарификации | Стоимость, руб. |
|---|---|---|---|
| ИТОГО | |||