🧾 Как обработать заказ
Карточка заказа собирает данные из нескольких систем: сам заказ хранится в магазине, отправление создаёт ApiShip или СДЭК, а копия заказа должна уходить в МойСклад. Ошибка одной интеграции не отменяет уже оформленный покупателем заказ.
:::danger МойСклад сейчас не работает Все запросы текущей интеграции блокируются из-за неверного технического заголовка, а сопоставление товаров использует поле, заполненное лишь у части номенклатуры. Виджет может показывать ожидание или ошибку, но это не означает, что заказ появился в МойСклад.
Не считайте синхронизацию рабочей до исправления разработчиком. Подробности — в разделе «Настройка и работа с МойСклад». :::
Шаг 1. Откройте заказ
- Войдите в админку:
https://mirkrasok.termitsdigital.ru/app. - Откройте «Заказы».
- Выберите новый заказ.
Сначала проверьте номер, состав, количество, итоговую сумму и статус оплаты. Не начинайте упаковку, если цена, количество или способ оплаты требуют уточнения у покупателя.
Шаг 2. Проверьте «Данные оформления»
Дополнительный виджет «Данные оформления» показывает поля, введённые покупателем при оформлении:
| Поле в карточке | Что проверить |
|---|---|
| Покупатель | Имя получателя |
| Телефон | Номер для связи и службы доставки |
| Город | Город доставки |
| Адрес | Улица, дом и квартира или офис |
| Комментарий | Пожелания покупателя |
Пустые поля виджет не показывает. Электронную почту смотрите в стандартных данных заказа — в этот виджет она не входит.
:::warning Виджета «Данные оформления» может не быть Он появляется только когда в заказе сохранилось хотя бы одно дополнительное поле оформления. Его отсутствие не означает, что вся карточка заказа сломана: проверьте стандартные данные покупателя и способ доставки. :::
Шаг 3. Проверьте оплату
Ориентируйтесь на статус в блоке оплаты, а не на сам факт появления заказа.
| Ситуация | Действие |
|---|---|
| Онлайн-оплата подтверждена | Можно переходить к сборке |
| Оплата ожидается при получении | Обрабатывайте по правилам магазина для этого способа |
| Онлайн-оплата не подтверждена или завершилась ошибкой | Не отправляйте как оплаченный; сначала уточните платёж |
Шаг 4. Проверьте создание отправления
После оформления магазин автоматически пытается создать отправление сначала для ApiShip, а если выбран другой поддерживаемый вариант — для СДЭК. Ошибка перевозчика не удаляет заказ и не сообщает покупателю, что заказ отменён.
| Что видите | Что это значит | Что делать |
|---|---|---|
| Виджет «Не удалось автоматически создать отправку ApiShip» | ApiShip не принял отправление | Прочитайте текст ошибки, исправьте данные и нажмите «Повторить попытку» |
| Виджет «Не удалось автоматически создать отправку СДЭК» | СДЭК не принял отправление | Прочитайте текст ошибки, исправьте данные и нажмите «Повторить попытку» |
| Ошибки нет и появился фулфилмент | Отправление и сборка созданы автоматически | Не создавайте второй фулфилмент вручную |
Успешный повтор сопровождается сообщением «Отправка ApiShip создана» или «Отправка СДЭК создана». После успешного повтора ApiShip карточка заказа сама перезагрузится примерно через секунду — это нормально. У СДЭК страница не перезагружается, обновляются только данные виджета.
:::warning Не нажимайте повтор много раз подряд Сначала устраните причину из текста ошибки: неверный адрес, недоступный тариф или обязательное поле. Повтор без исправления создаёт лишь новые неудачные запросы. :::
Шаг 5. Получите этикетку
| Перевозчик | Виджет | Действие |
|---|---|---|
| ApiShip | «Этикетка отправки» | Нажмите «Получить этикетку» — документ откроется в новой вкладке |
| СДЭК | «Этикетка СДЭК» | Нажмите «Получить этикетку» — магазин запросит файл и откроет его в новой вкладке |
Распечатайте этикетку и прикрепите к нужной посылке. Сверьте номер заказа перед печатью и перед наклейкой.
Если СДЭК отвечает «Сначала создайте отправку СДЭК.», вернитесь к Шагу 4: без принятого отправления этикетки ещё нет.
Если блока «Этикетка СДЭК» на странице нет вообще, отправление ещё не создано: блок появляется только после принятой перевозчиком отправки.
Шаг 6. Соберите и передайте заказ
- Сверьте варианты и количество с карточкой заказа.
- Упакуйте товар.
- Прикрепите этикетку.
- Фактически передайте посылку перевозчику.
- Только после передачи в блоке фулфилмента выберите «Отметить как отправленный».
- Если требуется, заполните «Номер отслеживания» через «Добавить номер отслеживания».
:::danger Не отмечайте отправку заранее Статус «Отправлено» должен означать, что посылка уже передана перевозчику. Этикетка или упакованная коробка сами по себе ещё не отправка. :::
🔄 Виджет МойСклад
Виджет «МойСклад» показывает основную отправку заказа в строке «Статус» и, после отмены, отдельную отправку отметки об отмене в строке «Отмена».
Статусы заказа
| Статус | Значение |
|---|---|
| Не отправлен | Записи синхронизации ещё нет |
| Ожидает | Запись ждёт фоновой попытки |
| Выполняется | Попытка идёт сейчас |
| Синхронизировано | МойСклад вернул идентификатор заказа |
| Ошибка синхронизации | Последняя попытка закончилась ошибкой; если лимит не исчерпан, система ещё назначит автоматический повтор |
Статусы отмены
| Статус | Значение |
|---|---|
| Ожидает отправки | Отмена ждёт попытки |
| Отправляется | Запрос выполняется |
| Отмена отправлена | В описание документа МойСклад добавлена отметка об отмене |
| Ошибка отправки отмены | Отметку передать не удалось |
При ошибке нажмите «Повторить вручную». После успешной основной синхронизации появляется ссылка «Открыть заказ в МойСклад».
:::note Где увидеть количество попыток В карточке заказа виден статус и последняя ошибка, но не число попыток. Счётчик «Попыток: …» находится в пункте меню «МойСклад» → «Синхронизация заказов». Заголовок открывшейся страницы — «Синхронизация заказов с МойСклад». :::
Ошибка синхронизации остатков видна в самой админке: откройте страницу интеграции МойСклад и найдите блок «Ошибка синхронизации остатков» с текстом и временем последней попытки.
❌ Шаг 7. Отмените заказ, если он не будет выполнен
- Убедитесь, что выбран правильный заказ.
- Откройте меню действий и выберите «Отмена».
- В окне «Вы уверены?» нажмите «Продолжить».
- Проверьте статус заказа и блок МойСклад.
- Отдельно проверьте возврат денег, если платёж был списан.
Если заказ уже был синхронизирован, магазин пытается обновить описание существующего документа в МойСклад текстом Заказ Medusa … — ОТМЕНЁН. Документ не удаляется, отдельный формальный статус МойСклад не устанавливается. Если основная синхронизация ещё не завершилась, отметка об отмене туда не отправляется.
:::danger Сейчас отметка об отмене тоже не доходит Она использует тот же неисправный клиент МойСклад. До исправления интеграции отмену нужно отразить в МойСклад вручную. :::
:::note Если интеграция выключена При выключенном переключателе «Интеграция активна» отметка не ставится в очередь вовсе, строки «Отмена» в виджете не будет, и это не признак ошибки. :::
💳 Возврат оплаты
Виджет «Возврат оплаты» показывает только конечный результат автоматического возврата:
| Статус | Что делать |
|---|---|
| Возвращён | Проверьте сумму и запись у платёжного провайдера |
| Ошибка возврата | Прочитайте ошибку, устраните причину и нажмите «Повторить возврат» |
:::warning Статуса pending в виджете нет
Во время выполнения возврата карточка не показывает отдельное состояние ожидания: виджет появляется только после результата refunded или error. Поэтому отсутствие виджета не подтверждает ни успех, ни ожидание операции.
:::
:::danger Отмена в админке не запускает этот автоматический возврат Автоматический виджет относится к возврату после отмены со стороны покупателя. Обычная «Отмена» в админке не отправляет событие этого автоматического возврата.
Если у отменяемого заказа деньги уже списаны, откройте стандартный блок оплаты и выполните «Создать возврат» по правилам магазина. Не считайте заказ возвращённым, пока это не подтверждено статусом и платёжным провайдером. :::
✅ Контроль перед завершением
| Проверка | Готово, когда |
|---|---|
| Данные получателя | Имя, телефон и адрес сверены |
| Оплата | Понятно, оплачено сейчас или при получении |
| Отправление | Нет ошибки ApiShip/СДЭК и не создан дубль |
| Этикетка | Распечатана для правильного заказа |
| Комплектация | Варианты и количество совпадают |
| Передача | Посылка фактически у перевозчика |
| Статус | После передачи выбран «Отметить как отправленный» |
| МойСклад | До исправления интеграции заказ и отмена отражены вручную |
🆘 Если что-то не получилось
| Что видите | Что делать |
|---|---|
| Ошибка ApiShip или СДЭК | Исправьте причину из сообщения и нажмите «Повторить попытку» |
| Кнопка этикетки выдаёт ошибку | Сначала убедитесь, что отправление создано; затем повторите получение |
| «Ошибка синхронизации» МойСклад | Не теряйте заказ: внесите его вручную и передайте ошибку разработчику |
| МойСклад показывает «Синхронизировано», но документ не найден | Откройте ссылку из виджета; при несоответствии передайте разработчику номер заказа |
| После отмены нет виджета возврата | Для отмены из админки это ожидаемо; проверьте стандартный блок оплаты и провайдера |
| «Ошибка возврата» | Проверьте причину и платёж, затем используйте «Повторить возврат» |