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

Вимоги

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

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

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

Обліковий запис FedEx і ключі API (лише для актуальних тарифів): у FedEx Developer Portal (developer.fedex.com) створіть проєкт із Rate API, прив'яжіть свій обліковий запис доставки FedEx і скопіюйте API Key та Secret Key. Також потрібен 9-значний номер облікового запису FedEx. Тестові ключі працюють лише з увімкненим Sandbox, ключі production — лише з вимкненим. Плагін використовує REST API FedEx з OAuth 2.0; meter number і пароль веб-служб не потрібні. Якщо ви використовуєте лише фіксовані ціни, ключі FedEx не потрібні.

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

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

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

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

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

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

5. Введіть API Key, Secret Key, 9-значний номер облікового запису FedEx і адресу Ship from (поштовий індекс та, для США і Канади, 2-літерний код штату). Вимкніть Sandbox, якщо використовуєте ключі production.

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

7. За бажанням введіть фіксовані ціни як резерв.

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

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

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

У верхній частині сторінки плагін показує попередження: заповнені лише деякі з трьох облікових даних API, немає ключів API або фіксованих цін (тоді спосіб ніколи не показується), не вказано поштовий індекс відправлення, для США або Канади не вказано код штату відправлення, або валюта магазину відрізняється від валюти облікового запису FedEx без курсу обміну. Під час кожного збереження налаштувань очищаються кешований токен FedEx і тарифи. Числові поля приймають десяткову крапку або кому. Некоректне число не зберігається, і про це повідомляється.

General

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

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

Tax status: Taxable дозволяє WooCommerce додати податок до вартості доставки, тому використовується сума FedEx без податків. None використовує чисту суму FedEx як є. За замовчуванням: Taxable.

API FedEx (актуальні тарифи)

Без ключів використовуються фіксовані ціни. Розділ містить посилання Clear cached FedEx token and rates.

Sandbox: використовує тестове середовище FedEx з тестовими ключами. Вимкніть, щоб отримувати реальні тарифи з ключами production. За замовчуванням: увімкнено.

API Key: API Key (client_id) вашого проєкту в FedEx Developer Portal.

Secret Key: Secret Key (client_secret) того самого проєкту.

FedEx account number: 9-значний обліковий запис доставки FedEx, прив'язаний до проєкту.

Rates: Account rates (your negotiated FedEx prices) (за замовчуванням) або List rates (FedEx published prices).

Residential delivery: розраховувати адреси покупців як житлові (FedEx Home Delivery, надбавка за житлову доставку). Вимкніть, якщо ви відправляєте переважно компаніям. За замовчуванням: увімкнено.

Box size: необов'язкові розміри коробки в одиницях вимірювання розмірів вашого магазину, наприклад 30x20x15. Тоді FedEx застосовує об'ємну вагу. Залиште порожнім, щоб розраховувати лише за вагою.

FedEx account currency: валюта вашого облікового запису FedEx, наприклад USD для облікових записів у США або CAD для Канади. За замовчуванням: USD. FedEx також завжди просять розрахувати вартість у валюті магазину.

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

Відправлення з

Адреса, з якої FedEx забирає посилки або куди ви їх здаєте. Використовується для актуальних тарифів.

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

State / province code: 2-літерний код, обов'язковий для США і Канади, наприклад TN, CA або ON.

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

ZIP / postal code: поштовий індекс відправлення. Без нього FedEx не може розрахувати тарифи.

Фіксовані ціни

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

Country prices: ціна у валюті вашого магазину для країни призначення, по одному рядку на країну у форматі CC=ЦІНА, наприклад US=12.99 або CA=19,99. Використовуйте * для будь-якої іншої країни, наприклад *=29.99. Рядки в іншому форматі ігноруються, і про них повідомляється під час збереження.

Fallback cost: фіксована ціна, коли жодна ціна для країни не підходить. Залиште порожнім, щоб приховати спосіб.

Fixed price is: Per order стягує ціну один раз. Per item (price x number of items) множить її на кількість товарів. Це стосується лише фіксованих цін. Актуальні тарифи FedEx завжди розраховуються для загальної ваги кошика.

Умови

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

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

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

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

Default product weight (kg): вага, яка використовується для товарів без ваги, для тарифів FedEx і для наведених вище обмежень за вагою. За замовчуванням: 0.5.

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

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

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

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

Додатково

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

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

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

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

Інакше плагін отримує токен OAuth і надсилає до Rate API FedEx адресу відправлення, адресу доставки, вагу кошика (у кг, а для магазинів, що використовують фунти або унції, — у фунтах), розмір коробки, якщо його задано, і валюту вашого магазину як бажану. Для країн, де використовуються поштові індекси, запит надсилається лише після того, як покупець введе індекс. Для міжнародних відправлень передається митна вартість кошика. Коди штатів надсилаються лише для США і Канади.

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

Токен кешується для кожного середовища та ключа і запитується повторно автоматично, коли FedEx його відхиляє. Тарифи кешуються на 1 годину. Невдалий запит тарифу запам'ятовується на 10 хвилин, невдалий запит токена — на 5 хвилин, щоб збій сервісу не сповільнював кожне оновлення оформлення замовлення. Тайм-аут API становить 15 секунд. Якщо FedEx не відповідає, покупець не бачить помилки: використовується фіксована ціна або спосіб приховується.

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

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

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

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

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

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

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

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

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

Актуальні тарифи не з'являються: увімкніть Debug log, перезавантажте оформлення замовлення і відкрийте WooCommerce > Status > Logs, джерело vfd-fedex. Там записуються неправильні ключі, хибне середовище (тестові ключі з вимкненим Sandbox або ключі production з увімкненим) і коди помилок FedEx.

Мій магазин не в USD: FedEx просять розрахувати тариф у валюті магазину. Якщо ваш обліковий запис повертає лише власну валюту, вкажіть FedEx account currency і Exchange rate. Без курсу обміну такі тарифи ігноруються і використовується фіксована ціна, тож сума в USD ніколи не показується в євро.

Чи множить «per item» тариф FedEx? Ні. Per item застосовується лише до фіксованих цін.

Тарифи виглядають застарілими після зміни: після зміни ключів кеш очищається автоматично. Також можна натиснути Clear cached FedEx token and rates.

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

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

Видалення

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

FedEx є торговельною маркою її власника. Цей плагін не пов'язаний з FedEx і не схвалений компанією FedEx.