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

Вимоги

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

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

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

Договір із Jadlog (для актуальних цін і пунктів Pickup): актуальні ціни та список пунктів Pickup надходять з API Embarcador Jadlog. Доступ видає ваша франшиза Jadlog після підписання договору. Вам потрібні токен API Embarcador, CNPJ (або CPF) відправника, зазначений у договорі, поточний рахунок (conta corrente) і, якщо він є, номер договору. Якщо ви використовуєте лише фіксовані ціни, договір із Jadlog не потрібен.

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

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

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

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

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

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

5. Вставте токен API, введіть CNPJ, поточний рахунок, номер договору та CEP відправлення, виберіть послугу Jadlog і, якщо валюта вашого магазину не BRL, введіть курс BRL. За потреби додайте фіксовані ціни або резервну вартість (див. розділ «Налаштування»).

6. Додайте VibeFox Jadlog до зони доставки для Бразилії в WooCommerce > Settings > Shipping > Shipping zones або увімкніть Ignore shipping zones і виберіть країни. Щоб пропонувати також пункти Jadlog Pickup, додайте спосіб до тієї самої зони вдруге та виберіть Pickup (40) як послугу.

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

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

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

Jadlog service (zone): послуга цього способу в зоні. Same as the global setting використовує послугу з головної сторінки налаштувань. Додайте спосіб двічі, щоб пропонувати, наприклад, доставку додому (.Package) і пункти Jadlog Pickup в одній зоні.

Якщо назва зони порожня, а послуга — Pickup, до загальної назви додається слово «Pickup», щоб два способи мали різні назви.

У верхній частині сторінки налаштувань плагін виводить попередження про неповне налаштування: немає токена API, CNPJ чи поточного рахунку, CEP відправлення або курсу BRL для магазину, який продає не в BRL. Щоразу, коли ви зберігаєте налаштування, кеш цін Jadlog і списків пунктів Pickup очищається.

Загальні

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

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

Актуальні ціни Jadlog

Актуальні ціни запитуються лише для адрес у Бразилії з повним 8-значним CEP.

API token: токен Embarcador від Jadlog. Його можна вставити з словом «Bearer» або без нього. Залиште порожнім, щоб використовувати лише фіксовані ціни.

CNPJ: CNPJ (14 цифр) або CPF (11 цифр) відправника, зазначеного в договорі Jadlog. Допускаються крапки, косі риски та дефіси. Плагін попередить, якщо кількість цифр неправильна.

Current account (conta corrente): номер вашого поточного рахунку Jadlog. Без нього та без CNPJ Jadlog не може розрахувати ціну, і використовуються лише фіксовані ціни.

Contract number: номер вашого договору з Jadlog, якщо франшиза його надала.

Origin CEP: поштовий індекс, з якого відправляються посилки, 8 цифр. Зберігається у форматі 00000-000. Залиште порожнім, щоб використовувати поштовий індекс магазину з WooCommerce > Settings > General, якщо адреса магазину в Бразилії.

Jadlog service: послуга (modalidade) вашого договору: .Package (3, за замовчуванням), .Com (9), Expresso (0), Rodoviário (4), Econômico (5), Doc (6), Corporate (7), Internacional (10), Cargo (12), Emergencial (14) або Pickup (40). Pickup пропонує пункти Jadlog Pickup поблизу покупця. Спосіб у зоні може використовувати іншу послугу.

Insurance type: Normal (N) (за замовчуванням) або Own insurance policy (A — apólice), як погоджено у вашому договорі з Jadlog.

Volumetric weight: Jadlog стягує більшу з фактичної та об'ємної ваги.

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

Delivery time: показувати термін доставки, повернутий Jadlog, поруч із назвою способу, наприклад «Jadlog (3 робочі дні)». Увімкнено за замовчуванням. Термін доставки завжди зберігається в замовленні.

Пункти Jadlog Pickup (використовуються послугою Pickup (40); потрібен токен API)

Points to show: скільки пунктів Pickup пропонувати, від 1 до 10. За замовчуванням: 5.

Фіксовані ціни (використовуються, коли немає токена API, для країн, які Jadlog не обслуговує, і щоразу, коли Jadlog не повертає ціну)

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

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

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

Умови

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

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

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

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

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

Tax status: Taxable додає податок WooCommerce до вартості доставки, None — ні. Ціни Jadlog — остаточні тарифи перевізника. Оберіть None, якщо WooCommerce не повинен додавати до них податок.

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

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

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

Додатково

Debug log: записує кожен запит і відповідь Jadlog у WooCommerce > Status > Logs, джерело vfd-jadlog. Помилки API завжди записуються, навіть якщо опцію вимкнено. Токен, CNPJ та рахунок ніколи не записуються, а CEP покупця скорочується. Вимкніть журнал, коли закінчите.

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

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

Коли покупець вводить адресу доставки, WooCommerce запитує у плагіна ціну. Плагін спершу перевіряє умови: вагу кошика, мінімальну суму замовлення та виключені класи доставки. Якщо проміжна сума кошика досягає Free shipping from, доставка безкоштовна і запит ціни до Jadlog не надсилається.

Для адреси доставки в Бразилії з повним 8-значним CEP плагін надсилає в Jadlog CEP відправлення та призначення, вагу, ваш CNPJ, поточний рахунок, договір, послугу, тип страхування та оголошену вартість замовлення, і показує повернуту ціну у валюті вашого магазину. Кошики без ваги розраховуються як 0,1 кг. Якщо актуальної ціни немає (немає токена, адреса поза Бразилією, неповний CEP, немає курсу BRL, помилка Jadlog), плагін використовує таблицю Price per country, потім Fallback cost. Якщо жоден із них не дає ціну, спосіб приховується для цього кошика.

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

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

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

Пункти Pickup

Спосіб із послугою Pickup (40) пропонується лише для адрес у Бразилії. Коли покупець ввів повний 8-значний CEP, плагін запитує в Jadlog активні найближчі пункти Pickup і пропонує до Points to show пунктів. Кожен пункт — окремий варіант доставки з власною ціною, наприклад «Jadlog Pickup: назва пункту — адреса». Покупець обирає пункт, вибираючи варіант доставки, як у класичному оформленні, так і в блоках «Кошик» і «Оформлення замовлення».

Ціна до кожного пункту запитується в Jadlog. Якщо Jadlog не дає ціну для пункту, використовується фіксована ціна, а пункт без жодної ціни пропускається. Списки пунктів кешуються на 12 годин.

Без токена API, без 8-значного CEP, коли Jadlog недоступний або коли поблизу немає активних пунктів, спосіб Pickup приховується. Замовлення без пункту не можна було б відправити.

Замовлення

Рядок доставки в замовленні зберігає послугу Jadlog і, якщо Jadlog її повернув, термін доставки в робочих днях. Для замовлення з Pickup назва рядка доставки містить назву та адресу пункту, а замовлення також зберігає назву, адресу та ID пункту Pickup. Їх видно під рядком доставки на екрані замовлення в адмін-панелі. Покупець бачить обраний пункт на сторінці «Дякуємо за замовлення» та в листах про замовлення.

Оформіть відправлення в системі Jadlog самостійно. У замовленні вказано послугу та ID пункту Pickup, які вам для цього потрібні.

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

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

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

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

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

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

Jadlog не з'являється під час оформлення замовлення: перевірте, що ліцензія активна, що Enable/Disable увімкнено і спосіб додано до зони країни покупця (або увімкнено Ignore shipping zones і країна дозволена). Перевірте попередження у верхній частині сторінки налаштувань, обмеження ваги, Minimum order amount і Excluded shipping classes. Якщо покупець ще не ввів повний 8-значний CEP, можна використовувати лише фіксовані ціни, тож додайте рядок у Price per country або Fallback cost.

Показуються лише фіксовані ціни: увімкніть Debug log, перезавантажте оформлення замовлення та відкрийте WooCommerce > Status > Logs, джерело vfd-jadlog. Там указано причину: немає CNPJ або поточного рахунку, немає CEP відправлення, неповний CEP призначення, немає курсу BRL або текст помилки Jadlog.

HTTP 401 або 403 у журналі: Jadlog відхилив токен API. Перевірте його у своїй франшизі Jadlog. Після цієї помилки API призупиняється на 10 хвилин. Збереження налаштувань знімає паузу, тож можна спробувати одразу.

Пункти Pickup не з'являються: способу Pickup потрібні токен API і повний 8-значний CEP у Бразилії. Якщо в Jadlog немає активних пунктів поблизу CEP, спосіб приховується. Причину дивіться в журналі.

Ціни в реалах, а не у моїй валюті: введіть BRL exchange rate (скільки коштує 1 BRL у валюті вашого магазину).

Ціни занадто низькі або занадто високі: заповніть ваги та розміри товарів. Кошики без ваги розраховуються як 0,1 кг, а для об'ємної ваги потрібні розміри.

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

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

Видалення

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

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