--- title: "МойСклад: Синхронизация товаров по API" url: "https://despi.ru/modules/rbs-moyskladstocks" description: "Импорт товаров, модификаций, услуг, комплектов, групп, цен, остатков и скидок из МойСклад на сайт 1С-Битрикс по JSON API 1.2. Массовый обмен агентами по расписанию и моментальное обновление по веб-хукам." updated: "2026-10-01" --- # МойСклад: Синхронизация товаров по API > Импорт товаров, модификаций, услуг, комплектов, групп, цен, остатков и скидок из МойСклад на сайт 1С-Битрикс по JSON API 1.2. Массовый обмен агентами по расписанию и моментальное обновление по веб-хукам. - Категория: Интеграции - Работает с: МойСклад, 1С-Битрикс, Интернет-магазин, Остатки и цены, Интеграция - Цена: 14 990 руб. - Демо-период: 14 дней - Установок: более 1000 - HTML-версия: https://despi.ru/modules/rbs-moyskladstocks - Инструкция по установке: https://despi.ru/modules/rbs-moyskladstocks#module-install - Маркетплейс: https://marketplace.1c-bitrix.ru/solutions/rbs.moyskladstocks/ - Документация: https://docs.despi.ru/rbs-moyskladstocks/ ## Описание # МойСклад: Синхронизация товаров по API — импорт товаров, цен и остатков из МойСклад в 1С-Битрикс Модуль подтягивает каталог из МойСклад на сайт 1С-Битрикс: товары, модификации, услуги, комплекты, структуру групп, цены, остатки по складам и скидки. Товаровед ведёт номенклатуру и цены в учёте — сайт сам обновляется, без выгрузки файлов и ручного переноса. Работает напрямую через JSON API 1.2 МойСклад. Обмен разбит на независимые части: остатки, цены, товары, группы и скидки включаются и настраиваются отдельно, у каждой — свой агент. Можно забирать из учёта всё сразу, а можно только цены и остатки к каталогу, который ведётся на сайте вручную. Документация: https://docs.despi.ru/rbs-moyskladstocks/ ## Что импортируется - **Товары, модификации, услуги и комплекты** — каждая сущность МойСклад со своими настройками полей, свойств, фильтров и правил создания. - **Остатки по складам** — с соответствием складов Битрикс и МойСклад, поддержкой вложенных складов и выбором типа остатка: складской, доступный (с учётом резерва и ожидания) или без ожидания. - **Цены** — по таблице соответствия типов цен и валют. Одному типу цены МойСклад можно сопоставить несколько типов цен на сайте. - **Группы** — структура папок МойСклад переносится в разделы инфоблока с сохранением вложенности. - **Скидки** типа «Специальная цена» — как правила работы с корзиной Битрикс. - **Стандартные поля**: наименование, артикул, штрихкоды, страна, вес, объём, НДС, единица измерения и другие — и дополнительные поля, созданные в МойСклад. - **Картинки** — основная попадает в анонс и детальную, остальные в множественное свойство типа «Файл». ## Как это выглядит в работе Каждый тип данных обменивается своим агентом: он запускается по расписанию и за шаг обрабатывает заданное количество элементов — весь каталог или только изменённые позиции. Пример из практики: при запуске раз в минуту и 50 товарах за шаг каталог из 1000 позиций обновляется примерно за 20 минут; в большинстве случаев каталог удаётся держать актуальным с отставанием 5–10 минут. Для точечных правок есть **веб-хуки**: сохранили карточку товара в МойСклад — модуль сразу обновил его на сайте. Поддерживаются создание, изменение и удаление товаров, модификаций, услуг, комплектов и групп. Массовые изменения веб-хуки не обрабатывают — их подхватывают агенты. Товары сопоставляются по **внешнему коду**, поэтому модуль можно подключить к уже наполненному каталогу: совпавшие товары обновятся, а не задублируются. ## Гибкая настройка импорта - **Только существующие товары.** Модуль может не создавать новые позиции, а обновлять те, что уже есть на сайте, — удобно, когда каталог ведётся вручную, а из учёта нужны только цены и остатки. - **Разные правила для новых и существующих.** При создании товара передаются все поля, при обновлении — только нужные: например, цены и остатки без описания и картинок. - **Фильтры.** Импорт только из выбранной группы МойСклад или только товаров с отмеченным доп. полем-флажком. Остатки можно обновлять у отфильтрованной части каталога. - **Управление активностью.** Товар скрывается на сайте по архивности в МойСклад, по выходу из группы, по флажку — или полностью управляется отдельным полем «Активность». - **Свойства всех основных типов**: строка, число, список, файл, привязка к элементам инфоблока, HTML/текст, дата, справочник (highload-блок). - **Комплекты** — как простые товары или как полноценные комплекты Битрикс (в зависимости от редакции). - **Дубликаты по внешнему коду** — выбираете стратегию: обновлять элемент с наименьшим или наибольшим ID, все дубли или пропускать. - **Профили обмена** — несколько аккаунтов МойСклад, разные инфоблоки, многосайтовость. ## Большие каталоги Для каталогов от 5 000 позиций или обмена с десятком складов есть режим **«Быстрые остатки»**: раз в сутки по расписанию идёт полная синхронизация, а в течение дня загружаются только изменившиеся остатки. Нагрузка на сервер заметно ниже, а отчёт об остатках формируется стабильно. Запросы к API экономят таблицы кеша на highload-блоках, при упоре в лимиты МойСклад модуль повторяет запрос с настраиваемой задержкой. Агенты можно запускать штатно или отдельным скриптом модуля на cron — чтобы обмен шёл в своём процессе. ## Диагностика - **Мониторинг** показывает все процессы импорта и обновляется каждые 10 секунд: включён ли импорт, настроен ли агент, запущен ли он по факту, есть ли ошибки и предупреждения. - **Логи** хранятся до 15 дней, ищутся по тексту и фильтруются по ошибкам и предупреждениям. - **Инструменты**: анализ дублей в инфоблоке по внешнему коду с выгрузкой в CSV и сопоставление товаров МойСклад и сайта. ## Вопросы и ответы ### Меняет ли модуль что-то в МойСклад? Нет. Обмен односторонний: модуль только импортирует данные из МойСклад на сайт 1С-Битрикс и ничего не создаёт и не изменяет в учётной системе. ### Можно ли подключить модуль к уже наполненному каталогу на сайте? Да. Товары сопоставляются по внешнему коду: если коды товаров на сайте и в МойСклад совпадают, модуль обновит существующие позиции, а не создаст новые. После авторизации один раз заполните таблицу внешних кодов. Важно, чтобы на сайте не было дублей по внешнему коду. ### Как быстро изменения из МойСклад попадают на сайт? Зависит от частоты запуска агента, числа элементов за шаг и режима (полный каталог или только изменённые). Например, при запуске раз в минуту и 50 товарах за шаг каталог из 1000 позиций обновится примерно за 20 минут. Если настроены веб-хуки, товар обновляется сразу после сохранения карточки в МойСклад. ### Почему массовое изменение товаров в МойСклад не пришло сразу? Веб-хуки рассчитаны на точечное редактирование — когда вы нажимаете «Сохранить» в карточке товара. Массовые изменения веб-хуками не обрабатываются: их подхватывают агенты модуля при очередном запуске. ### Можно ли импортировать только цены и остатки, не трогая описания и картинки? Да. Цены и остатки обмениваются независимо от импорта товаров и могут работать отдельно. Кроме того, модуль умеет работать только с существующими товарами (не создавать новые), а для новых и существующих товаров можно задать разные наборы полей. ### У нас большой каталог. Справится ли модуль с остатками? Для каталогов больше 5 000 позиций или обмена более чем с 10 складами есть режим «Быстрые остатки». Он раз в сутки по расписанию делает полную синхронизацию, а в течение дня загружает только изменившиеся остатки — это заметно снижает нагрузку на сервер. Одновременно работает только один режим: обычные или быстрые остатки. ### Какие сущности МойСклад поддерживаются? Товары, модификации, услуги и комплекты — каждая настраивается отдельно, плюс группы (разделы каталога), цены, остатки и скидки типа «Специальная цена». Остатки импортируются для товаров, модификаций и комплектов; у услуг остатков в МойСклад нет. ### Как импортируются комплекты? На выбор: как простой товар или как комплект 1С-Битрикс. Второй вариант доступен на редакциях «Бизнес» и «Интернет-магазин + CRM» (включая коробку Битрикс24); на «Малом бизнесе» комплекты передаются только как простые товары. Если комплект импортируется как простой товар, модуль может рассчитать его остаток по составу. ### Можно ли выгружать на сайт не весь каталог? Да. Для товаров, модификаций, комплектов и услуг есть фильтр: только из выбранной группы МойСклад или только позиции с отмеченным (или снятым) дополнительным полем-флажком. Остатки тоже можно обновлять только у отфильтрованных товаров. ### Как управлять тем, какие товары видны на сайте? Есть четыре механизма: по архивности товара в МойСклад, по принадлежности к группе, по дополнительному полю-флажку и через отдельное поле «Активность». Первые три работают вместе по логике «И». Поле «Активность» — приоритетный режим: при его выборе остальные правила отключаются. У модификаций работает только деактивация по архивности. ### Какие свойства товаров переносятся? Стандартные поля МойСклад (наименование, артикул, штрихкоды, страна, вес, объём, НДС, единица измерения и другие) и пользовательские дополнительные поля. Поддерживаемые типы свойств Битрикс: строка, число, список, файл, привязка к элементам инфоблока, HTML/текст, дата, справочник (highload-блок). Картинки загружаются все: основная — в анонс и детальную, остальные — в множественное свойство «Файл». ### Можно ли подключить несколько аккаунтов МойСклад или импортировать в разные инфоблоки? Да, для этого есть профили обмена. У каждого профиля свои настройки — в админке это выглядит как несколько установленных модулей. Профили позволяют работать с несколькими аккаунтами МойСклад, импортировать один аккаунт в разные инфоблоки и использовать многосайтовость. Функция включается отдельно, инструкция есть в документации. ### Что будет при упоре в лимиты API МойСклад? Модуль повторит запрос: количество повторных попыток (до 10) и задержка между ними (до 2 секунд) настраиваются. Чтобы реже обращаться к API, модуль использует таблицы кеша на highload-блоках. ### Как понять, что обмен работает, и найти причину, если нет? Откройте раздел «Диагностика». Мониторинг показывает каждый процесс импорта и раз в 10 секунд обновляется сам: включён ли импорт, настроен ли агент, запущен ли он по факту, есть ли ошибки. Логи хранятся до 15 дней и фильтруются по ошибкам и предупреждениям. Частые причины: агенты не переведены на cron, не включена галочка «Включить обмен» или импорт нужной сущности. ### Что делать, если на сайте есть дубли по внешнему коду? В настройках выбирается стратегия: обновлять элемент с наименьшим ID, с наибольшим ID, все дубликаты или пропускать обработку. Найти дубли помогает инструмент анализа инфоблока по внешнему коду с выгрузкой в CSV. ## Требования - Редакция 1С-Битрикс: «Малый бизнес», «Бизнес», «Интернет-магазин + CRM» или коробочный Битрикс24. - PHP выше 7.4 (включая 8.x), 1С-Битрикс выше 20.0.0. - Платный тариф МойСклад — для веб-хуков и дополнительных полей; подключение по токену или логину и паролю. - Агенты 1С-Битрикс, переведённые на cron. - Импорт комплектов как комплектов Битрикс — на редакциях «Бизнес» и «Интернет-магазин + CRM»; на «Малом бизнесе» — только как простые товары. ## Что модуль не делает - Не меняет и не создаёт ничего в МойСклад — только импортирует данные на сайт. - Не обменивает заказы и контрагентов — это задачи других модулей. - Не обрабатывает массовые изменения через веб-хуки — их доводят агенты по расписанию. - Не импортирует остатки услуг — в МойСклад их нет. ## Требования - Агент или cron: нужен - Редакция 1С-Битрикс: Малый бизнес, Бизнес, Интернет-магазин + CRM, коробочный Битрикс24 - Версии PHP и 1С-Битрикс: PHP выше 7.4 (включая 8.x), 1С-Битрикс выше 20.0.0 - Тариф МойСклад: Платный (веб-хуки и дополнительные поля) - Агенты 1С-Битрикс на cron: да - Импорт комплектов как комплектов Битрикс: Редакция «Бизнес» или «Интернет-магазин + CRM» (на «Малом бизнесе» — как простые товары) ## Частые вопросы ### Меняет ли модуль что-то в МойСклад? Нет. Обмен односторонний: модуль только импортирует данные из МойСклад на сайт 1С-Битрикс и ничего не создаёт и не изменяет в учётной системе. ### Можно ли подключить модуль к уже наполненному каталогу на сайте? Да. Товары сопоставляются по внешнему коду: если коды товаров на сайте и в МойСклад совпадают, модуль обновит существующие позиции, а не создаст новые. После авторизации один раз заполните таблицу внешних кодов. Важно, чтобы на сайте не было дублей по внешнему коду. ### Как быстро изменения из МойСклад попадают на сайт? Зависит от частоты запуска агента, числа элементов за шаг и режима (полный каталог или только изменённые). Например, при запуске раз в минуту и 50 товарах за шаг каталог из 1000 позиций обновится примерно за 20 минут. Если настроены веб-хуки, товар обновляется сразу после сохранения карточки в МойСклад. ### Почему массовое изменение товаров в МойСклад не пришло сразу? Веб-хуки рассчитаны на точечное редактирование — когда вы нажимаете «Сохранить» в карточке товара. Массовые изменения веб-хуками не обрабатываются: их подхватывают агенты модуля при очередном запуске. ### Можно ли импортировать только цены и остатки, не трогая описания и картинки? Да. Цены и остатки обмениваются независимо от импорта товаров и могут работать отдельно. Кроме того, модуль умеет работать только с существующими товарами (не создавать новые), а для новых и существующих товаров можно задать разные наборы полей. ### У нас большой каталог. Справится ли модуль с остатками? Для каталогов больше 5 000 позиций или обмена более чем с 10 складами есть режим «Быстрые остатки». Он раз в сутки по расписанию делает полную синхронизацию, а в течение дня загружает только изменившиеся остатки — это заметно снижает нагрузку на сервер. Одновременно работает только один режим: обычные или быстрые остатки. ### Какие сущности МойСклад поддерживаются? Товары, модификации, услуги и комплекты — каждая настраивается отдельно, плюс группы (разделы каталога), цены, остатки и скидки типа «Специальная цена». Остатки импортируются для товаров, модификаций и комплектов; у услуг остатков в МойСклад нет. ### Как импортируются комплекты? На выбор: как простой товар или как комплект 1С-Битрикс. Второй вариант доступен на редакциях «Бизнес» и «Интернет-магазин + CRM» (включая коробку Битрикс24); на «Малом бизнесе» комплекты передаются только как простые товары. Если комплект импортируется как простой товар, модуль может рассчитать его остаток по составу. ### Можно ли выгружать на сайт не весь каталог? Да. Для товаров, модификаций, комплектов и услуг есть фильтр: только из выбранной группы МойСклад или только позиции с отмеченным (или снятым) дополнительным полем-флажком. Остатки тоже можно обновлять только у отфильтрованных товаров. ### Как управлять тем, какие товары видны на сайте? Есть четыре механизма: по архивности товара в МойСклад, по принадлежности к группе, по дополнительному полю-флажку и через отдельное поле «Активность». Первые три работают вместе по логике «И». Поле «Активность» — приоритетный режим: при его выборе остальные правила отключаются. У модификаций работает только деактивация по архивности. ### Какие свойства товаров переносятся? Стандартные поля МойСклад (наименование, артикул, штрихкоды, страна, вес, объём, НДС, единица измерения и другие) и пользовательские дополнительные поля. Поддерживаемые типы свойств Битрикс: строка, число, список, файл, привязка к элементам инфоблока, HTML/текст, дата, справочник (highload-блок). Картинки загружаются все: основная — в анонс и детальную, остальные — в множественное свойство «Файл». ### Можно ли подключить несколько аккаунтов МойСклад или импортировать в разные инфоблоки? Да, для этого есть профили обмена. У каждого профиля свои настройки — в админке это выглядит как несколько установленных модулей. Профили позволяют работать с несколькими аккаунтами МойСклад, импортировать один аккаунт в разные инфоблоки и использовать многосайтовость. Функция включается отдельно, инструкция есть в документации. ### Что будет при упоре в лимиты API МойСклад? Модуль повторит запрос: количество повторных попыток (до 10) и задержка между ними (до 2 секунд) настраиваются. Чтобы реже обращаться к API, модуль использует таблицы кеша на highload-блоках. ### Как понять, что обмен работает, и найти причину, если нет? Откройте раздел «Диагностика». Мониторинг показывает каждый процесс импорта и раз в 10 секунд обновляется сам: включён ли импорт, настроен ли агент, запущен ли он по факту, есть ли ошибки. Логи хранятся до 15 дней и фильтруются по ошибкам и предупреждениям. Частые причины: агенты не переведены на cron, не включена галочка «Включить обмен» или импорт нужной сущности. ### Что делать, если на сайте есть дубли по внешнему коду? В настройках выбирается стратегия: обновлять элемент с наименьшим ID, с наибольшим ID, все дубликаты или пропускать обработку. Найти дубли помогает инструмент анализа инфоблока по внешнему коду с выгрузкой в CSV.