VibeFox EasyPost for WooCommerce — Допомога

Вимоги

WordPress: 5.8 або новіша версія.

WooCommerce: 7.0 або новіша, встановлений і активний. Плагін не активується без нього.

PHP: 8.0 або новіша версія.

Обліковий запис EasyPost (лише для актуальних тарифів): створіть обліковий запис на сайті EasyPost, підключіть облікові записи перевізників (USPS, UPS, FedEx та інших) у панелі EasyPost і скопіюйте ключ API з EasyPost Dashboard > Account Settings > API Keys. EasyPost стягує плату за придбані етикетки, а не за запити тарифів. Якщо ви використовуєте лише резервні ціни, обліковий запис EasyPost не потрібен.

Товари: товари мають мати вагу і, бажано, розміри.

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

Встановлення

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

2. Натисніть Activate.

3. Відкрийте налаштування: WooCommerce > Settings > Shipping > VibeFox EasyPost або натисніть Settings під назвою плагіна на сторінці Plugins.

4. Введіть ліцензійний ключ VibeFox у блоці ліцензії вгорі сторінки і натисніть Activate.

5. Вставте ключ API EasyPost і заповніть адресу Ship from. Поштовий індекс обов'язковий для актуальних тарифів.

6. Якщо валюта вашого магазину не USD, введіть USD exchange rate. За бажанням введіть резервні ціни (див. Налаштування).

7. Додайте VibeFox EasyPost до зони доставки в WooCommerce > Settings > Shipping > Shipping zones або увімкніть Ignore shipping zones і виберіть країни.

Налаштування

Усі налаштування містяться на одній сторінці: WooCommerce > Settings > Shipping > VibeFox EasyPost. Вони діють для всіх зон доставки. Коли ви додаєте спосіб до зони, у вікні зони є лише одне поле:

Title (zone): назва способу доставки, яку бачать покупці в цій зоні. Залиште порожнім, щоб використовувати загальну Name.

Вгорі сторінки плагін показує попередження, коли актуальні тарифи не можна використовувати: немає ключа API, немає поштового індексу або країни відправлення, або валюта магазину не USD без курсу обміну. Також з'являється примітка, якщо встановлено тестовий ключ API. Щоразу, коли ви зберігаєте налаштування, кеш тарифів EasyPost очищується.

Загальні

Enable/Disable: вмикає або вимикає спосіб у всіх зонах одночасно. За замовчуванням: увімкнено.

Name: назва способу доставки, що показується в кошику та на оформленні замовлення. Зона може замінити її власною Title. За замовчуванням: EasyPost Shipping.

Обліковий запис EasyPost

API key: ваш ключ API EasyPost з EasyPost Dashboard > Account Settings > API Keys. Робочий ключ (починається з EZAK) повертає реальні тарифи. Тестовий ключ (починається з EZTK) повертає тестові тарифи EasyPost; використовуйте його лише для перевірки.

Allowed carriers / services: необов'язково, через кому. Введіть перевізника (USPS) або перевізника і службу (USPS:Priority, UPS:Ground) так, як їх називає EasyPost. Показується найдешевший дозволений тариф. Залиште порожнім, щоб показувати найдешевший тариф будь-якого перевізника.

Звідки відправлення

Адреса, з якої відправляються ваші посилки. Якщо Country — країна вашого магазину, порожні поля заповнюються з адреси магазину в WooCommerce > Settings > General (а ім'я відправника — з назви сайту).

Sender name / company: ім'я відправника або назва компанії.

Street address: вулиця адреси відправлення.

City: місто відправлення.

State: двобуквений код штату, наприклад CA або NY.

ZIP code: поштовий індекс відправлення. Обов'язковий для актуальних тарифів.

Country: країна, з якої ви відправляєте. За замовчуванням: United States.

Тарифи

Parcels: як кошик надсилається в EasyPost.

Ваги переводяться з одиниці ваги магазину в унції (мінімум 1 oz), розміри — в дюйми. Якщо в якогось товару немає розмірів, посилка розраховується лише за вагою.

USD exchange rate: тарифи EasyPost вказані в USD. Введіть ціну 1 USD у валюті вашого магазину, наприклад 0.92. Без цього значення актуальні тарифи не використовуються, лише резервні ціни. Не потрібно, якщо валюта магазину — USD. Магазини в USD і CAD просять EasyPost розраховувати у їхній валюті. Розділювачем десяткової частини приймаються і крапка, і кома.

Tax status: Taxable дозволяє WooCommerce нараховувати податок на доставку за вашими податковими правилами, None — ні. Тарифи EasyPost не включають податок з продажу. За замовчуванням: Taxable.

Резервні ціни

Використовуються, коли актуального тарифу немає: немає ключа API, EasyPost недоступний, ключ відхилено або жоден перевізник не має тарифу для адреси. Ціни вказані у валюті вашого магазину. Залиште обидва поля порожніми, щоб у такому разі приховати спосіб.

Country prices: один рядок на країну: двобуквений код країни, двокрапка і ціна, наприклад US:9.99. Рядки в іншому форматі ігноруються і перелічуються в повідомленні про помилку під час збереження.

Other countries: ціна для країн, яких немає у списку вище. Залиште порожнім, щоб приховати спосіб для них.

Умови

Free shipping from: сума кошика, починаючи з якої доставка безкоштовна. У цьому разі запит до EasyPost не надсилається. Залиште порожнім, щоб вимкнути.

Minimum subtotal: показувати спосіб, лише якщо сума кошика не менша за цю величину. Залиште порожнім, щоб показувати завжди.

Minimum weight: приховувати спосіб, коли кошик важить менше, в одиницях ваги вашого магазину. 0 означає без обмежень.

Maximum weight: приховувати спосіб, коли кошик важить більше, в одиницях ваги вашого магазину. 0 означає без обмежень.

Disabled shipping classes: приховувати спосіб, коли в кошику є товар з будь-якого з цих класів доставки WooCommerce.

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

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

Countries: країни призначення для цього режиму. Залиште порожнім, щоб використовувати всі країни, до яких доставляє ваш магазин. Це поле використовується лише коли увімкнено Ignore shipping zones.

Додатково

Debug log: записує запити до EasyPost у WooCommerce > Status > Logs, джерело vfd-easypost. Помилки API завжди записуються, навіть коли ця опція вимкнена. Ключ API і адреси покупців ніколи не записуються в журнал.

Remove data on uninstall: якщо увімкнено, при видаленні плагіна видаляються його налаштування та способи в зонах. Деактивація плагіна ніколи не видаляє налаштування.

Як це працює під час оформлення замовлення

Коли покупець вводить адресу доставки, WooCommerce запитує в плагіна тариф. Плагін спочатку перевіряє умови: країна доставки, вага кошика, мінімальна сума та вимкнені класи доставки. Якщо діє безкоштовна доставка, спосіб показується з нульовою ціною і запит до EasyPost не надсилається.

Інакше плагін надсилає в EasyPost адресу відправлення, адресу доставки та посилку, отримує тарифи всіх ваших облікових записів перевізників, вибирає найдешевший дозволений тариф, перераховує його у валюту магазину і показує під назвою вашого способу. Для країн, де потрібен поштовий індекс, запит надсилається лише після того, як покупець його введе.

Кожна відповідь кешується на 1 годину для тієї самої адреси і тієї самої посилки. Адреса без придатних тарифів запам'ятовується на 10 хвилин. Після тайм-ауту, відхиленого ключа, обмеження частоти запитів (rate limit) або помилки сервера EasyPost запити не надсилаються протягом 5 хвилин. Тайм-аут API — 10 секунд. У всіх цих випадках покупець не бачить помилки: використовується резервна ціна, або спосіб приховується, якщо резервної ціни немає.

Вибраний перевізник і служба, а в режимі однієї посилки — орієнтовні строки доставки зберігаються в рядку доставки замовлення. Ви бачите їх на екрані замовлення в адмінці.

Спосіб працює в класичному оформленні замовлення та в блоках Кошик і Оформлення замовлення. Він сумісний із High-Performance Order Storage (HPOS) WooCommerce.

Плагін лише розраховує тарифи. Він не купує етикетки, не відстежує посилки, не перевіряє адреси, не пропонує пункти самовивозу чи здачі посилок, не додає страхування або підпис. Показується один варіант (найдешевший дозволений тариф), а не список служб. Пакування в коробки понад складання товарів в одну посилку немає, а націнки на тариф і плати за обробку немає.

Ліцензійний ключ

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

Один ключ працює на одному домені. Видалення ключа з сайту не звільняє місце під домен. Звільніть його у своєму обліковому записі на vibefox.net.

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

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

Усунення несправностей

EasyPost не з'являється під час оформлення замовлення: перевірте, що ліцензія активна, що Enable/Disable увімкнено і спосіб доданий до зони країни покупця (або що увімкнено Ignore shipping zones і країна дозволена). Перевірте обмеження за вагою, Minimum subtotal і Disabled shipping classes. Без актуального тарифу способу потрібна резервна ціна для країни або для Other countries.

Актуальні тарифи не з'являються: прочитайте попередження вгорі сторінки налаштувань, потім увімкніть Debug log, оновіть оформлення замовлення і відкрийте WooCommerce > Status > Logs, джерело vfd-easypost. Типові причини: немає ключа API або поштового індексу відправлення, магазин не в USD без USD exchange rate, покупець ще не ввів поштовий індекс, жоден перевізник вашого облікового запису EasyPost не обслуговує адресу, або фільтри Allowed carriers / services відсіюють усі тарифи.

Тарифи схожі на тестові ціни: встановлено тестовий ключ (EZTK...). Використовуйте робочий ключ (EZAK...) у магазині, який працює.

Тарифи зупинилися на кілька хвилин: після тайм-ауту, відхиленого ключа або помилки сервера EasyPost плагін призупиняє запити на 5 хвилин і використовує резервні ціни. Перевірте ключ API і журнал.

Чи включено податок? Тарифи EasyPost не включають податок з продажу. За Tax status Taxable WooCommerce нараховує податок на доставку згідно з вашими податковими налаштуваннями.

Тарифи виглядають застарілими після зміни: збережіть сторінку налаштувань. Це очистить кеш тарифів EasyPost.

Хуки для розробників: фільтри vfd_ep_shipment_request (тіло запиту), vfd_ep_selected_rate (вибраний тариф), vfd_ep_api_url (базовий URL API) і woocommerce_shipping_vfd_easypost_is_available налаштовують плагін.

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

Видалення

Деактивація плагіна зберігає всі налаштування і лише очищає кеш тарифів. Щоб видалити плагін, деактивуйте його і видаліть на сторінці Plugins. Ліцензійний ключ і статус ліцензії цього плагіна, кеш тарифів і старі файли журналів завжди видаляються. Налаштування і способи в зонах видаляються лише якщо було увімкнено Remove data on uninstall. Інакше вони зберігаються для повторного встановлення. Існуючі замовлення зберігають свої рядки доставки.

EasyPost є торговою маркою її власника. Цей плагін не афілійований з EasyPost і не схвалений нею.