МойСклад

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

Для чего эта страница#

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

Где найти#

Боковое меню: Настройки → Приложения, затем карточка Moysklad в каталоге (или Настроить в блоке Подключенные).

Кто видит#

Страница доступна сотрудникам с правом «Управлять приложениями и интеграциями». С этим правом сотрудник может подключить и отключить приложение и увидеть токен доступа.

Приложение доступно на всех тарифах. Новые товары из МойСклад учитываются в лимите товаров тарифа.

Обзор страницы#

1. Шапка — название, отметка Установлено, категория, сайт и разработчик. Кнопка Документация ведёт на сайт МойСклад, кнопка Отключить — отключает приложение.
2. Подключения — переключатель между аккаунтами, если подключено несколько.
3. Строка состояния — Подключение активно (или Нет токена доступа), счётчики Товаров связано и Вебхуков.
4. Настройки — семь разделов слева: Подключение, Склад и остатки, Заказы, Отгрузка, Отмена заказа, Импорт и связи, Вебхуки.
5. Панель сохранения — появляется внизу, когда вы изменили склад, создание заказов, статус отгрузки или действие при отмене: Отменить и Сохранить изменения.

Как сделать#

Подключить МойСклад#

1. В МойСклад заведите сотрудника с правами на API (или используйте существующего).
2. В каталоге приложений откройте Moysklad и нажмите Установить.
3. Введите Логин и Пароль этого сотрудника и нажмите Установить.
4. Обновите страницу через несколько секунд: в строке состояния должно быть Подключение активно.

Если осталось Нет токена доступа, логин или пароль не подошли. Отключите приложение и установите его заново с правильными данными.

Выбрать склад#

1. Откройте раздел Склад и остатки и нажмите Обновить список — склады придут из МойСклад.
2. Выберите склад.
3. Нажмите Сохранить изменения внизу страницы.

Загрузить товары из МойСклад#

1. Выберите склад (см. выше), иначе остатки будут суммироваться по всем складам.
2. Откройте Импорт и связи и в плитке Импорт товаров нажмите Импортировать.
3. Импорт идёт в фоне. Обновите страницу позже, чтобы увидеть товары и счётчик Товаров связано.

Связать существующие товары по штрихкоду#

Если товары уже есть в магазине, не импортируйте их заново — свяжите:

1. Проверьте, что у товаров в магазине и в МойСклад заполнены одинаковые штрихкоды.
2. В Импорт и связи нажмите Связать в плитке Связать по штрихкоду. Счётчик Не связано показывает, сколько вариантов со штрихкодом ещё не связано.
3. Остатки связанных товаров обновятся при следующем вебхуке по складским документам.

Включить автоматическое обновление (вебхуки)#

1. Откройте раздел Вебхуки.
2. Отметьте события: Товары (создание, обновление) и складские документы — приёмка, отгрузка, перемещение, списание, оприходование, возвраты.
3. Нажмите Добавить выбранные. В таблице появятся вебхуки с адресами вашего магазина.

Передавать заказы в МойСклад#

1. В разделе Заказы включите Создавать «Заказ покупателя».
2. В разделе Отгрузка выберите Статус для отгрузки — при переходе заказа в этот статус создастся отгрузка и спишет товар со склада.
3. В разделе Отмена заказа выберите Возврат покупателя или Удалить отгрузку.
4. Нажмите Сохранить изменения.

Отключить МойСклад#

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

Как это работает#

• Токен доступа. При установке магазин по логину и паролю получает токен МойСклад. Токен выпускается один раз: смена пароля в МойСклад его не перевыпускает. Если токен перестал работать, переустановите приложение.
• Что приходит при импорте. Название, описание, артикул (или код), первый штрихкод, цена продажи, закупочная цена, фото и остаток выбранного склада. Цена берётся из первого типа цены продажи в карточке МойСклад. Путь папки МойСклад записывается в поле производителя товара — категории магазина из папок не создаются.
• Модификации не загружаются. Каждый товар МойСклад становится товаром с одним вариантом.
• Как связываются товары. Импортированный товар связан с карточкой МойСклад по её внутреннему идентификатору: повторный импорт обновляет тот же товар (название, описание, цены, статус публикации), а не создаёт новый. Товар, который в МойСклад в архиве, в магазине становится черновиком. Кнопка Связать сопоставляет по штрихкоду товары, которые не были импортированы.
• Как часто обновляются данные. Расписания нет. Данные меняются только по вебхукам и по кнопкам. Вебхук по любому складскому документу пересчитывает остатки всех связанных товаров по выбранному складу; цены при этом не меняются. Вебхук по товару заново загружает карточку товара.
• Заказ покупателя создаётся сразу после оформления заказа, если в заказе есть товары, связанные с МойСклад. В него попадают номер заказа, клиент, адрес, позиции МойСклад и комментарий с телефоном, оплатой и доставкой. Контрагент ищется по телефону клиента; если не найден — создаётся новый.
• Отгрузка создаётся один раз на заказ, когда заказ переходит в выбранный статус. Скидка заказа распределяется по позициям. Если склад не выбран, используется первый склад аккаунта.
• Отмена заказа. Если по заказу была отгрузка: Возврат покупателя создаёт возвратный документ рядом с отгрузкой, Удалить отгрузку удаляет её. В обоих случаях товар возвращается на склад. Сам заказ покупателя в МойСклад при отмене не меняется.
• Цены в долларах. Если цена в МойСклад указана в USD, она пересчитывается в сумы по фиксированному курсу, а не по текущему.

Ограничения и важные нюансы#

• Импорт и вебхук по товару не создают товары с нулевым остатком на выбранном складе.
• Если карточку удалили в МойСклад, товар в магазине не удаляется. При выбранном складе его остаток станет нулевым при следующей синхронизации остатков.
• Заказ без телефона клиента в МойСклад не передаётся.
• Ошибки обмена в админке не показываются: кнопки сообщают только, что задача запущена. Если данные не пришли, проверьте статус подключения и вебхуки.
• Без активных вебхуков остатки обновляются только кнопками в разделе Импорт и связи.
• Список складов не запоминается: чтобы увидеть названия складов при следующем визите, снова нажмите Обновить список. Выбранный склад при этом сохранён.
• Когда достигнут лимит товаров тарифа, новые товары не добавляются, а в списке товаров появляется предупреждение.

Частые вопросы#

Изменил пароль сотрудника в МойСклад — нужно ли что-то делать? Нет, пока токен работает. Токен не зависит от пароля. Если статус стал Нет токена доступа или данные перестали приходить, переустановите приложение.

Почему часть товаров не загрузилась? Чаще всего у них нулевой остаток на выбранном складе или достигнут лимит товаров тарифа.

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

Можно ли выбрать другой тип цены? Нет. Используется первый тип цены продажи в карточке товара МойСклад.

Связанные статьи#

• Каталог приложений
• Инвентарь
• Импорт товаров
• Все продажи: список и канбан
• Тарифы и оплата подписки