Перейти к содержанию

Настройка Webhook API

Webhooks (Вебхуки) — это механизм, который позволяет МойСклад мгновенно отправлять уведомления в ваш интернет-магазин Shop-Script при любых изменениях.

Вместо того чтобы магазин периодически опрашивал МойСклад на предмет новых товаров или изменения остатков, МойСклад сам "сообщает" об этом плагину в реальном времени.

[!CAUTION] Важное правило! НЕ ВКЛЮЧАЙТЕ хуки, если вы планируете делать первичный экспорт каталога в МойСклад. Хуки следует включать только после полной настройки импорта справочника и после первого полного синхронизационного обмена. В противном случае может возникнуть цикл бесконечных обновлений.

Как включить и настроить Webhooks

  1. Перейдите в настройки плагина интеграции в Shop-Script, раздел Webhooks.
  2. Нажмите кнопку Зарегистрировать Webhooks.
  3. Плагин автоматически свяжется с API МойСклад и пропишет нужные адреса (URL) для получения уведомлений.
  4. После успешной регистрации в таблице ниже появится список всех активных хуков со статусом "Зарегистрирован".

Доступные события для Webhooks

Вы можете гибко настроить, на какие именно события должен реагировать магазин:

  • Создание товара/модификации: Как только товар создан в МС, он сразу появляется на витрине.
  • Обновление товара/модификации: Изменение цен, названий, описаний или характеристик моментально передается в магазин.
  • Изменение остатков: Любая приемка, отгрузка или инвентаризация обновляет остаток в SS быстрее чем за 1 секунду.
  • Удаление/Архивация: Товар будет скрыт или удален с витрины.
  • Загрузка изображений: Мгновенный импорт добавленных картинок в карточку товара МС.

[!NOTE] Если вы замечаете, что обновления иногда не доходят, убедитесь, что ваш хостинг или сервер не блокирует входящие POST-запросы от серверов МойСклад (частая проблема для пользователей Webasyst Cloud).