VibeFox Econt for OpenCart — Допомога

Вимоги

OpenCart: 3.0.x (перевірено на 3.0.5.0) або 4.0.2 і новіша (перевірено на 4.1.0.3).

PHP: 8.0 або новіша версія.

Країни: Болгарія та Румунія мають бути увімкнені в System > Localisation > Countries.

Econt: договір і ключ API не потрібні. Список відділень є публічним довідником Econt. До Econt надсилається лише код країни, без даних покупців. Вкажіть ім'я користувача та пароль e-Econt, лише якщо Econt вимагає від вашого магазину авторизацію. Вхід до e-Econt описано на сторінці розробників Econt (econt.com/developers).

Ліцензійний ключ VibeFox: купується на vibefox.net. Один ключ працює на одному домені.

Встановлення

Завантаження — це один zip-файл із пакетами для обох версій OpenCart. Розпакуйте його на своєму комп'ютері. Він містить README.txt, пакет для OpenCart 3 vfd_econt-oc3-(версія).ocmod.zip та пакет для OpenCart 4 vfd_econt.ocmod.zip. Встановлюйте лише пакет для вашої версії OpenCart. Ліцензійний ключ однаковий для обох версій.

OpenCart 3

1. В адмін-панелі перейдіть до Extensions > Installer, натисніть Upload і виберіть файл vfd_econt-oc3-(версія).ocmod.zip. Розширення не додає модифікацій OCMOD, тож оновлювати Extensions > Modifications не потрібно. Замість інсталятора можна скопіювати вміст папки upload із цього пакета в кореневу папку вашого магазину.

2. Перейдіть до Extensions > Extensions і виберіть тип розширень Shipping. Знайдіть VibeFox Econt і натисніть Install (зелена кнопка +).

3. Натисніть Edit (кнопка з олівцем), щоб відкрити сторінку налаштувань.

4. Введіть ліцензійний ключ VibeFox у поле License key в блоці ліцензії вгорі сторінки Edit і натисніть Activate (див. License key).

5. Встановіть тарифи за країнами та перевірте інші параметри (див. Configuration), увімкніть Enable/Disable і натисніть Save. Натисніть Load offices from Econt now, щоб перевірити з'єднання.

OpenCart 4

1. В адмін-панелі перейдіть до Extensions > Installer, натисніть Upload і виберіть файл vfd_econt.ocmod.zip. Не перейменовуйте файл: OpenCart 4 бере код розширення з імені файлу, і перейменований пакет не працює.

2. Пакет з'явиться у списку встановлених розширень на тій самій сторінці. Натисніть поруч із ним Install (зелена кнопка +).

3. Перейдіть до Extensions > Extensions і виберіть тип розширень Shipping. Знайдіть VibeFox Econt, натисніть Install (зелена кнопка +), потім Edit (кнопка з олівцем).

4. Введіть ліцензійний ключ і налаштування так само, як у кроках 4 і 5 для OpenCart 3. Сторінка налаштувань і її поля однакові в обох версіях.

Після встановлення спосіб вимкнений, доки ви не увімкнете Enable/Disable і не збережете налаштування. Якщо ви встановите розширення повторно після видалення, будуть використані збережені налаштування.

Налаштування

Усі налаштування містяться на сторінці розширення: Extensions > Extensions > Shipping > VibeFox Econt > Edit. Розділи перелічено ліворуч. Одна кнопка Save зберігає всю сторінку без перезавантаження. Зберігати налаштування, завантажувати відділення або очищувати журнал можуть лише адміністратори з правом змінювати це розширення.

У верхній частині сторінки розширення показує попередження: увімкнено демо-API, для Болгарії чи Румунії не задано тарифу (тоді спосіб ніколи не показується), останній запит відділень для країни завершився помилкою, або у вашому магазині немає класу ваги з одиницею кг (тоді ваги товарів зчитуються за назвою їхньої одиниці: kg, g, lb або oz). Числові поля приймають десятковий кому, наприклад 5,99. Якщо у числовому полі є щось, що не є числом або від'ємним числом, або якщо Minimum weight (kg) більше за Maximum weight (kg), помилка називає поле, і нічого не зберігається. Так само буде з порожнім Name або з назвою довшою за 64 символи, з Sort order, що не є цілим числом, або з невідомим класом податку чи геозоною.

Загальні

Enable/Disable: показує або приховує доставку Econt під час оформлення замовлення. За замовчуванням: вимкнено.

Name: назва способу доставки, яка показується в кошику та під час оформлення замовлення. За замовчуванням: Econt Express. Обов'язкове поле, до 64 символів.

Sort order: позиція серед способів доставки під час оформлення замовлення. Ціле число.

Tax class: клас податку на вартість доставки або --- None --- (за замовчуванням). OpenCart додає цей податок до тарифів нижче. За --- None --- тарифи є остаточними.

Список відділень Econt

Відділення та Econtomat завантажуються з API Econt і кешуються на 24 години.

Demo API: використовувати демо-API Econt з тестовими даними. На робочому магазині тримайте вимкненим. Відділення в демо-режимі мають інші ID, ніж справжні. У демо-режимі, якщо логін не заданий, використовується публічний тестовий обліковий запис Econt.

Econt username: необов'язково. Ваш логін e-Econt для HTTP Basic-авторизації.

Econt password: необов'язково. Зберігається в базі даних магазину і ніколи не записується в журнал. Після збереження поле лишається порожнім і показує Saved - leave empty to keep it. Вводьте нове значення, лише якщо хочете його змінити.

Remove the saved password: увімкніть цю опцію і натисніть Save, щоб видалити збережений пароль.

Office list: показує, скільки відділень закешовано за кожною країною і коли їх було завантажено. Кнопка Load offices from Econt now одразу перезавантажує списки для Болгарії та Румунії й показує результат за кожною країною. Якщо завантаження не вдалося, зберігаються відділення з останнього успішного завантаження. Без цієї кнопки список автоматично завантажується під час першого оформлення замовлення. Зміна Demo API, логіна або пароля очищає закешовані списки.

Вибір відділення під час оформлення замовлення

Show: які пункти може вибрати покупець.

City order: показувати спочатку найбільші міста (Софія, Пловдив, Варна, Бухарест та інші). Коли вимкнено, міста сортуються за алфавітом. За замовчуванням: увімкнено.

City list width: ширина списку міст у CSS, наприклад 100% або 300px. За замовчуванням: 100%.

Office list width: ширина списку відділень у CSS, наприклад 100% або 400px. За замовчуванням: 100%.

Тарифи (заголовок розділу показує валюту магазину за замовчуванням)

Тарифи вказуються у валюті магазину за замовчуванням, без податку. Розширення не запитує в Econt актуальні курси. З 1 січня 2026 року в Болгарії використовується євро, тому болгарський магазин зазвичай вводить тарифи в EUR.

Price per country: одна країна в рядку (або через кому): код країни, двокрапка, тариф, наприклад BG:5.99 і RO:8.99 (це значення за замовчуванням). Допускається десятковий кома: BG:5,99. Тариф 0 означає безкоштовну доставку. Якщо поле порожнє, використовуються тарифи за замовчуванням BG:5.99 і RO:8.99. Записи в іншому форматі ігноруються і перелічуються в попередженні під час збереження. Решта зберігається.

Calculation: Per order (за замовчуванням) стягує тариф один раз. Per item (price x quantity) множить його на кількість товарів, які потрібно доставити.

Price for other countries: використовується для країни Econt (Болгарія або Румунія), яку немає у списку вище. Порожнє значення або 0 приховує спосіб для цієї країни.

Умови

Проміжна сума кошика означає товари, що потребують доставки, після застосування купона і до податку.

Free shipping from: проміжна сума кошика, починаючи з якої доставка безкоштовна. Залиште порожнім, щоб ніколи не пропонувати безкоштовну доставку.

Minimum subtotal: показувати спосіб, лише якщо проміжна сума кошика не нижча за цю суму. Залиште порожнім, щоб показувати його завжди.

Minimum weight (kg): приховувати спосіб для легших кошиків. Ваги товарів переводяться з їхнього класу ваги в кг. Залиште порожнім, якщо обмеження немає.

Maximum weight (kg): приховувати спосіб для важчих кошиків. Залиште порожнім, якщо обмеження немає.

Доступність

Econt доставляє лише до Болгарії та Румунії. Зазвичай геозона визначає, де пропонується спосіб; з Ignore geo zone натомість вирішують вибрані країни.

Geo zone: пропонувати Econt лише адресам у цій геозоні. All Zones (за замовчуванням) означає по всій Болгарії та Румунії. Геозони керуються в System > Localisation > Geo Zones. Геозона не використовується з Ignore geo zone.

Ignore geo zone: геозона не перевіряється. Econt пропонується в країнах, зазначених нижче, незалежно від того, чи знаходиться адреса в геозоні.

Countries: Болгарія та/або Румунія. Використовується лише з Ignore geo zone. Якщо нічого не вибрано, мають на увазі всі країни Econt.

Додатково

Debug log: записує повідомлення налагодження у storage/logs/vfd_ecn_debug.log.php (в OpenCart 4 — system/storage/logs/vfd_ecn_debug.log.php). Файл не можна прочитати з веб-браузера. Коли він досягає 5 МБ, починається новий журнал. Помилки та попередження API (Econt недоступний, немає відділень, замовлення без відділення) завжди записуються в журнал. Паролі та дані покупців не записуються.

Log: показує розмір і останні записи журналу. Натисніть Clear log, щоб його очистити.

Remove data on uninstall: коли увімкнено, видалення розширення стирає налаштування Econt, журнал і вибір незавершених оформлень замовлень. Коли вимкнено, налаштування зберігаються для повторного встановлення. Відділення, збережені в замовленнях, завжди зберігаються.

Імпорт / Експорт

Export: натисніть Download JSON, щоб зберегти налаштування у файл JSON. Пароль не експортується.

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

Як це працює під час оформлення замовлення

Спосіб пропонується лише для Болгарії та Румунії. Коли OpenCart показує способи доставки, він запитує в розширення тариф Econt. З Ignore geo zone геозона не перевіряється, і спосіб пропонується лише для вибраних Countries (нічого не вибрано = Болгарія та Румунія). В іншому разі, якщо задано Geo zone, адреса має бути в ній. Враховуються лише товари з Requires Shipping, встановленим на Yes: інші товари не додають ваги і не входять до проміжної суми. Розширення перевіряє обмеження ваги та мінімальну суму, а потім бере тариф для країни. Якщо проміжна сума кошика досягає Free shipping from, тариф дорівнює 0. Якщо для країни немає списку відділень, спосіб приховується, оскільки доставка завжди йде у відділення. Тариф розраховується у валюті магазину за замовчуванням і показується покупцеві у його валюті з податком вибраного Tax class.

Коли покупець обирає Econt, під способом з'являються два списки: City і Office / Econtomat. Список відділень завантажується один раз на сторінку, лише коли обрано Econt. Econtomat позначено у списку. Вибір зберігається одразу. Якщо список відділень не вдалося завантажити, покупець бачить повідомлення Econt offices cannot be loaded right now. Please try again in a few minutes or choose another shipping method.

Коли покупець натискає Continue на кроці способу доставки, розширення перевіряє на сервері, що відділення вибрано і що воно є у списку Econt для країни доставки (з урахуванням Show). Без відділення покупець бачить Please select an Econt office or Econtomat. Відділення, якого немає у списку, відхиляється з повідомленням The selected Econt office is not available for the shipping country. Please select it again. Назва відділення завжди береться зі списку Econt, а не з браузера.

В OpenCart 4 покупець натискає Choose у блоці способу доставки на сторінці оформлення замовлення і вибирає Econt у вікні Shipping method options. Списки City та Office / Econtomat з'являються у цьому вікні під способом і працюють так, як описано вище. Кнопка Continue вікна не пропускає далі без дійсного відділення, з тими самими повідомленнями.

Список відділень кешується на 24 години окремо для робочого й демо-API та для кожної країни. Якщо Econt недоступний, використовується останній успішний список, і Econt не запитується повторно протягом 10 хвилин. Тайм-аут API становить 15 секунд. Список відділень надходить з https://ee.econt.com/services/ (робочий) або https://demo.econt.com/ee/services/ (демо).

Розширення використовує лише фіксовані тарифи. Воно не запитує в Econt актуальні тарифи, не створює накладних чи етикеток, не замовляє кур'єрів, не відстежує посилки, не працює з накладеним платежем і не доставляє за адресою. Список відділень є лише у Болгарії та Румунії.

Пункти видачі

Під час оформлення замовлення вибране відділення зберігається разом із замовленням: місто, назва та адреса відділення і код відділення Econt. Використовуйте код відділення, коли створюєте відправлення в e-Econt.

Покупець: відділення додається до способу доставки замовлення, наприклад Econt Express - Econt office / Econtomat: city, office (address) (до 128 символів; в OpenCart 4 текст не скорочується). Так воно з'являється в історії замовлень покупця, у листах про замовлення, на рахунку-фактурі та в замовленні в адмін-панелі. OpenCart 4 зберігає одне замовлення для оформлення і оновлює його щоразу, коли покупець підтверджує знову, а відділення замовлення оновлюється разом із ним.

Сторінка замовлення в адмін-панелі: у розділі Sales > Orders панель Econt office / Econtomat над історією показує відділення та його код, навіть якщо спосіб пізніше буде вимкнено. Під Change виберіть інше місто і відділення країни замовлення та натисніть Save. Панель показує Saved., текст способу доставки замовлення оновлюється, а примітка в історії замовлення (покупцеві не надсилається) фіксує старе і нове відділення. Якщо натиснути Save, не вибравши відділення, панель пише Select a city and an office first - nothing was changed. Відділення, якого немає у списку для країни замовлення, відхиляється з повідомленням The selected Econt office is not available for the shipping country - nothing was changed. Будь-який адміністратор з правом змінювати замовлення може змінити відділення; доступ до налаштувань розширення не потрібен. Якщо список відділень не вдалося завантажити, панель показує Econt offices cannot be loaded right now. Замовлення, оформлене без відділення, показує No Econt office is saved for this order., і в журналі для нього є помилка.

Назви відділень показуються місцевою мовою (кирилиця для Болгарії), якщо мова магазину болгарська або румунська, а в інших випадках англійською.

Ліцензійний ключ

Розширення працює з ліцензійним ключем VibeFox з vibefox.net. Блок ліцензії License — VibeFox Econt є першим блоком на сторінці Extensions > Extensions > Shipping > VibeFox Econt > Edit, над налаштуваннями. Введіть ключ у License key і натисніть Activate. Після цього блок показує ключ у прихованому вигляді, статус (наприклад, дату, до якої ліцензія активна, і ваш домен) та кнопки Check now для повторної перевірки статусу, Change key для введення іншого ключа і Remove key для видалення ключа з цього магазину. Нижче є рядок Product: opencart-shipping-econt і посилання Manage licenses and domains in your account, яке відкриває ваш обліковий запис vibefox.net. Змінювати ключ можуть лише адміністратори з правом Modify для розширення. Тексти блоку відповідають мові адміністратора (включено англійську та російську).

Якщо ключ не прийнято, блок пояснює причину, наприклад Key not found, This key belongs to another product, Domain limit reached або License expired on і дату. Після зміни адреси магазину або після звільнення слота домену у вашому обліковому записі натисніть Check now. Якщо сервер ліцензій недоступний, розширення продовжує працювати за останнім відомим статусом.

Один ключ працює на одному домені: адреса магазину з конфігурації OpenCart. Видалення ключа з магазину не звільняє його слот домену. Звільніть слот у своєму обліковому записі vibefox.net.

Без активного ключа спосіб доставки Econt не показується покупцям під час оформлення замовлення, і тариф не розраховується. Адміністратор, який увійшов в адмін-панель у тому самому браузері, усе ще бачить спосіб у магазині з позначкою (unlicensed — visible to admins only), тож ви можете налаштувати й перевірити розширення до купівлі ключа. В OpenCart 4 цей попередній перегляд недоступний: магазин не бачить вхід адміністратора, тож без активного ключа спосіб приховано для всіх. Після того як ви один раз відкриєте сторінку Edit, на Dashboard адмін-панелі з'явиться нагадування. Закрийте його кнопкою ×, щоб приховати на 7 днів. Наявні замовлення не змінюються.

Коли ліцензія спливає, розширення продовжує працювати, але для оновлень і підтримки потрібне продовження. Статус автоматично перевіряється під час відкриття Dashboard адмін-панелі або сторінки Edit: раз на день протягом перших 14 днів після введення ключа, потім раз на тиждень. Cron-завдання не потрібне. Видалення розширення завжди видаляє ліцензійний ключ і статус ліцензії.

Усунення несправностей

Econt не з'являється під час оформлення замовлення: перевірте, що ліцензія активна і Enable/Disable увімкнено, а країна доставки — Болгарія або Румунія (увімкнено в System > Localisation > Countries). Перевірте Geo zone (або Ignore geo zone і Countries), чи задано тариф для країни, обмеження ваги та Minimum subtotal. Перевірте рядок Office list у налаштуваннях: спосіб приховується, доки для країни немає списку відділень. Перевірте, що товари мають Requires Shipping, встановлений на Yes.

Список відділень не завантажується: натисніть Load offices from Econt now і прочитайте результат або попередження у верхній частині сторінки налаштувань. Помилки завжди записуються в журнал; увімкніть Debug log, щоб отримати більше деталей, і подивіться поле Log. Якщо Econt вимагає авторизацію для вашого магазину, заповніть Econt username і Econt password.

Покупці бачать тестові відділення: увімкнено Demo API. Вимкніть його на робочому магазині.

У якій валюті тарифи? У валюті магазину за замовчуванням, без податку. Покупці бачать їх у своїй валюті.

Податок нараховується понад тариф: вибрано клас податку. Встановіть Tax class на --- None ---, якщо ваші тарифи вже включають ПДВ.

Сторінка показує "Warning: You do not have permission to modify VibeFox Econt!": ваша група адміністраторів може лише переглядати налаштування. Надайте групі право змінювати extension/shipping/vfd_econt (OpenCart 3) або extension/vfd_econt/shipping/vfd_econt (OpenCart 4) у System > Users > User Groups.

Видалення

Перейдіть до Extensions > Extensions, виберіть тип Shipping і натисніть Uninstall (червона кнопка −) поруч із VibeFox Econt. Ліцензійний ключ і статус ліцензії цього розширення завжди видаляються. OpenCart завжди скидає Enable/Disable, Sort order, Tax class і Geo zone. Розширення завжди видаляє свої події та закешовані списки відділень. Якщо Remove data on uninstall увімкнено, також видаляються інші налаштування, журнал і вибір незавершених оформлень замовлень. Якщо вимкнено, налаштування зберігаються і використовуються знову під час повторного встановлення розширення. Відділення, збережені в замовленнях, завжди зберігаються, а наявні замовлення зберігають свій спосіб доставки та вартість.

На OpenCart 4, щоб видалити й файли розширення, після видалення перейдіть до Extensions > Installer, натисніть поруч із VibeFox Econt у списку встановлених розширень Uninstall (помаранчева кнопка −), потім Delete (червона кнопка з кошиком), щоб видалити завантажений пакет.

Econt є торговою маркою її власника. Це розширення не пов'язане з Econt і не схвалене Econt.