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

Вимоги

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

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

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

Обліковий запис DrEnvio (лише для актуальних тарифів): актуальні тарифи Estafeta надходять від DrEnvio, партнера Estafeta в Мексиці. Створіть обліковий запис на drenvio.com, увімкніть Estafeta, налаштуйте там адресу відправлення та скопіюйте ключ API з панелі DrEnvio. Це той самий ключ, який використовує офіційний плагін DrEnvio. Якщо ви користуєтеся лише власними цінами, обліковий запис DrEnvio не потрібен.

Товари: для актуальних тарифів товарам потрібна вага.

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

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

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

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

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

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

5. Введіть ключ API DrEnvio і, за бажанням, поштовий індекс відправлення. Якщо валюта вашого магазину не MXN, введіть MXN exchange rate. Задайте ціну для країни MX або резервну вартість, якщо спосіб доставки має залишатися видимим, коли DrEnvio не має тарифу.

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

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

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

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

Угорі сторінки плагін показує попередження: немає ключа API DrEnvio, валюта магазину не MXN без курсу обміну, або немає ціни для країни MX і резервної вартості (тоді спосіб приховується, якщо немає актуального тарифу). Щоразу, коли ви зберігаєте налаштування, кеш тарифів DrEnvio очищується. Числові поля приймають десятковий розділювач — крапку або кому. Значення, яке не є правильним числом, очищується та повідомляється під час збереження.

Загальні

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

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

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

Актуальні тарифи (API DrEnvio)

Пропонується найдешевша послуга Estafeta для адреси. Без ключа використовуються ціни з наступного розділу.

DrEnvio API key: ключ API з вашої панелі DrEnvio.

Origin country: дворядковий код країни адреси відправлення. За замовчуванням: MX. Надсилається лише разом із поштовим індексом відправлення.

Origin postcode: п'ятизначний поштовий індекс адреси відправлення. Залиште порожнім, щоб використовувати адресу відправлення, збережену у вашому обліковому записі DrEnvio. Поштовий індекс, у якому не 5 цифр, очищується під час збереження.

MXN exchange rate: DrEnvio розраховує в мексиканських песо. Потрібен лише якщо валюта вашого магазину не MXN: вартість 1 MXN у валюті вашого магазину, наприклад 0.05. Без нього актуальні тарифи не використовуються.

Ціни без актуального тарифу

Використовуються, коли немає ключа API або DrEnvio не повертає тариф Estafeta (API недоступний, невідомий поштовий індекс, поштовий індекс ще не введено). Ціни вказано у валюті вашого магазину.

Country prices: одна країна призначення в рядку у форматі CC:PRICE, наприклад MX:150. Використовуйте десятковий розділювач — крапку або кому, без роздільника тисяч. Частини в іншому форматі ігноруються та повідомляються під час збереження.

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

Calculation type: Per order стягує ціну один раз. Per item (price x number of items) множить її на кількість товарів, які можна відправити. Це стосується Country prices і Fallback cost. Актуальний тариф DrEnvio завжди є ціною всієї посилки.

Умови

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

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

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

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

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

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

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

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

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

Додатково

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

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

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

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

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

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

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

Плагін лише розраховує тарифи. Він не створює відправлень, не друкує накладні (guías) і не відстежує посилки; створюйте відправлення у своєму обліковому записі DrEnvio або Estafeta. Покупець не може вибрати конкретну послугу Estafeta чи відділення Estafeta, а курси валют не оновлюються автоматично.

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

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

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

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

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

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

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

Актуальні тарифи не з'являються: увімкніть Debug log, перезавантажте сторінку оформлення замовлення та відкрийте WooCommerce > Status > Logs, джерело vfd-estafeta. Там показано причину: немає ключа API, немає курсу обміну для магазину не в MXN, поштовий індекс відсутній або недійсний, ключ API відхилено (HTTP 401 або 403), або немає тарифу Estafeta для маршруту.

Чи включає ціна IVA? Це залежить від вашого облікового запису DrEnvio. Якщо ціни DrEnvio вже включають IVA, встановіть Tax status на None.

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

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

Видалення

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

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