OcBox ShippingHub — хаб доставок для OpenCart 3 і ocStore: Нова Пошта, Укрпошта, Meest, Rozetka Delivery, ТТН і статуси через CRON

OcBox ShippingHub, чотири українські перевізники в одному модулі OpenCart 3

Ви знаєте, як це виглядає у стандартному OpenCart. Спочатку ставите модуль Нової Пошти, потім окремий для Укрпошти, потім щось під Rozetka Delivery, і кожен зі своєю адмінкою, своїм списком міст, своїм форматом ТТН. Менеджер створює накладну одному замовленню тут, іншому там, статус у OpenCart оновлює руками. А статуси ТТН у Новій Пошті живуть окремо: «отримано», «в дорозі», «повернуто», і магазин про них дізнається тільки з листа клієнта.

OcBox ShippingHub об’єднує Нову Пошту, Укрпошту, Meest і Rozetka Delivery в одному модулі OpenCart 3. Одна адмінка, одна панель ТТН, один cron, який тягне статуси перевізників і сам переводить замовлення у ваш статус «Виконано» або «Повернуто». Плюс пікер міста і відділення прямо на оформленні, який вбудовується у поля магазину, а не показує окремий блок збоку.

Головна ідея: створення і супровід накладної для магазину має бути одним кліком, а не переходом між кабінетами перевізників. Менеджер відкриває замовлення, бачить кнопку «Створити ЕН», модуль сам знає адресу, знає вагу, знає суму післяплати за розміткою способу оплати, і накладна створена. Далі cron кожної ночі перевіряє статуси всіх активних ТТН і сам переводить замовлення у налаштований вами статус, коли клієнт отримав або повернув посилку. Стос післяплат розібраний.

Що ви отримуєте, детально

Що це означає простими словами

Магазин з 40 замовленнями на день. До ShippingHub: 40 хвилин щоранку копіювання адрес у кабінет Нової Пошти, окремо кабінет Укрпошти для міжнародних, окремо Meest. Плюс годину ввечері перевіряти, які посилки клієнти отримали, які повернулись, руками ставити статус у OpenCart.

Після ShippingHub: менеджер відкриває OpenCart, вибирає у списку 40 замовлень, тисне «Створити ЕН», модуль пробігає по кожному з правильною сумою післяплати. Далі магазин відкриває реєстр Нової Пошти на 30 накладних, друкує, кладе у пачку і відносить у відділення. Ввечері нічого перевіряти не треба: cron уже перевів отримані замовлення у «Виконано».

Нова Пошта, Укрпошта, Meest і Rozetka Delivery працюють з однієї адмінки

✓ Чотири перевізники в одній адмінці
Нова Пошта, Укрпошта, Meest, Rozetka Delivery. У Нової Пошти: доставка на відділення, поштомат, за адресою кур’єром. У кожного окрема вкладка з ключами API. Один список ТТН на всіх, з фільтрами за перевізником, статусом, датою.
⚠ Без цього: три різні модулі, три адмінки, і жодного місця, де видно всі накладні разом.

✓ Кеш відділень і поштоматів
Модуль тримає локальну копію довідника відділень (нічна синхронізація). Автокомпліт міста і відділення читає з локальної бази, коли синхронізація свіжа (14 днів), і б’є API Нової Пошти лише коли локального нема або результат порожній. Це прискорює оформлення і не витрачає ліміти API. Rate-limit на пошук у 40 запитів/хвилину як додаткова страховка.
⚠ Без цього: кожне натискання клавіші у полі «Місто» б’є живий API, а на популярних магазинах ліміт вичерпується посеред робочого дня.

✓ Захист секретних ключів API
Ключі API Нової Пошти, Meest, Rozetka і Укрпошти показуються у полях типу «пароль» з підписом «Ключ збережено», а не відкритим текстом. Читач-адмін бачить поля неактивними. Очищення ключа окремим чекбоксом, щоб випадкове порожнє поле не затерло робочий ключ. Ключ не потрапляє у посилання друку і в HTML сторінки.
⚠ Без цього: ключ Нової Пошти видно в HTML сторінки, будь-який доступ до бекапу дорівнює доступу до API перевізника.

Покупець обирає місто і відділення без помилок, а вартість доставки рахується сама

✓ Пікер міста і відділення прямо у полях магазину
Widget оформлення заповнює поле «Місто» вашого чекауту з підказкою (з областю поруч, коли є однойменні міста), а поле «Адреса 1» перетворює на список відділень або поштоматів вибраного міста. Це не окремий блок збоку, а вбудований у ваші поля. Працює у стандартному OpenCart 3, ocStore 3, а також у SmartOrder. Пункти самовивозу магазину і локальний кур’єр показуються як окремі рядки у списку способів доставки, а не збиваються в один груповий блок, тому стокове оформлення бачить їх як звичайні методи.
⚠ Без цього: клієнт вручну переписує «м. Львів, відділення 5» у поле «Адреса», а ви потім витираєте зайві коми у CRM.

✓ Перевірка вибору відділення на сервері
На кроці «Оформити замовлення» модуль ще раз перевіряє, що покупець справді обрав місто і відділення для методу Нової Пошти (або адресу для кур’єра, або поштомат). Не можна пройти повз JavaScript і надіслати замовлення з пустою адресою. Перемикач «Вимагати вибір точки» вмикається за замовчуванням.
⚠ Без цього: приходить замовлення з полем «Адреса» = «Львів», і менеджер вручну шукає, куди його відправити.

✓ Тарифні зони і калькуляція вартості
Задаєте власні тарифні зони (об’єднання областей і країн) і для кожної підметодики перевізника вказуєте свою вартість (або лишаєте «за тарифом перевізника»). Порожня ціна на оформленні показується як «за тарифом перевізника», а не «0 грн», щоб покупець не сподівався на безкоштовну доставку. Якщо у Нової Пошти платник «Отримувач», а магазин ще й бере тариф на оформленні, адмін бачить попередження про подвійну оплату.
⚠ Без цього: покупець побачив «0 грн», приїхав у відділення, там взяли 90 грн, клієнт незадоволений.

ТТН, друк і реєстри робите прямо з картки замовлення

✓ Створення ТТН з картки замовлення
Відкриваєте замовлення, у панелі ShippingHub тиснете «Створити ЕН». Модуль сам збирає адресу, вагу (з товарів або із загальної настройки), опис вантажу, суму післяплати (за розміткою способу оплати), об’явлену вартість. Якщо у замовленні вже є накладна, модуль просить підтвердження, а не робить дубль. Пакетне створення накладних одним натиском теж є: обираєте кілька замовлень у списку, натискаєте «Створити ЕН», модуль пробіжить по кожному.
⚠ Без цього: 20 хвилин у кабінеті перевізника, руками копіювати адресу і вагу з OpenCart.

✓ Друк ЕН і реєстрів через сервер магазину
Кнопки «Друк A4», «Друк Zebra», «Друк реєстру» відкривають PDF з домену вашого магазину, а не пряме посилання Нової Пошти з вбудованим API-ключем. Ваш ключ ніколи не потрапляє у HTML сторінки і не витікає у логи проксі.
⚠ Без цього: API-ключ Нової Пошти лежить у href прямо в панелі замовлення і легко копіюється.

✓ Реєстри Нової Пошти
Обираєте пачку ТТН, створюєте реєстр в один клік, друкуєте. Модуль сам робить запити до API реєстрів Нової Пошти і зберігає посилання, щоб перевізник у відділенні приймав відразу пакет замість перевірки кожної посилки окремо.
⚠ Без цього: створення реєстру у кабінеті перевізника, потім скачати PDF, потім друкувати.

✓ Панель у картці замовлення
У кожному замовленні OpenCart з’являється блок ShippingHub: обране місто, відділення, ТТН з посиланням на трекінг, статус ТТН, історія трекінгу, кнопки «Створити», «Друк», «Видалити». Панель показується тільки на замовленнях з методом ShippingHub, щоб не забруднювати картки з іншими способами.
⚠ Без цього: інформацію про ТТН менеджер шукає у коментарях замовлення.

Статуси замовлень оновлюються самі, поки посилка в дорозі

✓ Автоматичне оновлення статусів замовлень за статусами ТТН
CRON-скрипт php cli/shipping_hub_track.php (запускається планувальником хостингу зазвичай раз на годину) читає статуси всіх активних ТТН з API перевізників і переводить замовлення у ваш налаштований статус: «Отримано», «В дорозі», «Повернуто», «Скасовано». Статус змінюється штатним механізмом OpenCart, тобто спрацьовують стандартні події, покупцю йде лист (якщо ви це задали). Мапу «код статусу перевізника → статус замовлення OpenCart» ви редагуєте прямо в адмінці модуля, без залізання у базу. Оновлення застосовуються навіть коли магазин у режимі обслуговування.
⚠ Без цього: менеджер щодня заходить у кабінет Нової Пошти, вручну звіряє статуси і руками переводить замовлення.

✓ Мапа статусів ТТН, яку ви редагуєте самі
Окрема сторінка модуля показує всі коди статусів Нової Пошти з їх поясненнями і select «У який статус замовлення переводити». Хочете, щоб «Отримано клієнтом» переводило замовлення у «Виконано», а «Відмова від отримання» у «Повернуто», задаєте раз, працює далі саме. Прапорець «Сповістити покупця» на кожному рядку окремо.
⚠ Без цього: щоб змінити відповідність, доводиться правити код або лізти у базу.

Післяплата, передоплата, самовивіз і свій кур’єр налаштовуються один раз

✓ Розмітка способів оплати: післяплата чи передоплата
На вкладці «Оплата» ви позначаєте кожен код способу оплати магазину: це післяплата чи передоплата. Модуль сам розмічає коди, що містять «cod». Далі при створенні накладної: замовлення з post-плати автоматично отримує суму післяплати з суми замовлення, замовлення з передоплатою іде без післяплати. Якщо спосіб не розмічений і менеджер створює накладну руками, модуль вимагає підтвердження, а не заповнює тихо нуль. Створення накладної на замовлення, яке вже помічене як передплачене, теж вимагає підтвердження, щоб клієнту не виставили платіж двічі.
⚠ Без цього: одне замовлення поїхало без стягнення грошей, а на другому клієнту вдруге виставили післяплату.

✓ Пункти самовивозу і локальний кур’єр
Магазин може задати власні пункти самовивозу (адреса, години роботи, ціна) і локальних кур’єрів (за містом, з ціною за виклик або за кг). Кожен пункт і кожен кур’єр показується як окремий рядок у списку способів доставки, а не «Самовивіз» одним групованим блоком, який ламався у стоковому OpenCart.
⚠ Без цього: клієнт не бачить конкретного пункту, тому пише у коментарі «заберу з магазину на Шевченка».

Технічні деталі

• Перевізники: Нова Пошта (відділення, поштомати, кур’єр), Укрпошта, Meest, Rozetka Delivery.
• Створення ТТН з панелі замовлення (пооднинці і пакетом), автоматичне заповнення адреси, ваги, суми післяплати, об’явленої вартості.
• CRON php cli/shipping_hub_track.php, in-process (без внутрішніх HTTP-запитів до самого себе), працює навіть при увімкненому режимі обслуговування магазину. Використовує штатний addOrderHistory OpenCart, тобто спрацьовують стандартні події.
• Мапа кодів статусів Нової Пошти на статуси замовлень OpenCart, редагується в адмінці модуля.
• Widget оформлення: підказка міста з областю, вибір відділення/поштомату/адреси, вбудований у ваші поля селекторами.
• Локальний кеш відділень (нічна синхронізація), rate-limit пошуку, ключ у password-полі з placeholder «Ключ збережено».
• Реєстри Нової Пошти (створення, друк).
• Кнопка «Очистити робочі дані модуля» для рестарту з нуля без переустановки.
• OCMOD файлова доставка, підтримка стокової теми OpenCart 3, ocStore 3 і адаптація до тем oct_deals (окремий OCMOD).

Працює разом з іншими модулями оформлення OcBox

Модулі розраховані на спільну роботу. ShippingHub не дає створити ТТН, поки PaymentHub не підтвердив оплату. Shipping Rules вирішує, які доставки й оплати бачить покупець. SmartOrder збирає все це на одній сторінці оформлення. При цьому кожен модуль працює і окремо, на стандартному оформленні OpenCart.

• OcBox PaymentHub: усі українські онлайн і офлайн оплати, статус «Оплачено» ставиться сам, повернення коштів з картки замовлення.
• OcBox SmartOrder: оформлення замовлення на одній сторінці, купівля в один клік, покинуті кошики.
• OcBox Shipping Rules: правила показу доставок і оплат, тарифи за вагою і сумою кошика, доплати.

Сумісність

• OpenCart 3.0.x та ocStore 3.0.x
• PHP 7.4+
• ionCube Loader: потрібен (версія 14 або вище)
• SmartOrder інтеграція «з коробки»: widget доставки і карта післяплата/передоплата працюють на швидкому оформленні.

Робочого файла модуля на форумі немає, тут описова сторінка. Кожна збірка компілюється індивідуально під ваш домен, тому доступ до завантаження надається після оплати. Напишіть в особисті повідомлення і вкажіть домен, версію PHP і версію ionCube Loader.

ionCube Loader: зверніть увагу!
Модуль закодований ionCube Encoder 15. Для роботи потрібен ionCube Loader версії 14 або вище. Якщо у вас на хостингу встановлений Loader 13.x або нижче, модуль не запуститься.

Купуючи зараз, ви отримуєте повний доступ до всіх чотирьох перевізників, cron-трекера, панелі ТТН і всіх виправлень протягом року. Кожна нова версія оголошується у вкладці «Журнал змін» на форумі.

Продовження ліцензії на оновлення

У вартість модуля вже входить рік оновлень. Далі продовження за тією ж ціною щорічно, щоб отримувати нові версії. Якщо не продовжувати, модуль продовжує працювати як і раніше, просто без нових версій. Клієнти, які придбали до впровадження продовжень, зберігають умови на дату покупки. Продовження не включає повторну ionCube-компіляцію, установку та персональні консультації.

Регламент видачі файлів модуля

У робочі дні в робочий час файл модуля передається покупцеві протягом доби з моменту оплати, як правило менш ніж за годину. У вихідні дні та офіційні (державні) свята можливі затримки, модуль буде надісланий з настанням найближчого робочого дня. Дякуємо за розуміння.

Рекомендовані платні модулі OcBox

Smart Related $30 — пов’язані товари	SEO FAQ AI $30 — AI FAQ + Schema.org	AI Product Editor $50 — масове редагування
Image Pro $15 — WebP, водяний знак	Filter $30 — розумний фільтр + SEO	Category Manager $15 — візуальний менеджер категорій
AI Smart Search $200 — AI-пошук з синонімами	AI Chat $100 — AI-консультант 24/7	AI Photo Studio $50 — AI-обробка фото
PaymentHub $80 — хаб оплат	SmartOrder $30 — швидке замовлення	ShippingRules $30 — правила доставки
AI Megareports $20 — звіти й Telegram-дайджест	Product Bundles $30 — комплекти і набори	Simple Super Search $15 — нечіткий пошук без Sphinx

Підписуйтесь на наш канал: t.me/ocboxchannel