ТТН у маркетплейси для OpenCart — Rozetka і Епіцентр

ТТН у маркетплейси — модуль для OpenCart 2.3, 3.x і 4.x, який відправляє номер накладної із замовлення магазину в кабінет Rozetka Маркетплейс і Епіцентр Маркетплейс. Продавець більше не переносить той самий номер руками: створив накладну в замовленні — і одна кнопка (або автовідправка в Pro) кладе її в кабінет разом зі статусом.

Модуль не створює накладні й не замінює доставку. Він бере номер, який уже є в замовленні OpenCart — від Нової Пошти, Укрпошти, ROZETKA Delivery або будь-якого іншого модуля — і закриває останній, найбільш ручний крок дня.

Навіщо це магазину

Продавець, який торгує і на маркетплейсі, і у власному магазині, робить одну й ту саму роботу двічі. Спочатку в OpenCart створюється накладна: покупець обрав відділення, менеджер натиснув «Створити ТТН», номер записався в замовлення. Потім відкривається кабінет Rozetka або Епіцентру, знаходиться те саме замовлення й номер вбивається туди вручну.

На двадцяти замовленнях на день це двадцять переходів між вкладками, двадцять пошуків замовлення в чужому інтерфейсі й рівно стільки ж шансів переплутати цифру. Помилка в номері на маркетплейсі коштує дорожче, ніж у себе: кабінет перестає бачити рух посилки, замовлення висить «Очікує відправлення», і претензія прилітає продавцю, а не перевізнику.

Модуль прибирає другий крок повністю. Номер їде в кабінет із замовлення OpenCart, а разом з ним виставляється статус — далі трекінг маркетплейс веде сам.

Як це виглядає для менеджера

У меню адмінки OpenCart з’являється пункт «Замовлення маркетплейсів». Це один список замовлень обох кабінетів, яким ще потрібна накладна — не окремо Rozetka й окремо Епіцентр, а спільна черга роботи на день.

У кожному рядку видно: замовлення маркетплейсу, прив’язане до нього замовлення OpenCart, номер накладної, якщо він уже є, і кнопку відправки. Натиснули — номер пішов у кабінет, у рядку з’явилась відповідь кабінету. Не з’явився — модуль покаже, чому саме, словами самого кабінету.

Уся робота йде з одного списку: там і прив’язка, і номер, і кнопка відправки. Окремо ходити в кожне замовлення не треба.

Самовивіз у списку позначається окремо. Там накладної не буде ніколи, тому модуль не пропонує кнопку й не показує такі замовлення як «незакриті» — інакше черга ніколи не ставала б порожньою.

Звідки береться номер накладної

Модуль не вигадує номер і не звертається до перевізника. Він читає його з таблиць наших модулів доставки: np_shipment.int_doc_number (Нова Пошта), up_shipment.barcode (Укрпошта) і з ROZETKA Delivery. Тобто номер підставляється сам, щойно накладна створена, а з Pro — і відправляється сам.

Якщо доставку у вас веде інший модуль, номер можна вписати в замовлення руками: черга й відправка від цього не змінюються, зникає лише автопідстановка.

Rozetka Маркетплейс

Для Rozetka разом з номером накладної виставляється статус замовлення. Це важливо: у кабінеті Rozetka номер сам по собі нічого не запускає, поки замовлення не переведене у відповідний статус. Модуль робить обидві дії за один виклик, тому після натискання кнопки замовлення в кабінеті одразу стає відправленим.

Далі трекінг веде сам кабінет — модуль більше в це замовлення не лізе й не смикає API щогодини. Це свідоме рішення: Rozetka сама краще знає, де зараз посилка, і дублювати її статуси у себе означає лише накопичувати розбіжності.

Реквізити для підключення — логін і пароль кабінету продавця з seller.rozetka.com.ua. Окремий API-ключ отримувати не треба.

Епіцентр Маркетплейс

Для Епіцентру модуль кладе номер накладної й переводить замовлення в «Відправлено» одним рухом. Логіка та сама, що й у Rozetka, відрізняється тільки спосіб авторизації.

Епіцентр працює за статичним токеном. Береться він у кабінеті: «Налаштування компанії» → вкладка «API». Якщо вкладки не видно — доступ до неї відкриває ваш категорійний менеджер, це питання одного повідомлення йому.

Як це працює — крок за кроком

1. Замовлення приходить із маркетплейсу у ваш звичайний робочий процес. Модуль бачить його в спільній черзі «Замовлення маркетплейсів».

2. Ви прив’язуєте замовлення маркетплейсу до замовлення OpenCart — без окремого екрана й без імпорту.

3. У замовленні створюється накладна вашим звичайним способом. Номер лягає в мета-поле.

4. Ви натискаєте «Відправити ТТН» — зі списку або з картки. Модуль бере номер, звертається до кабінету, виставляє статус.

5. Відповідь кабінету пишеться в журнал. Якщо все добре — рядок зникає з черги. Якщо ні — ви бачите точну причину.

У Pro-версії кроки 4 і 5 відбуваються самі: номер їде в кабінет, щойно з’явився в замовленні.

Журнал відправлень

Кожна відправка пишеться в журнал: яке замовлення, в який кабінет, коли, з яким номером і що саме відповів кабінет. Це не декоративний лог — саме він відповідає на питання «чому в кабінеті порожньо, я ж натискав».

Помилка кабінету показується його ж словами, а не кодом відповіді. Якщо Rozetka каже, що замовлення вже в іншому статусі, ви прочитаєте саме це, а не HTTP 400. Так менеджер розбирається сам, без звернення до розробника.

Повторна відправка того самого номера не робиться. Якщо кнопку натиснули двічі або крон зачепив замовлення, яке вже закрите, модуль просто нічого не робить — кабінет не смикається на порожньому місці й не отримує дублів.

Безкоштовна версія і Pro

Безкоштовна версія робить усе, описане вище, руками: спільна черга, прив’язка замовлень, відправка кнопкою зі списку або з картки, журнал, обидва маркетплейси. Обмежень за часом і реклами в адмінці немає.

Pro прибирає останню ручну дію:

— автовідправка: номер їде в кабінет сам, щойно з’явився в замовленні;
— вибір статусів замовлення, які вмикають відправку — щоб номер не поїхав з чернетки чи скасованого;
— крон раз на 10 хвилин добирає ті замовлення, де накладна прийшла із затримкою (перевізник віддав номер не одразу — модуль повернеться й дошле).

Pro можна спробувати 7 днів безкоштовно, без картки.

Скільки коштує

Ліцензія Pro — 1 290 грн, на один домен. Ліцензія назавжди: оплачуєте один раз, без щорічних платежів.

Технічні вимоги

Підтримуються OpenCart 4.x, 3.x і 2.3 — три окремі збірки в одному архіві, ставиться та, що відповідає вашій версії. ocStore на базі цих версій теж підходить.

Для роботи потрібен вихідний HTTPS до API Rozetka й Епіцентру. На звичайному хостингу він відкритий; якщо магазин стоїть за жорстким фаєрволом, це єдине, що треба буде дозволити.

Чому немає демо-стенду

У жодного з двох маркетплейсів немає пісочниці: API відкривається тільки реквізитами живого кабінету продавця. Тому «помацати» модуль на чужому демо неможливо — ні в нас, ні в будь-кого іншого.

Замість демо в модулі є кнопка «Перевірити зв’язок». Ви вводите свої реквізити й одразу бачите, що відповів кабінет — за секунду, ще до першої відправки. Якщо реквізити не ті або токен не виданий, ви дізнаєтесь про це відразу, а не на першому реальному замовленні.

Що під капотом

Модуль спілкується з кабінетами через їхні офіційні API — жодного парсингу сторінок і жодної емуляції входу в кабінет. Реквізити зберігаються в налаштуваннях магазину в зашифрованому вигляді.

Результат кожної відправки лягає не тільки в журнал модуля, а й в історію замовлення — там, де менеджер і так звик дивитись, що з замовленням відбувалось. Прив’язка замовлення OpenCart до замовлення маркетплейсу зберігається в окремій таблиці й переживає оновлення теми та магазину.

Модуль не створює власних сторінок у вітрині, не додає скриптів у магазин і взагалі нічого не робить поза адмінкою — покупець його не бачить і не може сповільнити.

Як встановити

1. Залийте архів через «Розширення → Установник розширень» (в OpenCart 2.3 і 3.x — «Установник доповнень»).

2. «Розширення → Модулі» → знайдіть «ТТН у маркетплейси» і встановіть.

3. Відкрийте налаштування, увімкніть потрібні кабінети, введіть реквізити й натисніть «Перевірити зв’язок».

4. Далі працюєте у списку замовлень маркетплейсів — це і є ваша щоденна черга тих, кому ще потрібен номер.

Налаштування займає кілька хвилин, і найдовше в ньому — знайти токен Епіцентру в кабінеті.

Історія версій

1.0.0 — перший випуск. Rozetka Маркетплейс і Епіцентр Маркетплейс, спільна черга замовлень, відправка ТТН зі списку й з картки замовлення, джерела номера (Нова Пошта, Укрпошта, ROZETKA Delivery, своє поле), журнал відправлень, захист від повторної відправки, окрема позначка самовивозу, запис результату в історію замовлення, збірки під OpenCart 4.x, 3.x і 2.3. У Pro — автовідправка, вибір статусів-тригерів і крон-добирач.