ТТН в маркетплейсы для OpenCart — Rozetka и Эпицентр

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

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

Зачем это магазину

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

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

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

Как это выглядит для менеджера

В меню админки OpenCart появляется пункт «Заказы маркетплейсов». Это один список заказов обоих кабинетов, которым ещё нужна накладная — не отдельно Rozetka и отдельно Эпицентр, а общая очередь работы на день.

В каждой строке видно: заказ маркетплейса, привязанный к нему заказ WooCommerce, номер накладной, если он уже есть, и кнопку отправки. Нажали — номер ушёл в кабинет, в строке появился ответ кабинета. Не появился — модуль покажет, почему именно, словами самого кабинета.

Вся работа идёт из одного списка: там и привязка, и номер, и кнопка отправки. Отдельно ходить в каждый заказ не нужно.

Самовывоз в списке отмечается отдельно. Там накладной не будет никогда, поэтому модуль не предлагает кнопку и не показывает такие заказы как «незакрытые» — иначе очередь никогда не становилась бы пустой.

Откуда берётся номер накладной

Модуль не выдумывает номер и не обращается к перевозчику. Он читает его из таблиц наших модулей доставки: 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. Дальше работаете в списке заказов маркетплейсов — это и есть ваша ежедневная очередь тех, кому ещё нужен номер.

Настройка занимает несколько минут, и дольше всего в ней — найти токен Эпицентра в кабинете.