*️⃣ Прочее

В этом разделе настраиваются прочие параметры модуля.

к сведению

Скриншот показывает прежний вид вкладки. В актуальной версии на вкладке есть разделы «Управление бета функциями модуля» и «Параметры создания пользователя при импорте», а опции «Отладка» больше нет — все сообщения модуля пишутся в логи, которые теперь находятся на странице Диагностика.

Управление бета функциями модуля

Бета

Опции этого раздела включают новый механизм синхронизации состава документов. Механизм находится в стадии бета-тестирования: включайте его сначала на тестовом стенде или на небольшом объёме заказов и проверяйте результат по логам. По умолчанию все опции выключены («Не применять»), и модуль работает по прежней логике.

Унификация корзины для отгрузок

Направление нового механизма синхронизации состава отгрузок:

• Не применять — прежняя логика (по умолчанию).
• Двусторонний обмен — новый механизм работает и при выгрузке отгрузки в МойСклад, и при загрузке отгрузки из МойСклад на сайт.
• Из БУС в МС — только выгрузка в МойСклад: составы сравниваются, существующие позиции обновляются, а не пересоздаются.
• Из МС в БУС — только загрузка на сайт: нет лишних движений по складу, а товар, который не удалось сопоставить, не теряется — в лог пишется предупреждение.

Унификация корзины для заказов

То же самое для состава корзины заказа:

• Не применять — прежняя логика (по умолчанию).
• Двусторонний обмен — и при выгрузке заказа в МойСклад, и при загрузке заказа на сайт.
• Из БУС в МС — только выгрузка: позиции заказа в МойСклад обновляются, а не пересоздаются, поэтому связанные с ними данные сохраняются.
• Из МС в БУС — только загрузка корзины заказа из МойСклад.

Допустимая погрешность при сравнении состава документа

Работает только когда включена хотя бы одна из опций унификации корзины. Задаёт, насколько числа (количество, цена в копейках, скидка в процентах) могут различаться, чтобы модуль всё ещё считал их одинаковыми.

• 0 (по умолчанию) — числа должны совпадать точно.
• Если в логах видно, что документ отправляется в МойСклад при каждом обмене, хотя его состав не менялся, — причина обычно в округлении копеек. В этом случае укажите небольшую погрешность, например 0.01 (можно и через запятую — 0,01).

Параметры создания пользователя при импорте

Домен логина для контрагента без почты

Используется, когда модуль при импорте заказа из МойСклад создаёт пользователя на сайте по контрагенту (см. Создание пользователя Битрикс на основе контрагента).

Логин пользователя на сайте берётся из почты контрагента. Если почта у контрагента в МойСклад не заполнена или длиннее 50 символов (логин в Битриксе не может быть длиннее), модуль собирает логин-заглушку вида:

идентификатор_контрагента@домен

где идентификатор — UUID контрагента в МойСклад, а домен — значение этой опции. Если почты у контрагента нет, такое же значение записывается и в почту пользователя. Если почта есть, но слишком длинная, в поле почты пользователя остаётся настоящая почта контрагента — заглушкой становится только логин.

• По умолчанию используется домен from.ms.
• Домен должен быть не длиннее 13 символов и выглядеть как обычный домен (латиница, цифры, дефис и точка, например shop.ru). Знак @ в начале можно не указывать.
• Слишком длинный или некорректный домен модуль не применяет — вместо него используется from.ms.

подсказка

Укажите домен своего сайта (если он короткий) — так пользователей, созданных модулем по контрагентам без почты, будет проще найти в списке пользователей.

Параметры часового пояса

Применять принудительно часовой пояс Москвы при работе с датами

Если у вас сервер находится вне часового пояса Москвы, то можно проставить эту галочку, чтобы модуль верно учитывал время изменения документов в МойСклад для корректной работы агентов. Опция влияет только на даты, которыми модуль обменивается с МойСклад.

Принудительная установка часового пояса для всех процессов

Позволяет выбрать часовой пояс, который модуль установит для всех своих процессов (агентов, обработки веб-хуков и т.д.). Применяется, если время в логах модуля не соответствует времени сервера. По умолчанию — «Не устанавливать».

Параметры попыток обращений к API

Количество попыток повторного запроса при ошибке

Опция позволяет установить количество попыток повторного обращения в МС в случае временных ошибок. По умолчанию — 3.

Повторяются запросы, на которые МойСклад ответил временной ошибкой: превышение лимитов API, ошибки сервера (500, 502, 503, 504) и т.п. Если МойСклад сообщает, сколько нужно подождать из-за лимитов, модуль ждёт именно столько; в остальных случаях — время из опции ниже.

Задержка в миллисекундах между попытками

Опция регулирует задержку между повторными попытками обращения в МС. По умолчанию — 500 миллисекунд.

к сведению

Разрешено не более 10 попыток и интервал не более 2000 миллисекунд (2 секунд). Большие значения автоматически ограничиваются этими пределами, а пустое или нулевое значение заменяется значением по умолчанию.

Оповещение об ошибках

В разделе есть опции:

• Выводить плашку вверху административной части при ошибке;
• Оповещать об ошибке на почту;
• Почта для оповещений (по умолчанию подставляется почта отправителя из настроек главного модуля).

warning

В текущей версии модуля эти опции сохраняются, но не влияют на работу: плашка в административной части и письма об ошибках модулем не отправляются. Для контроля ошибок используйте логи на странице Диагностика.

Кеш

Выборка элементов корзины из каталога (сек)

Модуль кеширует данные о товарах для экономии запросов в БД при поиске позиций корзины. По умолчанию — 86400 секунд (сутки). Необходимо выставить 0, если из МС будут регулярно добавляться товары в БУС.

Выборка элементов корзины из МС (сек)

Аналогично модуль экономит запросы в МС при поиске товаров. По умолчанию — 86400 секунд. Выставьте 0, если поиск товаров в МС не должен кешироваться.

Сбросить кеш запросов API к МойСклад

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

Кеш также сбрасывается автоматически при смене данных авторизации.

Очистить папку кеша модуля

Если отметить галочку и сохранить настройки модуля, то будет удалена вся папка с кешем модуля. Под опцией показывается текущий размер папки кеша.

Кеш веб-хука (секунды)

Вы можете указать, как часто модуль будет обрабатывать один и тот же веб-хук. Опция защищает от повторных веб-хуков со стороны МС. Допустимо от 1 до 10 секунд, по умолчанию — 5. Значение вне этого диапазона заменяется на 5.

Агенты

Агент проверки заказов из МС

Вспомогательный агент для импорта изменений из МС на сайт: он периодически массово проверяет последние изменившиеся заказы в МС и загружает данные по ним согласно настройкам модуля. Таким образом уменьшается вероятность неактуальных данных, если какой-то веб-хук не дошёл.

• Установить агент — если галочка отмечена, при сохранении настроек агент устанавливается; если снята — агент удаляется. По умолчанию отмечена.
• Время, за которое выбрать заказы из МС (минуты) — при первом запуске агент выберет заказы, изменённые в МС за указанное количество минут. По умолчанию — 30.

Под опциями выводится состояние агента: «Агент установлен» (по клику — активность, время последнего и следующего запуска и ссылка на агент) или «Агент не установлен».

Агент выгрузки заказа в МС

Агенты выгрузки заказов устанавливаются при создании заказа на сайте. Когда срабатывает агент, модуль пытается выгрузить данные в МС.

• Интервал срабатывания агентов (сек) — с каким интервалом запускаются агенты модуля. По умолчанию — 60 секунд. Этот же интервал используется для агента проверки заказов из МС и агента очереди веб-хуков.
• Время жизни агента (сек) — сколько времени агент будет повторять попытки, если выгрузить заказ (а также изменения заказа или оплату, которые ждут появления заказа в МС) не удалось. Отсчёт идёт от даты создания заказа на сайте; после истечения этого времени агент перестаёт перезапускаться. По умолчанию — 86400 секунд (сутки).