Автор: Юрий Кая (МойСклад)
Клиент работает в сегменте доставки питьевой воды — рынке, где ежедневная операционная нагрузка зависит от скорости приёма заказов, корректности данных и своевременной синхронизации складских позиций. Такие компании особенно нуждаются в автоматизации, потому что большое количество повторяющихся заказов, частые изменения адресов и высокая скорость обработки заявок требуют стабильных интеграций между каналами приёма заказов и учётной системой.
Компания занимается доставкой бутилированной воды физическим лицам и корпоративным клиентам. Основные процессы включают приём заказов, распределение по курьерам, контроль остатков и работу с клиентскими данными. Первоначально все заказы велись только в МойСклад, но для удобства клиентов компания внедрила мобильное приложение Aqua Delivery, разработанное на базе aqua-delivery.com.
Проблема заказчика
После запуска мобильного приложения возникла ключевая проблема: новые заказы, созданные в Aqua Delivery, не попадали автоматически в МойСклад. Операторы вручную переносили каждую заявку, что замедляло обработку заказов, увеличивало риск ошибок, создавало двусмысленность в данных о клиентах и товарах.
Компания искала решение, которое позволит в режиме реального времени переносить заказы из приложения в МойСклад со всеми параметрами: товарами, клиентом, комментариями, адресом и суммой.
Предложенная автоматизация
Мы предложили интеграцию через API Aqua Delivery с автоматической обработкой входящих вебхуков в Нодуле. После создания заказа сервис передаёт структуру данных, а сценарий в Нодуле обрабатывает её и формирует заказ в МойСклад.
Ключевые элементы решения:
• единая архитектура обработки заказа через вебхук Aqua Delivery
• сопоставление сущностей по дополнительным полям «ID aqua delivery»
• многоступенчатый алгоритм поиска клиента и позиций
• автоматическое создание заказа в МойСклад и ведение журнала операций
Такой подход позволил избежать ручной работы и обеспечить предсказуемое поведение интеграции при любых исключениях.
Решение проблемы
Вся логика была реализована в одном сценарии Нодуля, который последовательно обрабатывает поступивший заказ из Aqua Delivery.
Часть 1
Мы подготовили систему к интеграции: создали в МойСклад дополнительные поля для товаров, контрагентов и заказов. В эти поля заносится соответствующий внешний ID из Aqua Delivery. Благодаря этому удалось обеспечить точное сопоставление между двумя системами.
Часть 2
Далее сценарий переходит к обработке позиций заказа.
Процесс идёт циклом: из Aqua Delivery приходит список товаров с их внешними ID, сценарий ищет каждый товар в МойСклад и выполняет корректное сопоставление. В случае ошибок логика поведения прозрачна:
- API МойСклад возвращает ошибку
- найдено несколько товаров с одинаковым ID
- товар отсутствует в базе
Любое событие фиксируется в комментарии к заказу, что делает диагностику максимально удобной.
Часть 3
Следующий этап посвящён работе с контрагентами. Сценарий использует трёхуровневую схему:
- поиск по дополнительному полю «ID aqua delivery»
- поиск по номеру телефона
- создание нового клиента
Если один из шагов выполнен успешно, дальнейшие попытки не выполняются. При критической ошибке процесс останавливается, что предотвращает создание «битых» заказов.
Часть 4
После успешной идентификации клиента и позиций формируется тело заказа в формате JSON и отправляется в МойСклад.
Созданный заказ включает все параметры: товары, количество, комментарий, адрес, телефон, итоговую сумму и организацию, на которую оформляется продажа.
Результат каждого запуска виден в истории сценария: можно быстро понять, какие этапы были пройдены, и в каком месте произошла ошибка, если она возникла.
Вывод
Интеграция позволила полностью исключить ручную работу по переносу заказов между Aqua Delivery и МойСклад. Компания получила:
• автоматическую синхронизацию данных в реальном времени
• снижение количества ошибок и дублирующихся сущностей
• ускорение обработки заказов
• прозрачную историю исполнения сценария
• стабильную логику поведения при любых исключениях
Кейс демонстрирует, что через Нодуль можно подключить к МойСклад практически любой сервис с API и реализовать бизнес-логику любой сложности, сохраняя прозрачность, масштабируемость и контроль на каждом шаге.
