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

Вимоги

PrestaShop: 8.0–9.x.

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

Обліковий запис Loggi (лише для цін у реальному часі): ціна в реальному часі використовує GraphQL API Loggi з ключем API, який Loggi видає для бізнес-облікових записів. Зверніться до свого менеджера Loggi або до служби підтримки інтеграцій Loggi (integracoes@loggi.com), див. також документацію API Loggi на docs.api.loggi.com. Потрібні три значення: e-mail вашого облікового запису Loggi, ключ API і числовий ID вашого магазину. Якщо у вашому обліковому записі Loggi є лише облікові дані для нової REST-платформи API Loggi (client ID та secret), ціна в реальному часі недоступна і використовуються фіксовані ціни. Якщо ви користуєтеся лише фіксованими цінами, обліковий запис Loggi не потрібен.

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

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

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

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

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

4. Введіть e-mail API Loggi, ключ API, Shop ID і адресу забору, а якщо основна валюта вашого магазину не BRL — курс BRL. Додайте фіксовані ціни як страховку (див. Налаштування) і натисніть Save.

5. Додайте Бразилію до зон перевізника Loggi у Shipping > Carriers або увімкніть Ignore shipping zones і виберіть країни.

Під час встановлення модуль створює перевізника Loggi з текстом терміну доставки Courier delivery in Brazil. Перевізник призначається всім зонам і всім групам клієнтів. Зони, групи клієнтів, термін доставки, логотип і обмеження розміру можна змінити в Shipping > Carriers. Ціни там не задавайте: ціна завжди береться з модуля.

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

Усі налаштування розташовані на сторінці модуля: Modules > Module Manager > VibeFox Loggi > Configure. Вони застосовуються до всіх зон перевізника. Кожен розділ має власну кнопку Save, яка зберігає всю сторінку. Кожне збереження також очищає кеш цін Loggi.

Попередження вгорі сторінки показують неповне налаштування: немає облікових даних API (використовуються лише фіксовані ціни), немає облікових даних API і фіксованих цін (перевізник ніколи не показується), немає адреси забору, немає курсу BRL, або одиниця ваги чи габаритів магазину не розпізнається модулем (тоді вона рахується як кг або см; задайте одиниці в International > Localization). Якщо значення некоректне, наприклад від'ємне число, сторінка показує помилку і нічого не зберігається.

Загальні

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

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

API Loggi (актуальна ціна) (залиште облікові дані порожніми, щоб використовувати лише фіксовані ціни)

API e-mail: e-mail вашого облікового запису Loggi. Ключ API належить до нього. Має бути коректна адреса e-mail.

API key: ваш ключ API Loggi. Він передається лише до Loggi і ніколи не записується в журнал. Після збереження поле залишається порожнім і показує Saved — leave empty to keep it; clear the API e-mail to remove it. Вводьте нове значення, лише якщо хочете його змінити. Якщо ви змінюєте API e-mail, введіть також ключ API для нового e-mail, інакше сторінка покаже помилку і нічого не збережеться. Щоб видалити збережений ключ, очистіть API e-mail і збережіть.

Shop ID: числовий ID (pk) вашого магазину в панелі Loggi. Приймається лише додатне число. Інше значення відхиляється з помилкою.

Staging: використовувати тестове середовище Loggi (staging) з тестовими обліковими даними. Staging і робоче середовище мають різні облікові записи та ключі. За замовчуванням: вимкнено.

Pickup address: адреса, за якою Loggi забирає посилки, в одному рядку: вулиця і номер будинку, район, місто, штат і CEP, наприклад Rua Example, 123 - Bairro, São Paulo - SP, 01310-100. Залиште порожнім, щоб використати адресу магазину з Shop Parameters > Contact > Stores, якщо вона в Бразилії і має адресу та місто. Без адреси забору Loggi не може розрахувати ціну, і використовуються лише фіксовані ціни.

BRL exchange rate: ціни Loggi вказані в бразильських реалах. Якщо основна валюта вашого магазину BRL, це поле не потрібне, і сторінка про це повідомляє. Інакше введіть, скільки коштує 1 BRL у валюті вашого магазину, наприклад 0.16. Без нього ціни в реальному часі не використовуються. Приймається лише додатне число. Як десятковий роздільник приймаються і крапка, і кома.

Фіксовані ціни (в основній валюті вашого магазину, без податку)

Фіксовані ціни використовуються, коли API Loggi не налаштовано, для напрямків за межами Бразилії або без повного CEP, а також щоразу, коли Loggi не повертає ціну (API недоступний, ключ відхилено, адреса поза зоною обслуговування).

Price table: один рядок на країну призначення. Натисніть Add country, щоб додати рядок, і значок кошика, щоб його видалити. Виберіть * All other countries для всіх країн без власного рядка. Кожен рядок має Base price і колонки ваги: XS ≤1 kg, S ≤2 kg, M ≤3 kg, L ≤5 kg та XL >5 kg. Порожня (або нульова) колонка ваги використовує базову ціну. Базова ціна 0 означає безкоштовну доставку. Приймаються як «9.99», так і «9,99». Порожні рядки та другий рядок для тієї самої країни видаляються під час збереження.

Price for countries not in the table: використовується, коли немає актуальної ціни Loggi і в таблиці немає рядка для країни призначення (і немає рядка *). Залиште порожнім, щоб у такому разі приховати перевізника.

Fixed price applies: спосіб розрахунку фіксованих цін. Актуальна ціна Loggi вже покриває весь кошик і ніколи не множиться.

Умови

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

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

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

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

Tax: податкове правило перевізника або No tax. Виберіть No tax, якщо ваші ціни і ціна Loggi вже включають податки.

Для обмежень ваги та колонок ваги товар без ваги рахується як 0 кг.

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

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

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

Додатково

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

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

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

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

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

Для адреси в Бразилії з повним 8-значним CEP модуль формує посилки Loggi: кожен товар повертається так, щоб його найменша сторона була висотою, і товари укладаються в одну посилку, поки вона залишається в межах 55 × 55 × 55 см і 20 кг. Товари без ваги або габаритів рахуються як 1 см з кожного боку, а кожна посилка важить щонайменше 100 г. Loggi приймає 2 посилки на один розрахунок, тому великі кошики надсилаються кількома запитами, а суми підсумовуються. Модуль передає до Loggi ваш Shop ID, адресу забору, адресу доставки та посилки і перераховує підсумкову суму Loggi з BRL в основну валюту вашого магазину. Потім ціна показується у валюті кошика покупця.

Кожна ціна Loggi кешується на 1 годину для кожного кошика, адреси, облікового запису і середовища, щоб той самий кошик не викликав новий запит. Невдалий розрахунок кешується на 10 хвилин. Якщо Loggi взагалі недоступний, запити призупиняються на 2 хвилини, щоб оформлення замовлення не чекало Loggi під час кожного оновлення. Тайм-аут API — 10 секунд.

Натомість використовуються фіксовані ціни, якщо API не налаштовано, адреса за межами Бразилії або повного CEP ще немає, бракує курсу BRL, немає адреси забору, товар більший за посилку Loggi, кошику потрібно більше 10 посилок, або Loggi повертає помилку, відхилену посилку, адресу поза зоною обслуговування чи нульову суму. Якщо немає й фіксованої ціни, перевізник приховується. Покупець ніколи не бачить помилку API. Причина записується в журнал налагодження.

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

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

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

Модуль працює з ліцензійним ключем VibeFox з vibefox.net. Блок ліцензії License — VibeFox Loggi — це перший блок на сторінці Modules > Module Manager > VibeFox Loggi > Configure, над налаштуваннями. Введіть ключ у поле License key і натисніть Activate. Після цього блок показує ключ у прихованому вигляді, статус (наприклад, дату, до якої діє ліцензія, і ваш домен) та кнопки Check now для повторної перевірки статусу, Change key для введення іншого ключа і Remove key для видалення ключа з цього магазину. Нижче розташовані рядок Product: presta-shipping-loggi і посилання 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.

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

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

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

Loggi не з'являється під час оформлення замовлення: перевірте, що ліцензія активна і Enable Loggi увімкнено. У Shipping > Carriers перевірте, що перевізник охоплює зону країни покупця і групу покупця (або що увімкнено Ignore shipping zones і країна дозволена). Перегляньте попередження вгорі сторінки модуля, обмеження ваги та Minimum order amount. Якщо покупець ще не ввів повний CEP або Loggi не повертає ціну, перевізнику потрібна фіксована ціна: рядок для країни, рядок * або Price for countries not in the table. Товари також можна обмежити певними перевізниками на сторінці товару.

Показуються лише фіксовані ціни: перегляньте поле Log на сторінці модуля. Помилки завжди записуються. Увімкніть Debug log, щоб бачити кожен крок, і перезавантажте оформлення замовлення. Типові причини: немає e-mail API, ключа або Shop ID, немає адреси забору, не введено BRL exchange rate для валюти магазину, відмінної від BRL, ще немає повного 8-значного CEP, товар більший за 55 см або важчий за 20 кг, або адреса поза зоною обслуговування Loggi.

HTTP 401 або 403 у журналі: Loggi відхилив e-mail або ключ API. Перевірте їх у Loggi і переконайтеся, що Staging відповідає обліковим даним: ключі тестового і робочого середовищ різні.

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

Ціни неточні: заповніть вагу та габарити товарів. Без них товари рахуються як 1 см з кожного боку, а кожна посилка — як мінімум 100 г.

Per item не множить ціну Loggi: так задумано. Актуальна ціна Loggi покриває весь кошик. Per item застосовується лише до фіксованих цін.

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

Сторінка повідомляє, що перевізника Loggi не знайдено: перевізника видалено в Shipping > Carriers. Скиньте модуль у Modules > Module Manager, щоб створити його знову.

Видалення

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

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