Подключение МойСклад: цены, остатки и каталог в обе стороны
Интеграция с МойСклад закрывает главный вопрос: «посчитали цены — а дальше?». После каждой переоценки PriceBridge сам передаёт цены и остатки в ваш МойСклад, а заодно умеет синхронизировать поля карточек, забирать остатки вашего склада из МойСклад обратно и — для нового клиента — затянуть весь каталог из МойСклад одной кнопкой. В этой статье настроим всё по шагам.
Шаг 1. Получите API-токен в МойСклад
В личном кабинете МойСклад откройте Настройки → Обмен данными → Токены и создайте новый токен. Это строка-ключ, по которой PriceBridge будет обращаться к вашему аккаунту. Токен даёт доступ к данным — не публикуйте его и не пересылайте в открытых чатах.
Шаг 2. Подключите интеграцию
В PriceBridge откройте Ещё → Настройки → вкладка МойСклад и раскройте карточку Интеграция с МойСклад. Внизу карточки — блок Настройки подключения:
- API токен — вставьте токен из шага 1. После сохранения интерфейс будет показывать только маску (последние символы) — целиком токен никогда не отображается. Чтобы заменить токен, просто введите новый; пустое поле означает «оставить прежний».
- Аккаунт МойСклад — имя вашего аккаунта (субдомен из адреса личного кабинета).
- Склад-источник остатков (source_store_id) и Склад назначения (target_store_id) — UUID складов в МойСклад: с первого система читает ваши остатки, во второй пишет. UUID можно взять из адресной строки, открыв склад в МойСклад. Если работаете с одним складом — укажите его в обоих полях.
- Что считать артикулом карточки из МойСклад — «Артикул, а если он пуст — Код» (по умолчанию), «Код» или «Только артикул». Код в МойСклад есть у каждой карточки, он ставится автоматически; артикул заполняется вручную и бывает пустым. Если ваш учёт живёт на кодах, выберите «Код», чтобы все карточки в PriceBridge были опознаны одинаково. Смена выбора применяется при следующем переносе (шаг 4) и не меняет ничего в самом МойСклад.
- Поставьте галочку Включить синхронизацию с МойСклад — это главный выключатель всей интеграции — и нажмите Сохранить.
Шаг 3. Выберите, какие поля выгружать
В карточке МойСклад — что выгружать галочками отмечается, какие поля карточек PriceBridge будет обновлять в МойСклад: название, цена, остаток, закупочная цена, описание, вес, ТНВЭД, штрихкод. Снимете галочку — поле перестанет приходить в карточки при следующем обновлении.
- Артикул синхронизируется всегда — это ключ привязки. При этом МойСклад идентифицирует товар по внутреннему UUID, поэтому артикул в главном каталоге можно спокойно править: связь не потеряется, новое значение просто уедет в МС как обычное поле.
- Описание. В МойСклад одно поле «Описание» — переключателем Источник описания для МС выберите, что туда выгружать: полное или краткое описание из главного каталога.
- Штрихкод уезжает в МС как EAN-13.
- Ограничения: габариты МойСклад отдельным полем не принимает (в МС есть только объём), а картинка применяется только при первичном создании товара — последующие смены фото в главном каталоге в МС не переносятся.
Шаг 4. Bootstrap: свяжите каталоги между собой
Если каталог в МойСклад уже существует, системе нужно один раз сопоставить товары — для этого есть блок Привязка UUID МойСклад. Bootstrap скачивает каталог из МС и сохраняет UUID товаров по совпадению артикула. Какое поле МойСклад считать артикулом («Артикул», «Код» или «Артикул, а если пуст — Код»), задаётся в настройках выше. После этого синхронизация не зависит от изменений SKU: уже связанные карточки при повторном переносе опознаются по идентификатору, а не по артикулу.
- Если хотите заодно затянуть в PriceBridge товары, которых здесь ещё нет, — отметьте чекбокс «Также импортировать в каталог товары из МС, которых ещё нет в PriceBridge». Карточки создаются сразу с привязкой и обратно в МС не дублируются.
- Нажмите Запустить bootstrap (кнопка доступна при включённой интеграции). Статус обновляется каждые несколько секунд.
- По завершении смотрите метрики: Совпало (привязано по артикулу), Не найдено в МС, Неоднозначно (один артикул — несколько товаров МС, такие пары нужно разобрать руками), Импортировано в главный каталог.
Шаг 5. Быстрые действия и мониторинг
В верхней части карточки интеграции — блок Быстрые действия:
- Передать цены в МС и Передать остатки в МС — поставить в очередь немедленную выгрузку всех цен или остатков. В обычной жизни это не нужно (после переоценки всё уходит само) — кнопки пригодятся после первичной настройки или чтобы форсировать обновление.
- Полный ресинк остатков — полная сверка остатков с нуля; статус показывается рядом («В очереди», «Выполняется…», «✓ Выполнен»).
Выше, в карточке Мониторинг синхронизации, видно фактическое состояние: когда была последняя выгрузка, сколько задач в очереди, есть ли ошибки. Раздел Статус выгрузки цен показывает таблицу ошибок с колонками «Артикул» и «Причина ошибки» — если какой-то товар не доехал, причина будет здесь. А Лог операций синхронизации хранит журнал по типам операций: цены, создание товаров, остатки, ресинк.
Остатки вашего склада из МойСклад
Интеграция работает и в обратную сторону: блок Локальный склад (остатки) загружает остатки из МойСклад в отдельное поле товаров главного каталога («Мой склад»). Так вы видите в каталоге и остатки поставщиков, и собственный склад, а разделы «Закупки» и алерты «На исходе» получают реальные цифры.
Кнопка Синхронизировать локальный склад запускает загрузку; в результате видно, сколько строк пришло из МС, сколько SKU сопоставлено с главным каталогом и сколько — нет. «Не сопоставлено» обычно означает расхождение артикулов — его лечит bootstrap из шага 4.
Дополнительные цены → типы цен МойСклад
Если вы ведёте в PriceBridge дополнительные цены (вкладка Доп. цены в Настройках — например, оптовую или B2B-цену), блок Доп. цены → типы цен МойСклад позволяет выгружать каждую из них в свой тип цены МС — отдельной ценой рядом с основной. Вариант «Не выгружать» оставляет цену только для фидов.
Если вы пришли из приложения МойСклад
PriceBridge доступен и как приложение внутри МойСклад. В этом случае связка настраивается ещё проще: приложение даёт одноразовую ссылку подтверждения — открыв её, вы увидите вопрос «Связать аккаунт МойСклад … с вашим аккаунтом PriceBridge …?» и кнопку Подтвердить связку. Токен вводить не нужно — доступ выдаётся самим приложением.
Частые вопросы
Кнопки «Передать цены/остатки» серые
Не включён главный выключатель — галочка Включить синхронизацию с МойСклад в настройках подключения (шаг 2).
Цены посчитались, но в МойСклад не появились
- Подождите пару минут: выгрузка идёт через очередь.
- Откройте Мониторинг синхронизации: если статус «Есть ошибки» — смотрите таблицу в «Статус выгрузки цен», там причина по каждому артикулу.
- Проверьте, что товар привязан к МС (был в bootstrap или создан через синхронизацию).
Я сменил артикул товара в главном каталоге — связь не сломается?
Нет. МойСклад идентифицирует товары по UUID, артикул — обычное синхронизируемое поле. Именно поэтому стоит один раз выполнить bootstrap: после него SKU можно менять свободно.
Поменялся токен (отозвали/пересоздали)
Введите новый токен в поле API токен и сохраните. Старое значение целиком не показывается — это нормально, ориентируйтесь на маску.
Фото товара обновил, а в МойСклад старое
Так задумано: картинка передаётся только при первичном создании товара в МС. Обновлять фото существующих товаров нужно в самом МойСклад.