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

Вимоги

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

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

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

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

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

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

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

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

6. Додайте VibeFox Loggi до зони доставки для Бразилії в WooCommerce > Settings > Shipping > Shipping zones або увімкніть Ignore shipping zones і виберіть країни.

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

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

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

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

Загальні

Enable/Disable: вмикає або вимикає метод у всіх зонах одночасно.

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

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

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

API key: ваш ключ API Loggi. Він надсилається лише до Loggi і ніколи не записується в журнал.

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

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

Pickup address: звідки Loggi забирає посилки, одним рядком: вулиця та номер будинку, район, місто, штат і CEP, наприклад Rua Example, 123 - Bairro, São Paulo - SP, 01310-100. Залиште порожнім, щоб використати адресу магазину з WooCommerce > Settings > General, якщо вона в Бразилії. Без адреси забору 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) колонка ваги використовує базову ціну. Базова ціна 0 означає безкоштовну доставку. Приймаються як «9.99», так і «9,99». Порожні рядки та другий рядок для тієї самої країни видаляються під час збереження.

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

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

Умови

Minimum weight (kg): приховує метод, якщо кошик важить менше. 0 означає без обмежень.

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

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

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

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

Tax status: Taxable додає податок WooCommerce до вартості доставки, None — ні. Виберіть None, якщо ваші ціни і ціна Loggi вже включають податки.

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

Ignore shipping zones: пропонувати Loggi для зазначених нижче країн, навіть якщо метод не додано до жодної зони доставки.

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

Додатково

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

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

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

Коли покупець вводить адресу доставки, WooCommerce запитує в плагіна тариф. Плагін спочатку перевіряє умови: країна доставки, вага кошика, мінімальна сума замовлення та виключені класи доставки. Якщо застосовується безкоштовна доставка, покупець бачить метод без оплати, і запит до 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. Причина записується в журнал.

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

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

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

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

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

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

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

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

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

Показуються лише фіксовані ціни: відкрийте WooCommerce > Status > Logs, джерело vfd-loggi. Помилки записуються завжди. Увімкніть Debug log, щоб бачити кожен крок. Типові причини: не вказано e-mail, ключ або Shop ID API, немає адреси забору, немає 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 застосовується лише до фіксованих цін.

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

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

Видалення

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

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