ТТН у маркетплейси для 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 просто в рядку черги — вписуєте ID замовлення OpenCart, без імпорту.

3. У замовленні створюється накладна вашим звичайним способом. Якщо її робить модуль доставки CatCode, номер сам підставляється в рядок черги; інакше його вписують руками.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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