Вебхуки МойСклад: как получать изменения
Вебхук сообщает внешней системе о событии. Разбираем пример вебхука в Сценариях МоегоСклада и отличаем его от вебхуков JSON API.
Представьте, что заказ в МоемСкладе изменился и клиенту нужно отправить уведомление. В примере вебхука, настроенного через Сценарии, внешняя система получает ID и тип документа. Затем она сама запрашивает подробности заказа и решает, что делать. Вебхуки JSON API — отдельный механизм со своим форматом.
Что происходит после изменения
В официальном примере вебхука в Сценариях МоегоСклада внешней системе передаются идентификатор и тип документа. Для заказа покупателя тип обозначен как CustomerOrder. Получатель по ID запрашивает актуальное состояние через API, проверяет условие и только затем выполняет действие, например обновляет запись во внешней CRM.
Этот пример не описывает формат всех вебхуков МоегоСклада. Если вы создаёте подписку через JSON API, сверяйте структуру её уведомления в документации API. Само получение события не заменяет обработчик, проверку и последующее действие.
Как подготовить обработчик
Сначала выберите механизм: вебхук в Сценариях или подписку через JSON API. Для первого настройте событие и адрес получателя в Сценарии; для второго проверьте настройки и формат по документации API. Затем определите способ получить объект, правило действия и устойчивый ключ обработки, чтобы повторный сигнал не создал второй результат. Гарантии доставки и конкретные поля сверяйте с документацией выбранного механизма перед кодом.
Для проверки измените один тестовый заказ, убедитесь, что сигнал получен, затем сравните идентификатор, статус и итоговое действие в обеих системах. Повторите тот же запрос к обработчику и проверьте, что дубль действия не возник. Если обработчик временно недоступен, понадобится отдельный план восстановления и сверки пропущенных изменений.
Когда здесь нужен MCP
Официальный MCP МоегоСклада помогает агенту отвечать на вопросы по данным аккаунта. Для событийной синхронизации он сейчас не заменяет Сценарии или вебхуки JSON API. Если нужна интеграция «изменился заказ → обновилась другая система», проектируйте её как программный процесс с журналом и контрольной сверкой.
Частые вопросы
Вебхук содержит все данные заказа?
В примере вебхука в Сценариях МоегоСклада передаются ID и тип документа, а подробности получатель запрашивает через API. Не переносите этот формат на вебхуки JSON API без проверки документации.
Может ли MCP заменить вебхуки?
Официальный MCP МоегоСклада ориентирован на чтение данных в диалоге с агентом. Событийную интеграцию проектируют отдельно, используя Сценарии или вебхуки JSON API.
Что проверить перед запуском?
Уточнить вид вебхука, формат уведомления, получение события, права на чтение объекта, поведение при повторной обработке и сверку итогового действия.
Официальная документация проверена 30 октября 2026 года. Доступ к клиентскому аккаунту и работу конкретного подключения для этой статьи не тестировали.