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