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

Вимоги

PrestaShop: 8.0–9.x.

PHP: 8.0 або новіша версія. Модуль не встановлюється на старіших версіях PHP.

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

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

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

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

1. У бек-офісі перейдіть до Modules > Module Manager і натисніть Upload a module. Виберіть ZIP-файл модуля.

2. Коли завантаження завершиться, натисніть Configure або пізніше знайдіть VibeFox 99Minutos у списку модулів і натисніть Configure.

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

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

Під час встановлення модуль створює перевізника 99Minutos з текстом терміну доставки Courier delivery. Перевізник призначається всім зонам і всім групам клієнтів. Зони, групи клієнтів, термін доставки, логотип і обмеження розміру можна змінити в Shipping > Carriers. Зони Мексики, Колумбії, Чилі та Перу мають залишатися увімкненими для перевізника. Не встановлюйте там ціни: ціна завжди береться з модуля.

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

Усі налаштування розташовані на сторінці модуля: Modules > Module Manager > VibeFox 99Minutos > Configure. Кожен розділ має власну кнопку Save, яка зберігає всю сторінку. Кожне збереження також очищує кешовані результати перевірки покриття. Після збереження сторінка попереджає, якщо матриця цін порожня, якщо в ній є рядки для країн, які 99minutos не обслуговує, якщо обрано режим перевірки покриття без API-ключа або якщо модуль не знає одиницю ваги магазину (тоді ваги вважаються в кілограмах). Нічого не зберігається, і показується помилка, якщо Method title довший за 64 символи, якщо поле ваги або суми не є числом від 0 і більше, або якщо Min weight (kg) більше за Max weight (kg). Якщо сторінка показує The 99Minutos carrier was not found — reset the module to create it again., див. розділ Усунення несправностей.

Загальні

Enable 99Minutos: вмикає або вимикає перевізника. Це той самий перемикач, що й статус перевізника в Shipping > Carriers.

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

Tax: податкове правило перевізника або No tax. З податковим правилом PrestaShop додає податок до ціни доставки з матриці.

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

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

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

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

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

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

Environment: Sandbox (test) (за замовчуванням) або Production. Sandbox і 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: показувати перевізника лише тоді, коли проміжна сума кошика (після знижок, без податків) становить щонайменше цю суму. Залиште порожнім, щоб показувати завжди.

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

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

Додатково

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

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

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

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

На кроці доставки PrestaShop запитує в модуля ціну 99Minutos. Враховуються лише фізичні товари: віртуальні товари не додають ваги і не входять до проміжної суми кошика. Перевізник пропонується лише тоді, коли країна доставки — Мексика, Колумбія, Чилі або Перу (і вона є у списку Countries, якщо увімкнено Restrict countries). Далі модуль перевіряє обмеження ваги та Minimum subtotal.

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

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

Якщо ви редагуєте перевізника в Shipping > Carriers після того, як у нього з'явилися замовлення, PrestaShop зберігає його як нову версію перевізника. Модуль автоматично слідує за новою версією.

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

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

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

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

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

Без активного ключа перевізники 99Minutos не показуються покупцям під час оформлення замовлення, і тариф не розраховується. Вітрина PrestaShop не знає, що ви увійшли в бек-офіс, тому перевізники приховані й для вас: ви можете налаштувати модуль до купівлі ключа, але не можете перевірити його під час оформлення замовлення. Нагадування з'являється в Modules > Module Manager на вкладці Alerts. Наявні замовлення не змінюються.

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

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

99Minutos не з'являється під час оформлення замовлення: перевірте, що ліцензія активна і Enable 99Minutos увімкнено. Країна доставки має бути Мексика, Колумбія, Чилі або Перу і бути активною в International > Locations. У Shipping > Carriers перевірте, що перевізник охоплює зону країни покупця та його групу. Перевірте, чи є в Price matrix рядок для цієї країни або рядок * Default, а також обмеження ваги, Minimum subtotal і Restrict countries. Товари також можуть бути обмежені певними перевізниками на сторінці товару.

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

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

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

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

Сторінка повідомляє, що перевізника 99Minutos не знайдено: перевізника видалено в Shipping > Carriers. Скиньте модуль у Modules > Module Manager, щоб створити його знову. Те саме стосується повідомлення The settings were saved, but the carrier could not be updated. Reset the module to create it again.

Видалення

Перейдіть до Modules > Module Manager, відкрийте меню поруч із VibeFox 99Minutos і виберіть Uninstall. Ліцензійний ключ і статус ліцензії завжди видаляються. Кеш покриття також завжди видаляється. Якщо увімкнено Remove data on uninstall, перевізника видаляють (замовлення зберігають історію), а налаштування та журнал вилучаються. Якщо вимкнено, перевізника лише вимикають, а всі налаштування зберігаються. Під час повторного встановлення модуля збережений перевізник повертає той статус, який мав до видалення, тож Reset не вмикає вимкнутого перевізника.

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