Вопросы и ответы
Подключение
Как подключить модуль к МойСклад?
В настройках подключения выберите Тип авторизации: Токен (по умолчанию и рекомендуется) или Логин и пароль. Модуль работает в МойСклад от имени той учётной записи, под которой выдан токен или указан логин, — с её правами. Статус подключения виден в боковой панели под логотипом модуля: «МойСклад подключён». Подробнее — Подключение к МойСклад и все поля авторизации.
Что нужно настроить на стороне сервера?
Две вещи. Первая — агенты Битрикс24 на cron: они разбирают очередь обмена. Вторая — адрес сайта портала, доступный из интернета: на него МойСклад присылает уведомления. Файл-обработчик модуль кладёт на сервер сам кнопкой Установить файл на странице Вебхуки МойСклад — FTP не нужен. Подробнее — Вебхуки МойСклад.
Что будет, если МойСклад недоступен или токен перестал работать?
Перед каждым проходом очередь проверяет подключение к МойСклад. Если авторизация не проходит, проход пропускается целиком и попытки задач не тратятся — задачи дождутся, пока подключение восстановится. Временные сбои при самом обмене лечатся повтором: у задачи до трёх попыток. Подробнее — Очередь.
Обмен документами
Обмен односторонний или двусторонний?
Двусторонний, но направление задаётся по частям: отдельно для каждого документа, для товаров, ответственных, валюты, статусов и для каждой пары полей. Можно, например, отдавать ответственного в МойСклад, но не принимать его обратно. Подробнее — Сопоставление полей.
Нужно ли менеджеру нажимать кнопку «выгрузить»?
Нет. Обмен запускается сам, когда сделку, контакт или компанию создают или меняют. Обратно — когда МойСклад присылает уведомление об изменении заказа, контрагента или платежа. Подробнее — Экспорт и Импорт.
Как быстро сделка попадает в МойСклад?
Обычно за несколько секунд: поставив задачу, модуль тут же выполняет её в фоне, уже после того как карточка сохранилась. При массовых изменениях (импорт, групповое обновление сделок) мгновенный запуск отключается и задачи разбирает агент — по десять за проход, примерно раз в минуту. Подробнее — Очередь.
Сделка сохранена, а заказа в МойСклад нет. Что проверить?
Откройте Очередь обмена и найдите задачу по сделке.
- Задачи нет вообще — проверьте страницу События модуля: изменение сделки должно быть включено. Подробнее — События модуля.
- Задача висит и не выполняется — посмотрите карточку «Агенты очереди» на Дашборде: агент мог остановиться (см. вопрос ниже).
- Задача «Выполнена», а заказа нет — сработала проверка готовности, и причина записана в Логах. Чаще всего:
- не включён Включить обмен для документа;
- не выбрано поле в настройке Привязка типа документа МойСклад к сделке Битрикс24 (в логах — «Не выбрано поле типа документа»);
- ни у одного поля поиска не включена опция Сохранять соответствия;
- поле, выбранное в настройках (поле поиска, поле типа документа, свойство корзины), удалено в Битрикс24 или МойСклад;
- сделка не прошла Фильтры.
Подробнее — Заказ покупателя, Очередь обмена и Логи.
Как модуль отличает продажу от закупки?
По полю-списку в сделке, которое выбрано в настройке Привязка типа документа МойСклад к сделке Битрикс24 (поле создаёт кнопка Управление полем). Если значение в сделке пустое, сделка уходит заказом покупателя. Заказом поставщику она станет, только если в поле явно выбрано «Заказ поставщику». Подробнее — Заказ поставщику.
Можно ли выгружать в МойСклад не все сделки?
Да. На вкладке Фильтры задаются условия на поля сделки (Фильтрация документов из Битрикс24) и отдельно на поля заказа (Фильтрация документов из МойСклад). Если условий несколько, документ должен подходить под все сразу. Подробнее — Заказ покупателя.
Синхронизируются ли оплаты?
Да: оплата сделки ↔ входящий платёж МойСклад, только для заказов покупателя. Контур оплат работает, если включён обмен заказом покупателя. Для приёма платежей из МойСклад нужно выбрать Платёжную систему по умолчанию — без неё импорт оплат не пройдёт проверку готовности. Оплаты сделок с типом «Заказ поставщику» не обмениваются. Подробнее — Оплаты.
Контрагенты
Откуда берутся дубли контрагентов и как их избежать?
Дубль появляется, когда модуль не нашёл уже существующего контрагента и создал нового. Найти пару помогают поля поиска на странице Контрагенты → Общие настройки. Самый надёжный способ — кнопка Управление полем для поиска: она заведёт в Битрикс24 поле «Идентификатор МС» и сразу включит его в поиск. Подойдут также UUID или внешний код с включённым сохранением соответствия: после первого обмена связь запишется в обе карточки.
Со стороны Битрикс24 искать можно по ID, внешнему идентификатору, первому телефону, первому e-mail и строковым пользовательским полям. По ИНН из реквизитов Битрикс24 искать нельзя: ИНН контрагента МойСклад можно сопоставить только со строковым пользовательским полем компании. Поля проверяются сверху вниз до первого совпадения — поставьте наверх самое надёжное. Проверить поиск на реальных данных можно кнопкой Проверить поиск. Подробнее — Контрагенты и Как модуль находит пару.
Нужно ли выгружать клиентскую базу заранее?
Нет. У заказа не бывает без клиента, поэтому контрагент обменивается вместе со сделкой, даже если Включить независимый обмен контрагентами выключен. В МойСклад попадут только клиенты, по которым есть заказы. Но сами настройки контрагентов (поиск, типы, поля) нужны в любом случае. Подробнее — Контрагенты.
Работает ли обмен с ИП и физлицами?
Да. Юрлицо, ИП и физлицо настраиваются на отдельных страницах: к контакту или компании привязан тип, какие поля переносить, какой шаблон реквизитов Битрикс24 использовать. Реквизиты и адреса записываются в реквизит выбранного шаблона. Подробнее — Типы контрагентов.
Товары и корзина
Почему заказ ушёл без товаров?
По умолчанию товары не обмениваются. Включите Обмен корзиной (товары документа) на вкладке Общие настройки страницы документа. Пока он выключен, настройки страницы Корзина ни на что не влияют. Подробнее — Корзина.
Товар не находится или создаётся заново. Что делать?
Модуль ищет товар по полю, выбранному на странице Корзина: в Битрикс24 — Поле для поиска товара (внешний код XML_ID или строковое свойство инфоблока), в МойСклад — Поле для поиска ассортимента (внешний код или идентификатор). Если пара не нашлась, товар создаётся: в Битрикс24 — в выбранном Инфоблоке торгового каталога, в МойСклад — в указанной группе или в корне. Если товары создаются повторно, проверьте, что поле поиска заполнено одинаково в обеих системах. Подробнее — Корзина.
Нужно ли заранее выгружать каталог?
Нет. Каталог наполняется по мере появления заказов: товары, услуги, комплекты и модификации создаются при первом обмене. У модификации сначала создаётся родительский товар, у комплекта — его состав. Подробнее — Корзина.
Переносятся ли остатки, цены каталога и лиды?
Нет. Лиды в обмене не участвуют — только сделки (и их оплаты), контакты и компании. Цена и скидка переносятся только как часть позиции в конкретном заказе, а не в каталог. Скидка — только в процентах: фиксированная скидка в рублях при выгрузке в МойСклад теряется. Подробнее — Ограничения.
Статусы
Стадия сделки и статус заказа синхронизируются?
Да, по таблице на вкладке Статусы: для каждой пары «стадия сделки ↔ статус документа» выбирается Направление обмена. Сами по названиям стадии и статусы не сопоставляются. Подробнее — Статусы в обе стороны.
Статус в МойСклад поменяли, а стадия сделки не изменилась. Почему?
Проверьте по порядку:
- Есть ли новый статус в таблице на вкладке Статусы и разрешено ли для него направление в Битрикс24.
- Доходят ли уведомления из МойСклад — см. вопрос про вебхуки ниже.
- Появилась ли задача в Очереди обмена и что о ней записано в Логах.
Несопоставленный статус стадию не меняет. Подробнее — Заказ покупателя.
Очередь и ошибки
Из МойСклад ничего не приходит. Что проверить?
Откройте Вебхуки МойСклад:
- у файла-обработчика оба бейджа должны быть зелёными — «Файл установлен» и «Доступ разрешён». Если доступ красный, нажмите Обновить доступ — иначе Битрикс24 вместо ответа отдаёт МойСклад форму входа;
- адрес должен быть доступен из интернета;
- в таблице вебхуков не должно быть красных отметок. После смены секретного ключа старые вебхуки ведут на прежний адрес («Ошибка URL») — нажмите Обновить хуки.
Подробнее — Вебхуки МойСклад.
Задачи копятся и не выполняются. Почему?
Скорее всего, остановлен агент очереди. Если за час накопилось сто задач с ошибкой, агент выключается сам, чтобы не повторять заведомо неудачный обмен. Найдите причину на странице Очередь обмена (в подробностях задачи виден текст ошибки), устраните её и нажмите Реактивировать в карточке «Агенты очереди» на Дашборде. Подробнее — Очередь и Дашборд.
Можно ли запустить задачу вручную?
Да. На странице Очередь обмена у задачи есть Выполнить принудительно, а у очереди — Вызвать агент очереди. Учтите: задача, запущенная принудительно, после выполнения удаляется из очереди при любом результате. Сначала исправьте причину ошибки, потом запускайте. Подробнее — Очередь обмена.
Что будет при удалении сделки, контакта или заказа?
Ничего: удаления не переносятся ни в одну сторону. Удалённая сделка не удаляет заказ в МойСклад, удалённый в МойСклад контрагент остаётся в Битрикс24. Это сделано намеренно — удаление необратимо, и размножать его автоматически опасно. Подробнее — Ограничения.
Лицензия и демо-режим
Можно ли попробовать модуль до покупки?
Да. Демо-версия ставится так же, как платная, работает с полным набором возможностей и ограничена по времени. Статус лицензии виден в приложении модуля. Подробнее — Покупка и продление модуля.
Модуль пишет «Доступ к модулю заблокирован». Что делать?
Значит, лицензия не прошла проверку: закончился ознакомительный режим, истёк срок лицензии или проверка не удалась. В окне информации о лицензии есть кнопки Купить модуль или Продлить модуль, Повторить проверку и Скопировать сведения — последние пригодятся для обращения в поддержку. Подробнее — Проверка лицензии модуля.