🔄 Настройка и работа с МойСклад
Интеграция решает две задачи: передавать заказы из магазина в МойСклад и получать остатки товаров из МойСклад в магазин.
🧭 Кто что делает
| Направление | Автоматически | Вручную сотрудником |
|---|---|---|
| Магазин → МойСклад | Создание заказа покупателя с позициями и ценами | Проверка документа, резерв, отгрузка и дальнейшая работа в МойСклад |
| МойСклад → магазин | Доступный остаток по сопоставленным вариантам | Исправление кодов и неоднозначных соответствий |
| Отмена → МойСклад | Допись ОТМЕНЁН в описание уже синхронизированного документа | Проверка и фактическая отмена по правилам учёта |
Шаг 1. Откройте раздел МойСклад
- Войдите в админку:
https://mirkrasok.termitsdigital.ru/app. - В левом меню откройте «МойСклад».
- На странице «Интеграция с МойСклад» посмотрите текущий статус.
🚦 Что означает статус подключения
| Статус | Значение | Действие |
|---|---|---|
| Не настроено | Реквизиты ещё не сохранены | Заполните форму |
| Интеграция отключена | Реквизиты есть, но обмен выключен | Включайте только после проверки причины отключения |
| Реквизиты сохранены | Настройка активна, явной последней ошибки нет | Всё равно проверьте реальный заказ и остаток |
| Требует внимания | Последний заказ, отмена или обновление остатков завершились ошибкой | Прокрутите страницу интеграции и откройте журнал заказов |
| Статус недоступен | Админка не смогла получить состояние интеграции | Обновите страницу; если повторяется — к разработчику |
Статус говорит только о сохранённой настройке и известных ошибках. Он не проверяет, что все товары однозначно сопоставлены и остатки действительно обновились. Пройдите проверку из раздела «✅ Что проверить после первой настройки» ниже.
Шаг 2. Выберите способ входа
В форме доступны две вкладки:
| Вкладка | Поля |
|---|---|
| Токен | «Токен доступа» |
| Логин и пароль | «Логин» и «Пароль» |
- Выберите один способ.
- Заполните все поля выбранного способа.
- Нажмите «Проверить и сохранить».
Если поле пустое, форма показывает «Заполните реквизиты доступа.» Успешные реквизиты сохраняются в зашифрованном виде и повторно целиком не показываются. Успешная проверка сразу активирует подключение.
Шаг 3. Включите или отключите обмен
После сохранения доступен переключатель «Интеграция активна».
При отключении появляется окно «Отключить интеграцию?» с пояснением «Новые заказы и синхронизация остатков не будут передаваться в МойСклад.» Кнопки — «Отмена» и «Отключить».
Отключение приостанавливает и заказы, и остатки. Используйте его при аварии или работах, но помните: несинхронизированные операции придётся контролировать вручную, пока интеграция выключена.
🧾 Как передаётся заказ
SKU — это артикул варианта товара в админке магазина (Медузе). Он задаётся при создании товара (см. «Как добавить товар») и виден в карточке варианта. На SKU завязано всё сопоставление с МойСклад: чтобы товар нашёлся правильно, значение в поле «Код» номенклатуры МойСклад должно совпадать с этим SKU один в один.
После оформления заказ ставится в очередь и передаётся автоматически:
| Данные | Поведение |
|---|---|
| Покупатель | Найти контрагента по email или создать физическое лицо с именем, email и телефоном |
| Позиции | Найти товар МойСклад по коду, совпадающему с SKU варианта магазина, и добавить количество |
| Цена | Передать цену позиции из заказа магазина |
| Описание | Добавить Заказ Medusa … |
Адрес доставки в создаваемый документ этим обработчиком не передаётся. Резерв, отгрузка, платёж и статусы дальнейшего исполнения сотрудник оформляет в МойСклад самостоятельно.
В МойСклад заполняйте поле «Код» номенклатуры значением, совпадающим с SKU варианта в админке магазина — именно по нему интеграция находит нужный товар. Поле «Артикул» для сопоставления не используется.
Автоматические попытки
Если попытка передачи не удалась, интеграция сама повторяет её по расписанию — первая попытка сразу, затем пять повторов:
| Повтор | Через сколько после предыдущей ошибки |
|---|---|
| 1 | 1 минута |
| 2 | 5 минут |
| 3 | 30 минут |
| 4 | 2 часа |
| 5 | 12 часов |
Фоновая проверка очереди запускается каждую минуту. Всего получается до шести попыток вместе с первой.
Шаг 4. Откройте журнал заказов
В разделе «МойСклад» откройте пункт меню «Синхронизация заказов». Заголовок открывшейся страницы — «Синхронизация заказов с МойСклад». Журнал показывает последние 50 записей.
| Фильтр | Что показывает |
|---|---|
| Ошибки | Неудачные синхронизации; выбран по умолчанию |
| Ожидают | Записи в очереди |
| Выполняются | Текущие попытки |
| Синхронизированы | Записи с полученным ID МойСклад |
| Все | Все последние записи |
В строке видны ссылка на заказ, статус, «Попыток: …» и последняя ошибка для неудачной записи.
Нажмите на ID заказа, откройте его карточку и в виджете «МойСклад» используйте «Повторить вручную».
Шаг 5. Разберите ошибку заказа
- Откройте фильтр «Ошибки».
- Перейдите в карточку заказа.
- Прочитайте последнюю ошибку.
- Проверьте SKU каждой позиции и соответствие коду номенклатуры в МойСклад.
- Исправьте причину — обычно это отсутствующий или неоднозначный код МойСклад.
- Нажмите «Повторить вручную».
- Проверьте статус «Синхронизировано» и ссылку «Открыть заказ в МойСклад».
Пока автоматические повторы ещё не исчерпаны, заказ разберётся сам к следующей ступени расписания. Ручной повтор нужен, если ждать нежелательно или все попытки уже исчерпаны.
Он лишь снова запускает тот же обмен. Если код номенклатуры или сопоставление остались неверными, повтор завершится той же ошибкой.
❌ Что уходит при отмене
Если основная синхронизация уже завершилась, отмена заказа магазина обновляет описание существующего документа на:
Заказ Medusa <ID заказа> — ОТМЕНЁН
Документ не удаляется, отдельный статус отмены МойСклад не устанавливается. Если основная отправка заказа не была успешной, отправлять отметку некуда — её нужно внести вручную.
При выключенном переключателе «Интеграция активна» отметка об отмене не ставится в очередь вовсе.
В карточке заказа статусы отмены называются «Ожидает отправки», «Отправляется», «Отмена отправлена» и «Ошибка отправки отмены».
📦 Как обновляются остатки
Задание запускается каждые 15 минут и работает с местом хранения магазина по умолчанию.
Вычитание заказов за 48 часов временно защищает от перепродажи: новый заказ мог ещё не отразиться в остатке МойСклад, но товар уже обещан покупателю.
Учитываются только неотменённые заказы, распознанные как оформленные через эту витрину. Вариант без SKU пропускается. Вариант без связанной складской позиции (обычно это варианты без управляемого складского учёта) тоже пропускается — обновлять там нечего.
Неоднозначные соответствия
Остаток обновляется только при связи один вариант магазина ↔ одна позиция МойСклад. Если SKU отсутствует, найдено несколько вариантов магазина или несколько позиций МойСклад с одним и тем же кодом, запись пропускается, чтобы не испортить чужой остаток.
На странице «МойСклад» есть отдельный блок диагностики: он перечисляет несопоставленные позиции и причину каждого пропуска — например «нет кода МойСклад», «несколько вариантов с одним SKU» или «несколько позиций МойСклад с одним кодом», — а также время последней попытки и последнего успешного обновления. Проверяйте его после каждого сомнения в остатках: «синхронизация прошла» не означает «обновлены все товары», часть могла быть пропущена именно по этим причинам.
Если в МойСклад заполнено не «Код», а «Артикул», сопоставление для такой позиции не сработает — заполните «Код» тем же значением, что и SKU варианта в магазине.
🚫 Что не синхронизируется
| Не передаётся автоматически | Где поддерживать вручную |
|---|---|
| Названия и описания товаров | В админке магазина |
| Цены каталога | В админке магазина |
| Изображения и документы | В админке магазина |
| Категории, коллекции и бренды | В админке магазина |
| Заказы, созданные вручную в МойСклад | Они не появляются обратно в магазине |
| Адрес доставки в создаваемом заказе МойСклад | Скопировать из карточки заказа при необходимости |
| Резервы и документы отгрузки | Оформить в МойСклад |
| Статусы оплаты и доставки МойСклад | Они не возвращаются в заказ магазина |
| Изменения контрагента из МойСклад | Они не обновляют покупателя магазина |
Интеграция остатков односторонняя: МойСклад → магазин. Товарные данные и статусы исполнения обратно не зеркалируются.
✅ Что проверить после первой настройки
Перед тем как полагаться на интеграцию в обычной работе, убедитесь, что она действительно работает на вашей номенклатуре:
- Проверьте реквизиты кнопкой «Проверить и сохранить».
- Включите «Интеграция активна».
- Создайте один безопасный тестовый заказ.
- Убедитесь, что статус стал «Синхронизировано», а ссылка открывает правильный документ.
- Отмените тестовый заказ и проверьте пометку
ОТМЕНЁН. - Сверьте один известный остаток после ближайшего 15-минутного цикла.
- Откройте блок диагностики несопоставленных позиций и убедитесь, что в нём нет неожиданных для вас товаров.
Один успешный тестовый заказ подтверждает подключение, но не подтверждает, что вся остальная номенклатура правильно сопоставлена по коду. Первое время после запуска регулярно сверяйте блок диагностики несопоставленных позиций.
🆘 Если что-то не получилось
При статусе «Требует внимания» прокрутите страницу интеграции: под формой появятся блоки «Интеграция требует внимания» и «Ошибка синхронизации остатков» с текстом и строкой «Последняя попытка: …». Заказы разбирайте в журнале, а текст ошибки остатков передайте разработчику.
| Что видите | Что делать сейчас |
|---|---|
| Правильные реквизиты не проходят проверку | Проверьте, что токен или логин с паролем действительно верны в самом МойСклад; если проблема не в реквизитах — к разработчику |
| «Требует внимания» | Прокрутите страницу интеграции, прочитайте блоки под формой; заказы разберите в журнале, текст ошибки остатков передайте разработчику |
| Заказ в статусе ошибки | Разберите SKU и код номенклатуры, затем нажмите «Повторить вручную» |
| Остаток не изменился через 15 минут | Не обещайте его покупателю; проверьте SKU, управляемый остаток и однозначность сопоставления по коду |
| Отмена не появилась в МойСклад | Отметьте её вручную и передайте разработчику текст ошибки |
| В журнале нет кнопки повтора | Откройте карточку заказа и нажмите «Повторить вручную» в виджете |