VibeFox Frenet for WooCommerce — Помощь

Требования

WordPress: 5.8 или новее.

WooCommerce: 5.0 или новее, установлен и активен. Без него плагин не активируется.

PHP: 8.0 или новее.

Учётная запись Frenet (только для живых расчётов): создайте бесплатную учётную запись в панели Frenet (painel.frenet.com.br), включите нужных перевозчиков и скопируйте свой API-токен. Если вы используете только фиксированные цены, учётная запись Frenet не нужна.

Товары: заполните вес и размеры для точных цен. Для товаров без них расчёт ведётся как для 0,3 кг и 16 × 11 × 2 см (минимальная коробка Correios).

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

Установка

1. В WordPress откройте Plugins > Add New > Upload Plugin, выберите ZIP-файл плагина и нажмите Install Now. Также можно загрузить папку vfd_frenet в /wp-content/plugins/ по FTP.

2. Нажмите Activate.

3. Откройте настройки: WooCommerce > Settings > Shipping > VibeFox Frenet или нажмите Settings под названием плагина на странице «Плагины».

4. Введите лицензионный ключ VibeFox в блоке лицензии вверху страницы и нажмите Activate.

5. Вставьте API-токен и укажите почтовый индекс отправления (CEP). Если валюта магазина не BRL, укажите курс BRL. При желании добавьте фиксированные цены и запасную стоимость.

6. Добавьте VibeFox Frenet в зону доставки для Бразилии в WooCommerce > Settings > Shipping > Shipping zones или включите Ignore shipping zones и выберите страны.

Настройка

Все параметры находятся на одной странице: WooCommerce > Settings > Shipping > VibeFox Frenet. Они действуют во всех зонах доставки. Когда вы добавляете метод в зону, в окне зоны есть только одно поле:

Title (zone): название, которое покупатели видят для этой зоны. Оставьте поле пустым, чтобы использовать общее Method title.

Вверху страницы плагин показывает предупреждения: нет API-токена (тогда используются только фиксированные цены, либо метод не показывается, если фиксированных цен тоже нет), нет 8-значного CEP отправления или валюта магазина не BRL без курса обмена. При каждом сохранении настроек кешированные расчёты очищаются. В полях цен допускаются и точка, и запятая в качестве десятичного разделителя.

Общие

Enable/Disable: отключает метод во всех зонах сразу. По умолчанию: on.

Method title: название способа доставки, которое показывается в корзине и при оформлении заказа. Зона может его переопределить. По умолчанию: Frenet.

Живые расчёты Frenet

Frenet сравнивает перевозчиков, включённых в вашей учётной записи Frenet, и возвращает их цены для корзины. Живые расчёты запрашиваются только для адресов в Бразилии с полным 8-значным CEP.

API token: ваш API-токен Frenet из панели Frenet. Оставьте поле пустым, чтобы использовать только фиксированные цены.

Origin CEP: почтовый индекс (CEP), с которого отправляются посылки, например 00000-000. Оставьте поле пустым, чтобы использовать почтовый индекс магазина, если адрес магазина в Бразилии. CEP не из 8 цифр сообщается при сохранении.

Service to offer: Cheapest service (по умолчанию) или Fastest service. Frenet возвращает несколько служб, а метод показывает одну цену.

BRL exchange rate: Frenet считает в бразильских реалах. Если валюта вашего магазина не BRL, укажите, сколько 1 BRL составляет в валюте магазина, например 0.16. По нему переводятся расчёт и объявленная сумма заказа. Без курса живые расчёты не используются. Не нужно, если валюта магазина — BRL.

Фиксированные цены

Используются при отсутствии API-токена, для стран, которые Frenet не обслуживает, и всякий раз, когда Frenet не возвращает цену (API недоступен, CEP не обслуживается).

Price per country: таблица с колонками Country, Price, XS, S, M, L и XL, цены в валюте вашего магазина. Нажмите + Add country, чтобы добавить строку, и крестик (×), чтобы удалить её. Колонки размеров зависят от веса корзины: XS — до 1 кг, S — до 2 кг, M — до 3 кг, L — до 5 кг, XL — свыше 5 кг. Цена Price используется, когда колонка размера пуста. Цена Price, равная 0, означает бесплатную доставку в эту страну. Используйте * Default для всех остальных стран. Строки без каких-либо цен удаляются при сохранении.

Fallback cost: используется, когда ни Frenet, ни таблица не дают цену. Оставьте поле пустым, чтобы скрыть метод.

Fixed price applies: Per order берёт цену один раз. Per item (price × quantity) умножает её на количество товаров. Это касается только фиксированных цен и запасной стоимости. Расчёты Frenet уже учитывают всю корзину.

Условия

Minimum weight (kg): скрывает метод при весе корзины ниже этого значения. 0 означает без ограничения.

Maximum weight (kg): скрывает метод при весе корзины выше этого значения. По умолчанию: 30. 0 означает без ограничения.

Minimum order amount: показывает метод, только если промежуточный итог корзины (после скидок, до налога) не меньше этой суммы. Оставьте поле пустым, чтобы показывать метод всегда.

Excluded shipping classes: скрывает метод, если в корзине есть товар из любого из этих классов доставки WooCommerce.

Free shipping from: промежуточный итог корзины (после скидок, до налога), начиная с которого доставка бесплатна. Оставьте поле пустым, чтобы никогда не предоставлять бесплатную доставку.

Tax status: Taxable добавляет налог WooCommerce к стоимости доставки, None — не добавляет. Цены Frenet — это окончательные цены перевозчика; выберите None, если WooCommerce не должен начислять на них налог.

Веса товаров пересчитываются из единицы измерения вашего магазина в кг.

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

Ignore shipping zones: предлагает Frenet для стран ниже, даже если он не добавлен в зону доставки.

Countries: страны назначения для этого режима. Оставьте поле пустым, чтобы использовать все страны, в которые вы доставляете. Используется, только если включён Ignore shipping zones.

Дополнительно

Debug log: записывает каждый запрос расчёта и ответ в WooCommerce > Status > Logs, источник vfd-frenet. Ошибки API записываются всегда. Токен никогда не записывается, а CEP покупателя сокращается. Выключите, когда закончите.

Remove data on uninstall: если включено, удаление плагина стирает все настройки Frenet и методы зон. Деактивация плагина никогда не удаляет настройки. Кешированные расчёты удаляются всегда.

Как это работает при оформлении заказа

Когда покупатель вводит адрес доставки, WooCommerce запрашивает у плагина тариф. Плагин сначала проверяет вес корзины, минимальную сумму заказа и исключённые классы доставки. Если действует бесплатная доставка, метод показывается с нулевой ценой, и запрос в Frenet не отправляется.

Для адреса в Бразилии с полным 8-значным CEP плагин отправляет в Frenet CEP отправления и назначения, каждый товар корзины (вес в кг, размеры в см, количество, SKU и категории), сумму заказа в BRL и первый применённый купон. Пока CEP не заполнен полностью, запрос не отправляется. Frenet возвращает службы ваших включённых перевозчиков. Службы с ошибкой или без цены пропускаются. Плагин выбирает самую дешёвую или самую быструю службу и переводит цену в валюту вашего магазина. Перевозчик, служба и срок доставки сохраняются со строкой доставки заказа и показываются на экране заказа в админке.

Каждый ответ кешируется на 1 час для той же корзины и того же адреса. Неудачный запрос или CEP, который не обслуживает ни один включённый перевозчик, запоминается на 10 минут. Таймаут API — 10 секунд. В этих случаях покупатель не видит ошибки: используется фиксированная цена или запасная стоимость, либо метод скрывается, если их нет. Для адресов за пределами Бразилии используются только фиксированные цены.

Метод работает на классическом оформлении заказа и в блоках «Корзина» и «Оформление заказа». Совместим с WooCommerce High-Performance Order Storage (HPOS).

Плагин только рассчитывает тарифы. Он не создаёт отправления, не печатает этикетки и не отслеживает посылки — это делает Frenet в своей панели. Он показывает одну службу Frenet на корзину, а не несколько, и не поддерживает пункты выдачи и постаматы. Frenet рассчитывает доставку только внутри Бразилии; для других стран используйте фиксированные цены.

Лицензионный ключ

Плагин работает с лицензионным ключом VibeFox с vibefox.net. Блок лицензии находится вверху страницы WooCommerce > Settings > Shipping > VibeFox Frenet. Вставьте ключ в поле License key и нажмите Activate. В блоке отображается статус, например дата, до которой лицензия активна, и ваш домен. Кнопка Check now повторно проверяет статус, Change key позволяет ввести другой ключ, а Remove key удаляет ключ с этого сайта. Ссылка Manage licenses and domains in your account открывает ваш аккаунт на vibefox.net.

Один ключ работает на одном домене. Удаление ключа с сайта не освобождает слот домена. Освободите слот в своём аккаунте на vibefox.net.

Без активного ключа Frenet не показывается покупателям при оформлении заказа. Авторизованные администраторы магазина видят его, отмеченным (unlicensed — visible to admins only), чтобы вы могли настроить и проверить плагин до покупки ключа. Напоминание появляется на странице «Плагины» и на страницах WooCommerce. Существующие заказы не затрагиваются.

Когда срок лицензии истекает, плагин продолжает работать, но для обновлений и поддержки нужно продление. Статус автоматически проверяется снова в фоновом режиме.

Устранение неполадок

Frenet не появляется при оформлении заказа: проверьте, что лицензия активна, что Enable/Disable включён и метод добавлен в зону страны покупателя (или что Ignore shipping zones включён и страна разрешена). Проверьте предупреждения вверху страницы настроек, ограничения по весу, Minimum order amount и Excluded shipping classes. Типичные причины: покупатель ещё не ввёл полный 8-значный CEP, а фиксированных цен нет, либо Frenet не вернул службу для маршрута, и фиксированной цены тоже нет.

Живые расчёты не появляются: включите Debug log, перезагрузите оформление заказа и откройте WooCommerce > Status > Logs, источник vfd-frenet. Там указана причина: токен отклонён (HTTP 401 или 403), нет CEP отправления, нет курса BRL, в панели Frenet не включён ни один перевозчик, либо сообщения о пропущенных службах.

Мой магазин продаёт в евро или долларах: Frenet отвечает в BRL. Введите BRL exchange rate (сколько 1 BRL составляет в валюте вашего магазина).

Тарифы выглядят устаревшими после изменения: сохраните страницу настроек. Это очистит кешированные расчёты.

Блок лицензии показывает ошибку: следуйте сообщению в блоке. Например, если ключ уже используется на другом домене, освободите слот в аккаунте vibefox.net и нажмите Check now. Если адрес сайта изменился, нажмите Check now, чтобы активировать ключ для нового домена. Если сервер лицензий недоступен, плагин продолжает работать с последним известным статусом.

Удаление

Деактивация плагина сохраняет все настройки и только очищает кешированные расчёты. Чтобы удалить плагин, деактивируйте его и удалите на странице Plugins. Лицензионный ключ и статус лицензии этого плагина, кешированные расчёты и старые файлы журналов удаляются всегда. Настройки и методы зон удаляются, только если была включена опция Remove data on uninstall. Иначе они сохраняются для повторной установки. Существующие заказы сохраняют свои строки доставки с перевозчиком Frenet.

Frenet — товарный знак его правообладателя. Этот плагин не аффилирован с Frenet и не одобрен компанией Frenet.