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

Вимоги

PrestaShop: 8.0–9.x.

PHP: 8.0 або новіша. Модуль не встановлюється на старіших версіях PHP.

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

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

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

1. В адмін-панелі перейдіть до Modules > Module Manager і натисніть Upload a module. Оберіть ZIP-файл модуля.

2. Після завершення завантаження натисніть Configure або пізніше знайдіть VibeFox Econt у списку модулів і натисніть Configure.

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

4. Задайте тарифи за країнами і перевірте інші опції (див. Налаштування), потім натисніть Save. Натисніть Load offices from Econt now, щоб перевірити з'єднання.

Під час встановлення модуль створює перевізника Econt Express з текстом строку доставки Delivery to an Econt office or Econtomat. Перевізник призначається зонам Болгарії та Румунії та всім групам клієнтів. Зони, групи клієнтів, строк доставки, логотип і обмеження розміру можна змінити в Shipping > Carriers. Тарифи там не встановлюйте: ціна завжди береться з модуля.

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

Усі налаштування розташовані на сторінці модуля: Modules > Module Manager > VibeFox Econt > Configure. Кожен розділ має власну кнопку Save, яка зберігає всю сторінку. Тариф і умови застосовуються до всіх зон перевізника.

Угорі сторінки модуль показує попередження: перевізника Econt не знайдено, увімкнено демо-API, для Болгарії або Румунії не задано тариф (тоді перевізник ніколи не показується), останній запит списку офісів для країни завершився помилкою або одиниця ваги магазину модулю невідома (тоді ваги враховуються в кг; задайте одиницю в International > Localization, Local units). Числові поля приймають десяткову кому, наприклад 5,99. Якщо числове поле містить щось, що не є числом або від'ємним числом, або якщо Minimum weight (kg) більше за Maximum weight (kg), помилка називає поле і нічого не зберігається.

Загальні

Enable/Disable: вмикає або вимикає доставку Econt. Це той самий перемикач, що й статус перевізника в Shipping > Carriers.

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

Tax: податкове правило перевізника або No tax. PrestaShop додає цей податок до тарифів нижче. За No tax тарифи є остаточними.

Список офісів 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 і збережіть, щоб видалити пароль.

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 (за Ignore zones країни поза зонами перевізника тоді не отримують тариф). Записи в іншому форматі ігноруються і перелічуються в попередженні під час збереження. Решта зберігається.

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): приховувати перевізника для важчих кошиків. Залиште порожнім, щоб не мати обмежень.

Доступність без зон доставки

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

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

Додатково

Debug log: записує налагоджувальні повідомлення у logs/vfd_ecn_debug.log.php у папці модуля. Файл не можна відкрити з веб-браузера. Помилки API завжди записуються. Паролі та дані клієнтів не записуються.

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

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

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

Перевізник пропонується лише для Болгарії та Румунії. На етапі доставки PrestaShop запитує у модуля тариф Econt. Враховуються лише фізичні товари: віртуальні товари не додають ваги і не входять до проміжної суми. Модуль перевіряє обмеження ваги та мінімальну суму, потім бере тариф для країни. Якщо проміжна сума кошика досягає Free shipping from, тариф становить 0. Якщо для країни немає списку офісів, перевізник приховується, бо доставка завжди йде до офісу. Тариф розраховується у валюті магазину за замовчуванням, а потім показується у валюті кошика покупця.

Коли покупець обирає 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, а не з браузера. Вибір працює з темою Classic і з Hummingbird.

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

Якщо ви редагуєте перевізника в Shipping > Carriers після того, як у нього з'явилися замовлення, PrestaShop зберігає його як нову версію перевізника. Модуль автоматично слідує за новою версією.

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

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

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

Сторінка замовлення в адмін-панелі: блок Econt office / Econtomat показує офіс і Office code. Під Change оберіть інше місто та офіс у країні замовлення і натисніть Save. Зміна зберігається одразу, а приватне повідомлення до замовлення фіксує старий і новий офіс. Якщо натиснути Save, не обравши офіс, блок напише Select a city and an office first - nothing was changed. Будь-який співробітник, якому дозволено редагувати замовлення, може змінити офіс; доступ до сторінки модуля не потрібен. Якщо список офісів не вдалося завантажити, блок показує Econt offices cannot be loaded right now.

Кілька замовлень з одного кошика: офіс належить першому замовленню. Інше замовлення, оформлене з того самого кошика, офіс не отримує: у журнал записується помилка, а його блок повідомляє, що офіс цього кошика належить іншому замовленню. Узгодьте офіс із покупцем і створіть відправлення в e-Econt вручну.

Покупець: офіс показується на сторінці замовлення покупця і на сторінці підтвердження замовлення, а також додається до назви перевізника в листі з підтвердженням замовлення і в листі про нове замовлення магазину.

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

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

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

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

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

Без активного ключа перевізник Econt не показується покупцям під час оформлення замовлення, і тариф не розраховується. Вітрина PrestaShop не знає, що ви увійшли в адмін-панель, тому перевізник приховано і для вас: налаштувати модуль можна до купівлі ключа, але перевірити його під час оформлення не можна. Нагадування з'являється в Modules > Module Manager на вкладці Alerts. Наявні замовлення не змінюються.

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

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

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

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

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

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

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

На сторінці написано, що перевізника Econt не знайдено: перевізника видалено в Shipping > Carriers. Скиньте модуль у Modules > Module Manager, щоб створити його знову.

Видалення

Перейдіть до Modules > Module Manager, відкрийте меню поруч із VibeFox Econt і оберіть Uninstall. Ліцензійний ключ і статус ліцензії завжди видаляються. Кешовані списки офісів завжди видаляються. Якщо Remove data on uninstall увімкнено, перевізник видаляється (замовлення зберігають свою історію), а налаштування та журнал видаляються. Якщо вимкнено, перевізник лише деактивується, і всі налаштування зберігаються. Повторне встановлення модуля відновлює збереженого перевізника зі статусом, який він мав. Скидання модуля зберігає поточний статус перевізника. Офіси, збережені в замовленнях, завжди зберігаються.

Econt — торгова марка її власника. Цей модуль не пов'язаний з Econt і не схвалений Econt.