Торговля • Интеграции (Мой Склад)

Подключение МойСклада («Товары → Загрузка товаров» → МойСклад; в прежнем меню — «Торговля → Интеграции») связывает учётную систему (ERP) к вашему приложению. Сейчас в каталоге доступен сервис «Мой Склад».

Интеграция опциональна: пока настройки не сохранены со статусом «Активно», магазин работает как раньше — локальный каталог, цены и остатки. После активации Мой Склад становится источником номенклатуры, цен и остатков, а заказы из магазина отправляются в Мой Склад.

Перед настройкой выберите нужное приложение в шапке кабинета. У вас должно быть право управлять интеграциями торговли (владелец приложения или роль с соответствующим доступом).

Что даёт интеграция

После подключения Sunblaze и Мой Склад работают так:

1. Каталог
   Товары и услуги из Мой Склад подтягиваются в номенклатуру приложения: название, артикул, описание, вес, объём, группа (из папки Мой Склад) и изображения. Повторные синхронизации пишут только изменения. Товар, который уже заведён в кабинете с тем же артикулом, связывается, а не дублируется. Архивные и удалённые в Мой Склад товары скрываются в магазине, возвращённые из архива — снова показываются.
2. Цены
   Цена выбранного типа (обычно «Цена продажи») становится ценой в магазине. Товар с нулевой ценой этого типа или с ценой не в рублях скрывается, пока цена не появится. Ставка НДС переносится, только если включить «Брать ставку НДС из Мой Склад».
3. Остатки
   Покупатель видит остаток выбранного склада за вычетом резерва (склад-группа — вместе с вложенными складами) или сумму всех складов. Проданный до нуля товар получает остаток 0. Заказ уменьшает остаток в магазине сразу, и синхронизация не возвращает эти единицы, пока заказа нет в Мой Склад (оплаченный или подтверждённый — до 30 дней, неоплаченный — сутки: брошенная корзина не держит товар долго), — последнюю единицу не продадут дважды. Остаток, который Мой Склад пересчитывает, обновится при следующей синхронизации. Услуги продаются без ограничения остатка.
4. Заказы
   Заказ уходит в Мой Склад как заказ покупателя: с контрагентом (физлицо), ценами со скидками, доставкой отдельной позицией и резервом товара на складе. Сумма документа равна сумме, которую платит покупатель. Отмена заказа в магазине снимает документ с проведения и освобождает резерв. Повторная отправка не создаёт дубликат.

Подготовка в Мой Склад

Перед подключением в личном кабинете Мой Склад подготовьте доступ и учётные сущности.

1. Токен API
   В Мой Склад откройте настройки сотрудника и создайте токен доступа к JSON API (API 1.2). У сотрудника должны быть права на товары, остатки, заказы покупателей, контрагентов и услуги. Токен хранится в зашифрованном виде и в форме больше не показывается целиком. Мой Склад ограничивает число запросов по токену пользователя, поэтому большой каталог синхронизируется за несколько минут.
2. Организация, склад и тип цены
   Убедитесь, что в аккаунте есть организация, склад с остатками и нужный тип цены продажи. В кабинете их выбирают из списков после «Автоподбора» — без них интеграцию нельзя включить.
3. Ассортимент
   Товары, которые должны появиться в магазине, должны быть в ассортименте Мой Склад. Модификации (размер, цвет) и комплекты не переносятся: товар с модификациями продаётся целиком, его остаток — сумма модификаций, а конкретную модификацию менеджер уточняет в заказе Мой Склад.

Пошаговое подключение в кабинете

1. Откройте «Товары → Загрузка товаров»
   Выберите источник «МойСклад» — откроется страница интеграций; в списке сервисов выберите «Мой Склад» и нажмите «Настроить» (или откройте строку).
2. Вставьте токен доступа API
   Поле «Токен доступа API». Токен можно проверить кнопкой «Проверить» — кабинет обратится к Мой Склад без сохранения настроек.
3. Автоподбор параметров
   Нажмите «Автоподбор»: кабинет загрузит из Мой Склад организации, склады, типы цен и статусы заказов. Выберите нужные в списках; единственную организацию и «Цену продажи» кабинет выберет сам.
4. Настройте синхронизацию и заказы
   «Автосинхронизация» — периодическое обновление каталога, цен и остатков; интервал не меньше 5 минут. Раз в сутки выполняется полная сверка: архивные и удалённые в Мой Склад товары скрываются. «Отправка заказа»: «on_paid» — после оплаты или когда заказ переходит в «В работе» и дальше — менеджером или автоматически при создании отправления с наложенным платежом (так уходят заказы с постоплатой; «Принят» — статус нового заказа с витрины, он заказ не отправляет); «on_create» — сразу после оформления. «Резервировать товар» — резерв на складе Мой Склад сразу при передаче заказа. «Статус отменённого заказа» — какой статус получает заказ в Мой Склад при отмене в магазине.
5. Сохраните со статусом «Активно»
   После сохранения модуль «Торговля» переключается на остатки из Мой Склад и включает количественный учёт. Прежние настройки запоминаются: при отключении интеграции они вернутся. Заказы, оформленные до включения, сами не отправляются — при необходимости отправьте их из карточки заказа. В полях организации, склада и типа цены — только значения из списков «Автоподбора»: название, введённое вручную, не сохранится.
6. Запустите первую синхронизацию
   Кнопка «Синхронизировать» в настройках или в меню сервиса. Прогресс и итоги (сколько товаров создано, обновлено, скрыто, сколько остатков обнулено) показываются в окне и в истории синхронизаций на странице интеграций.

Повседневная работа

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

1. Изменения в каталоге
   Новые товары, цены и остатки заводите в Мой Склад, затем дождитесь автосинхронизации или нажмите «Синхронизировать». Название, артикул и цену в кабинете не правьте — синхронизация перепишет их данными Мой Склад. Если цена Мой Склад стала ниже акционной или минимальной цены из кабинета, такая цена снимается — это видно в истории синхронизаций. Скрыть товар в магазине можно и в кабинете: синхронизация его не вернёт, пока товар не изменится в Мой Склад (архив или возврат из архива); товар, скрытый до подключения, при первой синхронизации тоже остаётся скрытым. Удалённый в кабинете товар синхронизация не восстанавливает. Позиции, данные которых Sunblaze не принял, перечислены в истории синхронизаций.
2. Заказы покупателей
   Оформление в мини-приложении не меняется. В карточке заказа видно, передан ли он в Мой Склад, со ссылкой на документ. Если передача не удалась (например, в заказе товар, которого нет в Мой Склад), там же причина и время следующей автоматической попытки; кнопка «Отправить снова» отправляет заказ сразу, дубликат не создаётся.
3. Частичные ошибки синхронизации
   Статус «Завершено с ошибками» означает, что связь с Мой Склад была, но часть строк не прочиталась или не записалась в магазин. Следующая синхронизация повторит их автоматически. Итоги и причины — в истории синхронизаций.
4. Ошибки подключения
   При сбое проверки, синхронизации или отправки заказа откройте «Подробнее» — там текст ответа Мой Склад. Частые причины: неверный или отозванный токен, недостаточно прав у сотрудника, недоступность API, слишком частые запросы.

Отключение интеграции

Удалите настройки Мой Склад на странице интеграций или смените статус на «Приостановлено» / «Отключено». В обоих случаях настройки модуля «Торговля» возвращаются к тем, что были до подключения: источник остатков, списание при заказе и количественный учёт. Настройку, которую вы меняли сами, пока интеграция работала, кабинет не трогает. Если интеграцию подключили до 24.09.2026, прежнее значение количественного учёта неизвестно: он останется включённым — выключите его в настройках модуля «Торговля», если он не нужен. Синхронизация выключенной интеграции не запускается.

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

Важные ограничения

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

Не переносятся: модификации и комплекты, штрихкоды (используются только для связи с уже заведёнными товарами), единицы измерения, минимальная цена, признак маркировки. Изображения загружаются для товаров, у которых в кабинете ещё нет фото, — до 5 на товар и порциями по 40 товаров за синхронизацию.

Синхронизация идёт по JSON API без файлового обмена (CommerceML в этом сценарии не используется).

Одновременно выполняется не больше одного задания синхронизации на сервис; при уже идущей синхронизации повторный запуск будет отклонён — дождитесь завершения.

Если две витрины Sunblaze передают заказы в один аккаунт Мой Склад, выберите нумерацию Мой Склад («Номер заказа в Мой Склад» = moysklad), чтобы номера SB-… не совпадали.

Токен доступа не нужно копировать в публичные поля и чаты: в интерфейсе он маскируется, на сервере хранится в защищённом виде.

Связанные разделы

Для полной картины торговли после подключения ERP обычно смотрят номенклатуру, заказы и настройки модуля торговли.