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.