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 і не схвалений нею.