VibeFox bpost Cubee for WooCommerce — Допомога

Вимоги

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

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

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

Обліковий запис bpost Shipping Platform (лише для вибору пункту видачі): плагін шукає пункти видачі через API bpost Shipping Platform. Увійдіть до свого облікового запису bpost Shipping Platform на plugins.bpost.be і створіть ключі в Settings > Key management. Потрібні три значення: Account ID (відкритий ключ), Passphrase (закритий ключ) і App ID (X-APPID). App ID видає bpost для вашої інтеграції; запитайте його в службі підтримки e-commerce bpost (eol@bpost.be). Також потрібен ідентифікатор перевізника за вашим договором (68 = bpost). Без повних ключів спосіб працює як спосіб доставки з фіксованою ціною, але покупцеві не пропонується обрати пункт видачі.

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

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

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

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

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

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

5. Введіть свої ціни та, для вибору пункту видачі, API-ключі bpost (див. Налаштування).

6. Додайте VibeFox bpost Cubee до своєї зони доставки для Бельгії в WooCommerce > Settings > Shipping > Shipping zones або увімкніть Ignore shipping zones і оберіть країни.

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

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

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

Сторінка налаштувань показує попередження, якщо щось непомітно приховує спосіб або вибір пункту: вибір пункту видачі увімкнено, але API-ключі заповнені не повністю, для Бельгії немає ціни або останнє підключення до API bpost не вдалося. Щоразу, коли ви зберігаєте налаштування, очищаються збережений API-токен і кешовані списки пунктів видачі.

Загальні

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

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

Tax status: Taxable додає податок WooCommerce до ваших цін, None означає, що ціни остаточні.

API bpost (пошук пунктів видачі) (потрібно лише для вибору пункту видачі)

Account ID (public key): відкритий ключ вашого облікового запису bpost Shipping Platform з розділу Key management на plugins.bpost.be.

Passphrase (private key): закритий ключ, яким підписується кожен запит (HMAC-SHA256). Він ніколи не надсилається до bpost і не записується в журнал.

App ID (X-APPID): ідентифікатор застосунку, виданий bpost для вашої інтеграції. Він передається в заголовку X-APPID.

Carrier ID: перевізник за вашим договором bpost Shipping Platform, чиї пункти видачі та поштомати відображаються у списку. За замовчуванням: 68 (bpost). Інші перевізники, увімкнені у вашому договорі, мають власні ID.

Вибір пункту видачі

Pickup points: показує на оформленні замовлення вибір пунктів видачі та поштоматів. Увімкнено за замовчуванням. Вибір з'являється лише тоді, коли заповнені всі три API-ключі.

Search field width: ширина поля поштового індексу / міста в CSS, наприклад 100% або 300px. За замовчуванням: 100%.

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

Ціни (у валюті вашого магазину; bpost не повертає ціни доставки через цей API)

Price by: як обирається ціна.

Country prices: один рядок на країну у форматі CC=PRICE, наприклад BE=4.95. Рядок *=PRICE встановлює ціну для всіх інших країн, наприклад *=9.95. Як десятковий роздільник приймаються і крапка, і кома. Некоректні рядки ігноруються та перелічуються в повідомленні про помилку під час збереження. Країнам без ціни (коли немає рядка *) спосіб не пропонується.

Size prices: використовується, коли Price by встановлено на розмір посилки, у форматі S=3.50, M=4.50, L=6.00, XL=8.00. Розмір визначається вагою кошика: S до 2 кг, M до 5 кг, L до 10 кг, XL понад 10 кг.

Calculation: Per order стягує ціну один раз. Per item (price x number of items) множить її на кількість товарів у кошику.

Умови

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

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

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

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

Ваги товарів переводяться з одиниці ваги магазину в кілограми.

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

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

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

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

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

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

Додатково

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

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

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

Коли покупець вводить адресу доставки, WooCommerce запитує в плагіна тариф. Плагін перевіряє умови: країна доставки, вага кошика, мінімальна сума замовлення та виключені класи доставки. Потім він бере ціну зі списку країн або за розміром посилки, множить її на кількість товарів у режимі Per item і обнуляє, якщо застосовується безкоштовна доставка.

Коли покупець обирає тариф bpost, під ним з'являються поле пошуку, кнопка Search і список пунктів видачі. Якщо поле пошуку порожнє, автоматично шукається поштовий індекс з адреси оформлення замовлення. Покупець може ввести інший поштовий індекс або назву міста. Кожен пункт показується з назвою та адресою. Виводиться до 50 пунктів. Список пунктів видачі запитується голландською мовою на голландськомовних сайтах і французькою в решті випадків.

Покупець має обрати пункт видачі. Без вибору класичне оформлення замовлення показує Please select a bpost pickup point., а блокове оформлення відмовляється приймати замовлення з тим самим повідомленням. Вибір зберігається протягом сеансу оформлення, тож оновлення сторінки його не скидає.

Щоб отримати список пунктів видачі, плагін надсилає до bpost лише шуканий поштовий індекс або місто, країну та ідентифікатор перевізника, підписані вашими ключами. Ім'я, адреса електронної пошти та рядок адреси покупця не надсилаються. API-токен запитується й оновлюється автоматично. Якщо bpost відхиляє токен, новий запитується один раз і пошук повторюється. Результати пошуку кешуються на 6 годин. Якщо bpost не відповідає, покупець бачить Pickup points cannot be loaded right now. Please try again in a few minutes or choose another shipping method., а плагін повторює спробу через 5 хвилин. Тайм-аут API — 15 секунд.

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

Плагін використовує лише фіксовані ціни. Він не отримує актуальні тарифи від bpost, не створює відправлення, не друкує етикетки та не відстежує посилки. Пункти видачі показуються списком, а не на карті. Створюйте відправлення у своєму обліковому записі bpost Shipping Platform або Shipping Manager; ідентифікатор пункту видачі міститься в замовленні.

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

Обраний пункт видачі (назва та адреса) і його ID зберігаються в замовленні. На екрані замовлення в адмінпанелі він показується під адресою доставки як bpost pickup point. Натисніть Change, знайдіть поштовий індекс або місто та оберіть інший пункт зі списку. Замовлення оновлюється одразу, і додається примітка до замовлення bpost pickup point changed to: …. Посилання Change доступне лише тоді, коли API-ключі заповнені.

Покупці бачать пункт видачі на сторінці подяки та в My account > Orders. Його також додають до листів про замовлення — як у HTML, так і у вигляді простого тексту.

Щоб пропонувати поштомат і доставку додому разом, додайте до тієї самої зони ще один спосіб доставки, наприклад Flat rate. Вибір пункту видачі з'являється лише під тарифом bpost.

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

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

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

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

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

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

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

Немає вибору пункту видачі на оформленні замовлення: перевірте, що Pickup points увімкнено і що Account ID (public key), Passphrase (private key) та App ID (X-APPID) заповнені. Сторінка налаштувань показує попередження, коли ключі заповнені не повністю.

Покупці бачать «Pickup points cannot be loaded right now»: bpost не відповів або відхилив ключі. Причина вказана в WooCommerce > Status > Logs (джерело vfd-bpost-cubee) і на сторінці налаштувань. Плагін автоматично повторює спробу через 5 хвилин. Збереження налаштувань повторює спробу одразу.

Для цього поштового індексу або міста пункти видачі не знайдено: bpost не повернув пунктів за цим пошуком. Попросіть покупця вказати сусідній поштовий індекс або назву міста та перевірте Carrier ID.

Ціни з комою не використовуються: приймаються і 5,50, і 5.50. Рядки в Country prices, що не відповідають формату CC=PRICE, ігноруються; повідомлення про помилку після збереження їх перелічує.

Ціни включають податок? Якщо Tax status встановлено на Taxable, WooCommerce додає податок до ваших цін. При None ціни остаточні.

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

Видалення

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

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