VibeFox 99Minutos for WooCommerce — Допомога

Вимоги

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

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

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

API-ключ 99minutos (лише для перевірки покриття): отримайте його у свого менеджера облікового запису 99minutos або на порталі розробників 99minutos (developers.99minutos.com). Ключі sandbox і production різні. Якщо ви використовуєте лише матрицю цін, API-ключ не потрібен.

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

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

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

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

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

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

5. Заповніть Price matrix (принаймні один рядок, наприклад «* Default»), а за бажанням API-ключ та режим перевірки покриття (див. розділ «Налаштування»).

6. Додайте VibeFox 99Minutos до зони доставки в WooCommerce > Settings > Shipping > Shipping zones, яка охоплює Мексику, Колумбію, Чилі або Перу.

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

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

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

Під час збереження налаштувань сторінка попереджає, якщо матриця цін порожня або обрано режим перевірки покриття без API-ключа.

Загальні

Enable/Disable: вмикає 99Minutos одразу у всіх зонах доставки. Спосіб також потрібно додати до зони доставки, яка охоплює Мексику, Колумбію, Чилі або Перу. За замовчуванням: увімкнено.

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

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

API 99minutos (перевірка покриття) (необов'язково)

API використовується лише для перевірки, чи доставляє 99minutos за поштовим індексом покупця. Ціна завжди береться з матриці.

Coverage check: чи перевіряється поштовий індекс і яким способом.

Off — matrix price for every postcode: запитів до API немає. За замовчуванням.

Strict — show only if the API confirms coverage: спосіб показується лише тоді, коли API 99minutos підтверджує покриття поштового індексу. Якщо API недоступний або API-ключ не задано, спосіб приховується.

Soft — hide if not covered; if the API is unavailable, still show the matrix price: спосіб приховується лише тоді, коли API повідомляє, що поштовий індекс не покривається. За помилок API або без API-ключа використовується ціна з матриці.

За увімкненої перевірки покриття спосіб доставки з'являється лише після того, як покупець введе поштовий індекс. Результати кешуються: покрито — 6 годин, не покрито — 30 хвилин, помилка API — 5 хвилин. До 99minutos надсилається лише поштовий індекс.

API key: ваш API-ключ 99minutos, що надсилається як Bearer-токен на endpoint перевірки покриття 99minutos. Обов'язковий, коли перевірка покриття увімкнена. Поле приховано маскою.

Environment: Sandbox (test) (за замовчуванням) або Production. Sandbox і production використовують різні API-ключі, тож оберіть середовище, що відповідає вашому ключу.

Тарифи

Ціни вказуються у валюті магазину і використовуються так, як введені, без конвертації.

Price matrix: таблиця країн призначення та цін. Натисніть + Add country, щоб додати рядок, і хрестик, щоб його видалити. У кожному рядку є Country, Base price та ціни для розмірів XS (до 1 кг), S (до 2 кг), M (до 3 кг), L (до 5 кг) і XL (понад 5 кг). Порожня або нульова ціна розміру замінюється на Base price. Рядок * Default застосовується до країн без власного рядка. Як десятковий роздільник приймаються і крапка, і кома; від'ємні ціни зберігаються як 0. Доки в матриці немає принаймні одного рядка, спосіб доставки під час оформлення замовлення не показується.

Calculation: Per order — size by the total cart weight (за замовчуванням) стягує одну ціну за розмір посилки всього кошика. Per item — each unit priced by its own weight оцінює кожну одиницю за розміром її власної ваги і підсумовує результати.

Free shipping: вмикає безкоштовну доставку від проміжної суми кошика.

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

Обмеження

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

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

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

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

Restrict countries: пропонує спосіб лише для країн, наведених нижче. Це додатковий фільтр понад зони доставки: спосіб однаково потрібно додати до зони. Корисно, коли одна зона охоплює кілька країн.

Countries: вибір країн 99minutos (Мексика, Колумбія, Чилі, Перу). Використовується лише якщо увімкнено Restrict countries. Залиште порожнім, щоб дозволити всі країни 99minutos.

Додатково

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

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

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

Спосіб пропонується, лише якщо країна доставки — Мексика, Колумбія, Чилі або Перу (і вона є у списку Countries, якщо увімкнено Restrict countries). Коли покупець вводить адресу доставки, плагін перевіряє обмеження ваги кошика, Minimum subtotal і Excluded shipping classes.

Якщо режим перевірки покриття увімкнено, плагін потім запитує в API 99minutos, чи покривається поштовий індекс. Тайм-аут запиту становить 10 секунд, а відповідь кешується, тож для того самого індексу новий запит не надсилається. Помилки API ніколи не показуються покупцеві: у режимі Strict спосіб приховується, у режимі Soft використовується ціна з матриці. Безкоштовна доставка не обходить перевірку покриття.

Ціна береться з рядка матриці для країни доставки або з рядка * Default. Якщо немає жодного з них, спосіб приховується. Якщо увімкнено Free shipping і проміжна сума кошика досягає Free shipping from, тариф дорівнює 0.

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

Плагін не отримує від 99minutos актуальні тарифи в реальному часі: ціни завжди береться з вашої матриці. Він не створює відправлень і замовлень у 99minutos, не друкує етикетки (guides), не відстежує посилки, не пропонує пункти видачі Punto99 і не приймає оплату при отриманні. Створюйте відправлення у своєму обліковому записі 99minutos, як звичайно.

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

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

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

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

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

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

99Minutos не з'являється під час оформлення замовлення: перевірте, чи ліцензія активна, чи увімкнено Enable/Disable і чи додано спосіб до зони, якій належить адреса покупця. Країна доставки має бути Мексика, Колумбія, Чилі або Перу. Переконайтеся, що в Price matrix є рядок для цієї країни або рядок * Default, а також перевірте обмеження ваги, Minimum subtotal, Excluded shipping classes і Restrict countries.

Спосіб з'являється лише після введення поштового індексу: це очікувана поведінка за перевірки покриття. У режимі Strict він з'являється, лише якщо API підтверджує покриття.

Спосіб завжди приховано в режимі Strict: увімкніть Debug log, перезавантажте оформлення замовлення та відкрийте WooCommerce > Status > Logs (джерело «vfd-99minutos»). Помилка HTTP 401 або 403 означає, що API-ключ відхилено: перевірте ключ і відповідність Environment (ключі sandbox і production різні). Використовуйте режим Soft, якщо покупці мають отримувати ціну з матриці, коли API недоступний.

Ціна не така, як ви очікували: перевірте Calculation (за замовлення або за товар), ваги товарів і одиницю виміру ваги у вашому магазині. Порожня або нульова ціна розміру замінюється на Base price.

Інші країни: розробники можуть змінити список підтримуваних країн за допомогою фільтра vfd_99m_supported_countries.

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

Видалення

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

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