VibeFox Loggi for WooCommerce — Помощь

Требования

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

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

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

Аккаунт Loggi (только для цен в реальном времени): цена в реальном времени использует GraphQL API Loggi с ключом API, который Loggi выдаёт бизнес-аккаунтам. Обратитесь к вашему менеджеру аккаунта Loggi или в службу интеграционной поддержки Loggi (integracoes@loggi.com), также см. документацию API Loggi на docs.api.loggi.com. Нужны три значения: e-mail вашего аккаунта Loggi, ключ API и числовой ID вашего магазина. Если в вашем аккаунте Loggi есть только учётные данные для нового REST API платформы Loggi (client ID и secret), цена в реальном времени недоступна, и используются фиксированные цены. Если вы используете только фиксированные цены, аккаунт Loggi не нужен.

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

Установка

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

2. Нажмите Activate.

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

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

5. Введите e-mail API Loggi, ключ API, Shop ID и адрес забора, а если валюта магазина не BRL — курс BRL. Добавьте фиксированные цены как страховку (см. Настройка).

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

Настройка

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

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

Предупреждения вверху страницы показывают неполную настройку: нет учётных данных API, нет адреса забора или нет курса BRL. При каждом сохранении настроек кэш цен Loggi очищается.

Общие

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

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

API Loggi (цена в реальном времени) (оставьте учётные данные пустыми, чтобы использовать только фиксированные цены)

API e-mail: e-mail вашего аккаунта Loggi. Ключ API принадлежит этому аккаунту.

API key: ваш ключ API Loggi. Он передаётся только в Loggi и никогда не записывается в журнал.

Shop ID: числовой ID (pk) вашего магазина в панели Loggi. Принимается только положительное число. Другое значение отклоняется с ошибкой, а сохранённое значение остаётся.

Staging: использовать тестовую среду Loggi (staging) с тестовыми учётными данными. Тестовая и рабочая среды имеют разные аккаунты и ключи. По умолчанию: выключено.

Pickup address: откуда Loggi забирает посылки, одной строкой: улица и номер дома, район, город, штат и CEP, например Rua Example, 123 - Bairro, São Paulo - SP, 01310-100. Оставьте пустым, чтобы использовать адрес магазина из WooCommerce > Settings > General, если он в Бразилии. Без адреса забора Loggi не может рассчитать стоимость, и используются только фиксированные цены.

BRL exchange rate: цены Loggi указаны в бразильских реалах. Если валюта вашего магазина BRL, это поле не нужно. Иначе введите, сколько стоит 1 BRL в валюте вашего магазина, например 0.16. Без него цены в реальном времени не используются. В качестве десятичного разделителя принимаются и точка, и запятая.

Фиксированные цены (в валюте вашего магазина)

Фиксированные цены используются, когда API Loggi не настроен, для направлений за пределами Бразилии или без полного CEP, а также всякий раз, когда Loggi не возвращает цену (API недоступен, ключ отклонён, адрес вне зоны обслуживания).

Price table: одна строка на страну назначения. Нажмите + Add country, чтобы добавить строку, и крестик, чтобы удалить её. Выберите * All other countries для всех стран без собственной строки. В каждой строке есть Base price и весовые колонки: XS ≤1 kg, S ≤2 kg, M ≤3 kg, L ≤5 kg и XL >5 kg. Пустая (или 0) весовая колонка использует базовую цену. Базовая цена 0 означает бесплатную доставку. Принимаются как «9.99», так и «9,99». Пустые строки и вторая строка для той же страны удаляются при сохранении.

Price for countries not in the table: используется, когда нет цены Loggi в реальном времени и в таблице нет строки для страны назначения (и нет строки *). Оставьте пустым, чтобы скрыть способ в этом случае.

Fixed price applies: способ подсчёта фиксированных цен. Цена Loggi в реальном времени уже покрывает всю корзину и никогда не умножается.

Условия

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

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

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

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

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

Tax status: Taxable добавляет налог WooCommerce к стоимости доставки, None — нет. Выберите None, если ваши цены и цена Loggi уже включают налоги.

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

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

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

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

Debug log: записывает в WooCommerce > Status > Logs (источник vfd-loggi) каждый расчёт стоимости и каждый запрос к Loggi. Ошибки API записываются всегда, даже если эта опция выключена. Ключ API и адреса покупателей никогда не записываются.

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

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

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

Для адреса в Бразилии с полным 8-значным CEP плагин формирует посылки Loggi: каждый товар поворачивается так, чтобы его самая короткая сторона была высотой, и товары укладываются в одну посылку, пока она остаётся в пределах 55 × 55 × 55 см и 20 кг. Товары без веса или габаритов считаются как 1 см по каждой стороне, а каждая посылка весит не менее 100 г. Loggi принимает 2 посылки на расчёт, поэтому крупные корзины отправляются несколькими запросами, а итоги суммируются. Плагин передаёт в Loggi ваш Shop ID, адрес забора, адрес доставки и посылки, переводит итог Loggi из BRL в валюту вашего магазина и показывает его.

Каждая цена Loggi кэшируется на 1 час для корзины, адреса, аккаунта и среды, поэтому одна и та же корзина не вызывает новый запрос. Неудачный расчёт кэшируется на 10 минут. Если Loggi вообще недоступен, запросы приостанавливаются на 2 минуты, чтобы оформление заказа не ждало Loggi при каждом обновлении. Таймаут API — 10 секунд.

Вместо них используются фиксированные цены, когда API не настроен, адрес находится за пределами Бразилии или ещё не содержит полный CEP, отсутствует курс BRL, товар больше посылки Loggi, для корзины нужно более 10 посылок, или Loggi возвращает ошибку, отклонённую посылку, адрес вне зоны обслуживания или нулевой итог. Если фиксированной цены тоже нет, способ скрывается. Покупатель никогда не видит ошибку API. Причина записывается в журнал.

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

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

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

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

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

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

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

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

Loggi не появляется при оформлении заказа: проверьте, что лицензия активна, Enable/Disable включён, и способ добавлен в зону страны покупателя (или включён Ignore shipping zones и страна разрешена). Проверьте предупреждения вверху страницы настроек, ограничения по весу, Minimum order amount и Excluded shipping classes. Если покупатель ещё не ввёл полный CEP или Loggi не возвращает цену, способу нужна фиксированная цена: строка для страны, строка * или Price for countries not in the table.

Показываются только фиксированные цены: откройте WooCommerce > Status > Logs, источник vfd-loggi. Ошибки записываются всегда. Включите Debug log, чтобы видеть каждый шаг. Типичные причины: не указаны e-mail, ключ или Shop ID API, нет адреса забора, нет BRL exchange rate для валюты магазина, отличной от BRL, ещё нет полного 8-значного CEP, товар больше 55 см или тяжелее 20 кг, либо адрес вне зоны покрытия Loggi.

HTTP 401 или 403 в журнале: Loggi отклонил e-mail или ключ API. Проверьте их в Loggi и убедитесь, что Staging соответствует учётным данным: тестовые и рабочие ключи различаются.

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

Цены неточные: заполните вес и размеры ваших товаров. Без них товары считаются как 1 см по каждой стороне, а каждая посылка — как минимум 100 г.

Per item не умножает цену Loggi: так и задумано. Цена Loggi в реальном времени покрывает всю корзину. Per item применяется только к фиксированным ценам.

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

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

Удаление

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

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