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

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

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

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

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

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

В меню «Продажи» появляется пункт «Контроль возвратов» с количеством проблемных посылок. Настройки — Дополнения → Дополнения → Модули → Marketplace Returns Control.

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

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

• Что отслеживать. ТТН из таблиц наших модулей Нова Пошта Premium, Укрпочта и Meest (модуль сам показывает «найден»), из таблицы другого модуля доставки или введённые в заказе. За сколько дней брать заказы, какие статусы пропускать, после скольких дней без движения посылка «зависла», за сколько дней до конца хранения предупреждать.
• Статусы «Выполнено», «Отменено», «Средства возвращены». Модуль сравнивает с ними состояние посылки. По умолчанию — стандартные Complete, Canceled и Refunded; если в вашем магазине другие, выберите свои.
• Перевозчики. Ключи берутся из наших модулей доставки. Собственные поля нужны, только если тех модулей нет или здесь нужен другой ключ. Для каждого перевозчика есть «Сохранить и проверить».
• История заказа. Строка в истории без уведомления покупателя, когда найдена проблема или подтверждён возврат (отключается).

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

• Rozetka, Prom.ua, Эпицентр. Заказы кабинета с ТТН сверяются с перевозчиком и с вашим заказом. Модуль ловит три ситуации: маркетплейс закрыл заказ как полученный, а перевозчик не вручил посылку; маркетплейс и перевозчик говорят разное; деньги вернули покупателю раньше, чем товар пришёл обратно. Реквизиты из наших модулей «ТТН в маркетплейсы», «Эпицентр: цены и наличие» и Prom Model Guard подхватываются сами.
• Связь с заказом OpenCart модуль берёт из «ТТН в маркетплейсы». Заказы маркетплейса без заказа в OpenCart тоже попадают в список.
• Ежечасная проверка перевозчиков и маркетплейсов без кнопки. В OpenCart 4 — через встроенный планировщик (Дополнения → Cron Jobs); если хостинг его не запускает, или в OpenCart 3 и 2.3 — через cron-адрес из настроек, раз в час.
• Утренняя сводка на почту: список посылок, требующих внимания.
• Telegram: срочные случаи (маркетплейс закрыл как полученный, маркетплейс и перевозчик говорят разное, деньги вернули раньше товара, «возвращено» без вашего подтверждения, посылка утеряна) сразу, сводка утром.
• Статус заказа меняется сам: после подтверждённого возврата и после отказа, со строкой в истории без уведомления покупателя.
• CSV из списка с учётом фильтров, с точкой с запятой и BOM — открывается в Excel без танцев с кодировкой.

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

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

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

• Без правок ядра. Меню и блок на странице заказа — через события OpenCart, без OCMOD-модификаций. Одна библиотека классов одинакова в трёх сборках, код совместим с PHP 7.0.
• Собственные таблицы oc_cc_mrc_parcel (одна ТТН — одна строка), oc_cc_mrc_event (история), oc_cc_mrc_order (ТТН, введённые в заказе), oc_cc_mrc_kv (служебные данные). Таблицы модулей доставки модуль только читает.
• API: Новая Почта TrackingDocument.getStatusDocuments, Укрпочта Status Tracking, Meest openAPI tracking. В Pro — Rozetka Seller API, Prom.ua API, Эпицентр Marketplace API.
• Ключи и токены хранятся зашифрованными (AES с HMAC) и не выводятся в HTML. Ключи наших модулей модуль расшифровывает сам, не подключая их файлов.
• Лицензия живёт в отдельной группе настроек: «Сохранить» её не трогает, деинсталляция тоже.
• Удаление: деинсталляция снимает события и крон; таблицы с посылками остаются для повторной установки. Галочка «Удалять посылки, их историю и настройки при удалении модуля» перед деинсталляцией убирает и их.

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

1. OpenCart 4: Дополнения → Установщик → загрузите cc_mrc.ocmod.zip (имя архива не меняйте) и нажмите «Установить». OpenCart 3: Дополнения → Установщик → cc_mrc-oc3.ocmod.zip. OpenCart 2.3: залейте содержимое папки upload/ из cc_mrc-oc2.ocmod.zip в корень магазина (FTP или файловый менеджер хостинга) — Установщик 2.3 без настроенного FTP файлы не копирует.
2. Дополнения → Дополнения → Модули → Marketplace Returns Control → «Установить», затем «Редактировать».
3. «Что отслеживать»: проверьте, что таблицы модулей доставки отмечены «найден». Ключи из наших модулей подхватятся сами — это видно по надписям «взято из модуля …».
4. Продажи → «Контроль возвратов» → «Проверить сейчас». Посылки появятся во вкладках по выводам.
5. Когда возврат физически пришёл, нажмите «Возврат получен» в списке или на странице заказа.
6. Для Pro: вставьте лицензионный ключ из письма после оплаты или нажмите «Попробовать Pro 7 дней» в разделе «Pro-лицензия», затем включите маркетплейсы и автоматизацию. Для OpenCart 3 и 2.3 добавьте cron-адрес из настроек в cron хостинга, раз в час.