API проверки контрагентов: интеграция в 1С, CRM и ERP

Зачем нужен API для проверки контрагентов

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

Типичные сценарии, где без API не обойтись:

• Автоматическая проверка при создании нового контрагента в 1С — до сохранения карточки система проверяет ИНН и возвращает светофор.
• Триггер в CRM — при переводе сделки в стадию «Договор» автоматически запускается проверка ИНН клиента.
• ERP-интеграция — платёжное поручение на сумму выше порога не уходит в банк без зелёного сигнала.
• Периодический мониторинг портфеля — cron-задание ежемесячно прогоняет весь реестр поставщиков через API и пишет результат в базу.

Во всех этих случаях нужен надёжный, документированный HTTP-эндпоинт с предсказуемым форматом ответа. Именно это предоставляет API АСМК-СДД.

---

Аутентификация по ключу dd_…

Все запросы к API аутентифицируются через API-ключ формата dd_<случайная строка>. Ключ создаётся в личном кабинете в разделе «API-ключи» — их можно выпустить несколько штук с разными метками (например, отдельный ключ для 1С, отдельный для CRM).

Ключ передаётся в заголовке:

Authorization: Bearer dd_xxxxxxxxxxxxxxxxxxxxxxxx

Ключ не привязан к пользователю — он привязан к организации (тенанту). Это означает, что все запросы по ключу списываются из квоты вашей организации вне зависимости от того, какой сотрудник создал ключ.

Рекомендации по безопасности:

• Не коммитить ключи в репозиторий — хранить в переменных окружения или секрет-менеджере.
• Выпускать отдельный ключ на каждую интеграцию: при компрометации можно отозвать только нужный.
• Периодически ротировать ключи через интерфейс.

---

Основные эндпоинты

Базовый URL: https://asmk-sdd.ru/api/v1

GET /check

Основной эндпоинт — проверка одного контрагента по ИНН.

curl -s "https://asmk-sdd.ru/api/v1/check?inn=7707083893" \
  -H "Authorization: Bearer dd_xxxxxxxx"

Ответ содержит:

• inn — запрошенный ИНН
• name — полное наименование из ЕГРЮЛ
• status — статус компании (active, liquidated, liquidating, reorganizing)
• semaphore — цветовой сигнал (GREEN, YELLOW, RED, GREY)
• risk_score — числовая оценка риска от 0 до 100 (выше = хуже)
• cached — был ли ответ из кэша
• checked_at — дата получения данных

GET /search

Поиск компании по названию или ИНН — возвращает список кандидатов с краткими реквизитами. Удобен для автодополнения при вводе контрагента.

curl -s "https://asmk-sdd.ru/api/v1/search?q=Сбербанк&limit=5" \
  -H "Authorization: Bearer dd_xxxxxxxx"

GET /report

Полный структурированный отчёт по ИНН: все секции vok-данных (реквизиты, директор, арбитраж, ФССП, банкротство, госконтракты, финансовая отчётность и т.д.).

curl -s "https://asmk-sdd.ru/api/v1/report?inn=7707083893" \
  -H "Authorization: Bearer dd_xxxxxxxx"

Этот эндпоинт возвращает более крупный JSON — его целесообразно кэшировать на стороне клиента.

GET /document

Ссылка на скачивание ВОК-PDF (финансовая выписка, бизнес-справка и т.п.). Документ генерируется СБИС и кэшируется сервером.

curl -s "https://asmk-sdd.ru/api/v1/document?inn=7707083893&type=financial" \
  -H "Authorization: Bearer dd_xxxxxxxx"

Поддерживаемые типы: dd (due diligence), financial, business, excerpt.

Полная документация со всеми параметрами и схемами ответов — на странице /docs.

---

MCP-сервер для ИИ-ассистентов

Помимо REST API, АСМК-СДД предоставляет MCP-сервер (Model Context Protocol) — это стандарт для подключения внешних инструментов к ИИ-ассистентам вроде Claude.

Если ваша команда использует ИИ-ассистента для работы с контрагентами, MCP позволяет ему напрямую запрашивать проверку и получать результаты без копипасты.

Доступные MCP-инструменты

Инструмент	Описание
find_counterparties	Поиск компаний по названию или ИНН, возвращает список с краткими данными
get_counterparty_report	Полный отчёт по ИНН: реквизиты, светофор, риск-скор, ключевые секции
get_document_link	Ссылка на ВОК-PDF нужного типа
check_counterparty	Быстрая проверка с возвратом только светофора и риск-скора
list_reports	История ранее запрошенных отчётов организации

MCP-сервер работает по протоколу OAuth 2.1 — ИИ-ассистент авторизуется один раз и далее работает с теми же правами, что и пользователь. Инструкция по подключению и эндпоинт /mcp описаны на странице API.

---

Сценарии интеграции в 1С, CRM и ERP

Интеграция в 1С: Бухгалтерия или 1С: ERP

Наиболее распространённый сценарий — проверка при создании карточки контрагента через стандартный объект HTTPСоединение (платформа 8.3, внешних компонент не нужно). Детальная схема с примером кода, сценариями массовой сверки и ответами на типовые вопросы — в статье «Интеграция АСМК-СДД с 1С».

Интеграция в CRM (amoCRM, Битрикс24)

В amoCRM и Битрикс24 интеграция реализуется через вебхуки или встроенные бизнес-процессы:

• Создать вебхук на событие «Создание сделки» или «Смена этапа».
• В обработчике вебхука (лямбда-функция или небольшой сервер) запросить GET /check по ИНН из поля сделки.
• Записать результат обратно в поле или тег сделки через API CRM.

Для Битрикс24 также подходит Robot Activity с HTTP-запросом — без программирования.

Интеграция в ERP (SAP, Oracle, самописные системы)

Для промышленных ERP ключевой сценарий — автоматическое блокирование платежей при высоком риск-скоре:

1. Перед формированием платёжного поручения ERP запрашивает /api/v1/check.
2. Если risk_score > 70 или semaphore == "RED" — платёж уходит на ручное согласование в службу безопасности.
3. Результат проверки сохраняется в журнале с датой и ИНН — это документальное подтверждение должной осмотрительности.

Для высоконагруженных систем, где один и тот же контрагент проверяется несколько раз в день, рекомендуется кэшировать результат на стороне ERP (TTL 24 часа) — повторные запросы внутри суток не несут новой информации, а квоту экономят.

Массовый мониторинг через API

Для ежемесячного мониторинга всего портфеля используйте batch-подход:

import httpx, time

INN_LIST = [...]  # ИНН из вашей базы
API_KEY = "dd_xxxxxxxx"

with httpx.Client(base_url="https://asmk-sdd.ru") as client:
    for inn in INN_LIST:
        r = client.get(f"/api/v1/check", params={"inn": inn},
                       headers={"Authorization": f"Bearer {API_KEY}"})
        result = r.json()
        # Записать result в вашу БД
        time.sleep(0.3)  # Уважать rate limit

Аналогичную логику можно реализовать на любом языке — важно соблюдать паузу между запросами, чтобы не превышать лимит частоты.

---

Итоги

API АСМК-СДД предоставляет всё необходимое для встраивания проверки контрагентов в любую корпоративную систему:

• Простая аутентификация по ключу dd_… в заголовке Authorization.
• Четыре эндпоинта для разных задач: быстрая проверка, полный отчёт, поиск, PDF-документы.
• MCP-сервер для ИИ-ассистентов с пятью готовыми инструментами.
• Предсказуемый формат ответа: цветовой светофор + числовой риск-скор + структурированные данные.

Документация с примерами запросов и схемами — на /docs. Создать API-ключ и попробовать первый запрос можно после регистрации — первые 10 проверок бесплатны.

Зарегистрироваться и получить API-ключ →