VibeFox Frenet for PrestaShop — Допомога

Вимоги

PrestaShop: 8.0 — 9.x.

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

Обліковий запис Frenet (лише для живих розрахунків): створіть безкоштовний обліковий запис у панелі Frenet (painel.frenet.com.br), увімкніть перевізників, яких використовуєте, і скопіюйте свій API-токен. Якщо ви використовуєте лише фіксовані ціни, обліковий запис Frenet не потрібен.

Товари: заповніть вагу та розміри для точних цін. Товари без них розраховуються як 0,3 кг і 16 × 11 × 2 см (мінімальна коробка Correios).

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

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

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

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

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

4. Вставте API-токен і вкажіть CEP відправлення. Якщо валюта магазину за замовчуванням не BRL, вкажіть курс BRL. За бажанням додайте фіксовані ціни та запасну вартість. Натисніть Save.

Під час встановлення модуль створює перевізника Frenet з текстом строку доставки Delivery by the carriers of your Frenet account. Перевізник призначається всім зонам і всім групам клієнтів. Зони, групи клієнтів, строк доставки, логотип і обмеження розмірів можна змінити в Shipping > Carriers. Не встановлюйте там ціни: ціна завжди береться з модуля.

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

Усі налаштування розміщені на сторінці модуля: Modules > Module Manager > VibeFox Frenet > Configure. Вони застосовуються до всіх зон перевізника. Кожен розділ має власну кнопку Save, яка зберігає всю сторінку. Кожне збереження також очищає кешовані розрахунки Frenet. У полях цін як десятковий роздільник можна використовувати і крапку, і кому; значення, що не є числом, відхиляється з повідомленням "…" must be a number. Також відхиляються від’ємні суми та ваги, курс BRL exchange rate 0 або менше та Minimum weight, більший за Maximum weight. Якщо є помилка, нічого не зберігається.

У верхній частині сторінки модуль показує попередження: немає API-токена (тоді використовуються лише фіксовані ціни, або перевізник не показується, якщо немає й фіксованих цін), немає 8-значного CEP відправлення або валюта за замовчуванням не BRL без курсу обміну. Також модуль попереджає, якщо одиниця ваги чи розмірів вашого магазину не розпізнається; така одиниця вважається кг або см. Встановіть стандартну одиницю (kg, g, lb або oz; cm, mm, m або in) в International > Localization (Local units).

Загальні

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

Method title: назва перевізника, що показується в кошику та під час оформлення замовлення. Default: Frenet. Обов’язкове поле, не більше 64 символів.

Живі розрахунки Frenet

Frenet порівнює перевізників, увімкнених у вашому обліковому записі Frenet, і повертає їхні ціни для кошика. Живі розрахунки запитуються лише для адрес у Бразилії з повним 8-значним CEP. Розділ містить посилання на панель Frenet.

API token: ваш API-токен Frenet з панелі Frenet. Залиште поле порожнім, щоб використовувати лише фіксовані ціни. Після збереження поле залишається порожнім і показує A token is saved — leave empty to keep it. Вводьте нове значення, лише якщо хочете його змінити. Щоб видалити збережений токен, позначте Remove the saved token і збережіть.

Origin CEP: поштовий індекс (CEP), з якого відправляються посилки, наприклад 00000-000. Залиште поле порожнім, щоб використовувати поштовий індекс магазину з Shop Parameters > Contact > Stores, якщо адреса магазину в Бразилії. CEP із меншою кількістю цифр, ніж 8, зберігається так, як введено, і сторінка показує Frenet: the origin CEP must have 8 digits.

Service to offer: Cheapest service (за замовчуванням) або Fastest service. Frenet повертає кілька служб, а перевізник показує одну ціну.

BRL exchange rate: Frenet розраховує в бразильських реалах. Якщо валюта магазину за замовчуванням не BRL, вкажіть, скільки коштує 1 BRL у валюті магазину за замовчуванням, наприклад 0.16. Розрахунок і оголошена сума замовлення перераховуються за цим курсом. Без нього живі розрахунки не використовуються. Якщо валюта за замовчуванням — BRL, поле показує Not needed (shop currency is BRL).

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

Використовуються, коли немає API-токена, для країн, які Frenet не обслуговує, і щоразу, коли Frenet не повертає ціну (API недоступний, CEP не обслуговується).

Price per country: таблиця зі стовпцями Country, Price, XS, S, M, L і XL, ціни вказуються у валюті магазину за замовчуванням без податку. Натисніть Add country, щоб додати рядок, і значок кошика, щоб видалити рядок. Стовпці розмірів залежать від ваги кошика: XS до 1 кг, S до 2 кг, M до 3 кг, L до 5 кг, XL понад 5 кг. Price використовується, коли стовпець розміру порожній. Ціна Price, що дорівнює 0, означає безкоштовну доставку для цієї країни. Використовуйте * Default для всіх інших країн. Рядки без жодної ціни видаляються під час збереження.

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

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

Умови

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

Maximum weight: приховує перевізника, якщо вага кошика більша за це значення, в кг. Default: 30 (також використовується, коли поле порожнє). 0 означає без обмежень. Не може бути меншою за Minimum weight.

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

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

Tax: податкове правило перевізника або No tax. Ціни Frenet — остаточні ціни перевізника. Виберіть No tax, якщо PrestaShop не повинен додавати до них податок.

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

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

Зазвичай перевізник пропонується в зонах, призначених йому в Shipping > Carriers.

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

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

Додатково

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

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

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

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

На етапі доставки PrestaShop запитує в модуля ціну Frenet. Враховуються лише фізичні товари: віртуальні товари не додають ваги і не входять до суми замовлення. До того як клієнт введе адресу, модуль використовує країну, яку магазин визначає для відвідувача. Модуль спочатку перевіряє список країн (якщо ввімкнено Ignore shipping zones), вагу кошика та мінімальну суму замовлення. Якщо застосовується безкоштовна доставка, ціна дорівнює 0 і запит до Frenet не надсилається.

Для адреси в Бразилії з повним 8-значним CEP модуль надсилає у Frenet CEP відправлення та призначення, кожен товар кошика (вага в кг, розміри в см, кількість, артикул і категорії), суму замовлення в BRL і перший код купона кошика. Поки CEP не заповнено повністю, запит не робиться. Frenet повертає служби ваших увімкнених перевізників. Служби з помилкою або без ціни пропускаються. Модуль обирає найдешевшу або найшвидшу службу та перераховує ціну у валюту магазину за замовчуванням. Потім ціна показується у валюті кошика клієнта.

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

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

Модуль лише розраховує тарифи. Він не створює відправлень, не друкує етикеток і не відстежує посилки. Він показує одну службу Frenet на кошик, а не кілька, і не підтримує пункти видачі чи поштомати. Frenet розраховує доставку лише в межах Бразилії; для інших країн використовуйте фіксовані ціни.

Замовлення

Коли замовлення оформлено з перевізником Frenet, модуль зберігає, як була розрахована вартість його доставки. Сторінка замовлення в back office тоді показує блок Frenet з такими рядками:

Carrier: перевізник Frenet і служба, наприклад служба Correios або Jadlog. Показується для живих розрахунків.

Delivery time: строк доставки в робочих днях, який повернув Frenet. Показується для живих розрахунків.

Price source: Live Frenet quote, Fixed price (price per country), Fallback cost або Free shipping.

Ці дані зберігаються під час видалення модуля, зокрема з Remove data on uninstall.

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

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

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

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

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

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

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

Frenet не з’являється під час оформлення замовлення: перевірте, що ліцензія активна і Enable Frenet увімкнено. У Shipping > Carriers перевірте, що перевізник охоплює зону країни клієнта та групу клієнта, або що Ignore shipping zones увімкнено і країна дозволена. Перегляньте попередження у верхній частині сторінки модуля, обмеження ваги та Minimum order amount. Типові причини: клієнт ще не ввів повний 8-значний CEP, і немає фіксованих цін; або Frenet не повернув жодної служби для маршруту, і немає фіксованої ціни. Крім того, товари можуть бути обмежені певними перевізниками на сторінці товару.

Живі розрахунки не з’являються: увімкніть Debug log, перезавантажте оформлення замовлення і перегляньте поле Log на сторінці модуля. Там вказано причину: немає CEP відправлення, немає курсу BRL, CEP клієнта не заповнено повністю, перевищено обмеження ваги або суми, або повідомлення пропущених служб.

У журналі вказано, що API-токен відхилено (HTTP 401 або 403): скопіюйте токен з панелі Frenet знову і вставте його в API token.

У журналі вказано, що Frenet не повернув жодної служби: увімкніть принаймні одного перевізника в панелі Frenet.

Мій магазин продає в євро або доларах: Frenet відповідає в BRL. Введіть BRL exchange rate (скільки коштує 1 BRL у валюті магазину за замовчуванням).

Податок стягується понад ціну Frenet: ціни Frenet — остаточні ціни перевізника. Встановіть Tax на No tax.

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

На сторінці написано, що перевізника Frenet не знайдено: перевізника видалено в Shipping > Carriers. Скиньте модуль у Modules > Module Manager, щоб створити його знову. До того часу під час збереження з’являється The settings were saved, but the carrier could not be updated.

Видалення

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

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