VibeFox Mercado Envios for WooCommerce — Допомога

Вимоги

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

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

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

Обліковий запис Mercado Pago (лише для актуальних тарифів): актуальні тарифи надходять з калькулятора Mercado Envios вашого облікового запису Mercado Pago в Аргентині, Бразилії або Мексиці. У обліковому записі має бути увімкнено Mercado Envios. Посилки розраховуються від адреси відправлення, вказаної в цьому обліковому записі. Потрібен Access Token для продакшену (він починається з APP_USR-): у панелі розробника Mercado Pago відкрийте свій застосунок і його облікові дані для продакшену. Кнопки входу немає: токен вставляється в налаштування. Якщо ви використовуєте лише ціни за країнами, обліковий запис Mercado Pago не потрібен.

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

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

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

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

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

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

5. Для актуальних тарифів вставте Access Token, оберіть країну Mercado Envios і, якщо валюта магазину не ARS, BRL або MXN, вкажіть курс обміну. За бажанням заповніть Country prices та Fallback cost (вони використовуються без актуальних тарифів).

6. Додайте VibeFox Mercado Envios до зони доставки: WooCommerce > Settings > Shipping > Shipping zones, або увімкніть Ignore shipping zones і оберіть країни.

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

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

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

Попередження у верхній частині сторінки показують проблеми з конфігурацією: відсутній курс обміну, немає токена доступу та ціни, а також остання помилка API Mercado Envios з датою. Щоразу, коли ви зберігаєте налаштування, кеш тарифів очищується.

Загальні

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

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

Tax status: Mercado Envios надає остаточні ціни. None показує їх як є, Taxable додає зверху податок на доставку WooCommerce.

API Mercado Envios (актуальні тарифи) (без токена використовуються лише ціни нижче)

Access token: ваш Access Token для продакшену з Mercado Pago (APP_USR-...). Він надсилається лише до Mercado Pago і ніколи не записується в журнал.

Mercado Envios country: країна вашого облікового запису Mercado Pago: Argentina (ARS) (за замовчуванням), Brazil (BRL) або Mexico (MXN). Актуальні тарифи запитуються лише для адрес призначення в цій країні і вказуються в її валюті.

Exchange rate: потрібен лише тоді, коли валюта магазину відрізняється від валюти Mercado Envios: ціна 1 ARS, BRL або MXN у валюті вашого магазину, наприклад 0.001. Без нього актуальні тарифи не використовуються. Як десятковий роздільник приймаються і крапка, і кома.

Ціни без актуальних тарифів

Ці ціни використовуються, коли немає токена доступу, для напрямків за межами країни Mercado Envios і коли API не повертає тариф.

Country prices: ціни у валюті магазину. Натисніть + Add country, щоб додати рядок, і хрестик, щоб видалити рядок. Оберіть * All other countries для всіх країн без власного рядка. Price — ціна для країни. Колонки XS (до 1 кг), S (1-2 кг), M (2-3 кг), L (3-5 кг) і XL (понад 5 кг) замінюють її для цієї ваги кошика. Порожня колонка або колонка з 0 використовує Price. Значення, які не є числами, показуються після збереження і очищаються. Рядки без жодної ціни видаляються під час збереження.

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

Calculation type: Per order стягує ціну один раз. Per item (each item priced by its own weight x quantity) знаходить у Country prices (або в Fallback cost) ціну за вагою кожного товару і множить її на кількість. Актуальні тарифи Mercado Envios завжди стосуються всієї посилки.

Доступність

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

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

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

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

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

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

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

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

Додатково

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

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

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

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

Для напрямку в країні Mercado Envios з коректним поштовим індексом плагін описує кошик як одну посилку: найбільші ширина та довжина товарів, сума висот усіх товарів і загальна вага в грамах. Кожна сторона та вага піднімаються до мінімальних значень Mercado Envios для країни, тому товари без габаритів або ваги теж отримують тариф. Вартість кошика передається як ціна товару у валюті Mercado Envios. Найдешевший варіант, який повернув Mercado Envios, перераховується у валюту магазину і показується під назвою вашого способу.

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

Ціни без актуальних тарифів використовуються натомість, коли немає токена, напрямок розташований за межами країни Mercado Envios, поштовий індекс відсутній або недійсний, курс обміну не задано, посилка важча за ліміт Mercado Envios для країни (25 кг в Аргентині, 15 кг у Бразилії, 30 кг у Мексиці), або Mercado Envios повертає помилку чи не пропонує жодного варіанта для адреси. Використовується рядок країни (або рядок *), інакше резервна вартість. Якщо ціни немає, спосіб приховується. Покупець ніколи не бачить помилку API.

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

Плагін лише розраховує тарифи. Він не створює відправлень, не друкує етикеток і не відстежує посилки. Створіть відправлення у своєму обліковому записі Mercado Libre або Mercado Pago. Він показує один тариф на спосіб, найдешевший варіант Mercado Envios, а не вибір із усіх варіантів, і не має вибору пункту видачі (агенції).

Замовлення

Коли замовлення оформлено з актуальним тарифом, назва служби та орієнтовний строк доставки в днях зберігаються в рядку доставки замовлення як Mercado Envios service та Estimated delivery. Існуючі замовлення зберігають свої рядки доставки.

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

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

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

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

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

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

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

Актуальні тарифи не з'являються: увімкніть Debug log, перезавантажте оформлення замовлення і відкрийте WooCommerce > Status > Logs, джерело vfd-mercado-envios. Типові причини: немає токена, напрямок за межами країни Mercado Envios, відсутній або недійсний поштовий індекс, не задано Exchange rate, посилка перевищує ліміт ваги або для адреси немає варіанта Mercado Envios.

HTTP 401 або 403 у попередженнях: токен доступу недійсний або прострочений. Скопіюйте Access Token для продакшену знову з панелі розробника Mercado Pago.

Mercado Envios відповів в іншій валюті: країна облікового запису не відповідає Mercado Envios country. Оберіть країну вашого облікового запису Mercado Pago.

У якій валюті ціни: Country prices та Fallback cost вказані у валюті вашого магазину. Актуальні тарифи надходять у валюті облікового запису Mercado Pago і перераховуються за Exchange rate, якщо магазин використовує іншу валюту.

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

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

Видалення

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

Mercado Envios і Mercado Pago є торговельними марками їх відповідних власників. Цей плагін не пов'язаний з Mercado Envios чи Mercado Pago і не схвалений ними.