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

Вимоги

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

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

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

Обліковий запис CTT e-commerce (лише для тарифів у реальному часі та пунктів CTT): тарифи в реальному часі та доставка до пункту CTT використовують API CTT e-commerce. Вам потрібен обліковий запис CTT e-commerce на enviosecommerce.ctt.pt (для клієнтів з договором CTT Expresso або запросіть пропозицію у CTT). На сторінці керування ключами цього облікового запису створіть пару відкритого та закритого ключів. App ID (X-APPID) видає CTT для вашої інтеграції: уточніть його у свого контакту CTT e-commerce. CTT також визначає, які функції API (оцінка вартості, пункти CTT) може використовувати ваш App ID. Нарешті, вам потрібен Carrier ID CTT у вашому обліковому записі. Сторінка налаштувань показує перевізників вашого облікового запису після збереження ключів. Якщо ви використовуєте лише таблицю цін і доставку додому, ключі API не потрібні.

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

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

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

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

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

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

5. Заповніть таблицю цін (принаймні рядок Portugal або * Default). За бажання введіть ключі API CTT і Carrier ID та увімкніть Live rates (див. Налаштування).

6. У WooCommerce > Settings > Shipping > Shipping zones відкрийте або створіть зону для Португалії та додайте VibeFox CTT. У налаштуваннях способу виберіть назву та тип доставки. Або увімкніть Ignore shipping zones і виберіть країни.

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

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

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

Delivery: To the customer's address (за замовчуванням) або To a CTT point or parcel locker chosen at checkout. Пункт CTT потребує ключів API CTT і Carrier ID у загальних налаштуваннях. Додайте спосіб до зони двічі, щоб пропонувати поруч доставку додому та доставку до пункту CTT.

Попередження над налаштуваннями повідомляють про відсутню ціну для Португалії, неповні ключі API, відсутній Carrier ID, валюту магазину без курсу обміну та невдале з'єднання з API CTT. Щоразу, коли ви зберігаєте налаштування, кешовані відповіді CTT очищаються.

Загальні

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

Name: назва способу доставки, яку бачить покупець на оформленні замовлення, наприклад «CTT Expresso». За замовчуванням: CTT. Title зони має пріоритет над нею.

Tax status: Taxable додає до ціни податок на доставку WooCommerce (наприклад, IVA), None означає, що ціна остаточна.

API CTT e-commerce (тарифи в реальному часі, пункти CTT) (необов'язково; без ключів використовується таблиця цін)

Public key: відкритий ключ зі сторінки керування ключами вашого облікового запису CTT e-commerce.

Private key: секретний ключ, яким підписується кожен запит (HMAC-SHA256). Він ніколи не надсилається до CTT і не записується в журнал.

App ID (X-APPID): ключ застосунку, виданий CTT для вашої інтеграції.

Carrier ID: ID перевізника CTT у вашому обліковому записі, який використовується для тарифів у реальному часі та пошуку пунктів CTT. Після збереження ключів перевізники вашого облікового запису виводяться під полем, а ті, що підтримують пункти CTT, позначені.

Live rates: запитує в CTT ціну (оцінку вартості), щойно покупець введе вулицю, поштовий індекс і місто. Таблиця цін використовується, поки адреса неповна, і щоразу, коли CTT не повертає ціну. CTT називає цю ціну оцінкою. За замовчуванням: вимкнено.

Service ID: необов'язково. Коли CTT повертає кілька послуг, використовується та, що має цей ServiceId. Залиште порожнім, щоб використовувати найдешевшу.

Exchange rate: ціни CTT вказані в євро. Якщо валюта вашого магазину інша, вкажіть, скільки одиниць валюти магазину дорівнюють 1 одиниці валюти CTT. Без цього тарифи в реальному часі в іншій валюті не використовуються, і діє таблиця цін.

Default product size (cm): довжина x ширина x висота, які надсилаються до CTT для товарів без розмірів. За замовчуванням: 30x20x15. Товари з розмірами використовують свої. Розміри переводяться в см, а вага — у грами з одиниць вашого магазину.

Ціни (у заголовку розділу показано валюту вашого магазину)

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

Price table: один рядок на напрямок. Виберіть країну, Portugal - Azores (PT-AC), Portugal - Madeira (PT-MA) або * Default (other destinations). У кожному рядку є базова ціна (Price) і необов'язкові ціни для розмірів XS (до 1 кг), S (до 2 кг), M (до 3 кг), L (до 5 кг) і XL (понад 5 кг). Порожня (або 0) ціна розміру використовує базову ціну. Рядок, де обидві ціни порожні, приховує спосіб. Рядок Азорських островів застосовується до португальських поштових індексів 9500–9999, рядок Мадейри (включно з Порту-Санту) — до 9000–9499. Без них застосовується рядок Portugal. Натисніть + Add destination, щоб додати рядок, і хрестик, щоб видалити. Ціни приймають крапку або кому як десятковий роздільник. Некоректні рядки виводяться під час збереження.

Calculation: як визначається ціна з таблиці.

Тариф CTT у реальному часі завжди стосується всього відправлення.

Умови

Min weight (kg): мінімальна вага кошика, за якої спосіб з'являється. 0 означає без обмеження.

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

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

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

Безкоштовна доставка

Free shipping: вмикає безкоштовну доставку CTT від суми, вказаної нижче.

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

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

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

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

Додатково

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

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

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

Коли покупець вводить адресу доставки, WooCommerce запитує в плагіна ціну. Спочатку плагін перевіряє вагу кошика, мінімальну суму замовлення та виключені класи доставки. Якщо увімкнено Live rates і адреса повна, він надсилає до CTT адресу доставки, а для кожної позиції кошика — кількість, вагу в грамах і розміри в см, і показує повернуту ціну. Інакше, або коли CTT не повертає ціну (помилка API, тайм-аут, немає покриття, функція не увімкнена для вашого App ID), ціна береться з таблиці. Якщо діє безкоштовна доставка, ціна дорівнює 0.

Ціна CTT кешується на 1 годину, щоб той самий кошик не викликав новий запит. Невдалий запит запам'ятовується на 5 хвилин, щоб оформлення замовлення не чекало CTT під час кожного оновлення. Тайм-аут API — 12 секунд.

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

Якщо ключі API заповнені, плагін надсилає до CTT адресу доставки, ваги та розміри товарів і URL вашого магазину, щоб отримати ціну або найближчі пункти CTT.

Плагін не створює відправлень, не друкує етикеток, не замовляє забір, не надає номери для відстеження і не показує карту пунктів CTT. Для всього магазину є одна таблиця цін і один набір налаштувань API. Зони відрізняються назвою та типом доставки.

Пункти видачі

Для способу зони з Delivery, встановленим на пункт CTT, під способом на оформленні замовлення з'являються поле пошуку та список. Адреса доставки шукається автоматично. Покупець може шукати інші пункти CTT за поштовим індексом або містом і має вибрати один до оформлення замовлення. Це також перевіряється на сервері. Списки пунктів CTT кешуються на 6 годин. Якщо CTT недоступна, покупець бачить повідомлення і може спробувати пізніше або вибрати інший спосіб доставки.

Вибраний пункт зберігається в замовленні. Він відображається в адмінпанелі замовлення під адресою доставки, на сторінці отриманого замовлення, в My account > Orders і в електронних листах про замовлення (HTML і звичайний текст) як CTT point.

В адмінпанелі замовлення натисніть Change поруч із пунктом CTT, знайдіть за поштовим індексом або містом і виберіть інший пункт. Зміна зберігається одразу і додає примітку до замовлення.

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

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

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

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

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

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

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

Покупець не може вибрати пункт CTT: селектор з'являється лише для способу зони з Delivery, встановленим на пункт CTT, і лише коли заповнені відкритий ключ, закритий ключ, App ID і Carrier ID. Увімкніть Debug log і перевірте WooCommerce > Status > Logs.

Тарифи в реальному часі не з'являються: таблиця цін використовується, доки покупець не ввів вулицю, поштовий індекс і місто. Перевірте попередження над налаштуваннями та журнал. Відповідь «405» означає, що функція не увімкнена для вашого App ID: запитайте у CTT. У магазині не в євро заповніть Exchange rate.

Не вдалося з'єднатися з API CTT: попередження над налаштуваннями показує помилку. Перевірте ключі та App ID. Плагін повторює спробу автоматично через кілька хвилин.

Ціни з ПДВ чи без: з Tax status на Taxable WooCommerce додає податок на доставку до ціни. З None ціна остаточна.

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

Видалення

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

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