VibeFox Estafeta for WooCommerce — Помощь

Требования

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

WooCommerce: 7.0 или новее, установлен и активен. Плагин не активируется без него.

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

Учётная запись DrEnvio (только для актуальных тарифов): актуальные тарифы Estafeta поступают от DrEnvio, партнёра Estafeta в Мексике. Создайте учётную запись на drenvio.com, включите Estafeta, укажите там адрес отправки и скопируйте ключ API из панели DrEnvio. Это тот же ключ, который использует официальный плагин DrEnvio. Если вы используете только собственные цены, учётная запись DrEnvio не нужна.

Товары: для актуальных тарифов товарам нужен вес.

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

Установка

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

2. Нажмите Activate.

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

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

5. Введите ключ API DrEnvio и, при необходимости, почтовый индекс отправления. Если валюта вашего магазина не MXN, введите MXN exchange rate. Задайте цену для страны MX или резервную стоимость, если способ доставки должен оставаться видимым, когда у DrEnvio нет тарифа.

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

Настройка

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

Title (zone): название этого варианта при оформлении заказа. Оставьте пустым, чтобы использовать общее Name.

Вверху страницы плагин показывает предупреждения: не задан ключ API DrEnvio, валюта магазина отличается от MXN и нет курса обмена, либо нет цены для страны MX и резервной стоимости (тогда способ скрывается, если актуального тарифа нет). При каждом сохранении настроек кэш тарифов DrEnvio очищается. Числовые поля принимают десятичную точку или запятую. Значение, которое не является допустимым числом, очищается и сообщается при сохранении.

Общие

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

Name: название способа доставки, которое видит покупатель при оформлении заказа. По умолчанию: Estafeta.

Tax status: Taxable позволяет WooCommerce добавлять налог к стоимости доставки, None — не добавлять. Включают ли тарифы DrEnvio IVA, зависит от вашей учётной записи DrEnvio. Если IVA уже включён, выберите None. По умолчанию: Taxable.

Актуальные тарифы (API DrEnvio)

Предлагается самая дешёвая услуга Estafeta для адреса. Без ключа используются цены из следующего раздела.

DrEnvio API key: ключ API из вашей панели DrEnvio.

Origin country: двухбуквенный код страны адреса отправки. По умолчанию: MX. Отправляется только вместе с почтовым индексом отправления.

Origin postcode: пятизначный почтовый индекс адреса отправки. Оставьте пустым, чтобы использовать адрес отправки, сохранённый в вашей учётной записи DrEnvio. Почтовый индекс, в котором не 5 цифр, очищается при сохранении.

MXN exchange rate: DrEnvio рассчитывает в мексиканских песо. Нужен только если валюта вашего магазина не MXN: стоимость 1 MXN в валюте вашего магазина, например 0.05. Без него актуальные тарифы не используются.

Цены без актуального тарифа

Используются, когда нет ключа API или DrEnvio не возвращает тариф Estafeta (API недоступен, неизвестный почтовый индекс, почтовый индекс ещё не введён). Цены указаны в валюте вашего магазина.

Country prices: одна страна назначения в строке в формате CC:PRICE, например MX:150. Используйте десятичную точку или запятую, без разделителя тысяч. Части в другом формате игнорируются и сообщаются при сохранении.

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

Calculation type: Per order берёт цену один раз. Per item (price x number of items) умножает её на количество товаров, которые можно отправить. Это относится к Country prices и Fallback cost. Актуальный тариф DrEnvio всегда является ценой всей посылки.

Условия

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

Minimum subtotal: показывать способ, только когда сумма корзины не меньше этого значения. Оставьте пустым, чтобы показывать всегда.

Min weight (kg): минимальный вес корзины, при котором появляется способ. 0 означает без ограничения.

Max weight (kg): максимальный вес корзины. Если он превышен, способ скрывается. По умолчанию: 30. 0 означает без ограничения.

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

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

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

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

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

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

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

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

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

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

В остальных случаях плагин отправляет в DrEnvio страну и почтовый индекс назначения, вес корзины, количество товаров и сумму, а также почтовый индекс отправления, если вы его задали. Мексиканские почтовые индексы должны состоять из 5 цифр; пока покупатель не введёт его, запрос не отправляется. DrEnvio возвращает расчёты всех перевозчиков вашей учётной записи. Плагин использует только расчёты Estafeta, игнорирует нулевые цены, выбирает самую дешёвую и переводит её в валюту вашего магазина. Услуга Estafeta и срок доставки сохраняются со строкой доставки заказа и отображаются на экране заказа в админ-панели.

Каждый ответ кэшируется на 1 час. Неудачный запрос или маршрут без тарифа Estafeta запоминается на 5 минут, поэтому медленный или сломанный API никогда не тормозит каждое обновление при оформлении заказа. Тайм-аут API составляет 12 секунд. В этих случаях покупатель не видит ошибки: используется цена для страны или резервная стоимость, либо способ скрывается, если не задано ни то, ни другое.

Способ работает в классическом оформлении заказа и в блоках Cart и Checkout. Он совместим с высокопроизводительным хранилищем заказов WooCommerce (HPOS).

Плагин только рассчитывает тарифы. Он не создаёт отправления, не печатает накладные (guías) и не отслеживает посылки; создавайте отправление в своей учётной записи DrEnvio или Estafeta. Покупатель не может выбрать конкретную услугу Estafeta или отделение Estafeta, а курсы валют не обновляются автоматически.

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

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

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

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

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

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

Estafeta не появляется при оформлении заказа: проверьте, что лицензия активна, Enable/Disable включено и способ добавлен в зону страны покупателя (или включено Ignore shipping zones и страна разрешена). Проверьте уведомления вверху страницы настроек, ограничения по весу, Minimum subtotal и Excluded shipping classes. Без ключа API или когда у DrEnvio нет тарифа Estafeta, способу нужна цена для страны назначения или резервная стоимость.

Актуальные тарифы не появляются: включите Debug log, обновите страницу оформления заказа и откройте WooCommerce > Status > Logs, источник vfd-estafeta. Там указана причина: нет ключа API, нет курса обмена для магазина не в MXN, почтовый индекс отсутствует или неверен, ключ API отклонён (HTTP 401 или 403) или для маршрута нет тарифа Estafeta.

Цена включает IVA? Это зависит от вашей учётной записи DrEnvio. Если цены DrEnvio уже включают IVA, установите Tax status в значение None.

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

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

Удаление

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

Estafeta и DrEnvio являются товарными знаками их владельцев. Этот плагин не связан с Estafeta или DrEnvio и не одобрен ими.