Перейти к основному содержимому

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

к сведению

Модуль импортирует товары, остатки, цены из сервиса "МойСклад" на сайт "1С-Битрикс". Работает на JSON API 1.2.

подсказка

Модуль не меняет товары в МойСклад. Он только импортирует данные из МойСклад в 1С-Битрикс.

Первый раз настраиваете модуль?

Начните с раздела Быстрый старт — там пошагово описана первая настройка модуля.

Основной принцип работы модуля​

Основная функция модуля — массовый импорт товаров, цен и остатков на сайт. Товары сопоставляются по внешнему коду, что позволяет синхронизировать уже существующие товары.

Модуль отдельно импортирует:

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

Как технически модуль передает данные из МойСклад на сайт?​

Схема работы модуля:

МойСклад (JSON API 1.2) → Модуль (агент / cron) → 1С-Битрикс (инфоблоки)

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

Пример блока настройки агента модуля

Настройка сводится к двум шагам:

  1. Отметьте нужные поля для импорта
  2. Включите агент для запуска импорта данных

Скорость обмена​

Скорость обмена зависит от:

  • Частоты запуска агента
  • Количества элементов за один шаг
  • Режима импорта: полный или только изменённые данные

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

к сведению

Скорость обмена зависит от частоты запуска cron на сервере. Минимальный интервал cron — 1 минута. Задачи крона могут выполняться дольше минуты, поэтому реальная скорость агента может отличаться на 10–20%.

Моментальные изменения​

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

к сведению

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

Подробнее об обмениваемых данных модуля​

Цены​

Импорт цен происходит независимо от остального импорта и может использоваться отдельно. Также есть возможность обновлять цены только у тех товаров, которые были обновлены за определенный период.

Остатки​

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

Для больших каталогов (более 5000 позиций) рекомендуется использовать режим Быстрые остатки.

Товары​

Модуль умеет работать с товарами в разных конфигурациях, к примеру:

  • Может обменивать только существующие товары (не создавать новые)
  • Может импортировать товары по фильтру

На стороне МоегоСклада существует несколько сущностей товаров:

Модуль умеет работать со всеми этими сущностями и выгружать их по отдельности.

Стандартные поля​

Модуль умеет обменивать большинство стандартных полей товара МС.

Список передаваемых стандартных полей

Свойства​

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

Типы поддерживаемых свойств

Картинки / файлы​

Модуль умеет выгружать все картинки из товара МоегоСклада и загружать их в галерею товара на сайте.