ADEO-API

ADEO-API — это открытый интерфейс прикладного программирования (API), разработанный компанией «АДЕО-Технологии» (входит в состав холдинга «АДЕО-Групп»). ADEO-API предназначен для интеграции информационных систем, автоматизации бизнес-процессов и создания приложений в сферах управления персоналом, документооборота, бухгалтерского учёта и корпоративного управления. API предоставляет доступ к функциональности одноимённой платформы «АДЕО», которая позиционируется как система класса ERP (Enterprise Resource Planning) для среднего и крупного бизнеса.

История

Разработка ADEO-API началась в 2018 году в рамках стратегии импортозамещения и перехода российских предприятий на отечественное программное обеспечение. Изначально платформа «АДЕО» создавалась как замена зарубежным ERP-системам, таким как SAP и Oracle E-Business Suite, которые после 2022 года столкнулись с ограничениями на российском рынке. Первая публичная версия ADEO-API была выпущена в 2020 году и включала базовые методы для работы с кадровыми данными, финансовыми операциями и отчётами.

В 2022 году, после введения санкций против ряда российских IT-компаний, «АДЕО-Технологии» активизировала развитие API, добавив поддержку протоколов REST и GraphQL. К 2024 году ADEO-API стал одним из ключевых инструментов интеграции в экосистеме «АДЕО», насчитывающей более 500 корпоративных клиентов, включая государственные учреждения и предприятия оборонно-промышленного комплекса.

Архитектура и принципы работы

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

• Шлюз API (API Gateway) — единая точка входа для всех запросов, обеспечивающая аутентификацию, авторизацию, маршрутизацию и ограничение скорости (rate limiting).
• Сервисы предметной области — набор микросервисов, каждый из которых отвечает за определённый функциональный блок: «Управление персоналом», «Бухгалтерия», «Документооборот», «Складской учёт» и другие.
• Сервис аутентификации — реализует протокол OAuth 2.0 с поддержкой OpenID Connect, что позволяет использовать единый вход (SSO) для различных приложений.
• Сервис событий — предоставляет механизм webhook-уведомлений для оповещения внешних систем об изменениях данных (например, о создании нового сотрудника или изменении статуса заказа).

Протоколы и форматы данных

ADEO-API поддерживает два основных протокола:

• REST — использование HTTP-методов (GET, POST, PUT, DELETE) для выполнения CRUD-операций. Данные передаются в формате JSON.
• GraphQL — позволяет клиентам запрашивать только необходимые поля и вложенные объекты, что снижает объём передаваемых данных.

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

Ключевые возможности

Управление персоналом (HR)

• Создание и редактирование профилей сотрудников — добавление, изменение и удаление записей о сотрудниках, включая персональные данные, должности, подразделения и графики работы.
• Кадровые приказы — автоматизация создания приказов о приёме, увольнении, переводе, отпуске и командировках.
• Табель учёта рабочего времени — интеграция с системами контроля доступа (СКУД) и автоматическое формирование табелей.
• Расчёт заработной платы — вычисление начислений, удержаний, налогов и страховых взносов в соответствии с законодательством РФ.

Бухгалтерский учёт и финансы

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

Документооборот

• Электронные документы — создание, подписание (включая усиленную квалифицированную электронную подпись) и хранение документов в форматах PDF, DOCX, XML.
• Маршруты согласования — настройка последовательности утверждения документов с учётом ролей и иерархии.
• Интеграция с ЕСИА и Госуслугами — обмен документами с государственными информационными системами.

Складской учёт и логистика

• Управление остатками — учёт движения товаров, инвентаризация, резервирование.
• Заказы и отгрузки — создание заказов на поставку, отгрузку и перемещение.
• Маркировка товаров — интеграция с системой «Честный ЗНАК» для работы с маркированной продукцией.

Примеры использования

Интеграция с CRM-системой

Предприятие розничной торговли использует ADEO-API для синхронизации данных между своей CRM-системой (например, «Битрикс24») и бухгалтерским модулем «АДЕО». При создании нового заказа в CRM через API автоматически формируется счёт на оплату в бухгалтерии, а при его оплате — обновляется статус заказа и остатки на складе.

Автоматизация кадрового учёта

Крупная производственная компания с 10 000 сотрудников внедрила ADEO-API для интеграции с системой управления табелями (СКУД). Каждый день данные о времени прихода и ухода сотрудников передаются в модуль «Управление персоналом», где автоматически рассчитываются отработанные часы и формируются табели для расчёта зарплаты.

Отчётность для ФНС

Бухгалтерский отдел использует ADEO-API для выгрузки данных по налогам и страховым взносам в формате, требуемом Федеральной налоговой службой. API формирует XML-файлы, соответствующие форматам XSD, и отправляет их через систему «Контур.Экстерн» или аналогичные сервисы.

Ограничения и критика

Несмотря на широкие возможности, ADEO-API имеет ряд недостатков, отмечаемых пользователями и экспертами:

• Сложность начальной настройки — для полноценного использования требуется глубокое понимание бизнес-процессов и навыки программирования. Документация, по мнению некоторых разработчиков, недостаточно подробна для быстрой интеграции.
• Зависимость от версий платформы — обновления «АДЕО» могут приводить к несовместимости старых версий API, что требует регулярного обновления интеграционных решений.
• Производительность при высоких нагрузках — при одновременной работе нескольких внешних систем (более 1000 запросов в секунду) наблюдаются задержки обработки, особенно в модулях аналитики и отчётности.
• Отсутствие открытого сообщества — в отличие от многих зарубежных API, ADEO-API не имеет публичного форума или репозитория на GitHub, что затрудняет обмен опытом и поиск решений типовых проблем.

Перспективы развития

По данным компании «АДЕО-Технологии», в 2025—2026 годах планируется:

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

Источники

• Официальная документация платформы «АДЕО» (версия 4.2, раздел «API-интеграция»)
• Презентация «АДЕО-Технологии» на конференции «Цифровая индустрия промышленной России» (ЦИПР, 2023)
• Статья «Импортозамещение ERP: опыт внедрения „АДЕО“» в журнале «Информационные технологии в бизнесе» (№ 4, 2024)
• Отчёт «Рынок российского ПО для управления предприятием» (Аналитический центр при Правительстве РФ, 2024)
• Интервью с техническим директором «АДЕО-Технологии» на портале «CNews» (2024)