SunBlazeВойти
Торговля

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

Подключение Мой Склад: токен API, автоподбор организации и склада, синхронизация каталога, цен и остатков, отправка заказов.

Открыть в кабинете →← К обзору

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

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

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

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

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

  1. Каталог
    Товары из ассортимента Мой Склад подтягиваются в номенклатуру приложения. Повторные синхронизации обновляют уже связанные позиции.
  2. Цены
    Розничные (или выбранный тип) цены из Мой Склад записываются в каталог магазина.
  3. Остатки
    Количество на выбранном складе отображается покупателю в магазине. Локальное списание при заказе отключается — остатки ведутся в Мой Склад и обновляются синхронизацией.
  4. Заказы
    После создания или оплаты заказа (настраивается) в Мой Склад создаётся заказ покупателя с контрагентом. Повторная отправка того же заказа не создаёт дубликат.

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

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

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

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

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

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

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

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

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

Удалите настройки Мой Склад на странице интеграций (или снимите активность, если достаточно временно остановить обмен). После удаления приложение возвращается к локальному учёту остатков: stock_source=local и снова включается списание при заказе.

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

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

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

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

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

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

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

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

Торговля • ЗаказыНоменклатура • ПозицииОткрыть интеграции в кабинете