VibeFox Australia Post for WooCommerce — Помощь

Требования

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

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

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

Ключ PAC API Australia Post (только для тарифов в реальном времени): тарифы в реальном времени используют API Postage Assessment Calculator (PAC) Australia Post. Ключ бесплатный: зарегистрируйтесь на Australia Post Developer Centre (developers.auspost.com.au) и получите ключ PAC API. Также нужен 4-значный австралийский почтовый индекс, с которого вы отправляете посылки. Если вы используете только фиксированные цены для каждой страны, ключ API не нужен.

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

Установка

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

2. Нажмите Activate.

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

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

5. Выберите Rate source. Для тарифов в реальном времени введите ключ PAC API, почтовый индекс отправления и, если валюта магазина не AUD, курс пересчёта в AUD (см. раздел «Настройка»).

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

Настройка

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

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

При каждом сохранении настроек кэш тарифов Australia Post очищается. Если выбраны тарифы в реальном времени, но не заполнены ключ API, почтовый индекс отправления или курс AUD, после сохранения появится предупреждение.

General

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

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

Tax status: Taxable добавляет налог WooCommerce к стоимости доставки, None — нет.

Rate source: способ расчёта цены.

Подробности ошибок записываются в журнал и никогда не показываются покупателю.

API Australia Post (тарифы в реальном времени) (для фиксированных цен не нужен)

PAC API key: ваш бесплатный ключ PAC API Australia Post. Он передаётся в Australia Post в заголовке AUTH-KEY.

Ship-from postcode: 4-значный австралийский почтовый индекс, с которого отправляются посылки, например 2000.

Domestic service: используется для доставки внутри Австралии (до 22 кг, 105 см по каждой стороне): Parcel Post (по умолчанию) или Express Post.

International service: используется для доставки за пределы Австралии (до 20 кг): International Standard (по умолчанию), International Express или International Courier.

Remove GST: делит внутренние цены API на 1,1. Внутренние цены Australia Post включают 10 % GST. Включайте опцию, когда WooCommerce сам добавляет налог к доставке (Tax status = Taxable), чтобы GST не начислялся дважды. Международная почта не облагается GST и никогда не изменяется.

AUD → (your currency) rate: цены Australia Post указаны в AUD. Если валюта магазина не AUD, укажите, сколько единиц вашей валюты стоит 1 AUD, например 0.61. Без этого значения тарифы в реальном времени не используются. Если валюта магазина AUD, оставьте поле пустым. В качестве десятичного разделителя принимаются и точка, и запятая.

Посылка для тарифов в реальном времени

Корзина отправляется как одна посылка. Вес и размеры товаров переводятся из единиц вашего магазина в кг и см. Значения ниже используются для товаров без веса или размеров.

Default product weight (kg): используется для каждого товара без веса — в запросе к Australia Post и при проверке Min cart weight / Max cart weight. По умолчанию: 1.

Default parcel length (cm): используется, когда ни у одного товара в корзине нет размеров. По умолчанию: 22.

Default parcel width (cm): используется, когда ни у одного товара в корзине нет размеров. По умолчанию: 16.

Default parcel height (cm): используется, когда ни у одного товара в корзине нет размеров. По умолчанию: 8.

Фиксированные цены (используются при фиксированных ценах и как запасной вариант для тарифов в реальном времени)

Country prices: таблица кодов стран из 2 букв (AU, NZ, US и т. д.) и цен в валюте вашего магазина. Нажмите + Add row, чтобы добавить страну, и кнопку удаления, чтобы убрать строку. Используйте * для всех остальных стран. Для страны без цены (и без строки *) фиксированного тарифа нет, поэтому способ для неё скрывается. Таблица пуста, пока вы не добавите цены.

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

Условия

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

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

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

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

Free shipping: включает бесплатную доставку от суммы, указанной ниже.

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

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

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

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

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

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

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

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

Когда покупатель вводит адрес доставки, WooCommerce запрашивает у плагина тариф. Плагин сначала проверяет вес корзины, Minimum order amount и Excluded shipping classes. Если применяется бесплатная доставка, тариф равен 0 и запрос в Australia Post не отправляется.

В режиме фиксированных цен цена берётся из таблицы. В режимах тарифов в реальном времени плагин отправляет в Australia Post вес посылки и, для внутренней доставки, почтовые индексы отправления и доставки и размер посылки; для международной доставки — страну назначения. Внутренний тариф в реальном времени запрашивается только после того, как покупатель ввёл 4-значный почтовый индекс. Если посылка превышает лимиты Australia Post (22 кг или 105 см внутри страны, 20 кг международная), запрос не отправляется. Цена в AUD пересчитывается по вашему курсу, а GST исключается из внутренних цен, если включена опция Remove GST.

Каждый успешный ответ кешируется на 1 час, поэтому та же корзина не вызывает новый запрос. Неудачный запрос кешируется на 10 минут, чтобы оформление заказа не ждало Australia Post при каждом обновлении. Ошибки API никогда не показываются покупателю: способ скрывается или, в режиме запасного варианта, используется фиксированная цена.

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

Плагин только рассчитывает тарифы. Он не создаёт этикетки доставки, отправления eParcel или MyPost Business и манифесты, не отслеживает посылки и не позволяет покупателям выбирать постаматы или почтовые отделения. Корзина всегда рассчитывается как одна посылка. Письма, сумки (satchel) и договорные тарифы (eParcel) не учитываются.

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

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

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

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

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

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

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

Тарифы в реальном времени не появляются: включите Debug log, перезагрузите страницу оформления заказа и откройте WooCommerce > Status > Logs (источник «vfd-australia-post»). Там будет указана причина: нет ключа API или почтового индекса отправления, ещё не введён 4-значный почтовый индекс доставки, посылка выше лимитов, нет курса AUD или ошибка Australia Post. При Live rates, fixed price if the API gives no rate покупатели по-прежнему видят фиксированную цену, пока вы устраняете проблему.

Магазин не в AUD: введите курс пересчёта (сколько единиц вашей валюты стоит 1 AUD) в поле AUD → (your currency) rate. Фиксированные цены всегда указываются в валюте магазина.

GST при доставке начисляется дважды: внутренние цены Australia Post включают 10 % GST. Если Tax status равен Taxable, включите Remove GST.

Цена слишком высокая или слишком низкая: проверьте вес и размеры товаров и значения по умолчанию в разделе Parcel for live rates. При Item (price × quantity) фиксированные цены умножаются на количество товаров.

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

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

Удаление

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

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