Marketplace Returns Control для WooCommerce — контроль возвратов и невыкупленных посылок

Marketplace Returns Control для WooCommerce — модуль для магазинов, которые отправляют Новой Почтой, Укрпочтой или Meest и продают на Rozetka, Prom или в Эпицентре. Посылка, которую покупатель не забрал, стоит дважды: доставка туда и обратно плюс товар, который «где-то в пути». Хуже, когда перевозчик или маркетплейс закрывает такую посылку как «вручено» или «возвращено», а она всё ещё лежит в отделении. Через неделю уже никто не помнит, что её надо было забрать.

Модуль сверяет каждую ТТН ваших заказов с перевозчиком (кнопкой «Проверить сейчас», в Pro ещё и каждый час) и показывает только те посылки, где нужен человек. Возврат закрывается не статусом перевозчика, а вашим «Возврат получен», то есть когда товар действительно на полке. ТТН и ключи модуль берёт из наших модулей Новая Почта, Укрпочта и Meest, поэтому после установки обычно ничего не нужно заполнять.

Как это выглядит для покупателя

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

Что получает админ

WooCommerce → «Контроль возвратов»: список посылок с количеством проблем на пункте меню, и «Настройки контроля возвратов».

• Один вывод на посылку. Каждая ТТН получает ровно один вывод, и список делится на вкладки: «Требуют внимания», «Возвраты», «В пути», «Завершённые», «Все». Рядом — статус перевозчика с кодом, дата изменения, дата окончания хранения, связанный заказ и маркетплейс.
• Действия. «Возврат получен» с комментарием, «Отметить решённым» (посылка исчезает из «Требуют внимания» и возвращается, если состояние снова изменится), удалить, история.
• Фильтры и поиск. По источнику (WooCommerce, Rozetka, Prom, Эпицентр), перевозчику, ТТН, обратной ТТН или номеру заказа.
• Ручное добавление. ТТН посылки, которой нет среди заказов WooCommerce, например заказа маркетплейса, отправленного вручную.

Блок в карточке заказа показывает посылки этого заказа, вывод, кнопки «Возврат получен» / «Отменить подтверждение» / «Отметить решённым» и историю: кто, когда и что подтвердил. Если ТТН не записал ни один модуль доставки, её можно ввести здесь и сохранить вместе с заказом.

• Что отслеживать. Какие мета-поля заказа содержат ТТН (наши модули Новая Почта, Укрпочта, Meest, «ТТН в маркетплейсы» или ваше поле), за сколько дней брать заказы, какие статусы пропускать, через сколько дней без движения посылка «зависла», за сколько дней до конца хранения предупреждать.
• Перевозчики. Ключи берутся из наших модулей доставки. Собственные поля нужны, только если этих модулей нет или здесь нужен другой ключ. Для каждого перевозчика есть «Сохранить и проверить».
• Заметки в заказе. Приватная заметка, когда найдена проблема или подтверждён возврат (отключается).

Pro: маркетплейсы, автоматизация, Telegram

• Rozetka, Prom.ua, Эпицентр. Заказы кабинета с ТТН сверяются с перевозчиком и с вашим заказом. Модуль ловит три ситуации: маркетплейс закрыл заказ как полученный, а перевозчик не вручил посылку; маркетплейс и перевозчик говорят разное; деньги вернули покупателю раньше, чем товар пришёл обратно. Реквизиты из наших модулей «ТТН в маркетплейсы», «Эпицентр: цены и наличие» и Prom Model Guard подхватываются сами.
• Связь с заказом WooCommerce модуль берёт из ТТН в маркетплейсы. Заказы маркетплейса без заказа в WooCommerce тоже попадают в список.

• Ежечасная проверка перевозчиков и маркетплейсов без кнопки.
• Утренняя сводка на почту: список посылок, которым нужно внимание.
• Telegram: срочные случаи (маркетплейс закрыл как полученное, маркетплейс и перевозчик говорят разное, деньги вернули раньше товара, «возвращено» без вашего подтверждения, посылка утеряна) сразу, сводка утром.
• Статус заказа меняется сам: после подтверждённого возврата (например, «Возвращён») и после отказа (например, «На удержании»), с заметкой в заказе.
• CSV из списка с учётом фильтров, для Excel и учёта.

Как это работает — шаг за шагом

1. Как только заказ сохраняется с ТТН, которую записал модуль доставки или вы вручную, модуль заводит посылку. Заказы в статусах, которые вы пропускаете (например, «Ожидает оплаты»), не берутся.
2. «Проверить сейчас» (в Pro ещё и каждый час) опрашивает перевозчиков: Новую Почту и Укрпочту пачками до 100 ТТН, Meest по одной. Сначала идут посылки, которые ещё не проверялись, потом самые давние.
3. Ответ каждого перевозчика сводится к одному состоянию: в пути, в отделении, вручено, отказ, возвращается, возвращено отправителю, утеряно. Для Новой Почты модуль берёт обратную ТТН (кроме переадресации) и дату окончания хранения.
4. В Pro модуль читает заказы Rozetka, Prom и Эпицентра с ТТН и добавляет к посылке состояние маркетплейса и возврат денег.
5. Из всего этого и статуса вашего заказа получается один вывод, от важного к обычному: маркетплейс закрыл как полученное, расхождение, деньги раньше товара, «возвращено» без подтверждения, утеряно, статус заказа противоречит, заканчивается хранение, зависла.
6. Каждое изменение попадает в историю посылки, в Pro — ещё и в Telegram или утреннюю сводку. Возврат закрывается только вашим «Возврат получен».

Что под капотом

• Собственные таблицы wp_ccmrc_parcels (одна ТТН — одна строка, данные заказа и маркетплейса сливаются в неё) и wp_ccmrc_events (история). Все запросы через $wpdb->prepare().
• API перевозчиков: Новая Почта TrackingDocument.getStatusDocuments, Укрпочта Status Tracking, Meest openAPI tracking. В Pro — Rozetka Seller API, Prom.ua API, Эпицентр Marketplace API.
• Ключи и токены шифруются AES-256 с HMAC и не выводятся в HTML. Ключи наших модулей модуль читает через их классы, ничего не копирует.
• Безопасность: все действия с nonce и правом manage_woocommerce. Анонимные запросы к обработчикам модуль отклоняет.
• Удаление: деинсталляция убирает таблицы, настройки, транзиенты, крон и собственные мета-поля заказов. ТТН модулей доставки остаются.

Как установить

1. Скачайте бесплатную версию catcode-marketplace-returns-control-for-woocommerce-1.0.0.zip кнопкой вверху страницы (или Pro-архив из кабинета после оплаты) и установите: Плагины → Добавить новый → Загрузить плагин. WooCommerce должен быть активен.
2. WooCommerce → «Настройки контроля возвратов»: проверьте, какие поля заказа содержат ТТН. Ключи из наших модулей доставки подхватятся сами, это видно по надписям «взято из модуля …».
3. WooCommerce → «Контроль возвратов» → «Проверить сейчас». Посылки появятся во вкладках по выводам.
4. Когда возврат физически пришёл, нажмите «Возврат получен» в списке или в карточке заказа.
5. Для Pro: вставьте лицензионный ключ из письма после оплаты или нажмите «Попробовать Pro 7 дней» в разделе «Pro-лицензия», затем включите маркетплейсы и автоматизацию.