Как подключить МойСклад

Для подключения МойСклад к вашему мини-приложению вам понадобится API-токен.

Шаг 1: Получите API-токен

1. Войдите в МойСклад
2. Нажмите на иконку пользователя в правом верхнем углу → выберите Настройки
3. В левом меню найдите раздел Обмен данными и нажмите Токены
4. Нажмите + Токен
5. Скопируйте полученный токен

Внимание

Токен отображается только один раз. Сохраните его в надёжном месте. При создании нового токена предыдущий перестаёт работать — все подключённые интеграции, использующие старый токен, необходимо будет обновить.

Шаг 2: Вставьте токен и подключитесь

1. Откройте настройки вашего приложения
2. Перейдите во вкладку МойСклад
3. Вставьте API-токен в поле «Токен доступа»
4. Нажмите Подключить МойСклад — откроется окно настройки

К сведению

Синхронизация запускается автоматически после сохранения настроек и затем выполняется периодически.

Шаг 3: Выберите организацию и контрагента

В модальном окне выберите:

Организация — ваше юридическое лицо в МойСклад. Используется при создании заказов.

Контрагент для заказов — контрагент, от имени которого создаются заказы покупателей в МойСклад при оформлении в мини-приложении.

Шаг 4: Выберите склад (необязательно)

В том же окне есть поле Склад. Оно важно, если у вас несколько складов в МойСклад:

• выберите склад — остатки товаров в мини-приложении берутся именно с него;
• оставьте пустым — остатки суммируются по всем складам.

Список складов подгружается автоматически при подключении МойСклад.

Шаг 5: Настройте состояния заказа (необязательно)

В разделе Состояния заказа можно сопоставить статусы заказа из мини-приложения с этапами в МойСклад:

Статус в мини-приложении	Этап в МойСклад
Оплачен	Выберите нужное состояние
Отменён	Выберите нужное состояние
Готов к выдаче	Выберите нужное состояние
В доставке	Выберите нужное состояние
Завершён	Выберите нужное состояние

Если оставить поле пустым («— не синхронизировать —»), смена этого статуса не будет передаваться в МойСклад.

Нажмите Сохранить — окно закроется, на вкладке появится карточка подключённой интеграции.

Изменение настроек

На вкладке МойСклад нажмите Изменить на карточке интеграции — откроется то же окно настройки.

Решение «Лояльность» в каталоге МойСклад

Чтобы бонусы работали в кассе МойСклад, дополнительно установите решение из каталога решений МойСклад — это отдельная установка, не через токен на этой вкладке.

Внимание

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

Пошагово: Решение «Лояльность» в МойСклад.

Отключение

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

Отключение интеграции здесь не удаляет решение «Лояльность» из каталога МойСклад — его нужно удалить отдельно.

Возможные ошибки

Ошибка	Решение
Неверный токен	Проверьте, что токен скопирован полностью, без пробелов
Нет доступа к API	Убедитесь, что у пользователя МойСклад включён доступ к API
Товары не появляются	Подождите несколько минут и обновите страницу
Лимит документов	На вашем тарифе МойСклад ограничено количество документов — каталог грузится, но заказы не создаются. Увеличьте тариф в МойСклад