Маркет интеграций
Маркет интеграций помогает быстро понять, какие сервисы можно подключить к закупочному контуру SNABZHENETS+, какие данные они передают и как ими управлять после установки.
Интерфейс рассчитан на B2B-сценарии: администратор видит разработчика, способ подключения, права доступа, статусы синхронизации, журнал событий и документацию до установки.
Витрина
Верхняя часть маркета содержит:
- название раздела «Маркет SNABZHENETS+»;
- поиск по интеграциям, поставщикам, API и 1С;
- кнопки Webhooks и Предложить интеграцию;
- категории интеграций;
- промо-блоки для 1С/ERP, ЭДО и API/Webhooks;
- подборки «Рекомендации дня», «Популярно для закупок», «Быстрый старт», «Автоматизация документов», «Интеграции для аналитики» и «Инструменты для интеграций».
Карточка интеграции показывает название, разработчика, категорию, короткое описание, рейтинг, количество установок, тип подключения, бейджи и действие: Установить бесплатно, Подключить, Подробнее или Настроить.
Пример: Email
Карточка Email относится к категории Уведомления и подключает корпоративную почту:
- отправка писем через SMTP;
- при включении IMAP — работа с письмами поставщиков во встроенной почте;
- тестовое письмо перед включением;
- журнал отправок, синхронизаций и ошибок.
Базовый сценарий: администратор указывает SMTP host, порт, SSL/TLS, логин, пароль, email отправителя и имя отправителя, отправляет тестовое письмо и включает интеграцию.
Расширенный сценарий: администратор дополнительно указывает IMAP host, порт, SSL/TLS, логин и пароль. После включения Email в портале появляется встроенная почта поставщиков: пользователь может открыть цепочку, скачать вложения, ответить поставщику и связать письмо с поставщиком, заявкой на закупку, закупкой/PR, RFQ, КП или счётом.
Карточка Wazzup доступна для установки из маркета. Администратор вставляет API-ключ Wazzup, проверяет соединение, синхронизирует каналы и регистрирует webhook. После включения пользователям с правом messengers.read становится доступен раздел Мессенджеры со встроенным окном чатов.
Карточка DaData относится к категории Поставщики и каталоги. Администратор указывает API key DaData и при необходимости Secret key для стандартизации телефонов, затем выбирает справочники и формы, где подсказки будут доступны. После включения подсказки появляются в карточках контрагентов, сторонах PR, платёжных реквизитах с несколькими счетами, профилях моей организации и адресных полях логистики: объектах, маршрутах и документах поставки. Подсказка применяется только после выбора пользователем.
Карточка Контур.Диадок относится к категории ЭДО и документы. После подключения через Контур ID и выбора BoxId организации в счетах, договорах и документах поставки появляется виджет отправки в ЭДО. Пользователь отправляет сформированный PDF/DOCX контрагенту, а S+ получает обратно статус доставки и подписи.
Карточка СБИС / SABY ЭДО тоже относится к категории ЭДО и документы. Администратор указывает учётные данные SABY, ИНН своей организации и параметры маршрута ЭДО, проверяет соединение и включает интеграцию. После этого в счетах, договорах и документах поставки появляется виджет SABY: пользователь отправляет документ контрагенту, видит ID документа, последнее событие и статус подписи, а S+ получает изменения документооборота обратно из SABY.
Карточка Калуга Астрал ЭДО относится к категории ЭДО и документы. Администратор указывает API-токен, abonentId, при необходимости departmentId, режим загрузки черновиков и требование подписи. После включения в счетах, договорах и документах поставки появляется виджет Калуга Астрал: пользователь отправляет PDF/DOCX контрагенту из адресной книги Астрала, видит DraftId, DocflowId, последнее событие и статус подписи, а S+ получает изменения документооборота обратно.
Если установлены несколько операторов ЭДО, карточки документов используют единый блок ЭДО с переключателем только по активным операторам: Контур.Диадок, СБИС / SABY или Калуга Астрал. Пользователь выбирает канал перед отправкой, а статусы и идентификаторы каждого оператора остаются раздельными.
Категории и фильтры
Во вкладках категорий доступна выдача по выбранному направлению:
| Категория | Что подключается |
|---|---|
| 1С и ERP | учётные системы, 1С, ERP и справочники |
| ЭДО и документы | электронный документооборот, счета, акты, УПД |
| Банки и счета | банк-клиент, платежные статусы и сверка оплат |
| Поставщики и каталоги | прайс-листы, номенклатура, B2B-каталоги, импорт цен и справочники реквизитов |
| Склад и логистика | WMS, TMS, остатки, отгрузки и доставка |
| CRM и продажи | сделки, клиенты, контрагенты и клиентские запросы |
| BI и аналитика | отчёты, витрины данных и экспорт |
| Уведомления | почта, мессенджеры, SMS и командные каналы |
| API и Webhooks | REST API, входящие и исходящие события, CSV/XLSX-импорт |
| Отраслевые решения | отраслевые расширения и профили для специализированных сценариев |
Фильтры в категории:
- статус или бейдж: Проверено, Beta, Built by SNABZHENETS+;
- тип подключения: OAuth, API-key, Webhook, Файл CSV/XLSX;
- данные: поставщики, PR, счета, номенклатура, статусы;
- минимальный рейтинг;
- сортировка: популярные, новые, рейтинг, недавно обновлены.
Карточка интеграции
При открытии карточки появляется модальное окно. Слева находятся логотип, название, разработчик, категория, рейтинг, кнопка подключения, ссылка на документацию, согласие на передачу коммерческих данных и блок доверия.
Справа находятся:
- скриншоты или демонстрационный экран;
- описание интеграции;
- список возможностей;
- таблица «Какие данные передаются»;
- сценарии использования;
- инструкция подключения;
- отзывы;
- блок «Журнал и безопасность».
Таблица передаваемых данных показывает сущность и направление доступа, например Поставщики — чтение/запись или Статусы оплат — чтение.
Установленные интеграции
Вкладка Установленные показывает подключенные интеграции списком. В строке отображаются:
- название и категория;
- статус: Установлено, Требуется настройка, Ошибка синхронизации, Отключено;
- дата установки;
- последняя синхронизация;
- подключенная организация или аккаунт;
- разработчик;
- действия Настроить, Журнал, Отключить.
Статусы и даты относятся только к текущему порталу.
API и Webhooks
Категория API и Webhooks содержит инструменты для интеграции:
- REST API;
- входящие и исходящие вебхуки;
- импорт CSV/XLSX;
- карточки с URL, статусом доставки, успешными и ошибочными вызовами.
Типовые события: создание заявки, смена статуса PR, создание счёта, обновление поставщика, изменение цены товара, изменение статуса оплаты.
Публичный API маркета
Интеграторам доступны публично описываемые методы:
| Метод | Назначение |
|---|---|
GET /api/v1/integrations/marketplace | список опубликованных интеграций с фильтрами по поиску, категории, типу подключения, статусу и установке |
GET /api/v1/integrations/marketplace/:slug | карточка интеграции с описанием, требованиями, возможностями, инструкцией подключения и статусом установки для текущего портала |
GET /api/v1/integrations/marketplace/categories | список активных категорий с количеством опубликованных интеграций |
Для установки, настройки и синхронизации используйте раздел Управление установками.
Ограничения
- Маркет показывает только опубликованные интеграции.
- Бейджи доверия описывают реализованные продуктовые свойства и не являются юридическими сертификатами.
- Фактические параметры подключения смотрите в карточке конкретной интеграции.