Сервис 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=<Ваш ключ>
Ответ сервера...Метод | Требуемое кол-во запросов в год | Способ тарификации | Стоимость, руб. |
---|---|---|---|
ИТОГО |