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

Вимоги

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

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

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

Обліковий запис Frenet (лише для живих розрахунків): створіть безкоштовний обліковий запис у панелі Frenet (painel.frenet.com.br), увімкніть перевізників, яких використовуєте, і скопіюйте свій API-токен. Якщо ви користуєтеся лише фіксованими цінами, обліковий запис Frenet не потрібен.

Товари: заповніть вагу та розміри для точних цін. Для товарів без них розрахунок ведеться як для 0,3 кг і 16 × 11 × 2 см (мінімальна коробка Correios).

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

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

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

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

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

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

5. Вставте API-токен і вкажіть поштовий індекс відправлення (CEP). Якщо валюта магазину не BRL, вкажіть курс BRL. За бажанням додайте фіксовані ціни та запасну вартість.

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

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

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

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

Угорі сторінки плагін показує попередження: немає API-токена (тоді використовуються лише фіксовані ціни, або метод ніколи не показується, якщо фіксованих цін також немає), немає 8-значного CEP відправлення або валюта магазину не BRL без курсу обміну. Під час кожного збереження налаштувань кешовані розрахунки очищаються. У полях цін допускаються і крапка, і кома як десятковий роздільник.

Загальні

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

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

Живі розрахунки Frenet

Frenet порівнює перевізників, увімкнених у вашому обліковому записі Frenet, і повертає їхні ціни для кошика. Живі розрахунки запитуються лише для адрес у Бразилії з повним 8-значним CEP.

API token: ваш API-токен Frenet з панелі Frenet. Залиште поле порожнім, щоб використовувати лише фіксовані ціни.

Origin CEP: поштовий індекс (CEP), з якого відправляються посилки, наприклад 00000-000. Залиште поле порожнім, щоб використовувати поштовий індекс магазину, якщо адреса магазину в Бразилії. CEP не з 8 цифр повідомляється під час збереження.

Service to offer: Cheapest service (за замовчуванням) або Fastest service. Frenet повертає кілька служб, а метод показує одну ціну.

BRL exchange rate: Frenet розраховує в бразильських реалах. Якщо валюта вашого магазину не BRL, вкажіть, скільки 1 BRL становить у валюті магазину, наприклад 0.16. За цим курсом переводяться розрахунок і оголошена сума замовлення. Без курсу живі розрахунки не використовуються. Не потрібно, якщо валюта магазину — BRL.

Фіксовані ціни

Використовуються за відсутності API-токена, для країн, які Frenet не обслуговує, та щоразу, коли Frenet не повертає ціну (API недоступний, CEP не обслуговується).

Price per country: таблиця з колонками Country, Price, XS, S, M, L та XL, ціни у валюті магазину. Натисніть + Add country, щоб додати рядок, і хрестик (×), щоб видалити його. Колонки розмірів залежать від ваги кошика: XS — до 1 кг, S — до 2 кг, M — до 3 кг, L — до 5 кг, XL — понад 5 кг. Price використовується, коли колонка розміру порожня. Ціна Price, що дорівнює 0, означає безкоштовну доставку для цієї країни. Використовуйте * Default для всіх інших країн. Рядки без жодної ціни видаляються під час збереження.

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

Fixed price applies: Per order стягує ціну один раз. Per item (price × quantity) множить її на кількість товарів. Це стосується лише фіксованих цін і запасної вартості. Розрахунки Frenet уже охоплюють увесь кошик.

Умови

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

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

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

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

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

Tax status: Taxable додає податок WooCommerce до вартості доставки, None — ні. Ціни Frenet є остаточними цінами перевізника; оберіть None, якщо WooCommerce не повинен нараховувати на них податок.

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

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

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

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

Додатково

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

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

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

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

Для адреси в Бразилії з повним 8-значним CEP плагін надсилає в Frenet CEP відправлення та призначення, кожен товар кошика (вага в кг, розміри в см, кількість, SKU та категорії), суму замовлення в BRL і перший застосований купон. Доки CEP не заповнено повністю, запит не надсилається. Frenet повертає служби ваших увімкнених перевізників. Служби з помилкою або без ціни пропускаються. Плагін обирає найдешевшу або найшвидшу службу та переводить ціну у валюту вашого магазину. Перевізник, служба та строк доставки зберігаються разом з рядком доставки замовлення й відображаються на екрані замовлення в адмінпанелі.

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

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

Плагін лише розраховує тарифи. Він не створює відправлень, не друкує етикетки та не відстежує посилки — це робить Frenet у своїй панелі. Він показує одну службу Frenet на кошик, а не кілька, і не підтримує пункти видачі чи поштомати. Frenet розраховує доставку лише в межах Бразилії; для інших країн використовуйте фіксовані ціни.

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

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

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

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

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

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

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

Живі розрахунки не з'являються: увімкніть Debug log, перезавантажте оформлення замовлення та відкрийте WooCommerce > Status > Logs, джерело vfd-frenet. Там буде причина: токен відхилено (HTTP 401 або 403), немає CEP відправлення, немає курсу BRL, у панелі Frenet не увімкнено жодного перевізника, або повідомлення про пропущені служби.

Мій магазин продає в євро або доларах: Frenet відповідає в BRL. Введіть BRL exchange rate (скільки 1 BRL становить у валюті вашого магазину).

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

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

Видалення

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

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