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-ліцензія», потім увімкніть маркетплейси й автоматизацію.