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

Вимоги

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

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

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

Обліковий запис Balikobot (для живих тарифів і пунктів видачі): потрібен обліковий запис Balikobot з доступом до API. Користувач API і ключ API знаходяться в клієнтській зоні Balikobot (client.balikobot.cz). Служба підтримки Balikobot (podpora@balikobot.cz) активує API для вашого облікового запису та перевізників. Живим тарифам потрібні перевізник і послуга, для яких Balikobot підтримує «transportcosts». Пунктам видачі потрібен перевізник з підтримкою «branchlocator» (наприклад Česká pošta, Zásilkovna, PPL, DPD, GLS). Якщо не впевнені, зверніться до служби підтримки Balikobot. Фіксовані ціни працюють без облікового запису.

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

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

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

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

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

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

5. Введіть користувача та ключ API, виберіть перевізника, тип послуги, джерело ціни та ціни за країнами (див. Налаштування). Для послуг із пунктами видачі увімкніть Pickup point selection.

6. Додайте VibeFox Balikobot до зони доставки (наприклад, Чехія) у WooCommerce > Settings > Shipping > Shipping zones або увімкніть Ignore shipping zones і виберіть країни.

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

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

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

Загальні

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

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

Tax status: Taxable означає, що WooCommerce додає податок на доставку до ціни; None означає, що не додає. Ціни Balikobot зазвичай без ПДВ.

Обліковий запис API Balikobot (потрібен для живих тарифів і пунктів видачі)

API user: ваш користувач API Balikobot з клієнтської зони.

API key: ваш ключ API Balikobot з клієнтської зони.

Carrier: перевізник Balikobot для тарифів і пунктів видачі: Česká pošta (за замовчуванням), Zásilkovna (Packeta), PPL, DPD, GLS, DHL Express, UPS, TNT, FedEx, Geis, InTime, Uloženka, Toptrans, Pošta bez hranic, Slovenská pošta, SPS (Slovak Parcel Service) або Magyar Posta. Він має бути активований у вашому обліковому записі Balikobot.

Service type: код послуги Balikobot у перевізника. За замовчуванням: NP. Для Česká pošta: NP = посилка до поштового відділення, NB = посилка до Balíkovna, DR = доставка додому. Коди інших перевізників наведено в клієнтській зоні Balikobot і в документації API.

Ціна (усі ціни вказано у валюті вашого магазину)

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

Country prices: фіксована ціна для кожної країни призначення (код із 2 літер, наприклад CZ, SK). Використовуйте * для всіх інших країн. Десяткові значення з крапкою або комою. Використовується у фіксованому режимі та як запасний варіант, якщо API не працює. Країна без ціни (і без рядка *) фіксованого тарифу не отримує.

Fixed price per: Order — ціна стягується один раз. Item (price × quantity) — ціна множиться на кількість товарів у кошику. Це стосується лише фіксованих цін. Живий тариф Balikobot завжди розраховано на всю посилку.

Exchange rate: вартість 1 одиниці валюти ціни Balikobot (зазвичай CZK) у валюті вашого магазину, наприклад 0.04. Використовується, лише якщо Balikobot повертає ціну в іншій валюті. Залиште поле порожнім, щоб відхиляти такі ціни, і покупець ніколи не заплатить неправильну суму.

Умови

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

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

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

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

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

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

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

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

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

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

Pickup point selection: покупець повинен обрати пункт видачі. Використовуйте для послуг із пунктами видачі, наприклад Česká pošta NP або NB, або Zásilkovna. Потребує користувача та ключ API.

Selector width: CSS-ширина списку пунктів видачі, наприклад 100% або 400px. За замовчуванням: 100%.

Додатково

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

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

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

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

У фіксованому режимі ціна береться з Country prices. У живих режимах плагін передає Balikobot перевізника, тип послуги, країну та поштовий індекс призначення, а також вагу кошика в кг. Живий тариф запитується лише після того, як покупець ввів поштовий індекс. Ціна в іншій валюті конвертується за Exchange rate або відхиляється, якщо курс не задано.

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

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

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

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

Коли увімкнено Pickup point selection, під опцією Balikobot під час оформлення замовлення з'являється список пунктів видачі — як при класичному оформленні, так і в блочному. Список завантажується з «branchlocator» Balikobot для країни, міста та поштового індексу покупця. Доки не введено місто та поштовий індекс, покупець бачить Enter your city and postcode to see the pickup points. Список кешується на 12 годин.

Вибір обов'язковий: покупець бачить Please select a pickup point. Сервер також перевіряє, що обраний пункт належить до адреси доставки. Після зміни адреси покупцеві пропонують обрати пункт видачі знову. Якщо пункти не вдалося завантажити, покупцеві пропонують повторити спробу пізніше або обрати інший спосіб доставки.

Обраний пункт видачі зберігається в замовленні. На екрані замовлення в адмінці він відображається під адресою доставки як Balikobot pickup point з ID відділення Balikobot та перевізником — вони потрібні під час створення відправлення в Balikobot. Натисніть Change, щоб обрати інший пункт поблизу адреси замовлення. Покупець бачить пункт як Pickup point на сторінці замовлення та в листах про замовлення (HTML і текстова версія). Існуючі замовлення зберігають дані свого пункту видачі.

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

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

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

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

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

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

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

Живі тарифи не з'являються: увімкніть Debug log, перезавантажте сторінку оформлення замовлення та відкрийте WooCommerce > Status > Logs (джерело «vfd-balikobot»). Там вказано причину: відсутні облікові дані API, ще не введено поштовий індекс, помилка Balikobot для перевізника та послуги або ціна в іншій валюті без Exchange rate. З Live Balikobot rate, fixed price if the API fails покупці все одно отримають фіксовану ціну, поки ви усуваєте проблему.

Ціни в неправильній валюті: фіксовані ціни вказуються у валюті вашого магазину. Balikobot повертає живі ціни у валюті вашого договору з Balikobot (зазвичай CZK). Якщо вона відрізняється від валюти магазину, задайте Exchange rate.

Чи включено ПДВ? Ціни Balikobot зазвичай без ПДВ. Якщо Tax status встановлено на Taxable, WooCommerce додає податок на доставку.

У списку немає пунктів видачі: перевірте, що вказано користувача та ключ API, що перевізник підтримує «branchlocator» і що покупець ввів місто та поштовий індекс. Перегляньте в журналі помилку Balikobot.

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

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

Видалення

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

Balikobot — торгова марка її власника. Цей плагін не пов'язаний з Balikobot і не схвалений Balikobot.