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

Модуль подтягивает каталог из МойСклад на сайт 1С-Битрикс: товары, модификации, услуги, комплекты, структуру групп, цены, остатки по складам и скидки. Товаровед ведёт номенклатуру и цены в учёте — сайт сам обновляется, без выгрузки файлов и ручного переноса. Работает напрямую через JSON API 1.2 МойСклад.

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

Что импортируется

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

• Остатки по складам — с соответствием складов Битрикс и МойСклад, поддержкой вложенных складов и выбором типа остатка: складской, доступный (с учётом резерва и ожидания) или без ожидания.

• Цены — по таблице соответствия типов цен и валют. Одному типу цены МойСклад можно сопоставить несколько типов цен на сайте.

• Группы — структура папок МойСклад переносится в разделы инфоблока с сохранением вложенности.

• Скидки типа «Специальная цена» — как правила работы с корзиной Битрикс.

• Стандартные поля: наименование, артикул, штрихкоды, страна, вес, объём, НДС, единица измерения и другие — и дополнительные поля, созданные в МойСклад.

• Картинки — основная попадает в анонс и детальную, остальные в множественное свойство типа «Файл».

Как это выглядит в работе

Каждый тип данных обменивается своим агентом: он запускается по расписанию и за шаг обрабатывает заданное количество элементов — весь каталог или только изменённые позиции. Пример из практики: при запуске раз в минуту и 50 товарах за шаг каталог из 1000 позиций обновляется примерно за 20 минут; в большинстве случаев каталог удаётся держать актуальным с отставанием 5–10 минут.

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

Товары сопоставляются по внешнему коду, поэтому модуль можно подключить к уже наполненному каталогу: совпавшие товары обновятся, а не задублируются.

Гибкая настройка импорта

• Только существующие товары. Модуль может не создавать новые позиции, а обновлять те, что уже есть на сайте, — удобно, когда каталог ведётся вручную, а из учёта нужны только цены и остатки.

• Разные правила для новых и существующих. При создании товара передаются все поля, при обновлении — только нужные: например, цены и остатки без описания и картинок.

• Фильтры. Импорт только из выбранной группы МойСклад или только товаров с отмеченным доп. полем-флажком. Остатки можно обновлять у отфильтрованной части каталога.

• Управление активностью. Товар скрывается на сайте по архивности в МойСклад, по выходу из группы, по флажку — или полностью управляется отдельным полем «Активность».

• Свойства всех основных типов: строка, число, список, файл, привязка к элементам инфоблока, HTML/текст, дата, справочник (highload-блок).

• Комплекты — как простые товары или как полноценные комплекты Битрикс (в зависимости от редакции).

• Дубликаты по внешнему коду — выбираете стратегию: обновлять элемент с наименьшим или наибольшим ID, все дубли или пропускать.

• Профили обмена — несколько аккаунтов МойСклад, разные инфоблоки, многосайтовость.

Большие каталоги

Для каталогов от 5 000 позиций или обмена с десятком складов есть режим «Быстрые остатки»: раз в сутки по расписанию идёт полная синхронизация, а в течение дня загружаются только изменившиеся остатки. Нагрузка на сервер заметно ниже, а отчёт об остатках формируется стабильно.

Запросы к API экономят таблицы кеша на highload-блоках, при упоре в лимиты МойСклад модуль повторяет запрос с настраиваемой задержкой. Агенты можно запускать штатно или отдельным скриптом модуля на cron — чтобы обмен шёл в своём процессе.

Диагностика

• Мониторинг показывает все процессы импорта и обновляется каждые 10 секунд: включён ли импорт, настроен ли агент, запущен ли он по факту, есть ли ошибки и предупреждения.

• Логи хранятся до 15 дней, ищутся по тексту и фильтруются по ошибкам и предупреждениям.

• Инструменты: анализ дублей в инфоблоке по внешнему коду с выгрузкой в CSV и сопоставление товаров МойСклад и сайта.

Требования

• 1С-Битрикс: Управление сайтом редакций «Малый бизнес», «Бизнес», «Интернет-магазин + CRM» или коробочный Битрикс24.

• Платный тариф МойСклад — для веб-хуков и дополнительных полей; подключение по токену или логину и паролю.

• Агенты Битрикс, переведённые на cron.

Что модуль не делает

• Не меняет и не создаёт ничего в МойСклад — только импортирует данные на сайт.

• Не обменивает заказы и контрагентов — это задачи других модулей.

• Не обрабатывает массовые изменения через веб-хуки — их доводят агенты по расписанию.

• Не импортирует остатки услуг — в МойСклад их нет.