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

Вимоги

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

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

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

Обліковий запис Shippo: створіть обліковий запис Shippo, підключіть або увімкніть перевізників (USPS, UPS, FedEx, DHL та інших) і скопіюйте API-токен у розділі Shippo > Settings > Advanced > API. Shippo стягує плату за придбані етикетки, а не за запити тарифів. Нові облікові записи Shippo можуть потребувати перевірки з боку Shippo, перш ніж почнуть повертатися тарифи в реальному часі. Без токена використовуються лише резервні ціни.

Товари: товари мають містити вагу та розміри. Товари без розмірів використовують коробку за замовчуванням.

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

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

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

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

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

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

5. Вставте API-токен Shippo та заповніть адресу Ship from. Поштовий індекс є обов'язковим.

6. Виберіть Shippo rate currency (USD, якщо ви відправляєте зі США) і, якщо ваш магазин використовує іншу валюту, введіть курс обміну.

7. За бажанням введіть резервні ціни в таблиці за країнами та вагою.

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

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

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

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

Щоразу, коли ви зберігаєте налаштування, кешовані тарифи Shippo очищаються. Попередження над налаштуваннями повідомляють, коли спосіб не можна показати ніколи або коли тарифи в реальному часі не можна використовувати: немає API-токена, немає поштового індексу чи країни відправника або не задано курс обміну. Сповіщення нагадує, що встановлено тестовий токен.

Загальні

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

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

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

API token: ваш API-токен Shippo. Використовуйте робочий токен (shippo_live_...) для реальних тарифів у робочому магазині або тестовий токен (shippo_test_...) для тестових тарифів Shippo.

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

Ship from (адреса, з якої відправляються посилки; порожні поля заповнюються з адреси магазину в WooCommerce > Settings > General, якщо вона в тій самій країні)

Sender name / company: ім'я відправника. Воно також використовується для підпису митної декларації.

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

City: місто відправника.

State / province: двобуквений код штату або області, наприклад CA або NY. Деякі перевізники його вимагають.

Postal / ZIP code: обов'язково для тарифів у реальному часі.

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

Тарифи

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

Default box size: довжина x ширина x висота в одиницях виміру вашого магазину, наприклад 30 x 20 x 10. Shippo потрібен розмір коробки. Він використовується, коли товар у кошику не має розмірів. Залиште порожнім, щоб використовувати 30 x 20 x 10 см.

Shippo rate currency: валюта, у якій Shippo котирує перевізників, тобто валюта країни відправлення: USD (США), CAD (Канада), GBP (Велика Британія), EUR (єврозона) або AUD (Австралія). За замовчуванням: USD. Тарифи, які Shippo повертає у валюті магазину, завжди використовуються як є.

Exchange rate: ціна 1 одиниці Shippo rate currency у валюті вашого магазину, наприклад 0.92. Не потрібен, якщо валюти однакові. Без нього тарифи в іншій валюті не використовуються і діють резервні ціни. Плагін не конвертує валюти автоматично.

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

Резервні ціни (використовуються, коли тарифу в реальному часі немає: немає API-токена, Shippo недоступний, токен відхилено або немає тарифів перевізників для адреси; ціни у валюті магазину; залиште обидва поля порожніми, щоб приховати спосіб у такому разі)

Country prices: таблиця цін за країною та вагою кошика. Натисніть + Add country, щоб додати рядок, і хрестик, щоб видалити його. Стовпці: Price та вагові категорії XS (до 1 кг), S (до 2 кг), M (до 3 кг), L (до 5 кг) і XL (понад 5 кг). Порожня або нульова категорія використовує стовпець Price. Рядок * Default застосовується до країн без власного рядка. Новий рядок створюється як * Default. Рядок, збережений з усіма порожніми клітинками, стягує 0, тож видаляйте рядки, які не заповнюєте.

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

Умови

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

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

Minimum weight (kg): мінімальна вага кошика, за якої показується цей спосіб. 0 означає без обмежень.

Maximum weight (kg): спосіб приховується, якщо вага кошика перевищує це значення. За замовчуванням: 30. 0 означає без обмежень.

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

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

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

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

Додатково

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

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

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

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

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

У режимі «одна посилка на замовлення» товари складаються в одну коробку: найдовша та середня сторони найбільших товарів і найменші сторони всіх одиниць, додані разом. Якщо в якогось товару немає розмірів, для всієї посилки використовується коробка за замовчуванням. У режимі «одна посилка на товар» кожен товар тарифікується як окрема посилка, а тариф множиться на його кількість.

Кожна відповідь кешується на 1 годину для кожної адреси та посилки. Коли Shippo відповідає без придатного тарифу, адреса запам'ятовується на 10 хвилин. Після тайм-ауту, відхиленого токена, помилки сервера або обмеження частоти запитів плагін призупиняє запити на 5 хвилин і використовує резервні ціни. Тайм-аут запиту — 10 секунд.

Якщо тарифу в реальному часі немає, ціна береться з резервної таблиці, потім з Other countries. Якщо жодна з них не підходить, спосіб приховується. Покупець ніколи не бачить помилки.

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

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

Замовлення

Рядок доставки замовлення зберігає вибрані Carrier / service і, для однієї посилки на замовлення, Estimated delivery days. Ви бачите їх на екрані замовлення в адмінці та можете купити відповідну етикетку в Shippo.

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

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

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

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

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

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

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

Тарифи в реальному часі не з'являються: увімкніть Debug log, перезавантажте оформлення замовлення та відкрийте WooCommerce > Status > Logs, джерело vfd-shippo. Поширені причини: немає API-токена або поштового індексу відправника, валюта магазину відрізняється від Shippo rate currency без курсу обміну, поштовий індекс покупця ще не введено, жоден перевізник вашого облікового запису Shippo не обслуговує адресу або обліковий запис Shippo ще не перевірено.

Тестові тарифи в робочому магазині: тестовий токен (shippo_test_...) повертає тестові тарифи Shippo. Використовуйте робочий токен (shippo_live_...).

Безкоштовна доставка для неочікуваних країн: перевірте таблицю цін на наявність порожнього рядка, особливо порожнього рядка * Default. Рядок з усіма порожніми клітинками стягує 0.

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

Для розробників: фільтри vfd_shpo_shipment_request, vfd_shpo_customs_declaration, vfd_shpo_selected_rate і vfd_shpo_api_url змінюють тіло запиту, митну декларацію, обраний тариф і URL API.

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

Видалення

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

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