VibeFox SF Express for WooCommerce — Допомога

Вимоги

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

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

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

Обліковий запис SF Express (лише для актуальних цін): актуальні ціни беруться з відкритої платформи FengQiao компанії SF Express (open.sf-express.com). Потрібні щомісячний обліковий запис SF Express і обліковий запис розробника на FengQiao. Зареєструйтеся там, створіть застосунок, додайте до нього API «Delivery time standard and price query» (EXP_RECE_QUERY_DELIVERTM) та скопіюйте код клієнта і checkword. Checkword для sandbox і для production різняться. Якщо ви використовуєте лише таблицю цін, обліковий запис SF Express не потрібен.

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

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

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

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

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

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

5. Заповніть таблицю цін та/або запасну вартість.

6. Для актуальних цін у материковому Китаї введіть код клієнта і checkword, провінцію та місто відправки (або вкажіть китайську адресу магазину) і, якщо валюта магазину не CNY, курс конвертації. Спершу перевірте роботу з Sandbox і тестовими обліковими даними.

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

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

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

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

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

Загальні

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

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

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

API FengQiao SF Express (актуальні ціни) (необов'язково, для адрес доставки в материковому Китаї)

Customer code (partnerID): код клієнта (顾客编码) вашого застосунку FengQiao.

Checkword: checkword (校验码) того самого середовища. Він використовується лише для підпису запитів і ніколи не надсилається та не записується в журнал.

Sandbox: використовуйте sandbox FengQiao для тестів з тестовими обліковими даними. Ціни в sandbox не справжні. У робочому магазині вимкніть цей параметр. За замовчуванням: off.

SF Express product: ціна якого продукту SF Express показується.

Sender province: провінція, з якої відправляються посилки. Залиште поле порожнім, щоб використовувати провінцію адреси магазину в WooCommerce > Settings > General, якщо магазин знаходиться в Китаї.

Sender city: стандартна китайська назва міста, наприклад 深圳市. Залиште поле порожнім, щоб використовувати місто магазину, якщо магазин знаходиться в Китаї.

Currency conversion rate: ціни SF Express вказані в CNY (юанях). Якщо валюта вашого магазину не CNY, вкажіть, скільки одиниць валюти магазину коштує один CNY. Без курсу актуальні ціни не використовуються. Якщо валюта магазину CNY, ціни використовуються як є. Як десятковий роздільник приймаються і крапка, і кома.

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

Country prices: таблиця з базовою ціною для кожної країни. Рядок * Any other country застосовується до всіх країн без власного рядка. Ціна вагової категорії більше 0 замінює базову ціну для посилок цієї категорії: ≤ 1 kg, ≤ 2 kg, ≤ 3 kg, ≤ 5 kg та > 5 kg. Базова ціна 0 означає безкоштовну доставку. Порожня базова ціна означає, що для цієї країни ціни немає, і використовується запасна вартість.

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

Table / fallback price is: як стягуються ціни з таблиці та запасні ціни.

Актуальні ціни SF Express завжди стосуються всього замовлення.

Умови

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

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: WooCommerce > Status > Logs, джерело vfd-sf-express. Помилки API завжди записуються в журнал, навіть коли цю опцію вимкнено. Checkword і адреси покупців не записуються.

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

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

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

Для адреси доставки в материковому Китаї, коли задано код клієнта і checkword, плагін передає в SF Express провінцію та місто відправки, провінцію та місто покупця, вагу кошика та об'єм кошика (з товарів, у яких вказано всі три розміри). Запит підписується вашим checkword. SF Express повертає ціни в CNY, а плагін переводить обрану ціну у валюту вашого магазину.

SF Express розпізнає адреси за стандартними китайськими назвами. Провінція покупця береться з поля «Регіон/область» на сторінці оформлення замовлення. Місто потрібно писати китайською, наприклад 广州市. Для Пекіна, Шанхаю, Тяньцзіня та Чунціна місто заповнюється автоматично. Місто, написане латиницею, наприклад «Guangzhou», отримує ціну з таблиці.

Кожна ціна кешується на годину, тож той самий кошик не викликає новий запит. Невдалий запит кешується на 10 хвилин, щоб оформлення замовлення не чекало SF Express під час кожного оновлення. Тайм-аут HTTP — 10 секунд.

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

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

Плагін лише розраховує ціни. Він не створює накладних і етикеток, не створює замовлень у SF Express, не бронює забір відправлень, не скасовує і не відстежує відправлення. Створюйте та відстежуйте відправлення у своєму обліковому записі SF Express, як зазвичай. Покупці не можуть обрати пункт відділення або поштомат SF. SF Express використовується як кур'єрська доставка «від дверей до дверей». Актуальні ціни існують лише для адрес доставки в материковому Китаї. Плагін розроблено за документацією FengQiao та на основі імітованих відповідей, тож перед запуском перевірте ціни у своєму обліковому записі SF Express (спершу в sandbox).

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

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

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

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

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

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

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

Ціна береться з таблиці, а не з SF Express: актуальні ціни потребують коду клієнта і checkword, провінції та міста відправки, адреси доставки в материковому Китаї з провінцією та китайською назвою міста, а для магазинів не в CNY — курсу конвертації. Відкрийте WooCommerce > Status > Logs, джерело vfd-sf-express, щоб побачити причину. Невдалий запит повторюється через 10 хвилин.

Помилка A1006 у журналі: недійсний підпис. Checkword неправильний або належить до іншого середовища. Перевірте налаштування Sandbox.

Помилка A1004 у журналі: API запиту цін не додано до вашого застосунку FengQiao.

Гонконг: працює з таблицею цін і запасною вартістю. Запит цін FengQiao стосується лише адрес у материковому Китаї.

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

Для розробників: фільтр vfd_sfex_quote_request змінює запит ціни, наприклад на інший код продукту. vfd_sfex_api_url змінює URL шлюзу.

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

Видалення

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

SF Express — торговельна марка її власника. Цей плагін не афілійований із SF Express і не схвалений нею.