VibeFox Jadlog for WooCommerce — Помощь

Требования

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

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

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

Договор с Jadlog (для актуальных цен и пунктов Pickup): актуальные цены и список пунктов Pickup поступают из API Embarcador Jadlog. Доступ выдаёт ваш франчайзи Jadlog после подписания договора. Нужны токен API Embarcador, CNPJ (или CPF) отправителя, указанный в договоре, расчётный счёт (conta corrente) и, если есть, номер договора. Если вы используете только фиксированные цены, договор с Jadlog не нужен.

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

Установка

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

2. Нажмите Activate.

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

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

5. Вставьте токен API, укажите CNPJ, расчётный счёт, номер договора и CEP отправки, выберите услугу Jadlog и, если валюта вашего магазина не BRL, введите курс BRL. При желании добавьте фиксированные цены или стоимость по умолчанию (см. раздел «Настройка»).

6. Добавьте VibeFox Jadlog в зону доставки для Бразилии в WooCommerce > Settings > Shipping > Shipping zones или включите Ignore shipping zones и выберите страны. Чтобы предлагать также пункты Jadlog Pickup, добавьте способ в ту же зону второй раз и выберите Pickup (40) как услугу.

Настройка

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

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

Jadlog service (zone): услуга этого способа в зоне. Same as the global setting использует услугу с главной страницы настроек. Добавьте способ дважды, чтобы предложить, например, доставку на дом (.Package) и пункты Jadlog Pickup в одной зоне.

Если название зоны пустое, а услуга — Pickup, к общему названию добавляется слово «Pickup», чтобы два способа имели разные названия.

Вверху страницы настроек плагин выводит предупреждения о неполной настройке: нет токена API, нет CNPJ или расчётного счёта, нет CEP отправки или нет курса BRL для магазина, который продаёт не в BRL. Каждый раз, когда вы сохраняете настройки, кэш цен Jadlog и списков пунктов Pickup очищается.

Общие

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

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

Актуальные цены Jadlog

Актуальные цены запрашиваются только для адресов в Бразилии с полным 8-значным CEP.

API token: токен Embarcador от Jadlog. Его можно вставить с ключевым словом «Bearer» или без него. Оставьте пустым, чтобы использовать только фиксированные цены.

CNPJ: CNPJ (14 цифр) или CPF (11 цифр) отправителя, указанного в договоре Jadlog. Допускаются точки, косые черты и дефисы. Плагин предупредит, если количество цифр неверное.

Current account (conta corrente): номер вашего расчётного счёта Jadlog. Без него и без CNPJ Jadlog не может рассчитать стоимость, и используются только фиксированные цены.

Contract number: номер вашего договора с Jadlog, если франчайзи его выдал.

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

Jadlog service: услуга (modalidade) вашего договора: .Package (3, по умолчанию), .Com (9), Expresso (0), Rodoviário (4), Econômico (5), Doc (6), Corporate (7), Internacional (10), Cargo (12), Emergencial (14) или Pickup (40). Pickup предлагает пункты Jadlog Pickup рядом с покупателем. Способ в зоне может использовать другую услугу.

Insurance type: Normal (N) (по умолчанию) или Own insurance policy (A — apólice), как согласовано в вашем договоре с Jadlog.

Volumetric weight: Jadlog взимает большее из фактического и объёмного веса.

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

Delivery time: показывать срок доставки, который вернул Jadlog, рядом с названием способа, например «Jadlog (3 рабочих дня)». Включено по умолчанию. Срок доставки всегда сохраняется в заказе.

Пункты Jadlog Pickup (используются услугой Pickup (40); нужен токен API)

Points to show: сколько пунктов Pickup предлагать, от 1 до 10. По умолчанию: 5.

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

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

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

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

Условия

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Для адреса доставки в Бразилии с полным 8-значным CEP плагин отправляет в Jadlog CEP отправления и получения, вес, ваш CNPJ, расчётный счёт, договор, услугу, тип страховки и объявленную стоимость заказа, и показывает возвращённую цену в валюте вашего магазина. Корзины без веса рассчитываются как 0,1 кг. Если актуальной цены нет (нет токена, адрес вне Бразилии, неполный CEP, нет курса BRL, ошибка Jadlog), плагин использует таблицу Price per country, затем Fallback cost. Если ни один из них не даёт цену, способ скрывается для этой корзины.

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

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

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

Пункты Pickup

Способ с услугой Pickup (40) предлагается только для адресов в Бразилии. Когда покупатель ввёл полный 8-значный CEP, плагин запрашивает у Jadlog активные ближайшие пункты Pickup и предлагает до Points to show пунктов. Каждый пункт — отдельный вариант доставки со своей ценой, например «Jadlog Pickup: название пункта — адрес». Покупатель выбирает пункт, выбирая вариант доставки, и в классическом оформлении, и в блоках «Корзина» и «Оформление заказа».

Цена до каждого пункта запрашивается у Jadlog. Если Jadlog не даёт цену для пункта, используется фиксированная цена, а пункт без какой-либо цены пропускается. Списки пунктов кэшируются на 12 часов.

Без токена API, без 8-значного CEP, когда Jadlog недоступен или когда поблизости нет активных пунктов, способ Pickup скрывается. Заказ без пункта нельзя было бы отправить.

Заказы

Строка доставки в заказе сохраняет услугу Jadlog и, если Jadlog её вернул, срок доставки в рабочих днях. Для заказа с Pickup название строки доставки содержит название и адрес пункта, а заказ также сохраняет название, адрес и ID пункта Pickup. Их видно под строкой доставки на экране заказа в админке. Покупатель видит выбранный пункт на странице «Спасибо за заказ» и в письмах о заказе.

Оформите отправление в системе Jadlog самостоятельно. В заказе указаны услуга и ID пункта Pickup, которые вам для этого нужны.

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

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

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

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

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

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

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

Показываются только фиксированные цены: включите Debug log, перезагрузите оформление заказа и откройте WooCommerce > Status > Logs, источник vfd-jadlog. Там указана причина: нет CNPJ или расчётного счёта, нет CEP отправки, неполный CEP назначения, нет курса BRL или текст ошибки Jadlog.

HTTP 401 или 403 в журнале: Jadlog отклонил токен API. Проверьте его у вашего франчайзи Jadlog. После этой ошибки API приостанавливается на 10 минут. Сохранение настроек снимает паузу, поэтому можно попробовать сразу.

Пункты Pickup не появляются: способу Pickup нужны токен API и полный 8-значный CEP в Бразилии. Если у Jadlog нет активных пунктов рядом с CEP, способ скрывается. Причину смотрите в журнале.

Цены в реалах, а не в моей валюте: введите BRL exchange rate (сколько стоит 1 BRL в валюте вашего магазина).

Цены слишком низкие или слишком высокие: заполните веса и габариты товаров. Корзины без веса рассчитываются как 0,1 кг, а объёмному весу нужны габариты.

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

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

Удаление

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

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