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

Вимоги

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

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

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

Обліковий запис Cargoson (лише для тарифів у реальному часі): тарифи в реальному часі використовують API тарифів на перевезення Cargoson. Запити тарифів на перевезення потребують передплати Cargoson з доступом до API (план Advanced або вищий на момент написання). Ключ API видається у вашому обліковому записі Cargoson; якщо ваш план не показує налаштування API, зверніться до служби підтримки Cargoson. Тарифи надходять від перевізників і прайс-листів, підключених до цього облікового запису. Якщо ви використовуєте лише фіксовані ціни, обліковий запис Cargoson не потрібен.

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

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

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

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

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

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

5. Виберіть, як розраховується вартість доставки, і заповніть відповідні розділи: фіксовані ціни та, для тарифів у реальному часі, ключ API і поштовий індекс відправлення (див. Налаштування).

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

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

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

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

Щоразу, коли ви зберігаєте налаштування, кешовані тарифи Cargoson очищуються. Десяткові числа можна вводити з крапкою або комою.

General

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

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

Shipping cost: спосіб розрахунку ціни.

Причина відсутності тарифу в реальному часі записується в журнал WooCommerce. Покупцеві вона ніколи не показується.

Cargoson API (потрібно лише для тарифів у реальному часі)

API key: ключ API з вашого облікового запису Cargoson. Він надсилається лише на cargoson.com і ніколи не показується покупцям та не записується в журнал.

Carrier: які тарифи використовуються. Покупець бачить один тариф.

Package type code: код типу упаковки Cargoson, що надсилається із запитом тарифу. За замовчуванням: CLL. Приклади API Cargoson використовують EUR (європалета EUR) і FIN (фінська палета FIN). Для посилок використовуйте код упаковки вашого облікового запису Cargoson. Замовлення надсилається як одна упаковка із загальною вагою кошика.

Price currency: валюта тарифів у вашому обліковому записі Cargoson у вигляді трилітерного коду. За замовчуванням: EUR. API повертає суми без коду валюти.

Currency conversion rate: потрібен, лише якщо валюта тарифів відрізняється від валюти магазину: 1 одиниця валюти Cargoson = X одиниць валюти магазину. Залиште поле порожнім, щоб відхиляти такі тарифи, і покупець ніколи не платитиме у неправильній валюті.

Ship from (collection address) (використовується для тарифів у реальному часі)

Collection country: країна, з якої ви відправляєте. За замовчуванням — країна вашого магазину.

Collection postcode: поштовий індекс, з якого ви відправляєте. Cargoson вимагає його. Якщо поле порожнє, а країна відправлення збігається з країною магазину, використовується поштовий індекс магазину з WooCommerce > Settings > General.

Дата забору, яка надсилається в Cargoson, — сьогодні або наступний понеділок, якщо сьогодні вихідний.

Fixed prices (використовуються, коли Shipping cost має значення Fixed prices, а також як запасний варіант для тарифів у реальному часі)

Price per country and size: таблиця країн зі стовпцем Price і цінами за вагою кошика у валюті магазину: XS до 1 кг, S до 2 кг, M до 3 кг, L до 5 кг, XL понад 5 кг. Порожня або нульова ціна розміру використовує стовпець Price; порожній стовпець Price означає, що для цього розміру фіксованого тарифу немає. Натисніть Add country, щоб додати рядок, і хрестик, щоб видалити його. Рядок * Default застосовується до всіх країн, які не мають власного рядка. Країни без рядка (коли рядка * немає) не отримують фіксованого тарифу, тому для них метод приховано.

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

Conditions

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

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

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

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

Free shipping: вмикає безкоштовну доставку, коли досягається сума замовлення, вказана нижче.

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

Tax status: Taxable додає податок на доставку відповідно до ваших податкових налаштувань WooCommerce, None — не додає. Тарифи перевізників у Cargoson зазвичай вказані без ПДВ. Виберіть None, якщо ваші ціни вже включають податок.

Availability without shipping zones

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

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

Advanced

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

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

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

Коли покупець вводить адресу доставки, WooCommerce запитує в плагіна тариф. Спершу плагін перевіряє умови: країна доставки, вага кошика, мінімальна сума замовлення та виключені класи доставки. Якщо застосовується безкоштовна доставка, покупець отримує безкоштовний тариф і запит до Cargoson не надсилається.

У режимі фіксованих цін ціна береться з таблиці. У режимах у реальному часі плагін надсилає в Cargoson дату забору, країну та поштовий індекс відправлення, країну та поштовий індекс доставки, а також одну упаковку з кодом типу упаковки та загальною вагою кошика (щонайменше 0,1 кг). Ваги товарів перераховуються з одиниць вашого магазину в кілограми. Тариф у реальному часі запитується лише після того, як покупець ввів поштовий індекс. Cargoson повертає ціни ваших перевізників; плагін обирає найдешевшу (серед обраного перевізника, якщо він заданий) і за потреби конвертує її у валюту магазину.

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

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

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

Замовлення

Коли використовується тариф у реальному часі, рядок доставки замовлення зберігає запропоновані Carrier, Service і Cargoson service ID. Вони відображаються на екрані редагування замовлення, щоб ви знали, що бронювати в Cargoson. Оформіть відправлення в Cargoson або через його власні інтеграції.

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

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

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

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

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

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

Cargoson не з'являється під час оформлення замовлення: перевірте, що ліцензія активна, Enable/Disable увімкнено, а метод додано до зони країни покупця (або увімкнено Ignore shipping zones і країна дозволена). Перевірте обмеження ваги, Minimum order amount і Excluded shipping classes. У режимі фіксованих цін переконайтеся, що для країни або * Default є ціна для розміру кошика.

Тарифи в реальному часі не з'являються: відкрийте WooCommerce > Status > Logs, джерело vfd_cargoson. Помилки API завжди записуються; увімкніть Debug log, щоб бачити кожен розрахунок. Типові причини: поштовий індекс доставки ще не введено, немає поштового індексу відправлення, ключ API відхилено (неправильний або прострочений ключ чи відсутній доступ до API у вашому плані Cargoson), немає перевізника для маршруту чи ваги або ціна в іншій валюті. З Cargoson live prices, fixed prices if the API fails покупці все одно отримують фіксовану ціну, поки ви усуваєте проблему.

Cargoson відхиляє тип упаковки: використовуйте код упаковки, який ваш обліковий запис Cargoson застосовує в Package type code. Причина відображається в журналі.

Ціна в іншій валюті відхиляється: встановіть Price currency на валюту ваших тарифів Cargoson і введіть Currency conversion rate.

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

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

Видалення

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

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