Интеграция АСМК-СДД с 1С: проверка контрагентов из учётной системы

Проверка контрагента «вручную» — открыть браузер, зайти на сервис, ввести ИНН, дождаться результата, перенести статус в таблицу — занимает 3–5 минут на один ИНН. При объёме в 50 новых поставщиков в месяц это уже 4 часа рутины. А если нужно перепроверить базу из 2000 активных контрагентов раз в квартал? Ответ — интеграция с учётной системой через API, при которой проверка происходит автоматически, без участия сотрудника.

В этой статье — конкретная схема интеграции АСМК-СДД с 1С: Предприятие через REST API, примеры вызовов и сценарии использования.

Зачем проверять контрагентов прямо в 1С

Учётная система — основное рабочее место для специалистов закупок, бухгалтерии и юридической службы. Именно здесь создаётся новый контрагент, выбирается поставщик в заявке на закупку, оформляется договор. Встроить проверку в этот процесс означает:

• Нет переключения контекста: менеджер не выходит из 1С, результат проверки отображается прямо в карточке контрагента.
• Нет человеческого фактора: проверка запускается автоматически при создании нового контрагента, а не «когда вспомнят».
• Аудиторская трасса: результат проверки сохраняется в реквизитах контрагента с датой и версией отчёта — доказательство должной осмотрительности для налоговой.
• Масштабируемость: обработать 2000 ИНН за ночь через фоновое задание столь же легко, как обработать один.

Схема интеграции через REST API

Интеграция строится на API-ключе (dd_…) из личного кабинета и эндпоинте /api/v1/check, который принимает ИНН и возвращает JSON с полями semaphore (GREEN/YELLOW/RED/GREY), risk_score (0–100) и массивом сигналов. Полное описание аутентификации, всех эндпоинтов и форматов ответов — в документации API.

Реализация на 1С (общая схема)

flowchart LR
    A["1С\n(новый контрагент)"] --> B["АСМК-СДД REST API\n/api/v1/check"]
    B --> C["СБИС / реестры"]
    C --> D["риск-светофор"]
    D --> E["запись статуса в 1С"]

В 1С интеграция реализуется через HTTP-соединение (объект HTTPСоединение в конфигурациях на платформе 8.3) или через внешние компоненты. Типовая реализация:

1. В справочнике «Контрагенты» добавляются дополнительные реквизиты: РискСтатус (строка, хранит GREEN/YELLOW/RED), РискСкор (число), ДатаПоследнейПроверки (дата).

2. Создаётся общий модуль АСМКИнтеграция с функцией ПроверитьКонтрагента(ИНН), которая формирует HTTP-запрос, разбирает JSON-ответ и возвращает структуру с результатом.

3. В форме справочника «Контрагенты» кнопка «Проверить в АСМК» вызывает эту функцию и обновляет реквизиты.

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

Полный пример кода на встроенном языке 1С доступен в документации API.

Автоматическая проверка новых контрагентов

Самый ценный сценарий — проверка при создании нового контрагента в системе. Реализуется через обработчик события ПриЗаписи в модуле объекта справочника «Контрагенты»:

// Псевдокод — конкретная реализация зависит от конфигурации
Процедура ПриЗаписи(Отказ)
    Если ЭтоНовый() И ЗаполненоИНН() Тогда
        Результат = АСМКИнтеграция.ПроверитьКонтрагента(ИНН);
        РискСтатус = Результат.Светофор;
        ДатаПроверки = ТекущаяДата();
        Если Результат.Светофор = "RED" Тогда
            ОтправитьУведомлениеСлужбеБезопасности(ИНН, Результат);
        КонецЕсли;
    КонецЕсли;
КонецПроцедуры

Такая логика обеспечивает проверку каждого нового поставщика без дополнительных действий со стороны пользователя. При «красном» светофоре автоматически отправляется уведомление ответственному сотруднику — он принимает решение, продолжать ли работу с контрагентом.

Важный нюанс: при потоковом создании контрагентов (например, при импорте данных из другой системы) API-вызов на каждую запись может замедлить процесс. В таких случаях лучше отложенная проверка через очередь или фоновое задание.

Массовая сверка базы контрагентов

Периодическая перепроверка всей базы — квартальная или полугодовая — позволяет выявить контрагентов, у которых изменился статус: возбуждено банкротство, появились крупные исполнительные производства, сменился директор.

Для массовой сверки в АСМК-СДД доступны два способа:

1. Excel-загрузка через интерфейс — выгружаете список ИНН из 1С в таблицу, загружаете в личный кабинет АСМК-СДД, получаете результат для каждой строки. Подходит для разовых сверок без разработки.

2. Пакетные вызовы через API — регламентное задание в 1С формирует список ИНН из активных контрагентов, последовательно или параллельно вызывает /api/v1/check для каждого, сохраняет результаты. Рекомендуемая частота вызовов — не более 10 запросов в секунду, чтобы не превысить ограничения API.

// Регламентное задание: массовая сверка
Для Каждого Контрагент Из СписокАктивных Цикл
    Результат = АСМКИнтеграция.ПроверитьКонтрагента(Контрагент.ИНН);
    ОбновитьРеквизитыКонтрагента(Контрагент, Результат);
    Если НеобходимоУведомление(Результат) Тогда
        ДобавитьВОчередьУведомлений(Контрагент, Результат);
    КонецЕсли;
КонецЦикла;

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

Сценарии ЭДО: проверка перед принятием документов

Интеграция АСМК-СДД особенно актуальна в связке с системами электронного документооборота (ЭДО). Типичный болезненный момент: компания получает УПД или акт от контрагента через ЭДО, принимает документ — и только потом выясняет, что поставщик находится в процессе ликвидации или имеет задолженность перед бюджетом.

Варианты встройки в ЭДО-процессы:

• Проверка при первом получении документа от нового контрагента: если ИНН отправителя не найден в базе 1С как «проверенный», автоматически запускается проверка в АСМК-СДД перед маршрутизацией документа на согласование.
• Блокировка согласования при красном статусе: при АСМК-статусе RED документ помещается в очередь «требует согласования СБ» вместо штатного маршрута.
• Периодическое обновление статуса действующих поставщиков: прежде чем акцептовать документ от поставщика, с которым не работали 3+ месяца, автоматически перепроверить его актуальный статус.

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

Ключи API и управление доступом

Для интеграции 1С с АСМК-СДД используется API-ключ типа dd_…. Несколько практических рекомендаций:

• Отдельный ключ для интеграции — не используйте личный ключ разработчика в продуктовой 1С. Создайте выделенный ключ с понятным описанием («1С Предприятие — основной сервер»).
• Ротация ключей: при смене администратора или при подозрении на компрометацию отзовите старый ключ и создайте новый — это занимает меньше минуты в личном кабинете.
• Логирование на стороне 1С: сохраняйте request_id из каждого ответа — он позволяет точно указать конкретный запрос при обращении в поддержку.

Подробная документация по аутентификации и всем доступным эндпоинтам — на странице API. Интерактивный Swagger-интерфейс для тестирования запросов доступен на /api-docs.

Типовые вопросы при внедрении

Нужна ли лицензия на внешние компоненты 1С? Нет. Интеграция использует стандартные средства платформы 1С 8.3 — HTTPСоединение и ПрочитатьJSON. Никаких внешних компонент не требуется.

Работает ли в облачных версиях 1С (1С:Fresh, 1С:Облако)? Исходящие HTTP-запросы доступны в 1С:Fresh начиная с определённых версий и при наличии соответствующих прав в сервисе. Рекомендуется уточнить у своего оператора облачной 1С.

Как обрабатывать ошибки API? При временной недоступности сервиса (HTTP 503) реализуйте повторные попытки с экспоненциальной задержкой. При ответе 402 Payment Required квота исчерпана — повторные попытки бессмысленны до пополнения. Коды ошибок описаны в документации.

Сколько стоит массовая сверка? Стоимость зависит от тарифа. Подробности — на странице Тарифы.

Итог

Интеграция АСМК-СДД с 1С через REST API превращает проверку контрагентов из ручной рутины в автоматический процесс: новые поставщики проверяются при создании карточки, базу можно перепроверить по расписанию, результаты хранятся в реквизитах контрагента и доступны при любой проверке. Трудозатраты на внедрение — несколько часов программиста 1С, экономия — часы рутины и снижение риска работы с проблемными контрагентами.

---

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