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

Вимоги

OpenCart: 3.0.x (перевірено на 3.0.5.0) або 4.0.2 і новіші (перевірено на 4.1.0.3).

PHP: 8.0 або новіша.

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

Країни: 99minutos доставляє до Мексики, Колумбії, Чилі та Перу. Країни, до яких ви відправляєте, мають бути увімкнені в System > Localisation > Countries.

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

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

Архів для завантаження — це один zip-файл із пакетами для обох версій OpenCart. Розпакуйте його на своєму комп’ютері. Він містить README.txt, пакет для OpenCart 3 vfd_99minutos-oc3-(version).ocmod.zip і пакет для OpenCart 4 vfd_99minutos.ocmod.zip. Встановлюйте лише пакет для вашої версії OpenCart. Ліцензійний ключ однаковий для обох версій.

OpenCart 3

1. В адмінпанелі перейдіть до Extensions > Installer, натисніть Upload і виберіть файл vfd_99minutos-oc3-(version).ocmod.zip. Розширення не додає модифікацій OCMOD, тож оновлювати Extensions > Modifications не потрібно. Замість Installer можна скопіювати вміст папки upload цього пакета в кореневу папку вашого магазину.

2. Перейдіть до Extensions > Extensions і оберіть тип розширень Shipping. Знайдіть VibeFox 99Minutos і натисніть Install (зелена кнопка +).

3. Натисніть Edit (кнопка з олівцем), щоб відкрити сторінку налаштувань.

4. Введіть ваш ліцензійний ключ VibeFox у полі License key блоку ліцензії у верхній частині сторінки Edit і натисніть Activate (див. Ліцензійний ключ).

5. Заповніть Price matrix (принаймні один рядок, наприклад "* Default") і за бажанням ключ API та режим перевірки обслуговування (див. Конфігурація). Увімкніть Enable 99Minutos і натисніть Save.

OpenCart 4

1. В адмінпанелі перейдіть до Extensions > Installer, натисніть Upload і виберіть файл vfd_99minutos.ocmod.zip. Не перейменовуйте файл: OpenCart 4 бере код розширення з назви файлу, тому перейменований пакет не працює.

2. Пакет з’являється у списку встановлених розширень на тій самій сторінці. Натисніть Install (зелена кнопка +) поруч із ним.

3. Перейдіть до Extensions > Extensions і оберіть тип розширень Shipping. Знайдіть VibeFox 99Minutos, натисніть Install (зелена кнопка +), а потім Edit (кнопка з олівцем).

4. Введіть ліцензійний ключ і налаштування так само, як у кроках 4 і 5 для OpenCart 3. Сторінка налаштувань і її поля однакові в обох версіях.

Після встановлення спосіб доставки вимкнено, доки ви не увімкнете Enable 99Minutos і не збережете налаштування. Якщо ви встановите розширення знову після видалення, збережені налаштування 99minutos знову використовуватимуться.

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

Усі налаштування розміщені на сторінці розширення: Extensions > Extensions > Shipping > VibeFox 99Minutos > Edit. Розділи перелічено ліворуч. Одна кнопка Save зберігає всю сторінку без перезавантаження. Кожне збереження також очищає кешовані результати перевірки обслуговування. Якщо значення неправильне, нічого не зберігається, а сторінка показує причину, наприклад Enter a method title (1 to 64 characters)., повідомлення про те, що поле має бути числом не менше 0, або що Min weight (kg) не може бути більшим за Max weight (kg). Після збереження попередження над налаштуваннями повідомляють, коли спосіб доставки не може працювати з поточною конфігурацією: матриця цін порожня, обрано режим перевірки обслуговування без ключа API, матриця містить рядки для країн, які 99minutos не обслуговує, або в магазині немає класу ваги "kg", а одиниця ваги не розпізнається розширенням (тоді ваги вважаються кілограмами). Зберігати налаштування можуть лише адміністратори з правом змінювати це розширення.

Загальні

Налаштування діють для всіх географічних зон. 99Minutos пропонується лише для Мексики, Колумбії, Чилі та Перу як країн призначення.

Enable 99Minutos: показує або приховує 99Minutos на оформленні замовлення. За замовчуванням: вимкнено.

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

Tax class: податковий клас вартості доставки або No tax (за замовчуванням). З податковим класом OpenCart додає податок до ціни з матриці.

Sort order: позиція 99Minutos серед способів доставки під час оформлення замовлення. Ціле число.

API 99minutos (перевірка обслуговування) (необов'язково)

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

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

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

API key: ваш ключ API 99minutos, який надсилається як токен Bearer на адресу перевірки обслуговування 99minutos. Обов'язковий, коли перевірка обслуговування увімкнена. Після збереження поле залишається порожнім і показує Saved — leave empty to keep it. Вводьте нове значення, лише якщо хочете його змінити. Ключ зберігається так, як введено; видаляються лише пробіли по краях.

Remove the saved API key: показується лише тоді, коли ключ збережено. Увімкніть і натисніть Save, щоб видалити ключ.

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

Тарифи

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

Price matrix: таблиця країн призначення та цін. Натисніть Add country, щоб додати рядок, і кнопку × , щоб його видалити. Кожен рядок має Country (* Default, Мексика, Колумбія, Чилі або Перу), 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). Ваги товарів переводяться з їхнього класу ваги.

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

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

Geo zone: пропонує 99Minutos лише для адрес у цій географічній зоні. All zones (за замовчуванням) означає без обмеження. Географічні зони керуються в System > Localisation > Geo Zones.

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

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

Додатково

Debug log: записує розрахунки тарифів до storage/logs/vfd_99m_debug.log.php. Файл недоступний для читання з веб. Помилки API записуються, навіть коли опцію вимкнено. Ключі API, імена та адреси покупців ніколи не записуються в журнал. Вимкніть журнал, коли закінчите. Коли файл досягає 5 МБ, його переміщують до vfd_99m_debug.old.log.php, і починається новий журнал.

Log: показує розмір і останні записи журналу налагодження. Натисніть Clear log, щоб його очистити.

Remove data on uninstall: якщо увімкнено, під час видалення розширення видаляються налаштування 99minutos, кеш перевірки обслуговування та журнал. Якщо вимкнено (за замовчуванням), вони зберігаються для повторного встановлення. Замовлення в будь-якому разі зберігаються.

Імпорт / Експорт

Export: натисніть Download JSON, щоб зберегти налаштування у файл JSON. Ключ API не експортується.

Import: вставте раніше експортований JSON і натисніть Import, щоб відновити налаштування, наприклад в іншому магазині. Значення перевіряються так само, як під час звичайного збереження. Збережений ключ API зберігається.

Робота під час оформлення замовлення

Коли OpenCart показує способи доставки, він запитує в розширення ціну 99Minutos. Якщо задано Geo zone, а адреса за її межами, 99Minutos не пропонується. Враховуються лише товари з Requires Shipping, встановленим на Yes: інші не додають ваги і не входять до суми замовлення. Спосіб доставки пропонується лише тоді, коли країна доставки — Мексика, Колумбія, Чилі або Перу (і вона є в списку Countries, якщо увімкнено Restrict countries). Далі розширення перевіряє обмеження ваги та Minimum subtotal. Сума замовлення — це ціна товарів, які потрібно доставити, після знижки за купоном і без податку. Подарункові сертифікати, бонусні бали та store credit не враховуються.

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

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

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

На OpenCart 4 покупець натискає Choose у блоці способу доставки на сторінці оформлення і обирає 99Minutos у вікні Shipping method options. Спосіб доставки працює так само, як на OpenCart 3.

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

Розширення працює з ліцензійним ключем VibeFox з vibefox.net. Блок ліцензії License — VibeFox 99Minutos є першим блоком на сторінці Extensions > Extensions > Shipping > VibeFox 99Minutos > Edit, над налаштуваннями. Введіть ключ у полі License key і натисніть Activate. Після цього блок показує ключ у прихованому вигляді, статус (наприклад, дату, до якої діє ліцензія, і ваш домен) та кнопки Check now, щоб знову перевірити статус, Change key, щоб ввести інший ключ, і Remove key, щоб видалити ключ із цього магазину. Нижче є рядок Product: opencart-shipping-99minutos і посилання Manage licenses and domains in your account, яке відкриває ваш обліковий запис vibefox.net. Змінювати ключ можуть лише адміністратори з правом Modify для цього розширення. Тексти блоку відповідають мові адмінпанелі (включено англійську та російську).

Якщо ключ не прийнято, блок повідомляє причину, наприклад Key not found, This key belongs to another product, Domain limit reached або License expired on і дату. Після зміни адреси магазину або після звільнення слота домену у вашому обліковому записі натисніть Check now. Якщо сервер ліцензій недоступний, розширення продовжує працювати за останнім відомим статусом.

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

Без активного ключа спосіб доставки 99Minutos не показується покупцям під час оформлення замовлення і тариф не розраховується. Адміністратор, який увійшов в адмінпанель в тому самому браузері, усе ще бачить спосіб доставки в магазині з позначкою (unlicensed — visible to admins only), тож ви можете налаштувати й перевірити розширення до купівлі ключа. На OpenCart 4 цей попередній перегляд недоступний: магазин не бачить входу адміністратора, тож без активного ключа спосіб доставки приховано для всіх. Після того як ви один раз відкрили сторінку Edit, на сторінці Dashboard адмінпанелі з’являється нагадування. Закрийте його кнопкою ×, щоб приховати на 7 днів. Наявні замовлення не змінюються.

Коли ліцензія спливає, розширення продовжує працювати, але для оновлень і підтримки потрібне продовження. Статус перевіряється знову автоматично, коли ви відкриваєте Dashboard або сторінку Edit в адмінпанелі: раз на добу протягом перших 14 днів після введення ключа, далі раз на тиждень. Cron-завдання не потрібне. Видалення розширення завжди видаляє ліцензійний ключ і статус ліцензії.

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

99Minutos не з'являється під час оформлення замовлення: перевірте, що ліцензія активна і Enable 99Minutos увімкнено. Країна доставки має бути Мексика, Колумбія, Чилі або Перу і бути увімкнена в System > Localisation > Countries. Перевірте Geo zone і Restrict countries. Перевірте, чи є в Price matrix рядок для цієї країни або рядок * Default, а також обмеження ваги та Minimum subtotal. Перевірте, що у товарів Requires Shipping встановлено на Yes. Попередження, що з'являються після Save, вказують на налаштування, які приховують спосіб доставки.

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

У режимі Strict спосіб доставки завжди прихований: увімкніть Debug log, перезавантажте оформлення замовлення та перегляньте поле Log на сторінці розширення. Помилка HTTP 401 або 403 означає, що API відхилив ключ: перевірте ключ і те, що Environment відповідає йому (тестові та робочі ключі різні). Використовуйте режим Soft, якщо покупці мають отримувати ціну з матриці, поки API недоступний.

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

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

Сторінка пише «Warning: You do not have permission to modify VibeFox 99Minutos!»: можливо, ваша група адміністраторів може лише переглядати налаштування. Надайте групі право змінювати extension/shipping/vfd_99minutos (OpenCart 3) або extension/vfd_99minutos/shipping/vfd_99minutos (OpenCart 4) у System > Users > User Groups.

Для розробників: адресу API 99minutos можна замінити налаштуванням vfd_99m_api_url (для тестів); на сторінці налаштувань для нього немає поля.

Видалення

Перейдіть до Extensions > Extensions, оберіть тип Shipping і натисніть Uninstall (червона кнопка −) поруч із VibeFox 99Minutos. Ліцензійний ключ і статус ліцензії цього розширення завжди видаляються. OpenCart завжди скидає Enable 99Minutos, Sort order, Tax class і Geo zone. Кешовані результати перевірки обслуговування завжди видаляються. Якщо Remove data on uninstall увімкнено, також видаляються налаштування 99minutos і журнал налагодження. Якщо вимкнено, решта налаштувань зберігається і знову використовується під час повторного встановлення розширення. Наявні замовлення зберігають свій спосіб доставки та вартість.

На OpenCart 4, щоб видалити також файли розширення, після видалення перейдіть до Extensions > Installer і натисніть Uninstall (помаранчева кнопка −) поруч із VibeFox 99Minutos у списку встановлених розширень, а потім Delete (червона кнопка з кошиком), щоб видалити завантажений пакет.

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