МойСклад: Синхронизация товаров по API

Важно:

При запуске агентов через cron теперь работает деактивация товаров вне выбранных групп: при включённой опции такие товары начнут выключаться.

Безопасность:

Временные файлы импорта текущих остатков закрыты от веб-доступа.

Новое:

Фильтр по группам МойСклад: группы любой вложенности, выбор деревом с поиском, счётчик выборки.

Блоки «Фильтрация» и «Активность» на вкладках сущностей: настройки в одном месте, подсказки, пояснение «Как работает».

Отдельный фильтр импорта цен: свои группы и свойство-флаг.

Опция «Обновлять элемент, даже если изменений нет».

Улучшено:

Новый дизайн блоков настроек и документация к ним.

Исправлено:

Активность решается по единым правилам при импорте, вебхуке и в агентах деактивации; доп. поле активности работает в вебхуках, архивные и внегрупповые товары не переключаются по кругу.

Вебхук модификаций учитывает подгруппы и новую группу родителя, а при сбое загрузки родителя не деактивирует ТП.

Сбой загрузки групп или доп. полей МойСклад больше не сбрасывает настройки и не выключает товары «вне групп».

Группы с символами %, _ и ; в названии.

Модификации без товара-родителя учитываются как пропущенные с предупреждением в журнале.

Поле с множественным выбором у внешних агентов больше не теряет значения.

Сообщения об ошибках на странице настроек, журнал импорта, опечатка в подсказке.

Новое:

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

Исправлено:

Изменение артикула и других строковых свойств на значение с ведущими нулями (например, с 33336 на 033336) теперь переносится на сайт.

Улучшено:

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

Исправлено:

Исправлена загрузка файлов из доп. полей типа «файл», когда МойСклад отдаёт их из облачного хранилища: расширение файла теперь определяется верно.

При включённой настройке «Полностью игнорировать активность» удаление товара в МойСклад больше не деактивирует элемент на сайте, а архивные товары и товары вне выбранных групп не обновляются по вебхукам

Улучшена поддержка внешних обработчиков событий модуля

Улучшения в работе профилей

При обновлении товаров с включённым обновлением групп раздел элемента больше не перезаписывается на каждом прогоне, если группа в МойСклад не менялась

Комплекты больше не перезаписываются при каждом импорте, если их состав в МойСклад не менялся

Запуск по cron больше не накладывается сам на себя при долгом импорте: из-за наложения к МойСклад шли лишние запросы. Зависший запуск теперь останавливается сам по истечении времени из настройки «Максимальное время одного запуска скрипта» (вкладка «Прочее», по умолчанию 30 минут), а следующий запуск продолжает импорт с места остановки. В cron/log.txt пишутся начало, окончание и длительность каждого прогона.

Картинки в дополнительном свойстве: при удалении или замене картинки у одного товара она больше не пропадает у других товаров с той же картинкой; замена картинки записывается с первого прогона, порядок фото повторяет МойСклад без повторной загрузки файлов.

Картинки во множественном свойстве: при удалении или замене картинки в МойСклад ненужный файл теперь удаляется с сайта, если он больше нигде не используется. Файлы, общие для нескольких товаров или служащие источником анонса и детальной картинки, сохраняются.

Ошибки импорта товара по вебхуку (не задан инфоблок, пустая группа, ошибка сохранения элемента) теперь записываются в лог модуля.

Новое:

Профили теперь включены по умолчанию и сами профили видны в отдельной панели: видно, в каком профиле сейчас находитесь, а переключить, переименовать, задать цвет и описание, добавить или удалить профиль можно в одном окне.

На вкладке каждой сущности появилась настройка «Полностью игнорировать активность»: с ней модуль не меняет активность товаров, модификаций, услуг и комплектов ни при импорте, ни по вебхукам — активностью полностью управляет сайт. Отдельные агенты деактивации при этом продолжают работать по своим настройкам.

Новые события для стороннего кода: OnBeforeDeleteItem (удаление по вебхуку — срабатывает, даже если элемента в каталоге нет), OnBuildImportFilter (изменение фильтра запроса к МойСклад в любом пайплайне), OnWebhookSkipped (вебхук по необработанной сущности). OnAfterImportItems теперь передаёт ID созданных элементов. В лог агента добавлена строка «Пропущено при создании». Методы put() и delete() API-клиента возвращают ответ МойСклад — ошибки изменения и удаления вебхука больше не теряются.

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

При импорте цен и остатков внешний обработчик может подставить свои элементы каталога для товаров, которые модуль не нашёл по XML\_ID, — в том числе несколько элементов на одну позицию МойСклад.

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

Улучшено:

Общие улучшения безопасности модуля.

Новый товар получает цены сразу при создании, в том же проходе импорта, — больше не нужно ждать очередного запуска агента цен. Работает для товаров, модификаций, услуг и комплектов, у которых включён импорт цен.

Если в одном вебхуке МойСклад приходит больше событий, чем задано в настройке лимита, лишние события больше не пропадают молча: они записываются в лог модуля (тип, действие, ссылка)

Исправлено:

Настройки модуля: при пустых или неверных данных авторизации снова выводится текст ошибки МойСклад — вместо служебной строки «\[Код: #ERROR\_ID#\] #TEXT#».

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

Кеш модуля под контролем: раз в сутки скрытый агент сам снимает записи с истёкшим сроком — прежде всего служебные записи обработки вебхуков, которые копились до ручной очистки. Живые записи не затрагиваются. Агент включается после сохранения настроек модуля.

Общие улучшения языковых фраз.

- Добавлены новые группы маркированной продукции: моторные и растительные масла, косметика, бытовая химия и товары личной гигиены, консервированные продукты, строительные материалы, натуральный мех, радиоэлектроника, ноутбуки и смартфоны, бакалея, корма для животных, детские игрушки.

- Неизвестная группа маркировки, пришедшая из МойСклад, отмечается предупреждением в журнале импорта.

- Артикул модификации теперь можно выгружать в свойство инфоблока.

- Исправлено назначение раздела при создании товаров: товар без группы в МойСклад мог попасть в раздел предыдущего импортированного товара вместо раздела по умолчанию.

- Общие исправления и улучшения модуля. Повышение безопасности.

Минимальная версия PHP для модуля 8.0

- Улучшено качество кода PHPstan уровень 4 (совместимость версий PHP: 8.0, 8.1, 8.2)

- Обновление безопасности

- Добавлена возможность выбирать несколько групп товаров для каждой сущности — товаров, модификаций, услуг, комплектов и групп товаров.

- Добавлен поиск по подстроке в списках выбора групп товаров.

- Добавлена новая страница «Разовый импорт» в админской диагностике с превью запроса, журналом и прогрессом каждого шага. Документация: ( https://docs.despi.ru/rbs-moyskladstocks/diag/instruments/import_once ).

- Добавлен разовый импорт быстрых (текущих) остатков из новой страницы диагностики.

- Добавлено автоматическое обновление родительских товаров при изменении остатков, цен или быстрых остатков их модификаций (включается отдельной настройкой).

- Исправлено сохранение значений списочных свойств товаров, которые приходят из булевых свойств МойСклад.

- Исправлена деактивация модификаций.

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

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

- Улучшено подключение ресурсов админских страниц модуля.

- Улучшена безопасность модуля.

- Добавлени идентификация товаров и разделов по UUID из МС (поле id), включается во вкладке "Прочее".

- При импорте скидок с определенной ценой теперь не нужно импортировать саму цену (работает если в скидке

выбраны только товары)

- Улучшено информирование в логах при импорте комплектов

- Добавлена возможность игнорирования изменения разделов для товаров на сайте, у которых выбрано более 1 раздела

- Добавлена опция игнорирования флага активности разделов при обмене разделами во вкладке "Группы"

- Исправлена ошибка проставления типа маркируемой продукции для модификаций из родительского товара

- Изменены названия настроек деактивации во вкладке "Группы"

- Небольшие исправления в настройках модуля

- Рефакторинг когда модуля

- Добавлена возможность переименовывать профили обмена

- Добавлена возможность загружать описания групп (разделов)

- Исправлена проблема запуска ручного и автоматического полного импорта в один день

- Исправления в инструменте анализа элементов инфоблока

- Добавлена документация по инструмента анализа: https://docs.despi.ru/rbs-moyskladstocks/diag/instruments/analyz-iblock

- Добавлен новый раздел в диагностику модуля "Инструменты", в нем реализованы инструменты отслеживания дублей товаров по внешнему коду, а также есть возможность посмотреть какие товары есть в МойСклад и нет на сайте, также по внешнему коду.

- Добавлено событие в модуль, которое вызывается после импорта цен. Подробнее: https://docs.despi.ru/rbs-moyskladstocks/devs/events/onpricestepimported/

Исправления в механизме активности по свойству-флагу

- Исправлена ошибка обновления штрих-кода в товаре, если выбрана опция "Импортировать первый штрих-код"

- Добавлена возможность управлять активностью товаров на сайте напрямую через доп. поле товара МС (тип поля "флажок"), подробнее: https://docs.despi.ru/rbs-moyskladstocks/settings/product/fields/#активность-по-доп-полю

- Добавлена возможность указать статус по умолчанию для новых контрагентов

- Исправлена ошибка при поиске контрагента