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

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

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

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

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

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

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

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

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

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

Те саме можна зробити з картки замовлення WooCommerce: у метабоксі показано, до якого замовлення маркетплейсу прив’язане це замовлення, і там же кнопка відправки. Кому зручніше працювати пачкою — працює зі списку, кому по одному — з картки.

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

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

Модуль не вигадує номер і не звертається до перевізника. Він читає мета-поля замовлення WooCommerce у такому порядку:

_npwc_ttn — Нова Пошта. _upwc_barcode — Укрпошта. _rzdwc_track_id — ROZETKA Delivery. Якщо накладну в замовлення пише якийсь інший модуль, у налаштуваннях є поле «Своє поле»: впишіть туди ключ мета-поля, і модуль перевірить його останнім.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

WordPress 6.2 і новіший, WooCommerce, PHP 7.4 і новіший. Модуль сумісний з HPOS — режимом окремих таблиць замовлень WooCommerce, — і працює як зі старим сховищем у wp_posts, так і з новим.

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

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

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

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

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

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

Прив’язка замовлення маркетплейсу до замовлення WooCommerce живе в мета-полі замовлення, тобто переживає зміну теми, оновлення WooCommerce і переїзд на HPOS. Журнал відправлень лежить у власній таблиці й не роздуває wp_options.

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

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

1. Завантажте архів у «Плагіни → Додати новий → Завантажити плагін».

2. Активуйте плагін.

3. WooCommerce → «ТТН у маркетплейси» — увімкніть потрібні кабінети та введіть реквізити. Натисніть «Перевірити зв’язок».

4. WooCommerce → «Замовлення маркетплейсів» — це і є ваш робочий список тих замовлень, кому ще потрібен номер.

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

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

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