OcBox Мультивалютні товари — ціна у валюті постачальника з автоперерахунком у валюту магазину для OpenCart 3 і ocStore

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

Знайома ситуація?

Ви закуповуєте товар у постачальника в USD або EUR, а каталог у гривні. Курс стрибнув на 70 копійок, менеджер відкриває Excel, рахує, відкриває адмінку, править ціну у 180 картках товару, зберігає. На цьому йде три години, і на половині він уже плутається, у кого ціна в UAH, а у кого насправді в доларах. Це робота, яка добре робиться машиною.

Паралельно у вас є ті самі товари у Rozetka або Prom, де ціни теж відстають. Сусід-конкурент уже підняв ціну за ніч, а ви ще два дні продаватимете собі в мінус, бо «не встигли переставити». Або ж навпаки, курс пішов донизу, і ви тижнями тримаєте завищену ціну, бо «ну колись переставимо», і втрачаєте продажі.

Паралельно OpenCart має штатну таблицю валют, яку можна оновлювати з Європейського центрального банку одним кліком. Але ця таблиця керує лише тим, що показується покупцю при перемиканні валюти на вітрині. Базова ціна в oc_product.price лежить мертво, як її колись туди записали. OcBox Мультивалютні товари зв’язує ці дві речі: ваша базова ціна тепер залежить від курсу, а не стоїть памʼятником.

А тепер уявіть, як буде з модулем

Ви вводите в адмінці нову модель чайника. У вкладці «Валютна ціна» вмикаєте галочку «Товар у валюті», обираєте «USD», вводите 65.00. Зберігаєте. Модуль бере актуальний курс USD з таблиці валют (припустимо, 41.50), ділить і записує в oc_product.price значення 1.5663 (базова валюта магазину це гривня, і OpenCart сам покаже покупцю 65.00 UAH × 41.50 = 2697.50 грн, якщо вітрина в гривні, або 65.00 доларів, якщо вітрина в доларах). Ви більше не тримаєте в голові, що там у вас виходить у гривнях.

Через два тижні курс USD став 42.80. Нічний крон пробігає по 120 вашим мультивалютним товарам, бере новий курс, перераховує і оновлює oc_product.price для кожного з них. Уранці ви відкриваєте каталог — ціни свіжі, ніхто руками нічого не чіпав.

Якщо захочете подивитися, що саме змінилось, відкриваєте вкладку модуля — зі списком бачите «USD 65.00 → базова 1.5187» (застарілий курс) замінилось на «USD 65.00 → базова 1.5187» (новий курс). Поряд дата останнього перерахунку. Усе чесно, нічого не прихвано.

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

Крок 1. Ви вмикаєте валютну ціну у товара. Відкриваєте картку товару → нова вкладка «Валютна ціна». Галочка «Товар у валюті», список валют (беруться зі штатних валют OpenCart зі статусом «активно»), поле з ціною. Зберігаєте товар.

Крок 2. Модуль рахує базову ціну. При збереженні товару бере вашу ціну у валюті, ділить на курс цієї валюти (значення зі штатної таблиці oc_currency.value) і округлює до заданої кількості знаків. Результат пише в oc_product.price. Паралельно записує «я тут стежу» в свою таблицю: product_id, валюта, оригінальна ціна, застосований курс.

Крок 3. CRON перераховує при зміні курсу. Коли штатне оновлення валют OpenCart (той самий «Оновити з ЄЦБ» або будь-яке стороннє оновлення) змінило значення в oc_currency.value, модуль при наступному запуску крона бере нові значення і переставляє oc_product.price для всіх мультивалютних товарів. Якщо курс не змінився з минулого прогону — товар просто пропускається.

Крок 4. Ви бачите стан у списку модуля. Окрема сторінка «OcBox Мультивалютні товари» показує таблицю: товар, валюта, ціна у валюті, застосований курс, поточна базова ціна, дата останнього перерахунку. Знизу ненадовго підсвічуються «не ті» рядки — ті, у кого валюта в OpenCart вимкнена або видалена. Такі товари модуль не перераховує, бо не знає, на що множити, і чесно каже про це.

Крок 5. Без зміни курсу — без зайвих оновлень бази. Модуль порівнює новий курс з тим, що був застосований минулого разу, з точністю 1e-8. Якщо різниці немає, UPDATE не виконується. Ваша база не отримує зайвих писань просто через те, що крон запустився ще раз.

Користь: прайс постачальника це єдина цифра, яку вам треба памʼятати по кожному товару. Решту рахує модуль, і рахує при кожному стрибку курсу.

Три прості сценарії, під які модуль заточений

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

Магазин меблів з польським постачальником. Прайс у PLN, каталог в EUR для європейських клієнтів. Вводите ціну в PLN, у магазині базова валюта EUR, модуль ділить на курс PLN/EUR і пише EUR в oc_product. Покупець бачить EUR, ви памʼятаєте PLN.

Український магазин з частково імпортним каталогом. Половина товарів наші, половина заходить з-за кордону в USD. Модуль чіпає тільки мультивалютні товари, інші не торкає взагалі. oc_product.price вашого вітчизняного каталогу лежить, як лежав.

Вже користуєтесь модулем «Валюта Плюс»? Переходьте без втрат

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

Переносяться не тільки ціни товарів. Якщо у вас заповнені іноземні ціни у варіантах, акціях і знижках, вони переїдуть теж, разом з налаштуванням округлення. Номінал курсу, коли курс задано не за одну одиницю валюти, наш модуль теж розуміє.

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

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

Чесно про межі

• Модуль не оновлює курси валют сам. Він читає oc_currency.value, тобто використовує те, що оновлюється штатним механізмом OpenCart (ЄЦБ) або будь-яким вашим зовнішнім інструментом. Якщо курс у вас стоїть місяцями без оновлень, модуль працюватиме за старим курсом.
• Один рядок валюти на товар. Якщо вам треба зберігати «USD для одного постачальника і EUR для іншого» на одному товарі, це не цей модуль. Один товар — одна валюта.
• Товар зі спеціальною ціною (знижка/акція) перерахунок не чіпає. Знижки лежать у oc_product_special окремо і модуль з ними не воює. Якщо знижка задана в UAH, вона в UAH і залишиться.
• Валютна ціна не враховує націнку/маржу. Якщо вам треба «USD × 1.15 + 100 грн обробки», це вже калькулятор ціноутворення, а не мультивалюта. Напишіть окремо, це індивідуальна доробка.
• Тільки OpenCart 3.0.x і ocStore 3.x. Окремої збірки під 2.3 і 4 поки немає.

Ці межі ми ставимо навмисно, бо модуль за $10 має робити одну задачу добре, а не намагатись покривати кожну схему ціноутворення у світі. Усе, що не вкладається у вузьку схему «ціна у валюті × курс = базова», — це окрема доробка, і про неї поговоримо приватно.

Як запустити, у 3 кроки

Крок 1. Скопіюйте файли на хостинг, у адмінці натисніть «Оновити» в «Модифікаціях», потім встановіть модуль у «Модулях».

Крок 2. Відкрийте «OcBox Мультивалютні товари» → валюта за замовчуванням (USD або EUR), округлення (0, 2 чи 4 знаки). Збережіть. Переконайтесь, що у «Локалізація → Валюти» відповідні валюти увімкнені і мають адекватний курс.

Крок 3. Пропишіть CRON (команда готова на сторінці модуля, скопіювати і вставити в cPanel/ISPmanager), раз на 10–60 хвилин. Або натисніть «Запустити зараз», щоб переконатись, що все йде як треба.

Після цього можна відкривати будь-який товар, перемикатись на вкладку «Валютна ціна», і починати ставити ціни у валюті. Існуючий каталог модуль не чіпає, доки ви явно не ввімкнете мультивалютний режим у конкретному товарі.

Кому підійде, а кому ні

Підійде:

• Магазинам, що закуповують в однієї валюти, а продають у іншій (USD → UAH, EUR → PLN, PLN → EUR і т.д.).
• Магазинам з частково імпортним каталогом, де тільки частина позицій у валюті постачальника, а інша у рідній валюті магазину.
• Власнику, який не хоче щодня перераховувати ціни руками через стрибки курсу.
• Магазинам, де ціна в oc_product.price це єдиний канал ціни (без агресивних знижок у спецпропозиціях і без калькулятора маржі).

Не підійде:

• Магазинам, де на одному товарі має бути ціна в кількох валютах одночасно (наш модуль — одна валюта на товар).
• Магазинам з хитрою маржею типу «курс × 1.15 + фіксована націнка» — це вже калькулятор ціноутворення, окрема доробка.
• Магазинам, що покладаються на oc_product_special для «ціна постачальника» — модуль працює з основною ціною, не зі знижками.
• OpenCart 2.3 чи 4: окремої збірки немає.

Часті питання перед покупкою

Чи буде модуль сам оновлювати курси валют з банку?
Ні. Курси валют оновлює штатний механізм OpenCart (ЄЦБ, одним кліком з «Локалізація → Валюти») або будь-який ваш модуль. Наш модуль читає значення зі штатної таблиці валют і переставляє на їх основі базову ціну товарів.

А як покупець побачить ціну на вітрині?
Так само, як у стандартному OpenCart. Магазин має базову валюту (у вашому випадку, скажімо, UAH), і покупець на вітрині може перемикатись між увімкненими валютами. Ціна показується з перерахунком через штатну таблицю валют. Наш модуль лише тримає базову ціну (UAH) актуальною до курсу USD.

А якщо в OpenCart моя базова валюта USD, а не UAH?
Усе працює так само. Якщо ви задали ціну в EUR, а базова валюта магазину USD, модуль порахує USD-ціну з EUR / курс EUR і запише її в oc_product.price.

Чи буде модуль чіпати товари, у яких я не ввімкнув вкладку «Валютна ціна»?
Ні. Модуль працює лише з тими товарами, де ви явно ввімкнули прапорець «Товар у валюті». Усі інші товари OpenCart лежать, як лежали.

Чи працюють з модулем спеціальні ціни (знижки, акції)?
Так, у штатному OpenCart спецціна це окрема таблиця oc_product_special, і модуль її не чіпає. Якщо ви задали знижку на товар у UAH, вона в UAH і залишиться. Якщо вам треба, щоб і спецціна рахувалась із валюти постачальника, це окрема доробка.

Як часто ставити CRON?
Один раз на 15–60 хвилин достатньо. Якщо курсу не змінилось, модуль одразу виходить, навантаження немає. Паралельний запуск захищено блокуванням, два прогони не зіткнуться.

Чи буде модуль чіпати ціну, якщо курс не змінився?
Ні. Модуль порівнює новий курс з раніше застосованим (точність 1e-8), і якщо різниця менша — не виконує UPDATE взагалі.

Якщо я вимкну валюту в OpenCart, що буде з товарами, у яких вона виставлена?
Товари залишаться з раніше розрахованою базовою ціною (бо її востаннє порахували з робочим курсом). У списку модуля ці товари підсвічуються — валюта «невідома» або «вимкнена», — і модуль їх більше не перераховує, поки ви не повернете валюту в активну.

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

Як отримати файли?
Доступ до завантаження надається після оплати.

Ціна, ліцензія і як отримати

• Ліцензія на домен магазину і тестовий домен.
• Назавжди: модуль працює без обмежень у часі.
• Перший рік оновлень уже входить у ціну.
• Доступ до завантаження надається після оплати.
• Питання і зв’язок: особисті повідомлення профілю OcBox.

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

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

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

Smart Related $30: пов’язані товари	SEO FAQ AI $30: AI FAQ + Schema.org	AI Chat $100: AI-консультант 24/7	AI Product Editor $50: масове редагування
Image Pro $15: WebP, водяний знак	PageSpeed Suite $40: прискорення сайту	Category Manager $30: візуальний менеджер категорій	AI Photo Studio $50: AI-обробка фото
Product Showcase $25: хіти, новинки, акції	AI Smart Search $200: AI-пошук з синонімами	Filter $30: розумний фільтр + SEO	Remarketing $40: ремаркетинг і аналітика
PaymentHub $80: хаб оплат	ShippingHub $80: хаб доставок	SmartOrder $30: швидке замовлення	Shipping Rules $30: правила доставки
AI Мегарепорти $20: звіти і Telegram-дайджест	Product Bundles $30: комплекти і набори	Simple Super Search $50: нечіткий пошук без Sphinx	OcBox MEGA $30: шаблон і комплект модулів
AI Quiz $50: AI-квіз підбору товарів	Універсальний імпорт $50: імпорт прайсів постачальників	Відгуки Pro $30: відгуки з фото і відео	Варіанти товару $30: матриця розмір і колір
ChatGPT Ads $10: реклама в ChatGPT	Кинутий кошик $10: повернення кинутих кошиків	Admin MCP $10: ШІ-керування адмінкою	Вчасно.Каса $10: фіскалізація чеків
Рупор $40: email, SMS, Viber, Telegram розсилки	Order Editor $40: редагування замовлень як людина	CRM Hub $40: єдина панель замовлень	Експорт у XML $10: експорт замовлень у XML
SEO Manager $40: SEO-аудит і ШІ-виправлення

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