Перейти к основному содержанию

API проверки контрагентов

Состав и ограничения API проверки контрагентов: подтверждённые сведения, описание методов и различие статусов источников.

Обновлено:

Вкратце

API проверки контрагентов — интерфейс сводного запроса по ИНН. Подтверждённый ограниченный состав — карточка организации, локальные копии ФНС, сведения МСП и четыре официальных перечня. Судебная практика в этом запросе не подтверждена. Ниже сохранено описание полей, в том числе необязательных score и grade; наличие поля в описании не подтверждает его работу в текущем подключении.

Часть источников (приставы, банкротства, арбитраж, РНП) — в подключении: проверка объявлена в каталоге, но данные пока не приходят. Такая проверка возвращает unavailable, а не «нарушений нет». Фактический состав — на странице проверки контрагента, условия учёта запросов — в тарифе и кабинете.

Общий адрес REST API — api.atomno-data.ru. Полный URL конкретного метода берите из инструкции подключения. Ниже сохранено описание интерфейса /compliance; оно само по себе не подтверждает доступность каждого метода. Подтверждённый состав — на странице сервера.

Ключ и подключённые пакеты — в общем кабинете, условия — на странице тарифов. В примерах YOUR_API_KEY — ваш ключ, а ATOMNO_HEALTH_URL, ATOMNO_CHECKS_URL и ATOMNO_METHOD_URL — полные URL соответствующих методов из инструкции подключения.

Быстрая проверка «жив ли сервис»

curl -s "$ATOMNO_HEALTH_URL"

Health-метод проверяет доступность сервиса. Даже ответ 200 со статусом OK не доказывает, что конкретный реестр вернул актуальные данные. Ответы 401 и 403 требуют проверки ключа и прав и сами по себе не означают недоступность источника.

Каталог доступных проверок

Публичный список проверок и их идентификаторов:

curl -s "$ATOMNO_CHECKS_URL"

В ответе — массив проверок с полями id, title_ru, availability, billing_unit.

Профиль компании (главный endpoint)

curl -s -X POST "$ATOMNO_METHOD_URL" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "inn": "7707083893",
    "include_score": true,
    "checks": ["egrul", "rfm_screen", "foreign_agent", "soyu", "msp", "cbr_bank"]
  }'

Параметры body

ПолеТипОбязательноОписание
innstringдаИНН юрлица (10 или 12 цифр)
include_scorebooleanнетДобавить score (0–100) и grade (A–F)
checksstring[]нетПодмножество проверок; по умолчанию — все live

Пример фрагмента ответа

Учебный пример структуры, не текущий ответ сервера и не подтверждение количества списанных единиц.

{
  "score": 50,
  "grade": "C",
  "billing_units": 2,
  "checks": [
    { "id": "egrul", "status": "clear", "source": "mcp-fns-check", "billable": true },
    { "id": "rfm_screen", "status": "clear", "source": "mcp-sanctions", "billable": true },
    { "id": "arbitration", "status": "unavailable", "billable": false }
  ]
}

Значения status: clear — реестр ответил, нарушений нет; hit — реестр ответил, нарушение есть; unavailable / error — реестр не ответил (это не равно «нарушений нет»); stub — ответ получен на демонстрационном наборе; skipped — в запросе не хватило данных. Поля billable и billing_units показаны как часть описания интерфейса. Действующий порядок учёта запросов проверяйте в тарифе и кабинете.

Track2 проверки (дополнительно)

В сохранённом описании интерфейса перечислены следующие идентификаторы. Это не текущая автоматическая проверка каждого метода:

idСмыслСтатус
mspРеестр МСП ФНСсведения МСП входят в подтверждённый состав; отдельный метод проверяйте по инструкции
disqualifiedДисквалифицированные директораописан в интерфейсе; отдельная текущая проверка здесь не приведена
cbr_bankСправочник банков ЦБ (БИК)описан в интерфейсе; отдельная текущая проверка здесь не приведена
rnpРеестр недобросовестных поставщиковв подключении
mass_addressМассовый адрес регистрациидемонстрационный набор, не проверка живого источника

Отличие от DaData / Kontur

DaData / CheckoAPI проверки контрагентов
МодельПоле в форме / отдельные APIОдин POST — профиль
AI-агентОграниченный MCP (4 tools у DaData)MCP + REST, checks[] composable
ScoreKontur.Focus UIAPI field include_score
Самостоятельный доступ для разработчиковКлюч + docsОткрытые MCP-клиенты + hosted API

Подробнее: Решение «Проверка контрагентов» →

Ошибки

HTTPСмысл
401Неверный или отсутствующий ключ
422Невалидный ИНН
429Превышен лимит запросов
503Частичная недоступность upstream — смотрите partial

Следующие шаги

  1. Посмотрите подтверждённый состав и условия доступа.
  2. Прочитайте REST vs MCP → — когда нужен MCP вместо REST
  3. Лендинг для отдела продаж: /solutions/compliance/

Частые вопросы

Описание метода подтверждает доступность всех проверок?

Нет. На странице сохранено описание интерфейса /compliance, а состав источников и полный URL метода нужно сверять с условиями подключения. Наличие проверки в схеме не означает, что она возвращает данные по вашему ключу.

Чем unavailable отличается от clear и stub?

В описанной схеме clear означает полученный ответ без найденного нарушения, unavailable — отсутствие ответа источника, а stub — демонстрационный набор. Ни unavailable, ни stub нельзя трактовать как успешную проверку живого реестра без рисков.

Что показывает сводная проверка контрагента?

Она объединяет результаты доступных проверок, сохраняя статус каждого источника. Состав вашего подключения нужно сверять отдельно: наличие поля в описании API не гарантирует получение данных по нему.

Можно ли передать итог проверки сотруднику для решения?

Да, вместе с исходными статусами, источниками и датами. Не заменяйте неполученные сведения выводом «рисков нет»; сводка помогает разбору, но не принимает решение за вашу организацию.

Можно ли показать сотруднику только общий балл риска?

Не скрывайте состав проверки за одним итогом. Сохраните источник, дату и статус каждого пункта, чтобы было видно, какие сведения получены, а какие недоступны или демонстрационные.

Можно ли запросить только часть проверок компании?

В описании body есть необязательный массив checks для выбора подмножества проверок. Наличие идентификатора проверки в запросе не подтверждает доступность её источника; сверяйте действующий состав продукта.

Можно ли считать работоспособность сервиса проверкой конкретной компании?

Нет. Успешный ответ самого сервиса не описывает контрагента. Для решения нужен запрос по нужному идентификатору, фактические сведения и статусы источников, участвовавших в этой проверке.

Просмотр кода

Копируется исходный текст. Переносы меняют только отображение.

Текст

Поиск по сайту

Введите хотя бы два символа.

Tab — переход по ссылкам · Esc — закрыть