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

Вимоги

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

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

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

Обліковий запис Envioclick (лише для тарифів у реальному часі): обліковий запис Envioclick у Мексиці або Колумбії з доступом до API. Ключ API знаходиться у вашому обліковому записі Envioclick: Mi cuenta (угорі праворуч) > Información del API. Якщо ви використовуєте лише фіксовані ціни, обліковий запис Envioclick не потрібен.

User-Agent (лише Мексика): Envioclick Mexico вимагає значення User-Agent у кожному запиті до API. Запитайте його у служби підтримки Envioclick (soporte.tecnico@envioclick.com).

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

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

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

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

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

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

5. Введіть ключ API, оберіть країну API, введіть User-Agent (Мексика), поштовий індекс або код DANE відправлення та адресу відправлення. Якщо валюта вашого магазину не MXN і не COP, введіть курс конвертації.

6. За бажанням додайте фіксовані ціни за країнами та запасну вартість.

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

Конфігурація

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

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

Коли встановлено ключ API, плагін показує попередження вгорі сторінки, якщо тарифи в реальному часі не можуть працювати: немає курсу конвертації для валюти магазину, відмінної від MXN або COP, немає User-Agent для Мексики, немає поштового індексу чи коду DANE відправлення або немає адреси відправлення для Колумбії. Щоразу, коли ви зберігаєте налаштування, кеш тарифів очищується. Числові поля приймають як крапку, так і кому як десятковий роздільник.

Загальні

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

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

Carrier in the title: показує перевізника та орієнтовний строк доставки поруч із назвою для тарифів у реальному часі, наприклад «Envioclick Shipping (Estafeta Express, 1 day)». Перевізник у будь-якому разі зберігається в замовленні та показується в листах про замовлення. За замовчуванням: увімкнено.

API Envioclick (тарифи в реальному часі)

Необов'язково. Без ключа API використовуються лише фіксовані ціни. Тарифи в реальному часі запитуються лише для напрямків у країні API. Доставка до інших країн використовує фіксовані ціни.

API key: ваш ключ API Envioclick з Mi cuenta > Información del API.

API country: країна вашого облікового запису Envioclick.

User-Agent (Mexico): значення, яке видає служба підтримки Envioclick (soporte.tecnico@envioclick.com). Обов'язкове для Мексики; без нього тарифи в реальному часі для Мексики не запитуються. Для Колумбії необов'язкове.

Carrier choice: Cheapest (за замовчуванням) або Fastest (then cheapest). Envioclick повертає тарифи від кількох перевізників, а покупець отримує один тариф.

Branch pickup rates: також враховувати тарифи «Ocurre», за якими покупець забирає посилку у відділенні перевізника. Якщо вимкнено, використовуються лише тарифи доставки до дверей. Послуги накладеного платежу (COD) ніколи не використовуються. За замовчуванням: вимкнено.

Currency conversion rate: Envioclick розраховує в MXN (Мексика) або COP (Колумбія). Якщо валюта вашого магазину інша, введіть вартість 1 MXN або 1 COP у валюті магазину, наприклад 0.05. Оголошена вартість посилки конвертується так само. Залиште поле порожнім, якщо валюта магазину MXN або COP. Без курсу тарифи в реальному часі в іншій валюті не використовуються.

Відправлення з

Використовується для тарифів у реальному часі. Порожні поля беруться з адреси магазину в WooCommerce > Settings > General, якщо магазин розташований у країні API.

Origin postcode / DANE code: Мексика: 5-значний поштовий індекс. Колумбія: 8-значний код DANE муніципалітету, наприклад 11001000 для міста Богота.

Origin address: вулиця та номер адреси забору. Обов'язкова для Колумбії, необов'язкова для Мексики.

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

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

Price per country: таблиця країн і цін у валюті вашого магазину. Натисніть + Add country, щоб додати рядок, і хрестик, щоб видалити його. Рядок * Default застосовується до всіх країн без власного рядка.

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

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

Умови

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

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

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

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

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

Tax status: Taxable додає податок WooCommerce до вартості доставки, None не додає. Тарифи Envioclick уже включають податки перевізників, тому оберіть None, щоб не стягувати податок із доставки двічі.

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

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

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

Додатково

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

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

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

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

Якщо ключ API встановлено і напрямок знаходиться в країні API, плагін запитує тарифи в Envioclick. У Мексиці запит надсилається, щойно покупець введе 5-значний поштовий індекс. У Колумбії — після того, як розпізнано департамент і муніципалітет (регістр і діакритика не мають значення, «Bogotá D.C.» також працює). Плагін обирає найдешевший або найшвидший тариф доставки до дверей, який не є накладеним платежем, і конвертує його у валюту вашого магазину.

Посилка завжди є однією коробкою: загальна вага в кг, довжина та ширина найбільшого товару, а висота — такою, щоб вмістити загальний обсяг усіх товарів. Товари без розмірів вважаються 10 × 10 × 10 см. Кошик без ваги надсилається як 0,5 кг. Оголошена вартість — проміжна сума кошика.

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

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

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

Замовлення

Коли замовлення оформлено за тарифом Envioclick у реальному часі, перевізник і послуга зберігаються в замовленні. На екрані замовлення в адмінпанелі під адресою доставки відображається Envioclick carrier з орієнтовним строком доставки. На сторінці замовлення покупця та в листах про замовлення (HTML і текст) відображається Shipping carrier. Ідентифікатор тарифу Envioclick для розрахунку зберігається разом із рядком доставки замовлення як прихований параметр; на екрані замовлення він не показується. Створіть накладну у своєму обліковому записі Envioclick.

Замовлення з фіксованою ціною не мають перевізника.

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

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

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

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

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

Вирішення проблем

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

Тарифи в реальному часі не з'являються: прочитайте попередження вгорі сторінки налаштувань, потім увімкніть Debug log, оновіть сторінку оформлення замовлення і відкрийте WooCommerce > Status > Logs, джерело vfd_envioclick. Типові причини: немає курсу конвертації (валюта магазину не MXN і не COP), немає User-Agent (Мексика), немає поштового індексу чи коду DANE відправлення, поштовий індекс покупця (Мексика) або місто (Колумбія) ще не введено, напрямок поза країною API або немає перевізника для маршруту.

Навіщо курс конвертації? Envioclick повертає ціни лише в мексиканських або колумбійських песо. Плагін ніколи не показує суму в песо як суму в іншій валюті.

Колумбія: місто не розпізнається: покупець має обрати департамент і ввести назву муніципалітету. Також працює 8-значний код DANE, введений замість поштового індексу. Розробники можуть передати код DANE через фільтр vfd_evc_dane_code.

Податок на доставку стягується двічі: тарифи Envioclick уже включають податки перевізників. Встановіть Tax status на None.

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

Фільтри для розробників: vfd_evc_quotation_request (тіло запиту), vfd_evc_api_url, vfd_evc_dane_code, vfd_evc_default_dimensions і vfd_evc_package_description.

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

Видалення

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

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