Установка и порядок настройки
После установки модуль ещё не обменивается ничем: пока не настроен хотя бы один контур, триггеры не создают задач, а проверки готовности не пропускают ни одну сущность. Настройка разбита на шаги, каждый следующий опирается на результат предыдущего.
Вся настройка идёт в интерфейсе модуля в административной части Битрикс24. Рядом с каждой настройкой есть подсказка, а внутри модуля — собственная интерактивная документация с демо-макетами: раздел Помощь → Документация.
Установка модуля
Модуль ставится как любое решение Маркетплейс — из карточки решения или из каталога решений на вашем портале. Общая инструкция: Установка модуля.
Демо-версия ставится так же, как платная, и работает с полным набором возможностей ограниченное время — именно на ней имеет смысл проходить эту инструкцию.
Подключение к МойСклад
Первое, что нужно модулю, — доступ к вашему аккаунту МойСклад. Поддерживаются два способа:
- Токен доступа — рекомендуемый вариант. Выпускается в МойСкладе в профиле пользователя и не зависит от смены пароля.
- Логин и пароль учётной записи МойСклад.
Права модуля в учётной системе — это права той учётной записи, под которой выпущен токен. Если заказ не создаётся или не читается справочник, первым делом проверьте права этой записи в МойСкладе.
Шаг 1. Вебхуки МойСклад
Вебхуки — способ МойСклад сообщить модулю, что заказ или контрагент изменились. Без них обмен работает только в одну сторону: из Битрикс24 в МойСклад.
На странице Вебхуки МойСклад два независимых блока, и оба должны быть в порядке:
- Файл-обработчик на вашем сервере — адрес, по которому МойСклад будет стучаться. Модуль кладёт обработчик сам и прописывает ему доступ; нужно только убедиться, что оба признака зелёные — файл установлен и доступ разрешён.
- Сами вебхуки в МойСклад — записи в вашем аккаунте, указывающие на этот адрес. Кнопка обновления хуков создаёт недостающие. Целевое состояние — девять галочек: три сущности на три действия.
Секретный ключ модуль генерирует сам: по нему он отличает настоящие уведомления от посторонних запросов.
Подробнее — в разделе Вебхуки и события.
Шаг 2. События Битрикс24
События — зеркальная половина вебхуков: они ловят изменения в Битрикс24 и ставят задачи на выгрузку. Модуль подписан на шесть событий CRM — добавление и изменение сделок, контактов и компаний.
Обработчики регистрируются автоматически при установке, поэтому на этом шаге обычно достаточно убедиться, что список непустой и все обработчики включены.
Шаг 3. Контрагенты, товары и справочники
Подготовительный шаг: заказ нельзя выгрузить, пока модуль не умеет сопоставлять его участников — клиента, товары и справочные значения.
- Контрагенты. Общие настройки (участие компаний и контактов в обмене, тип контрагента по умолчанию, поля поиска, группы и статусы) и три страницы типов — физлицо, ИП, юрлицо. Настроить контрагентов придётся в любом случае: у заказа не может не быть клиента.
- Товары. Инфоблок торгового каталога, поле для поиска товара и модификации, разделы и группы для новых позиций, соответствие характеристик модификаций.
- Справочники. Ответственные, валюты, единицы измерения и ставки НДС — простые таблицы соответствий «значение Битрикс24 ↔ значение МойСклад».
Пустой справочник НДС безопасен — модуль передаёт процент как есть. А заполненный наполовину опаснее пустого: ставка, для которой не нашлось пары, уходит не с ошибкой, а как «Без НДС». Заметить это можно уже по расхождению сумм в документах.
Шаг 4. Документы
Модуль работает с двумя документами МойСклад: заказ покупателя (продажа клиенту) и заказ поставщику (закупка). Страницы устроены одинаково, набор настроек зеркальный — настраивать оба необязательно.
Минимум, без которого документ обмениваться не начнёт:
- обмен для документа включён (по умолчанию выключен);
- тип документа привязан к полю сделки — в Битрикс24 и продажа, и закупка оформляются одной сделкой, поэтому модулю нужен признак;
- заданы поля поиска связанного документа;
- задано хотя бы одно соответствие полей;
- заполнена организация — единственное обязательное поле заказа в МойСклад.
Подробности — в разделе Документы: сделки и заказы.
Шаг 5. Агент очереди
Триггеры из шагов 1 и 2 только создают задачи — выполняет их агент очереди, фоновый планировщик Битрикс. Отдельного переключателя «включить очередь» нет: агент устанавливается сам при первой же задаче.
Поэтому пятый шаг — проверка, а не настройка: на дашборде карточка агента должна показывать состояние «активен» и время следующего запуска. Если агент неактивен, его останавливает защита от серии ошибок — сначала найдите причину в очереди и журнале, потом реактивируйте.
Если агенты запускаются «на хитах», очередь будет двигаться только при заходах пользователей на портал. Инструкция: Настройка агентов на cron.
Проверка: заработал ли обмен
Создайте тестовую сделку, заполните поле типа документа и добавьте товар. Затем откройте очередь обмена: задача должна появиться и в течение минуты перейти в состояние «Выполнена».
Если задача выполнилась, а заказа в МойСкладе нет — смотрите журнал действий: почти наверняка сработала одна из проверок готовности и в журнале перечислено, чего именно не хватило.