VibeFox Melhor Envio for WooCommerce — Допомога

Вимоги

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

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

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

Обліковий запис Melhor Envio (лише для актуальних розрахунків): для актуальних розрахунків потрібен токен доступу. У вашому обліковому записі Melhor Envio відкрийте сторінку дозволів доступу для токенів (Integrações > Permissões de acesso, melhorenvio.com.br/painel/gerenciar/tokens) і створіть токен з дозволом «shipping-calculate». Для тестів створіть токен у пісочниці Melhor Envio (sandbox.melhorenvio.com.br/painel/gerenciar/tokens). Токени для робочого середовища і пісочниці різні. Токени закінчуються. Кнопки «підключити» немає: токен вставляється в налаштування. Без токена спосіб доставки використовує резервні ціни.

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

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

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

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

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

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

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

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

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

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

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

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

Загальні

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

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

Tax status: Taxable додає податок WooCommerce до вартості доставки, None — не додає.

API Melhor Envio

Access token: токен обраного нижче середовища. Він ніколи не записується в журнал.

Sandbox: використовує пісочницю Melhor Envio (sandbox.melhorenvio.com.br) для тестів. Використовуйте з нею токен пісочниці. За замовчуванням: вимкнено.

Contact e-mail: контактна технічна e-mail адреса, яка передається в Melhor Envio з кожним запитом. Melhor Envio вимагає її від кожної інтеграції.

Origin CEP: CEP (8 цифр), з якого відправляються посилки, наприклад 01310-100. Без коректного CEP відправлення розрахунки не запитуються.

Services: необов'язковий список ID послуг Melhor Envio через кому для розрахунку, наприклад 1 = Correios PAC, 2 = Correios SEDEX, 17 = Correios Mini Envios, 3 = Jadlog .Package, 4 = Jadlog .Com. Залиште порожнім, щоб розраховувати всі послуги вашого облікового запису.

Quotes at checkout: спосіб відображення розрахунків.

Delivery time: показує поряд із назвою оцінку терміну доставки Melhor Envio, наприклад «(3-5 business days)». За замовчуванням: увімкнено.

Declared value: оголошує вартість товару (страхування) в розрахунках. Коли вимкнено, розрахунки виконуються без оголошеної вартості: дешевше, але посилки не застраховані. За замовчуванням: увімкнено.

BRL exchange rate: Melhor Envio розраховує вартість у бразильських реалах. Потрібен лише якщо валюта вашого магазину не BRL: введіть ціну 1 BRL у валюті магазину, наприклад 0.17. Без нього актуальні розрахунки не використовуються. Оголошена вартість переводиться в BRL за тим самим курсом.

Default product weight (kg): використовується для товарів без ваги, як у розрахунках, так і в обмеженнях за вагою. За замовчуванням: 0.3.

Default product size (cm): довжина x ширина x висота для товарів без розмірів. За замовчуванням: 16x11x5.

Fallback prices (у валюті вашого магазину)

Резервні ціни використовуються, коли немає токена, не вказано CEP призначення або API не повертає розрахунок (помилка, тайм-аут, немає покриття).

Fallback price table: ціна за країною та вагою кошика. Натисніть + Add country, щоб додати рядок, і хрестик, щоб видалити його. Оберіть * Any country для всіх країн без власного рядка. Кожен рядок має Price і колонки ваги: XS до 1 кг, S 1-2 кг, M 2-3 кг, L 3-5 кг та XL понад 5 кг. Порожня колонка або колонка з 0 використовує Price. Приймаються як «9.99», так і «9,99». Значення, що не є числами, виводяться після збереження і ігноруються.

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

Fallback calculation: Per order стягує резервну ціну один раз. Per item (each item priced by its own weight x quantity) шукає резервну ціну для ваги кожного товару (вага за замовчуванням, якщо її немає) і множить її на кількість. Це стосується лише резервних цін. Розрахунки Melhor Envio вже включають усі товари.

Availability

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

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

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

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

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

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

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

Advanced

Debug log: записує запити до API та розрахунок тарифів у WooCommerce > Status > Logs (джерело vfd-melhor-envio). Помилки записуються завжди, навіть коли цей параметр вимкнено. Токен і адреси покупців ніколи не записуються.

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

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

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

Для адреси доставки в Бразилії з 8-значним CEP плагін надсилає в Melhor Envio CEP відправлення та призначення, а також кожен товар, що відправляється, з вагою, розмірами, кількістю та оголошеною вартістю, плюс список послуг, якщо ви його задали. Розрахунки переводяться у валюту вашого магазину і сортуються за ціною. Покупець бачить найдешевшу послугу або варіант на кожну послугу, з оцінкою терміну доставки, якщо вона увімкнена. Якщо діє безкоштовна доставка, найдешевша послуга коштує 0.

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

Якщо немає токена, адреса поза Бразилією або ще не має коректного CEP, відсутній курс BRL, або Melhor Envio повертає помилку чи не знаходить послуги для маршруту, використовуються резервні ціни: рядок країни (або рядок *), а якщо його немає, — резервна вартість. Якщо діє безкоштовна доставка, спосіб показується безкоштовно, навіть без ціни. Якщо ціни немає взагалі, спосіб доставки приховується. Покупець ніколи не бачить помилку API.

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

Плагін лише розраховує ціни. Він не купує і не створює етикетки, не додає відправлення до кошика Melhor Envio, не відстежує посилки, не призначає забір і не надсилає дані рахунку-фактури (NF-e). Він не пропонує вибір відділень Jadlog, Azul чи LATAM (пунктів приймання) та додаткових послуг «вручення особисто» і «повідомлення про вручення». Керуйте відправленнями у своїй панелі Melhor Envio. Melhor Envio доставляє лише в межах Бразилії. Для інших країн доступні лише резервні ціни.

Замовлення

Коли замовлення оформлено з актуальним розрахунком, послуга та оцінка терміну доставки зберігаються в рядку доставки замовлення. Вони відображаються на екрані замовлення та в листах про замовлення як Melhor Envio service і Delivery estimate, щоб ви знали, яку послугу замовити в Melhor Envio. Наявні замовлення зберігають свої рядки доставки.

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

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

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

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

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

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

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

Показуються лише резервні ціни: увімкніть Debug log, перезавантажте оформлення замовлення і відкрийте WooCommerce > Status > Logs, джерело vfd-melhor-envio. Типові причини: немає токена, CEP відправлення не з 8 цифр, немає BRL exchange rate для валюти магазину, відмінної від BRL, ще немає CEP призначення або жодна послуга не покриває маршрут.

HTTP 401 або 403 у журналі чи попередженнях: Melhor Envio відхилив токен доступу. Він неправильний, прострочений або відкликаний, або належить до іншого середовища. Створіть новий токен і перевірте, що Sandbox відповідає йому.

Яку ціну бачать покупці: за одного варіанта — найдешевшу послугу, яку повернув Melhor Envio. За варіанта на кожну послугу — кожну послугу, що обслуговує маршрут. Per item стосується лише резервних цін.

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

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

Видалення

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

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