Что плагин делает с заказами
- Получает отправления — по расписанию (команда
orders) или по API-уведомлению Маркета. - Создаёт заказ магазина — с покупателем из настроек, датой и временем Маркета, статусом по соответствию статусов и отметкой оплаты, если она включена.
- Передаёт коды активации — автоматически после перехода отправления в «Собирается» (PROCESSING) или вручную из карточки заказа.
- Обновляет состояние — при изменении статуса отправления заказ магазина переводится в действие, заданное в настройках.
Настройки вкладки «Заказы и статусы»
- «Контакт для создания заказов Яндекс Маркет» — покупатель, от имени которого создаются заказы. В заказе видны его данные; сам покупатель в Маркете плагину не передаётся.
- «Дата, с которой получать заказы» — начало периода опроса при первом запуске. Маркет отдаёт заказы за период не длиннее 30 дней, поэтому глубже этой даты опрос не уходит.
- «Помечать созданные заказы оплаченными» — созданный заказ сразу получает оплату с датой и временем из заказа Маркета: запись об оплате в истории заказа тоже датируется временем Маркета.
- «Использовать API-уведомления Яндекс Маркета» и «Витрина для API-уведомлений» — плагин принимает уведомления о новых и изменившихся отправлениях, не дожидаясь cron. Адрес приёма показан в настройке и содержит идентификатор аккаунта и ключ: этот адрес указывается в кабинете Маркета.
- «Обрабатывать тестовые заказы» — по умолчанию выключено.
- «Вид кода для передачи» — вид кода в запасе (например, «Код активации»). Настройка доступна при установленном плагине «Управление товарными кодами».
- «Отправлять коды автоматически» — передача кодов без участия оператора после готовности отправления.
- «Действие при неудачной автопередаче» — действие магазина, которое выполняется, если коды передать не удалось.
- «Инструкция по активации» и «Если инструкции нет» — текст инструкции для покупателя. Маркет требует инструкцию при передаче цифровых товаров, поэтому при её отсутствии подставляется значение из второй настройки.
- «Срок активации» — до какой даты действуют коды. Для характеристики-строки или дополнительного параметра можно указать относительную дату, например
+3month: она считается от момента передачи кода.
Тестовые заказы
Тестовые заказы создаются в кабинете Маркета для отладки. У них есть признак, по которому плагин отличает их от настоящих.
- Настройка выключена — плагин запрашивает у Маркета только настоящие заказы; тестовые не опрашиваются, не создаются и не журналируются.
- Настройка включена — плагин запрашивает только тестовые заказы; настоящие в это время не опрашиваются.
Тестовые заказы проходят полный путь, включая передачу кодов: они списывают реальные коды из запаса. Поэтому после отладки настройку выключают до переноса плагина на рабочий магазин.
В карточке заказа, созданного по тестовому отправлению, показывается плашка «Тестовый заказ Маркета». Признак хранится в самом заказе: после выключения настройки уже созданный тестовый заказ остаётся помеченным.
Соответствие статусов действиям магазина
Для каждого статуса отправления Маркета выбирается действие магазина или «Не выполнять действие». Например: «Доставлен» → «Выполнен», «Собирается» → «Оплачен и комплектуется».
Действие выполняется один раз — при смене статуса. Если статус не изменился, повторного действия не будет, даже если заказ в магазине был переведён в другой статус вручную.
Статусы Маркета: PLACING, RESERVED, UNPAID, PENDING, PROCESSING, DELIVERY, PICKUP, DELIVERED, PARTIALLY_RETURNED, RETURNED, CANCELLED, UNKNOWN. Подстатусы (например, STARTED) показываются рядом со статусом; неизвестный код подстатуса выводится как есть.
Блок Яндекс Маркета в карточке заказа
В заказе, созданном из Маркета, видно номер отправления, статус и подстатус, переданные коды и состояние передачи. Доступны действия:
- «Обновить информацию» — запросить актуальное состояние отправления;
- «Передать коды» — отправить коды вручную; кнопка скрывается, когда коды по заказу уже переданы.
Сроки и повторы
Коды принимаются в течение 30 минут после перехода отправления в PROCESSING. Пропущенный срок требует повторной передачи — плагин делает её при следующем опросе и сообщает причину в истории заказа.
При неудачной автопередаче причина записывается в историю заказа, в объявление и в журнал плагина. Повтор с той же причиной второй раз не пишется: сообщение появляется один раз на причину, а при успешной передаче отметка о причине снимается.
Порядок обработки
Заказы внутри одной страницы обрабатываются от старых к новым, страницы — от свежих к старым. Так давние отправления не остаются в конце очереди на несколько часов.
