OcBox Shipping Rules — правила доставок і оплат для OpenCart 3 і ocStore, 26 типів умов, тарифи за вагою і сумою

OcBox Shipping Rules, правила доставок і оплат для OpenCart 3

Ви коли-небудь пробували вимкнути «Післяплату» у стандартному OpenCart для замовлень до 300 грн, щоб не платити комісію Нової Пошти на копійках? Або показати «Безкоштовну доставку» тільки клієнтам з групи «Оптовик»? Або приховати «Оплату частинами» для товарів з категорії «Розпродаж»? У стоковому OpenCart це або окрема доробка коду, або хардкод у контролері.

OcBox Shipping Rules робить це правилами в адмінці. Задаєте умову (сума кошика, категорія, група покупців, місто, будь-що з 26 типів) і дію: приховати спосіб, показати заглушку з поясненням, змінити ціну, змінити назву, додати доплату за спосіб оплати. Стандартний OpenCart 3 просто виконує правила, які ви задали, без єдиної правки коду теми чи модуля перевізника.

Головна ідея: покупець бачить на оформленні тільки ті способи доставки і оплати, які реально можна для його кошика, і в тій ціні, яку ви задали правилом. «Безкоштовна доставка від 2000 грн», «Післяплата тільки Новою Поштою і на суму до 20000», «Розстрочка тільки для клієнтів з групи "Оптовик" і не для товарів з категорії "Знижки"», «Кур’єр по Києву дорожче після 20:00», «Не показувати оплату часткою на кошиках з купоном», усе це стає одним рядком у списку правил.

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

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

Ви продаєте меблі. Ціни від 500 до 30000 грн. Логістика: власний кур’єр по Києву (500 грн), Нова Пошта відділення (за тарифом), Нова Пошта адресна (за тарифом плюс 100), самовивоз (безкоштовно). Оплата: LiqPay, післяплата, оплата на IBAN ФОП, розстрочка Monobank. Реальні бізнес-правила магазину: «Розстрочка тільки на замовлення від 3000 грн», «Післяплата тільки Новою Поштою і не для клієнтів з групи Опт», «Оптовикам показувати -3% на передоплату», «Кур’єр Києвом дорожче на 30% після 20:00», «Пакування 50 грн для замовлень > 15 кг», «Не пропонувати доставку у Донецьку і Луганську області».

Без Shipping Rules: 6 правил у 4 різних місцях, частина у коді. З Shipping Rules: 6 правил на одній сторінці адмінки, редагуються без розробника.

Ви ховаєте або змінюєте доставку й оплату за умовами, без правки коду

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

✓ 26 типів умов
Сума кошика, вага кошика, кількість товарів, кількість позицій, мінімальна сума замовлення, ID товару, ID категорії, ID виробника, група покупців, покупець авторизований чи гість, ID покупця, країна, область/регіон, гео-зона, місто, поштовий індекс, діапазон індексів, день тижня, діапазон часу, діапазон дат, метод доставки, метод оплати, магазин, мова, валюта, застосований купон. Кожна умова має свій набір операторів (=, ≠, >, <, між, входить у список, містить). Умови об’єднуються булевим виразом типу $0 AND ($1 OR $2), з підтримкою !, &&, ||.
⚠ Без цього: правило «безкоштовно від 2000 грн клієнтам з групи Оптовик» це або конструктор із 3 стокових обмежень, або код.

✓ Дія «Приховати» або «Змінити»
Кожне правило працює в одному з двох режимів. «Приховати, якщо умова не виконана» показує спосіб тільки коли всі умови справджуються, інакше спосіб зникає з оформлення. «Змінити, якщо умова виконана» лишає спосіб на місці, а коли умова виконана, застосовує задані зміни (нова ціна, нова назва, нова іконка, нова доплата), інакше нічого не робить. У «Приховати» можна ще й показати замість способу заглушку з пояснювальним текстом «Доступно лише для замовлень від 2000 грн, з підказкою користувачу», яку не можна обрати, тільки прочитати.
⚠ Без цього: спосіб просто зникає, і покупець не розуміє чому. Пише в підтримку.

Тарифи за вагою і сумою кошика та доплати налаштовуєте самі

✓ Тарифи за вагою або за сумою кошика
У власному правилі доставки можна задати тарифи за рівнями: до 1 кг, 60 грн, 1-3 кг, 90 грн, 3-10 кг, 150 грн, від 10 кг, 300 грн. Або за сумою: до 500 грн, 60 грн, 500-1500 грн, 30 грн, від 1500 грн, 0 грн. Кошик поза всіма діапазонами приховує спосіб (не тягне останній тариф), тому «безкоштовно від 2000» працює як задумано.
⚠ Без цього: тарифи задаються тільки в шаблоні перевізника, і зміни треба узгоджувати з розробником модуля.

✓ Доплата за спосіб оплати
На будь-який спосіб оплати (свій або існуючий) можна повісити доплату: фіксована сума або відсоток від підсумку замовлення. Наприклад, +2% на LiqPay, щоб покривати комісію банку. Або +50 грн на «Оплата кур’єру». Або -3% на передоплату як мотивація. Доплата видно у підсумках одразу після вибору способу, а не тільки на кроці «Оформити».
⚠ Без цього: комісії банку доводиться закладати в ціну товару для всіх клієнтів.

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

Покупець бачить зрозумілі способи з описом та іконкою

✓ Власні способи оплати з інформаційним текстом
Створюєте власний спосіб оплати (наприклад, «Оплата на IBAN ФОП» або «Через криптогаманець»), задаєте назву, іконку, текст-інструкцію для покупця («Ми надішлемо реквізити на пошту після оформлення»), статус замовлення після вибору, текст для листа-підтвердження. Спосіб з’являється на оформленні як звичайний, з умовами показу як у будь-якого правила.
⚠ Без цього: додати «Оплату на IBAN» це або модуль-фейк, або сторонній прайс-плагін.

✓ Опис і іконка методу на оформленні
Кожне правило має поле «Опис» і поле «CSS-клас або зображення іконки». На оформленні поруч зі способом показується коротке пояснення (наприклад, «Доставка 1-3 робочі дні») і ваша іконка (наприклад, лого перевізника). Все на 3 мови, які підтримує ваш магазин.
⚠ Без цього: у списку способів голі текстові рядки.

✓ Працює на стандартному оформленні і в SmartOrder
Стандартний OpenCart 3 і ocStore 3 через OCMOD (без ручних правок ядра). SmartOrder бачить правила Shipping Rules з коробки: приховані способи показуються як заглушки, свої способи оплати рендеряться як окремі картки, доплата за оплату оновлюється у підсумках одразу після кліку. Треті чекаути можуть використовувати наш публічний API у своїх адаптерах.
⚠ Без цього: правила довелося б переписувати в кожному чекауті окремо.

Помилка в правилі не зламає оформлення замовлення

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

✓ Панель стану підключення і виправлення
На сторінці модуля бачите блок «Стан підключення»: чи зареєстрований у Розширення > Доставка, у Розширення > Оплата, у Розширення > Підсумки замовлення, який статус (увімкнено / вимкнено / видалено власником). Кнопка «Відновити» ставить назад запис, який стокова адмінка OpenCart тихо видалила при відкритті сторінки Extensions. Плюс перемикач «Статус модуля» вимикає всі правила разом без видалення.
⚠ Без цього: після відкриття Extensions правила зникають, і магазин думає, що модуль зламався.

✓ Валідація умов при збереженні: не пропускає невалідне
Якщо ви вводите «діапазон дат 2026-13-45» або оператор «між» без другого числа або вираз $0 AND $5 з не існуючою умовою, модуль показує помилку прямо у формі і не зберігає правило. Правила, які збереглися до цієї версії з поламаними умовами, оцінюються як «false» (правило не спрацьовує, спосіб не проходить), а на сторінці модуля видно попереджувальний список «Ці правила треба виправити». Fail-closed за замовчуванням, щоб не було випадку «покупець отримав знижку через кривий вираз у правилі».
⚠ Без цього: тихо помилкове правило спрацьовує там, де не треба.

✓ Експорт і імпорт правил
Кнопки «Експорт» і «Імпорт» дозволяють перенести правила між магазинами (наприклад, з тестового на бойовий, чи між двома доменами). Імпорт валідує кожне правило, показує «додано / оновлено / пропущено» і список помилок, якщо щось не сходиться.
⚠ Без цього: 40 правил переносяться руками півдня.

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

• 3 типи правил: shipping, payment, total. Кожен тип реєструється у Розширення > Доставка / Оплата / Підсумки замовлення.
• 26 типів умов, оператори з whitelist на тип, булеві вирази з дужками, AND / OR / NOT та && / || / !.
• Тарифи за рівнями (weight tiers, cart total tiers), фіксована вартість, відсоток від суми кошика, вартість за кг ваги.
• Доплата за оплату: фіксована сума або відсоток від поточного підсумку замовлення на позиції правила.
• Група правил з ключем + режим «незалежний / найдешевший / найдорожчий».
• Опис і CSS-клас або зображення іконки на 3 мови.
• Спосіб-заглушка з пояснювальним текстом (не як кнопка, а як пояснення) для прихованих правилом методів.
• Валідація вибору на кроці confirm (штатний і SmartOrder), очищення сесії при перемиканні.
• Панель «Стан підключення» з кнопкою «Відновити» на кожен тип розширення, перемикач статусу модуля.
• Валідація умов і виразу на збереженні, fail-closed при поламаних правилах, попереджувальний список у налаштуваннях.
• Експорт і імпорт правил у форматі JSON, з валідацією на імпорт.
• Відкритий API правил доставки й оплати для інтеграції зі сторонніми чекаутами.
• OCMOD для стокової теми OpenCart 3, ocStore 3. Опис і іконка методу підтягуються з OCMOD-модифікації twig-шаблонів списку способів.

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

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

• OcBox PaymentHub: усі українські онлайн і офлайн оплати, статус «Оплачено» ставиться сам, повернення коштів з картки замовлення.
• OcBox ShippingHub: Нова Пошта, Укрпошта, Meest і Rozetka Delivery, ТТН з картки замовлення і статуси доставки без ручної роботи.
• OcBox SmartOrder: оформлення замовлення на одній сторінці, купівля в один клік, покинуті кошики.

Сумісність

• OpenCart 3.0.x та ocStore 3.0.x
• PHP 7.4+
• ionCube Loader: потрібен (версія 14 або вище)
• Стандартна тема, шаблони на її основі, а також SmartOrder з коробки. Для тем з сильною кастомізацією twig-шаблонів списку способів іконка і опис можуть не підтягнутись, у документації розписано, як це виправити (одна операція OCMOD).

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

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

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

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

У вартість модуля вже входить рік оновлень. Далі продовження за тією ж ціною щорічно, щоб отримувати нові версії. Якщо не продовжувати, модуль продовжує працювати як і раніше, просто без нових версій. Клієнти, які придбали до впровадження продовжень, зберігають умови на дату покупки. Продовження не включає повторну 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 — хаб оплат	ShippingHub $80 — хаб доставок	SmartOrder $30 — швидке замовлення
AI Megareports $20 — звіти й Telegram-дайджест	Product Bundles $30 — комплекти і набори	Simple Super Search $15 — нечіткий пошук без Sphinx

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