VibeFox J&T Express for WooCommerce — Допомога

Вимоги

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

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

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

Доступ до API J&T Express Malaysia (лише для онлайн-розрахунку): онлайн-розрахунок доступний лише для J&T Express Malaysia і лише для адрес доставки в Малайзії. Потрібні чотири значення. Подайте заявку на VIP-обліковий запис J&T на сайті J&T Express Malaysia (на сторінці налаштувань є посилання): J&T видасть вам VIP-код клієнта та VIP API-ключ. API-обліковий запис і приватний ключ для підпису запитів J&T видає для інтеграції через API. Запитайте їх у свого менеджера J&T. J&T Philippines, Indonesia та інші країни не мають публічного API розрахунку, тому для них використовуйте таблицю цін. Якщо ви використовуєте лише таблицю цін і резервну вартість, доступ до API J&T не потрібен.

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

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

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

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

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

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

5. Заповніть таблицю цін та/або резервну вартість. Для онлайн-розрахунку по Малайзії також введіть облікові дані API J&T, поштовий індекс відправника і, якщо валюта магазину не MYR, курс конвертації (див. розділ «Налаштування»).

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

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

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

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

Щоразу, коли ви зберігаєте налаштування, кеш розрахунків J&T очищується. Якщо онлайн-розрахунок налаштований не повністю, попередження вгорі сторінки перелічує відсутні налаштування або повідомляє, що не задано курс конвертації валюти.

Загальні

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

Method title: назва способу доставки, яка показується в кошику і під час оформлення замовлення. Зона може її перевизначити. За замовчуванням: J&T Express.

Tax status: Taxable додає податок на доставку вашого магазину до вартості, None — не додає. Оберіть None, якщо ціна J&T вже включає все, що ви хочете стягнути.

API J&T Express Malaysia (онлайн-розрахунок) (необов'язково, для адрес доставки в Малайзії; потрібні всі чотири значення)

VIP customer code: ваш VIP-код клієнта J&T Express.

VIP API key: API-ключ (пароль), який J&T Express видав разом з VIP-кодом. Він ніколи не записується в журнал.

API account: назва вашого API-облікового запису J&T Express.

API private key: приватний ключ API-облікового запису. Він використовується лише для підпису запитів (SHA-256). Він ніколи не надсилається до J&T і не записується в журнал.

Sender postcode: малайзійський поштовий індекс, з якого відправляються посилки. Залиште поле порожнім, щоб використовувати поштовий індекс магазину з WooCommerce > Settings > General, якщо магазин розташований у Малайзії. Пробіли видаляються під час збереження.

Currency conversion rate: тарифи J&T Express Malaysia вказані в MYR. Якщо валюта вашого магазину не MYR, вкажіть, скільки одиниць вашої валюти коштує один MYR (1 MYR = X). Без цього значення онлайн-розрахунок не використовується, натомість застосовуються таблиця цін або резервна вартість. Якщо валюта магазину MYR, залиште поле порожнім: тарифи використовуються без змін. Як десятковий роздільник приймаються і крапка, і кома.

Таблиця цін і резерв (використовується для країн, відмінних від Малайзії, коли онлайн-розрахунок не налаштований або коли J&T не повертає розрахунок; ціни у валюті вашого магазину)

Country prices: таблиця з одним рядком на країну. Натисніть Add country, щоб додати рядок, і хрестик, щоб його видалити. Оберіть * Any other country для всіх країн без власного рядка. У кожному рядку є Base price і п'ять вагових категорій: XS — до 1 кг, S — до 2 кг, M — до 3 кг, L — до 5 кг і XL — понад 5 кг. Ціна категорії більша за 0 замінює базову ціну для кошиків цієї категорії. Категорія з 0 використовує базову ціну. Базова ціна 0 означає безкоштовну доставку, а порожня базова ціна зберігається як 0. Країни без рядка (якщо немає рядка *) не отримують ціну з таблиці.

Fallback cost: ціна, яка використовується, коли ні J&T, ні таблиця не дають ціну. Залиште поле порожнім, щоб у цьому випадку приховати спосіб доставки.

Table / fallback price is: Per order — ціна стягується один раз. Per item (multiplied by the number of items) — ціна множиться на кількість товарів у кошику. Онлайн-розрахунки J&T завжди стосуються всього замовлення.

Умови

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

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

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

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

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

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

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

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

Додатково

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

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

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

Коли покупець вводить адресу доставки, WooCommerce запитує у плагіна тариф. Спочатку плагін перевіряє умови: країну доставки, вагу кошика, мінімальну суму і виключені класи доставки. Якщо сума кошика досягає Free shipping from, спосіб показується з ціною 0, але лише якщо для країни є ціна: рядок у Country prices, Fallback cost або онлайн-розрахунок J&T. Запит до J&T робиться, лише якщо таблиця й резервна вартість не дають ціни.

Інакше вартість береться з першого джерела, яке дає ціну:

1. Онлайн-розрахунок J&T: лише якщо задано всі чотири значення API і поштовий індекс відправника, країна доставки — Малайзія, покупець ввів 5-значний поштовий індекс і, для магазинів не в MYR, задано курс конвертації. Плагін надсилає в J&T поштові індекси відправника й одержувача та вагу кошика (щонайменше 0,1 кг) для стандартної послуги EZ, одна посилка, і перераховує отриману в MYR ціну у валюту вашого магазину.

2. Country prices: рядок країни доставки або рядок *, з ціною вагової категорії кошика.

3. Fallback cost.

Якщо жодне з джерел не дає ціну, спосіб приховується. Per item застосовується лише до цін таблиці та резервної вартості.

Кожна відповідь J&T кешується на 1 годину, тож той самий кошик не викликає новий запит. Невдалий запит кешується на 10 хвилин, щоб оформлення замовлення не чекало J&T при кожному оновленні. Тайм-аут запиту — 10 секунд. Якщо J&T повертає помилку, нульову ціну або не відповідає, покупець не бачить жодної помилки. Використовується ціна з таблиці або резервна вартість, а причина записується в журнал.

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

Плагін лише розраховує вартість доставки. Він не створює накладні, транспортні документи чи етикетки, не викликає кур'єра, не скасовує й не відстежує відправлення і не дозволяє покупцеві вибрати пункт видачі. Створюйте й відстежуйте відправлення у своєму обліковому записі J&T, як звичайно. Плагін створено на основі формату запитів офіційного плагіна J&T Express Malaysia. Перед запуском магазину уточніть тарифи у своєму обліковому записі J&T.

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

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

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

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

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

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

J&T Express не з'являється під час оформлення замовлення: перевірте, чи ліцензія активна, чи увімкнено Enable/Disable і чи додано спосіб до зони країни покупця (або чи увімкнено Ignore shipping zones і чи дозволена країна). Перевірте обмеження ваги, Minimum subtotal і Excluded shipping classes. Перевірте, чи є в Country prices рядок для країни або рядок *, чи задано Fallback cost. Увімкніть Debug log і перегляньте WooCommerce > Status > Logs.

Ціна береться з таблиці, а не від J&T: для онлайн-розрахунку потрібні всі чотири значення API, поштовий індекс відправника, малайзійська адреса доставки з 5-значним поштовим індексом і, для магазинів не в MYR, Currency conversion rate. Перегляньте попередження вгорі сторінки налаштувань. Якщо J&T відхиляє запит або не відповідає, помилка записується в журнал, і використовується ціна з таблиці або резервна вартість. Невдалий запит повторюється через 10 хвилин.

Немає онлайн-розрахунку для Філіппін або Індонезії: J&T не пропонує публічного API розрахунку для цих країн. Використовуйте для них таблицю цін і резервну вартість.

Країна помилково отримує безкоштовну доставку: її рядок має базову ціну 0 (порожня базова ціна зберігається як 0). Введіть базову ціну або видаліть рядок.

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

Хуки для розробників: фільтр vfd_jtex_quote_request змінює тіло запиту розрахунку (наприклад, тип послуги), vfd_jtex_api_url змінює адресу API розрахунку, а стандартний фільтр woocommerce_shipping_vfd_jt_express_is_available керує доступністю.

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

Видалення

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

J&T Express — торговельна марка її власника. Цей плагін не пов'язаний з J&T Express і не схвалений нею.