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.