Интеграции
АА.Докс в существующем ИТ-контуре
Платформа не требует вручную переносить каждый документ между системами. Она может принимать файлы и данные из корпоративных источников, запускать согласование и возвращать статус или результат туда, где продолжает работать команда.
API для управляемого обмена данными
Вебхуки для событий и статусов
Коннектор для закрытого контура
01
Какие системы можно связать
Типовой контур включает ERP или учётную систему, CRM, корпоративную почту, файловое хранилище и одного или нескольких операторов внешнего ЭДО. АА.Докс связывает их на уровне документного процесса.
Логотип или название системы на сайте обозначает предполагаемый сценарий подключения, а не готовую сертификацию. Перед проектом мы проверяем доступность API, формат данных, способ авторизации, лимиты и требования к размещению.
- ERP и учётные системы — карточки, суммы, статусы, проводки;
- CRM — сделки, коммерческие предложения и ответственные;
- почта — входящие документы и уведомления;
- операторы ЭДО — отправка, получение и статусы обмена.
02
Три способа подключения
API подходит для двустороннего обмена, когда исходная система предоставляет документированный интерфейс. Вебхуки позволяют передавать событие сразу после смены статуса. Коннектор используют, когда нужно обращаться к системе внутри защищённого контура или преобразовывать нестандартный формат.
Для каждого канала отдельно определяются повторные попытки, идемпотентность, подпись запросов, журналирование и поведение при недоступности одной из сторон.
| Способ | Когда применять | Что передаётся |
|---|---|---|
| API | Есть стабильный документированный интерфейс | Файлы, карточки, команды и статусы |
| Вебхуки | Нужна быстрая реакция на событие | Идентификатор, событие и изменённые поля |
| Коннектор | Система закрыта или использует особый формат | Нормализованные данные через локальный шлюз |
03
Контракт обмена до разработки
Интеграция начинается не с кода, а с таблицы ответственности. Для каждого события фиксируются источник истины, обязательные поля, формат идентификаторов, допустимая задержка, правило повторной отправки и владелец ошибки.
Это предотвращает ситуацию, когда один и тот же документ получает разные статусы в двух системах или повторное событие создаёт дубль.
- карта систем и владельцев данных;
- события входа и выхода для пилотного маршрута;
- тестовые примеры и ожидаемые ответы;
- сценарий восстановления после ошибки.
04
Безопасность интеграций
Секреты и токены не передаются в браузер. Вебхуки могут подписываться, исходящие адреса проверяются, а результат доставки сохраняется в журнале. Доступ к документу внутри платформы дополнительно ограничивается организацией и ролью пользователя.
Финальная схема зависит от вашей модели угроз и инфраструктуры. Требования к сети, хранению ключей и аудиту согласуются до подключения производственных данных.
Составим карту интеграции
Назовите исходную систему, одно событие на входе и желаемый результат. Этого достаточно, чтобы определить реалистичный контур первого подключения.