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 хостингу, раз на годину.