VibeFox Purolator for WooCommerce — Помощь

Требования

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

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

PHP: 8.0 или новее. Расширение PHP SOAP не требуется.

Purolator E-Ship Web Services (только для тарифов в реальном времени): зарегистрируйтесь в E-Ship Web Services в Purolator E-Ship Resource Centre на сайте Purolator. Purolator выдаёт отдельные ключи и пароли для среды разработки и рабочей среды. Также нужны номер вашей расчётной учётной записи Purolator и канадский почтовый индекс, с которого вы отправляете. Если вы используете только фиксированные цены, ключи API не нужны.

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

Установка

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

2. Нажмите Activate.

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

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

5. Для тарифов в реальном времени заполните раздел Purolator API (live rates). Для тестирования включите Development environment и укажите ключ для среды разработки. Заполните Country prices или Fallback price, если нужны фиксированные цены или запасная цена (см. Настройка).

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

Настройка

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

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

Каждый раз при сохранении настроек кешированные тарифы Purolator сбрасываются. Если тарифы в реальном времени не могут работать с сохранёнными значениями (нет ключа, пароля или учётной записи, нет канадского почтового индекса отправления, нет курса CAD) либо нет ни учётных данных API, ни фиксированных цен, над настройками появляется предупреждение.

Общие

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

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

Tax status: Taxable добавляет налог WooCommerce к стоимости доставки, None не добавляет. См. также Canadian sales taxes ниже.

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

Когда заполнены ключ API, пароль и расчётная учётная запись, цена берётся из веб-сервиса Purolator E-Ship Estimating. Если Purolator не возвращает тариф, используется фиксированная цена, а если её нет, способ скрывается.

API key: ваш ключ E-Ship Web Services для выбранной среды.

API password: пароль, соответствующий ключу.

Billing account number: номер вашей учётной записи Purolator. Оценки используют тарифы этой учётной записи. Среда разработки принимает тестовую учётную запись из документации Purolator.

Development environment: использует среду разработки Purolator (devwebservices.purolator.com) с ключом для разработки. Цены — тестовые данные. Выключите на рабочем магазине.

Ship-from postal code: канадский почтовый индекс, с которого отправляются посылки, например L4W 5M8.

Service in Canada: Cheapest available (по умолчанию), Purolator Ground, Purolator Ground 9AM, Purolator Ground 10:30AM, Purolator Ground Evening, Purolator Express, Purolator Express 9AM, Purolator Express 10:30AM, Purolator Express 12PM или Purolator Express Evening.

Service to the USA: Cheapest available (по умолчанию), Purolator Ground U.S., Purolator Express U.S., Purolator Express U.S. 9AM, Purolator Express U.S. 10:30AM или Purolator Express U.S. 12:00.

International service: Cheapest available (по умолчанию), Purolator Express International, Purolator Express International 9AM, Purolator Express International 10:30AM или Purolator Express International 12:00.

Если выбранная служба не предлагается для адреса, используется самая дешёвая из доступных.

Canadian sales taxes: для канадских адресов итоговая сумма Purolator включает GST/HST/PST/QST. Включите Use Purolator prices without GST/HST/PST/QST, когда Tax status установлен в Taxable, чтобы налог не начислялся дважды.

CAD → (store currency) rate: цены Purolator указаны в CAD. Если валюта вашего магазина не CAD, укажите, сколько единиц вашей валюты стоит один CAD, например 0.68. Без этого значения тарифы в реальном времени не используются. Если валюта магазина — CAD, оставьте поле пустым.

Default product weight (kg): используется для каждого товара без веса. По умолчанию: 0.5. Веса пересчитываются из единиц магазина и передаются в Purolator как общий вес в целых фунтах, с округлением вверх.

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

Country prices: цена по стране и весу корзины в валюте магазина. Нажмите + Add country, чтобы добавить строку, и крестик, чтобы удалить строку. Выберите * Default (all other countries) для строки, которая покрывает все страны без собственной строки. У каждой строки есть цена Base и колонки размеров: XS до 1 кг, S 1–2 кг, M 2–3 кг, L 3–5 кг и XL свыше 5 кг. Пустая или нулевая цена размера использует Base. Base, равный 0, или пустой Base означает бесплатную доставку для весов без собственной цены размера. Строки без цены и неверные коды стран удаляются при сохранении. Для каждой страны сохраняется только одна строка.

Fallback price: цена для страны, у которой нет строки в Country prices и строки *. Оставьте пустым, чтобы скрывать способ для таких стран.

Fixed price per: Order взимает цену один раз. Item (price × quantity) умножает её на количество товаров в корзине. Это относится только к фиксированным ценам. Тарифы в реальном времени всегда рассчитываются на всё отправление.

Условия

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

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

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

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

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

Для этих условий вес корзины считает товары без веса как 0. Цены и веса принимают запятую или точку как десятичный разделитель.

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

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

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

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

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

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

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

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

При наличии учётных данных API плагин отправляет в Purolator запрос Quick Estimate: вашу расчётную учётную запись, почтовый индекс отправления, город, область или штат покупателя, страну и почтовый индекс, а также общий вес корзины в целых фунтах. Для Канады нужен корректный почтовый индекс, для США — корректный ZIP-код; остальные страны отправляются с почтовым индексом в том виде, в котором он введён. Габариты (объёмный вес) не передаются. Purolator возвращает цены всех служб; плагин берёт выбранную вами службу или самую дешёвую, убирает канадские налоги с продаж, если это настроено, и пересчитывает цену из CAD. Служба сохраняется с заказом как Purolator service и видна на экране заказа в админке.

Каждый ответ кешируется на 1 час. Неудачный запрос кешируется на 10 минут, чтобы сбой Purolator не замедлял каждое обновление оформления заказа. Тайм-аут API — 10 секунд.

Если Purolator не возвращает тариф (API недоступен, неверные учётные данные или почтовый индекс, служба недоступна, нет курса CAD), покупатель не видит ошибки. Используется фиксированная цена, а если её нет, способ скрывается. Причина записывается в журнал.

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

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

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

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

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

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

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

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

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

Тарифы в реальном времени не появляются: откройте WooCommerce > Status > Logs, источник «vfd-purolator». Ошибки API там есть всегда. Включите Debug log для подробностей. С ключами API адрес должен содержать корректный почтовый индекс (Канада) или ZIP-код (США).

HTTP 401 в журнале: ключ или пароль API не соответствует выбранной среде. Ключи для разработки работают только при включённом Development environment, рабочие ключи — только при выключенном.

Тариф отличается от сайта Purolator: Quick Estimate использует тарифы вашей расчётной учётной записи и общий вес, округлённый вверх до целых фунтов, без объёмного веса. Для канадских адресов итог включает налоги с продаж; используйте Canadian sales taxes, если WooCommerce добавляет налог на доставку. Цены пересчитываются по вашему курсу CAD → (store currency) rate.

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

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

Удаление

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

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