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

Вимоги

WordPress: 5.8 або новіша.

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

PHP: 8.0 або новіша.

Обліковий запис Blue Express (лише для тарифів у реальному часі): тарифи в реальному часі потребують облікового запису e-commerce Blue Express і його API-ключа (x-api-key). Запитайте ключ у Blue Express: developers.bluex.cl або gpo.integraciones@bx.cl. Служба, яку ви використовуєте (EX, PY або MD), має бути увімкнена у вашому договорі з Blue Express. Якщо ви використовуєте лише фіксовані ціни, API-ключ не потрібен.

Пункти видачі: карта Blue Express завантажується в браузері покупця з widget-pudo.blue.cl.

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

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

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

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

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

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

5. Введіть API-ключ, службу, код району відправлення (наприклад, SCL), курс CLP, якщо валюта вашого магазину не CLP, та фіксовані ціни (наприклад, CL=4500). Див. розділ «Конфігурація».

6. Перейдіть до WooCommerce > Settings > Shipping > Shipping zones і додайте VibeFox Blue Express до вашої зони Чилі. У налаштуваннях методу оберіть назву та тип доставки (додому або самовивіз у пункті Blue Express). Додайте метод двічі, щоб пропонувати обидва варіанти.

Конфігурація

Основні налаштування розташовані в WooCommerce > Settings > Shipping > VibeFox Blue Express. Вони застосовуються до всіх зон доставки. Попередження про налаштування, які приховали б метод або тариф у реальному часі (немає API-ключа, немає курсу CLP, порожня таблиця фіксованих цін), показуються вгорі сторінки. Збереження налаштувань очищає кеш.

Вікно зони (коли ви додаєте метод до зони доставки)

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

Delivery type: As in the global settings (за замовчуванням), Home delivery або Pickup at a Blue Express point (PUDO). Додайте метод до зони двічі, щоб пропонувати доставку додому та самовивіз.

Загальні

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

Name: назва методу доставки, що відображається на оформленні замовлення. Зона може задати власну назву. За замовчуванням: Blue Express.

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

API Blue Express (потрібно для тарифів у реальному часі)

API key: ваш API-ключ Blue Express (заголовок x-api-key). Без нього використовуються лише фіксовані ціни.

Service: служба Blue Express для тарифу: Express (EX) (за замовчуванням), Prioritario (PY) або SameDay (MD). Вона має бути увімкнена у вашому договорі з Blue Express.

Origin district code: код району Blue Express місця, звідки ви відправляєте, наприклад SCL для Сантьяго (за замовчуванням). Якщо не впевнені, уточніть у Blue Express.

CLP per 1 (your currency): ціни Blue Express вказані в чилійських песо (CLP). Якщо ваш магазин використовує іншу валюту, вкажіть, скільки CLP коштує одиниця цієї валюти, наприклад 1050. Без цього значення тарифи в реальному часі не використовуються. Ігнорується, якщо валюта магазину — CLP.

Ціна

Rate source: як розраховується ціна.

Fixed prices: один рядок на країну у форматі COUNTRY_CODE=PRICE, у валюті вашого магазину, наприклад CL=4500 у магазині в CLP або CL=4.50 у магазині в EUR. Як десятковий роздільник приймаються кома або крапка. Некоректні рядки виводяться під час збереження. Фіксовані ціни можна використовувати для будь-якої країни.

Fixed price per: Order стягує ціну один раз. Item (price x quantity) множить її на кількість товарів у кошику. Це стосується лише фіксованої ціни. Тариф API завжди для всього відправлення.

Умови

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

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

Minimum order subtotal: показує метод лише від цієї суми кошика (валюта магазину). Залиште порожнім, щоб показувати завжди.

Excluded shipping classes: якщо будь-який товар у кошику належить до вибраного класу доставки WooCommerce, метод приховується.

Безкоштовна доставка

Free shipping: вмикає безкоштовну доставку від суми кошика.

Free from subtotal: сума кошика (валюта магазину), від якої доставка безкоштовна.

Самовивіз у пунктах Blue Express (PUDO)

Pickup point by default: якщо увімкнено, методи Blue Express доставляють до пункту Blue Express, обраного покупцем. Це значення за замовчуванням для методів зон з Delivery type = As in the global settings. Покупець має обрати пункт, щоб оформити замовлення.

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

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

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

Додатково

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

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

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

Коли покупець вводить адресу доставки, плагін перевіряє вагу кошика, Minimum order subtotal та Excluded shipping classes. Якщо діє безкоштовна доставка, тариф дорівнює 0 і запит до Blue Express не надсилається.

Для тарифу в реальному часі адреса має бути в Чилі, з регіоном і містом (комуною). Плагін спершу просить Blue Express розпізнати комуну, потім запитує ціну для служби, району відправлення, призначення та посилок. Кожен товар надсилається з вагою та розмірами, переведеними в кг і см. Товари без ваги або розмірів надсилаються як 0,01 кг, 10 x 10 x 10 см. Оголошена вартість надсилається в CLP. Ціна в CLP перераховується у валюту вашого магазину.

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

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

Плагін не створює відправлення чи етикетки в Blue Express, не призначає номери відстеження та не показує оновлення відстеження. Створіть відправлення у своєму обліковому записі Blue Express. Регіональних тарифних таблиць за комунами немає: використовуйте тариф API Blue Express або одну фіксовану ціну для країни. Тарифи в реальному часі працюють лише для Чилі.

Пункти видачі

За типу доставки Pickup at a Blue Express point (PUDO) покупець бачить Choose pickup point під варіантом Blue Express — як на класичному оформленні замовлення, так і на блоковому. Кнопка відкриває офіційну карту Blue Express, де покупець обирає пункт. Обраний пункт показується з назвою та адресою, а кнопка змінюється на Change pickup point. Потім тариф перераховується за ціною самовивозу Blue Express (PUDO).

Замовлення не можна оформити без пункту: покупець бачить Please choose a Blue Express pickup point. Це перевіряється на сервері.

Обраний пункт зберігається в замовленні з кодом агентства Blue Express, назвою та адресою. На екрані замовлення в адмінці він показується під адресою доставки як Blue Express pickup point. Натисніть Edit, щоб обрати інший пункт на карті Blue Express або ввести код агентства, назву й адресу вручну, а потім натисніть Save pickup point. Зміна записується в примітку до замовлення. Покупець бачить пункт на сторінці замовлення та в листах про замовлення (HTML і текстова версія). Листи магазину також показують код агентства. Існуючі замовлення зберігають дані свого пункту видачі.

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

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

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

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

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

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

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

Тарифи в реальному часі не з'являються: за Blue Express API only метод приховується, коли тарифу немає. Увімкніть Debug log, перезавантажте оформлення замовлення та відкрийте WooCommerce > Status > Logs (джерело «vfd-blue-express»). Типові причини: немає API-ключа, валюта магазину не CLP без курсу, відсутній регіон або комуна в адресі, комуна не розпізнана Blue Express або помилка API (наприклад, HTTP 401 чи 403, коли API-ключ відхилено). За Blue Express API, fixed price if the API gives no rate покупці все одно отримують фіксовану ціну, поки ви виправляєте проблему.

Податок додається понад ціну Blue Express: ціни Blue Express включають IVA. Установіть Tax status на None, якщо WooCommerce не має додавати податок зверху.

Карта не відкривається: карта завантажується в браузері покупця з widget-pudo.blue.cl, тож ця адреса має бути доступною і не блокуватися на вашому сайті.

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

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

Видалення

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

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