Синхронизация с МойСклад

Что умеет решение

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

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

Функции фильтрации позволяют выбирать конкретные группы и исключения, использовать флаг «На сайт» и ограничивать процесс только обновлением существующих товаров без создания новых. Товары, переведенные в архив или удаленные в МойСкладе, автоматически скрываются на сайте.

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

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

Управление остатками по складам включает отображение общего количества, свободного остатка (за вычетом резерва) или статуса «доступно». Количество может рассчитываться как сумма по всем складам или по выбранному списку. Товары без остатка можно скрывать и возвращать в каталог. Запрос обновлений осуществляется только для изменившихся позиций.

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

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

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

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

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

Изменения передаются через вебхуки в течение нескольких секунд. Модуль самостоятельно создает вебхуки, автоматически восстанавливает их при отключении со стороны МойСклада и пересоздает после переноса сайта. При отсутствии вебхуков используется режим опроса. Также выполняется ночная полная сверка данных.

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

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

В карточках товара и заказа на вкладке «МойСклад» доступны прямая ссылка на объект, история изменений и кнопка принудительной синхронизации.

Поддерживается работа с несколькими аккаунтами МойСклад и каталогами на одном сайте. Реализовано управление правами доступа по группам пользователей и система событий для расширения функционала без изменения кода модуля.

Перед установкой важно учитывать: для работы требуется платный аккаунт МойСклад. Вебхуки доступны только на платных тарифах; при их отсутствии модуль использует периодический опрос. Интеграция осуществляется через API и не использует стандартный обмен формата CommerceML.

Передача данных третьим сторонам: модуль обменивается данными исключительно с указанным вами аккаунтом МойСклад. В обмене участвуют товары, цены, остатки, заказы и данные покупателей из заказов (имя, телефон, e-mail, адрес доставки). На серверы разработчика данные не отправляются, персональная информация посетителей не собирается.

Требования к хостингу: PHP 8.2 или новее с расширениями curl, json, mbstring; главный модуль версии 20.0 или новее; сайт в кодировке UTF-8; подключены модули «Информационные блоки» и «Торговый каталог», для работы с заказами — «Интернет-магазин». Необходимы cron-агенты. Для работы вебхуков сайт должен быть доступен из интернета по протоколу HTTPS.

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

Исходный код модуля открыт, обфусцированных частей не содержит.

General iT может подключить «Синхронизация с МойСклад», настроить его и проверить корректность интеграции с текущим сайтом.