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

Технические данные

Совместимые редакции

• Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Малый бизнес
• Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Бизнес

Описание

Документация к модулю: https://support.codebrain.su/modules/moysklad/

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

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

• Каталог из МоегоСклада: группы → разделы, товары, модификации → торговые предложения (характеристики становятся свойствами-списками для фильтра), комплекты → комплекты торгового каталога, услуги. Описание, артикул, код, штрихкоды, вес (килограммы или граммы), габариты из доп. полей, НДС, единица измерения, страна, все доп. поля (свойства создаются сами), картинки.
  
• Отбор: выбранные группы и исключения, флажок "На сайт", только обновление существующих товаров без создания новых. Архивные и удалённые в МоёмСкладе товары скрываются.
  
• Для каждого поля - правило: записывать всегда, только новым товарам, если пусто или никогда (например, описания ведёт контент-менеджер на сайте, а цены и остатки - МойСклад).
  
• Цены: любые типы цен, закупочная и минимальная, наценка и округление; пустая цена модификации берётся у товара.
  
• Остатки по складам: остаток, свободный остаток (за вычетом резерва) или "доступно"; количество - сумма всех или выбранных складов; товар без остатка можно скрывать и показывать снова. Запрашиваются только изменившиеся остатки.
  
• Сопоставление с каталогом сайта: по внешнему коду, UUID, артикулу, коду, штрихкоду или названию, без учёта регистра, пробелов, дефисов и похожих букв. Несколько кандидатов - решение на отдельной странице, дубли не создаются.
  
• Безопасность: пробный прогон "было → станет" по каждому полю, защита ручных правок, задержка скачков и обнуления цены до решения, остановка, если синхронизация собирается скрыть большую часть каталога, откат любого запуска.
  
• Заказы сайта в МойСклад: цена до скидки и скидка позиции (менеджер видит, что скидка уже дана), доставка позицией-услугой, дата и номер заказа сайта, адрес по полям (индекс, город, улица, дом, квартира), юрлицо, склад, канал продаж и проект по правилам, доп. поля, резерв, покупатели без дублей по телефону, e-mail и ИНН.
  
• Из МоегоСклада на сайт: статусы, отмена, изменения состава заказа и стоимости доставки, входящие платежи и приходные ордера как оплаты, отгрузки с трек-номером и кодами маркировки "Честного знака". Заказы, созданные в МоёмСкладе, можно создавать и на сайте. Выгрузка старых заказов за период.
  
• Выгрузка каталога сайта в МойСклад: разделы, товары, торговые предложения с характеристиками, цены, артикулы, штрихкоды, вес, описания и картинки. Поля, которые ведутся на сайте (например, цены от поставщиков), и дальше передаются в МойСклад автоматически, а остатки по-прежнему приходят из МоегоСклада.
  
• Изменения приходят вебхуками за секунды; модуль сам создаёт вебхуки, включает их снова, если МойСклад их отключил, и пересоздаёт после переноса сайта. Без вебхуков - опрос. Ночная полная сверка.
  
• Лимиты API МоегоСклада: модуль выдерживает темп по заголовкам МоегоСклада, не повторяет ошибочные запросы и показывает расход лимита по часам.
  
• Страница "Здоровье": когда последний раз работал каждый поток обмена, агенты, вебхуки, очередь, отчёт для техподдержки. Уведомления о проблемах в информере и на e-mail. Журнал в базе с поиском по товару и заказу.
  
• Вкладка "МойСклад" в карточке товара и заказа: ссылка на объект в МоёмСкладе, история изменений, "синхронизировать сейчас".
  
• Несколько аккаунтов МоегоСклада и каталогов на одном сайте, права по группам пользователей, события для доработок без правки модуля.
  

Важно знать перед установкой

• Внешние платные сервисы: нужен аккаунт МоегоСклада (сервис МоегоСклада платный по его тарифам). Вебхуки МойСклад отправляет только на платных тарифах; без них модуль работает опросом. Модуль работает по API и не использует штатный обмен через CommerceML.
  
• Передача данных третьим сторонам: модуль обменивается данными только с аккаунтом МоегоСклада, указанным вами: товары, цены, остатки, заказы и данные покупателей из заказов (имя, телефон, e-mail, адрес доставки). На серверы разработчика модуль ничего не отправляет и персональные данные посетителей не собирает.
  
• Требования к хостингу: PHP 8.2 или новее с расширениями curl, json, mbstring; главный модуль 20.0 или новее; сайт в кодировке UTF-8; модули "Информационные блоки" и "Торговый каталог", для заказов - "Интернет-магазин". Агенты на cron. Для вебхуков сайт должен быть доступен из интернета по https.
  
• Модуль изменяет каталог и заказы: создаёт и обновляет товары, разделы, свойства, цены, остатки и картинки, может скрывать или удалять товары, удалённые в МоёмСкладе, меняет статусы, состав и оплаты заказов - по вашим настройкам. Перед первой синхронизацией используйте пробный прогон.
  
• Код модуля открыт, обфусцированных частей нет.