VibeFox Envioclick for WooCommerce — Помощь

Требования

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

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

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

Учётная запись Envioclick (только для тарифов в реальном времени): учётная запись Envioclick в Мексике или Колумбии с доступом к API. Ключ API находится в вашей учётной записи Envioclick: Mi cuenta (вверху справа) > Información del API. Если вы используете только фиксированные цены, учётная запись Envioclick не нужна.

User-Agent (только Мексика): Envioclick Mexico требует значение User-Agent в каждом запросе к API. Запросите его у службы поддержки Envioclick (soporte.tecnico@envioclick.com).

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

Установка

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

2. Нажмите Activate.

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

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

5. Введите ключ API, выберите страну API, введите User-Agent (Мексика), почтовый индекс или код DANE отправки и адрес отправки. Если валюта вашего магазина не MXN и не COP, введите курс конвертации.

6. По желанию добавьте фиксированные цены по странам и запасную стоимость.

7. Добавьте VibeFox Envioclick в зону доставки: WooCommerce > Settings > Shipping > Shipping zones, или включите Ignore shipping zones и выберите страны.

Настройки

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

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

Если задан ключ API, плагин показывает предупреждения вверху страницы, когда тарифы в реальном времени не могут работать: нет курса конвертации для валюты магазина, отличной от MXN или COP, нет User-Agent для Мексики, нет почтового индекса или кода DANE отправки, или нет адреса отправки для Колумбии. Каждый раз при сохранении настроек кэш тарифов очищается. Числовые поля принимают и точку, и запятую как десятичный разделитель.

Общие

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

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

Carrier in the title: показывает перевозчика и ориентировочный срок доставки рядом с названием для тарифов в реальном времени, например «Envioclick Shipping (Estafeta Express, 1 day)». Перевозчик в любом случае сохраняется в заказе и показывается в письмах о заказе. По умолчанию: включено.

API Envioclick (тарифы в реальном времени)

Необязательно. Без ключа API используются только фиксированные цены. Тарифы в реальном времени запрашиваются только для направлений в стране API. Доставка в другие страны использует фиксированные цены.

API key: ваш ключ API Envioclick из Mi cuenta > Información del API.

API country: страна вашей учётной записи Envioclick.

User-Agent (Mexico): значение, выданное службой поддержки Envioclick (soporte.tecnico@envioclick.com). Обязательно для Мексики; без него тарифы в реальном времени для Мексики не запрашиваются. Для Колумбии необязательно.

Carrier choice: Cheapest (по умолчанию) или Fastest (then cheapest). Envioclick возвращает тарифы нескольких перевозчиков, а покупатель получает один тариф.

Branch pickup rates: также учитывать тарифы «Ocurre», при которых покупатель забирает посылку в отделении перевозчика. Если выключено, используются только тарифы доставки до двери. Услуги наложенного платежа (COD) никогда не используются. По умолчанию: выключено.

Currency conversion rate: Envioclick считает в MXN (Мексика) или COP (Колумбия). Если валюта вашего магазина другая, введите стоимость 1 MXN или 1 COP в валюте магазина, например 0.05. Объявленная стоимость посылки пересчитывается так же. Оставьте поле пустым, если валюта магазина MXN или COP. Без курса тарифы в реальном времени в другой валюте не используются.

Отправка из

Используется для тарифов в реальном времени. Пустые поля берутся из адреса магазина в WooCommerce > Settings > General, если магазин находится в стране API.

Origin postcode / DANE code: Мексика: 5-значный почтовый индекс. Колумбия: 8-значный код DANE муниципалитета, например 11001000 для Боготы.

Origin address: улица и номер адреса отправки. Обязателен для Колумбии, необязателен для Мексики.

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

Используются, когда тарифа в реальном времени нет: нет ключа API, направление вне страны API, ошибка API или нет перевозчика для маршрута.

Price per country: таблица стран и цен в валюте вашего магазина. Нажмите + Add country, чтобы добавить строку, и крестик, чтобы удалить строку. Строка * Default применяется ко всем странам без собственной строки.

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

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

Условия

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

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

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

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

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

Tax status: Taxable добавляет налог WooCommerce к стоимости доставки, None не добавляет. Тарифы Envioclick уже включают налоги перевозчиков, поэтому выберите None, чтобы не брать налог с доставки дважды.

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

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

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

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

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

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

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

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

Если задан ключ API и направление находится в стране API, плагин запрашивает тарифы у Envioclick. В Мексике запрос выполняется, когда покупатель ввёл 5-значный почтовый индекс. В Колумбии — когда распознаны департамент и муниципалитет (регистр и диакритические знаки не важны, «Bogotá D.C.» тоже работает). Плагин выбирает самый дешёвый или самый быстрый тариф доставки до двери, который не является наложенным платежом, и пересчитывает его в валюту вашего магазина.

Посылка всегда одна коробка: общий вес в кг, длина и ширина самого большого товара, а высота такая, чтобы вместить общий объём всех товаров. Товары без размеров считаются 10 × 10 × 10 см. Корзина без веса отправляется как 0,5 кг. Объявленная стоимость — сумма товаров в корзине.

Каждый тариф кэшируется на 1 час для того же маршрута и той же посылки. Неудачный запрос кэшируется на 10 минут, чтобы недоступный API не замедлял каждое обновление при оформлении заказа. Тайм-аут API — 10 секунд. Если Envioclick возвращает ошибку или нет перевозчика для маршрута, покупатель не видит ошибки: используется фиксированная цена или способ скрывается. Причина записывается в журнал отладки.

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

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

Заказы

Когда заказ оформлен по тарифу Envioclick в реальном времени, перевозчик и услуга сохраняются в заказе. На экране заказа в админке под адресом доставки показан Envioclick carrier с ориентировочным сроком доставки. На странице заказа покупателя и в письмах о заказе (HTML и текст) показан Shipping carrier. Идентификатор тарифа Envioclick сохраняется в строке доставки заказа как скрытые данные; на экране заказа он не отображается. Создайте накладную в вашей учётной записи Envioclick.

У заказов с фиксированной ценой перевозчика нет.

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

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

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

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

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

Решение проблем

Envioclick не появляется при оформлении заказа: проверьте, что лицензия активна, Enable/Disable включено и способ добавлен в зону страны покупателя (или включено Ignore shipping zones и страна разрешена). Проверьте ограничения по весу, Minimum order amount и Excluded shipping classes. Без тарифа в реальном времени способу нужна фиксированная цена для страны, строка * Default или Fallback cost.

Тарифы в реальном времени не появляются: прочитайте предупреждения вверху страницы настроек, затем включите Debug log, обновите страницу оформления заказа и откройте WooCommerce > Status > Logs, источник vfd_envioclick. Частые причины: нет курса конвертации (валюта магазина не MXN и не COP), нет User-Agent (Мексика), нет почтового индекса или кода DANE отправки, почтовый индекс покупателя (Мексика) или город (Колумбия) ещё не введён, направление вне страны API или нет перевозчика для маршрута.

Зачем нужен курс конвертации? Envioclick возвращает цены только в мексиканских или колумбийских песо. Плагин никогда не показывает сумму в песо как сумму в другой валюте.

Колумбия: город не распознаётся: покупатель должен выбрать департамент и ввести название муниципалитета. Также работает 8-значный код DANE, введённый вместо почтового индекса. Разработчики могут передать код DANE через фильтр vfd_evc_dane_code.

Налог на доставку начисляется дважды: тарифы Envioclick уже включают налоги перевозчиков. Установите Tax status в None.

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

Фильтры для разработчиков: vfd_evc_quotation_request (тело запроса), vfd_evc_api_url, vfd_evc_dane_code, vfd_evc_default_dimensions и vfd_evc_package_description.

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

Удаление

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

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